TouchList

The TouchList interface represents a list of contact points on a touch surface. For example, if the user has three fingers on the touch surface (such as a screen or trackpad), the corresponding TouchList object would have one Touch object for each finger, for a total of three entries.

Properties

TouchList.length Read only
The number of Touch objects in the TouchList.

Methods

TouchList.identifiedTouch()
Returns the first Touch item in the list whose identifier matches a specified value.
TouchList.item()
Returns the Touch object at the specified index in the list.

Example

See the example on the main Touch events article.

Specifications

Specification Status Comment
Touch Events – Level 2 Draft Non-stable version.
Touch Events Recommendation Initial definition.

Browser compatibility

DesktopMobile
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewChrome for AndroidFirefox for AndroidOpera for AndroidSafari on iOSSamsung Internet
TouchListChrome Full support 18Edge Full support ≤18Firefox Full support 52
Full support 52
No support 18 — 24
IE No support NoOpera Full support 15Safari No support NoWebView Android Full support YesChrome Android Full support YesFirefox Android Full support 6Opera Android Full support 14Safari iOS Full support YesSamsung Internet Android Full support Yes
identifiedTouch
DeprecatedNon-standard
Chrome ? Edge ? Firefox ? IE No support NoOpera ? Safari No support NoWebView Android ? Chrome Android ? Firefox Android ? Opera Android ? Safari iOS ? Samsung Internet Android ?
itemChrome Full support 18Edge Full support ≤18Firefox Full support 52
Full support 52
No support 18 — 24
IE No support NoOpera Full support 15Safari No support NoWebView Android Full support YesChrome Android Full support YesFirefox Android Full support 6Opera Android Full support 14Safari iOS Full support YesSamsung Internet Android Full support Yes
lengthChrome Full support 18Edge Full support ≤18Firefox Full support 52
Full support 52
No support 18 — 24
IE No support NoOpera Full support 15Safari No support NoWebView Android Full support YesChrome Android Full support YesFirefox Android Full support 6Opera Android Full support 14Safari iOS Full support YesSamsung Internet Android Full support Yes

Legend

Full support
Full support
No support
No support
Compatibility unknown
Compatibility unknown
Non-standard. Expect poor cross-browser support.
Non-standard. Expect poor cross-browser support.
Deprecated. Not for use in new websites.
Deprecated. Not for use in new websites.

See also