TouchList class / dart:html Library / Dart API Reference

TouchList class

A TouchList represents a list of all of the points of contact with a touch surface; for example, if the user has three fingers on the screen (or trackpad), the corresponding TouchList would have one Touch object for each finger, for a total of three entries.

from MDN

@DomName('TouchList')
class TouchList extends Interceptor with ListMixin<Touch>, ImmutableListMixin<Touch> implements JavaScriptIndexingBehavior, List<Touch> native "TouchList" {
 /// NB: This constructor likely does not work as you might expect it to! This
 /// constructor will simply fail (returning null) if you are not on a device
 /// with touch enabled. See dartbug.com/8314.
 factory TouchList() => document.$dom_createTouchList();

 /// Checks if this type is supported on the current platform.
 static bool get supported => JS('bool', '!!document.createTouchList');

 @DomName('TouchList.length')
 @DocsEditable
 int get length => JS("int", "#.length", this);

 Touch operator[](int index) {
   if (JS("bool", "# >>> 0 !== # || # >= #", index,
       index, index, length))
     throw new RangeError.range(index, 0, length);
   return JS("Touch", "#[#]", this, index);
 }
 void operator[]=(int index, Touch value) {
   throw new UnsupportedError("Cannot assign element of immutable List.");
 }
 // -- start List<Touch> mixins.
 // Touch is the element type.


 void set length(int value) {
   throw new UnsupportedError("Cannot resize immutable List.");
 }

 Touch get first {
   if (this.length > 0) {
     return JS('Touch', '#[0]', this);
   }
   throw new StateError("No elements");
 }

 Touch get last {
   int len = this.length;
   if (len > 0) {
     return JS('Touch', '#[#]', this, len - 1);
   }
   throw new StateError("No elements");
 }

 Touch get single {
   int len = this.length;
   if (len == 1) {
     return JS('Touch', '#[0]', this);
   }
   if (len == 0) throw new StateError("No elements");
   throw new StateError("More than one element");
 }

 Touch elementAt(int index) => this[index];
 // -- end List<Touch> mixins.

 @DomName('TouchList.item')
 @DocsEditable
 Touch item(int index) native;

}

Extends

Interceptor > Interceptor_ListMixin > Interceptor_ListMixin_ImmutableListMixin > TouchList

Implements

List<Touch>, JavaScriptIndexingBehavior

Static Properties

final bool supported #

Checks if this type is supported on the current platform.

static bool get supported => JS('bool', '!!document.createTouchList');

Constructors

factory TouchList() #

NB: This constructor likely does not work as you might expect it to! This constructor will simply fail (returning null) if you are not on a device with touch enabled. See dartbug.com/8314.

factory TouchList() => document.$dom_createTouchList();

Properties

final Touch first #

Returns the first element.

If this is empty throws a StateError. Otherwise this method is equivalent to this.elementAt(0)

docs inherited from Iterable<E>

Touch get first {
 if (this.length > 0) {
   return JS('Touch', '#[0]', this);
 }
 throw new StateError("No elements");
}

final int hashCode #

inherited from Interceptor

Get a hash code for this object.

All objects have hash codes. Hash codes are guaranteed to be the same for objects that are equal when compared using the equality operator ==. Other than that there are no guarantees about the hash codes. They will not be consistent between runs and there are no distribution guarantees.

If a subclass overrides hashCode it should override the equality operator as well to maintain consistency.

docs inherited from Object

int get hashCode => Primitives.objectHashCode(this);

TouchList class

Extends

Implements

Static Properties

Code final bool supported #

Constructors

Code factory TouchList() #

Properties

Code final Touch first #

Code final int hashCode #

Code final bool isEmpty #

Code final Iterator<E> iterator #

Code final Touch last #

Code int get length #

Code void set length(int value) #

Code final Iterable<E> reversed #

Code final Type runtimeType #

Code final Touch single #

Operators

Code Touch operator [](int index) #

Code void operator []=(int index, Touch value) #

Code bool operator ==(other) #

Methods

Code void add(E value) #

Code void addAll(Iterable<E> iterable) #

Code bool any(bool test(E element)) #

Code Map<int, E> asMap() #

Code void clear() #

Code bool contains(E element) #

Code Touch elementAt(int index) #

Code bool every(bool test(E element)) #

Code Iterable expand(Iterable f(E element)) #

Code void fillRange(int start, int end, [E fillValue]) #

Code E firstWhere(bool test(E element), {E orElse()}) #

Code dynamic fold(initialValue, combine(previousValue, E element)) #

Code void forEach(void action(E element)) #

Code Iterable<E> getRange(int start, int end) #

Code int indexOf(E element, [int startIndex = 0]) #

Code void insert(int index, E element) #

Code void insertAll(int index, Iterable<E> iterable) #

Code Touch item(int index) #

Code String join([String separator = ""]) #

Code int lastIndexOf(E element, [int startIndex]) #

Code E lastWhere(bool test(E element), {E orElse()}) #

Code Iterable map(f(E element)) #

Code dynamic noSuchMethod(Invocation invocation) #

Code E reduce(E combine(E previousValue, E element)) #

Code void remove(Object object) #

Code E removeAt(int pos) #

Code E removeLast() #

Code void removeRange(int start, int end) #

Code void removeWhere(bool test(E element)) #

Code void replaceRange(int start, int end, Iterable<E> iterable) #

Code void retainWhere(bool test(E element)) #

Code void setAll(int index, Iterable<E> iterable) #

Code void setRange(int start, int end, Iterable<E> iterable, [int skipCount]) #

Code E singleWhere(bool test(E element)) #

Code Iterable<E> skip(int count) #

Code Iterable<E> skipWhile(bool test(E element)) #

Code void sort([int compare(E a, E b)]) #

Code List<E> sublist(int start, [int end]) #

Code Iterable<E> take(int count) #

Code Iterable<E> takeWhile(bool test(E element)) #

Code List<E> toList({bool growable: true}) #

Code Set<E> toSet() #

Code String toString() #

Code Iterable<E> where(bool test(E element)) #

final bool supported #

factory TouchList() #

final Touch first #

final int hashCode #

final bool isEmpty #

final Iterator<E> iterator #

final Touch last #

int get length #

void set length(int value) #

final Iterable<E> reversed #

final Type runtimeType #

final Touch single #

Touch operator [](int index) #

void operator []=(int index, Touch value) #

bool operator ==(other) #

void add(E value) #

void addAll(Iterable<E> iterable) #

bool any(bool test(E element)) #

Map<int, E> asMap() #

void clear() #

bool contains(E element) #

Touch elementAt(int index) #

bool every(bool test(E element)) #

Iterable expand(Iterable f(E element)) #

void fillRange(int start, int end, [E fillValue]) #

E firstWhere(bool test(E element), {E orElse()}) #

dynamic fold(initialValue, combine(previousValue, E element)) #

void forEach(void action(E element)) #

Iterable<E> getRange(int start, int end) #

int indexOf(E element, [int startIndex = 0]) #

void insert(int index, E element) #

void insertAll(int index, Iterable<E> iterable) #

Touch item(int index) #

String join([String separator = ""]) #

int lastIndexOf(E element, [int startIndex]) #

E lastWhere(bool test(E element), {E orElse()}) #

Iterable map(f(E element)) #

dynamic noSuchMethod(Invocation invocation) #

E reduce(E combine(E previousValue, E element)) #

void remove(Object object) #

E removeAt(int pos) #

E removeLast() #

void removeRange(int start, int end) #

void removeWhere(bool test(E element)) #

void replaceRange(int start, int end, Iterable<E> iterable) #

void retainWhere(bool test(E element)) #

void setAll(int index, Iterable<E> iterable) #

void setRange(int start, int end, Iterable<E> iterable, [int skipCount]) #

E singleWhere(bool test(E element)) #

Iterable<E> skip(int count) #

Iterable<E> skipWhile(bool test(E element)) #

void sort([int compare(E a, E b)]) #

List<E> sublist(int start, [int end]) #

Iterable<E> take(int count) #

Iterable<E> takeWhile(bool test(E element)) #

List<E> toList({bool growable: true}) #

Set<E> toSet() #

String toString() #

Iterable<E> where(bool test(E element)) #