TouchEvent: changedTouches property
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
ThechangedTouches read-only property is aTouchList whose touch points (Touch objects) varies depending on the event type, as follows:
- For the
touchstartevent, it is a list of the touch points that became active with the current event. - For the
touchmoveevent, it is a list of the touch points that have changed since the last event. - For the
touchendandtouchcancelevents, it is a list of the touch points that have been removed from the surface (that is, the set of touch points corresponding to fingers no longer touching the surface).
In this article
Value
ATouchList whoseTouch objects include all the touch points that contributed to this touch event.
Examples
This example illustrates theTouchEvent object'sTouchEvent.changedTouches property. TheTouchEvent.changedTouches property is aTouchList object that contains oneTouch object for each touch point which contributed to the event.
In following code snippet, thetouchmove event handler iterates through thechangedTouches list and prints the identifier of each touch point that changed since the last event.
js
someElement.addEventListener("touchmove", (e) => { // Iterate through the list of touch points that changed // since the last event and print each touch point's identifier. for (let i = 0; i < e.changedTouches.length; i++) { console.log( `changedTouches[${i}].identifier = ${e.changedTouches[i].identifier}`, ); }});Specifications
| Specification |
|---|
| Touch Events> # dom-touchevent-changedtouches> |