TouchList extension type

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.

This interface was an attempt to create an unmodifiable list and only continues to be supported to not break code that's already using it. Modern APIs represent list structures using types based on JavaScript arrays, thus making many array methods available, and at the same time imposing additional semantics on their usage (such as making their items read-only).

These historical reasons do not mean that you as a developer should avoid TouchList. You don't create TouchList objects yourself, but you get them from APIs such as TouchEvent.targetTouches, and these APIs are not deprecated. However, be careful of the semantic differences from a real array.

API documentation sourced from MDN Web Docs.

on
Implemented types
Available extensions

Properties

hashCode → int
The hash code for this object.
no setterinherited
length → int
The length read-only property indicates the number of items (touch points) in a given TouchList.
no setter
runtimeType → Type
A representation of the runtime type of the object.
no setterinherited

Methods

item(int index) → Touch?
The item() method returns the Touch object at the specified index in the TouchList.
noSuchMethod(Invocation invocation) → dynamic
Invoked when a nonexistent method or property is accessed.
inherited
toString() → String
A string representation of this object.
inherited

Operators

operator ==(Object other) → bool
The equality operator.
inherited