Document: createTouchList() method
Deprecated: This feature is no longer recommended. Though some browsers might still support it, it may have already been removed from the relevant web standards, may be in the process of being dropped, or may only be kept for compatibility purposes. Avoid using it, and update existing code if possible; see the compatibility table at the bottom of this page to guide your decision. Be aware that this feature may cease to work at any time.
Non-standard: This feature is not standardized. We do not recommend using non-standard features in production, as they have limited browser support, and may change or be removed. However, they can be a suitable alternative in specific cases where no standard option exists.
The Document.createTouchList()
method creates and returns a new TouchList
object.
Syntax
createTouchList(touch1)
createTouchList(touch1, touch2)
createTouchList(touch1, touch2, /* …, */ touchN)
Parameters
touch1
, …,touchN
-
Zero or more
Touch
objects. Note: Firefox also accepts an array ofTouch
objects.
Return value
Examples
This example illustrates using the Document.createTouchList()
method to
create TouchList
objects.
In following code snippet, some Touch
objects are created for the
target
element and those touch points are then used to create some
TouchList
objects.
const target = document.getElementById("target");
// Create some touch points
const touch1 = document.createTouch(window, target, 1, 15, 20, 35, 40);
const touch2 = document.createTouch(window, target, 2, 25, 30, 45, 50);
// Create an empty TouchList objects
const list0 = document.createTouchList();
// Create a TouchList with only one Touch object
const list1 = document.createTouchList(touch1);
// Create a list with two Touch objects
const list2 = document.createTouchList(touch1, touch2);
Specifications
This feature is not part of any current specification. It is no longer on track to become a standard.