Query<T> class

A query object that wraps around DOM Elements, HTMLDocument, Window and ShadowRoot which offers API to register event listeners in a batch, or to retrieve other query objects via selectors.

Implemented types
Implementers

Constructors

Query()

Properties

context → dynamic
The DOM node context originally passed to Query; if none was passed [...]
read-only
data Data
The interface to access custom element data.
read-only
first ↔ T
Returns the first element. [...]
read / write, inherited
firstIfAny → T
Return the first matched element, or null if empty.
read-only
hashCode int
The hash code for this object. [...]
read-only, inherited
isEmpty bool
Returns true if there are no elements in this collection. [...]
read-only, inherited
isNotEmpty bool
Returns true if there is at least one element in this collection. [...]
read-only, inherited
iterator Iterator<T>
Returns a new Iterator that allows iterating the elements of this Iterable. [...]
read-only, inherited
last ↔ T
Returns the last element. [...]
read / write, inherited
length int
The number of objects in this list. [...]
read / write, inherited
reversed Iterable<T>
An Iterable of the objects in this list in reverse order.
read-only, inherited
runtimeType Type
A representation of the runtime type of the object.
read-only, inherited
selector String
read-only
single → T
Checks that this iterable has only one element, and returns that element. [...]
read-only, inherited

Methods

add(T value) → void
Adds value to the end of this list, extending the length by one. [...]
inherited
addAll(Iterable<T> iterable) → void
Appends all objects of iterable to the end of this list. [...]
inherited
any(bool test(T element)) bool
Checks whether any element of this iterable satisfies test. [...]
inherited
asMap() Map<int, T>
An unmodifiable Map view of this list. [...]
inherited
cast<R>() List<R>
Returns a view of this list as a list of R instances. [...]
inherited
clear() → void
Removes all objects from this list; the length of the list becomes zero. [...]
inherited
contains(Object element) bool
Whether the collection contains an element equal to element. [...]
inherited
elementAt(int index) → T
Returns the indexth element. [...]
inherited
end() Query
Pops out the top Query object in the stack and retrieve the previous one. [...]
every(bool test(T element)) bool
Checks whether every element of this iterable satisfies test. [...]
inherited
expand<T>(Iterable<T> f(T element)) Iterable<T>
Expands each element of this Iterable into zero or more elements. [...]
inherited
fillRange(int start, int end, [T fillValue]) → void
Overwrites a range of elements with fillValue. [...]
inherited
find(String selector) ElementQuery
Retrieve an ElementQuery containing descendants of this element collection [...]
firstWhere(bool test(T element), {T orElse()}) → T
Returns the first element that satisfies the given predicate test. [...]
inherited
fold<T>(T initialValue, T combine(T previousValue, T element)) → T
Reduces a collection to a single value by iteratively combining each element of the collection with an existing value [...]
inherited
followedBy(Iterable<T> other) Iterable<T>
Returns the lazy concatenation of this iterable and other. [...]
inherited
forEach(void f(T element)) → void
Applies the function f to each element of this collection in iteration order.
inherited
getRange(int start, int end) Iterable<T>
Creates an Iterable that iterates over a range of elements. [...]
inherited
indexOf(T element, [int start = 0]) int
The first index of element in this list. [...]
inherited
indexWhere(bool test(T element), [int start = 0]) int
The first index in the list that satisfies the provided test. [...]
inherited
insert(int index, T element) → void
Inserts element at position index in this list. [...]
inherited
insertAll(int index, Iterable<T> iterable) → void
Inserts all objects of iterable at position index in this list. [...]
inherited
join([String separator = ""]) String
Converts each element to a String and concatenates the strings. [...]
inherited
lastIndexOf(T element, [int start]) int
The last index of element in this list. [...]
inherited
lastIndexWhere(bool test(T element), [int start]) int
The last index in the list that satisfies the provided test. [...]
inherited
lastWhere(bool test(T element), {T orElse()}) → T
Returns the last element that satisfies the given predicate test. [...]
inherited
map<T>(T f(T e)) Iterable<T>
Returns a new lazy Iterable with elements that are created by calling f on each element of this Iterable in iteration order. [...]
inherited
noSuchMethod(Invocation invocation) → dynamic
Invoked when a non-existent method or property is accessed. [...]
inherited
off(String types, {String selector, QueryEventListener handler}) → void
Unregister a handler for events of given types. [...]
on(String types, QueryEventListener handler, {String selector}) → void
Register a handler for events of given types on selected elements. [...]
one(String types, QueryEventListener handler, {String selector}) → void
Register a one-time handler for events of given types. Once called, [...]
pushStack(List<Element> elems) ElementQuery
Add a collection of DOM elements onto the Query stack.
reduce(T combine(T value, T element)) → T
Reduces a collection to a single value by iteratively combining elements of the collection using the provided function. [...]
inherited
remove(Object value) bool
Removes the first occurrence of value from this list. [...]
inherited
removeAt(int index) → T
Removes the object at position index from this list. [...]
inherited
removeLast() → T
Removes and returns the last object in this list. [...]
inherited
removeRange(int start, int end) → void
Removes a range of elements from the list. [...]
inherited
removeWhere(bool test(T element)) → void
Removes all objects from this list that satisfy test. [...]
inherited
replaceRange(int start, int end, Iterable<T> replacement) → void
Replaces a range of elements with the elements of replacement. [...]
inherited
retainWhere(bool test(T element)) → void
Removes all objects from this list that fail to satisfy test. [...]
inherited
setAll(int index, Iterable<T> iterable) → void
Overwrites elements with the objects of iterable. [...]
inherited
setRange(int start, int end, Iterable<T> iterable, [int skipCount = 0]) → void
Writes some elements of iterable into a range of this list. [...]
inherited
shuffle([Random random]) → void
Shuffles the elements of this list randomly.
inherited
singleWhere(bool test(T element), {T orElse()}) → T
Returns the single element that satisfies test. [...]
inherited
skip(int count) Iterable<T>
Returns an Iterable that provides all but the first count elements. [...]
inherited
skipWhile(bool test(T value)) Iterable<T>
Returns an Iterable that skips leading elements while test is satisfied. [...]
inherited
sort([int compare(T a, T b)]) → void
Sorts this list according to the order specified by the compare function. [...]
inherited
sublist(int start, [int end]) List<T>
Returns a new list containing the elements between start and end. [...]
inherited
take(int count) Iterable<T>
Returns a lazy iterable of the count first elements of this iterable. [...]
inherited
takeWhile(bool test(T value)) Iterable<T>
Returns a lazy iterable of the leading elements satisfying test. [...]
inherited
toList({bool growable = true}) List<T>
Creates a List containing the elements of this Iterable. [...]
inherited
toSet() Set<T>
Creates a Set containing the same elements as this iterable. [...]
inherited
toString() String
A string representation of this object. [...]
inherited
trigger(String type, {dynamic data}) → void
Trigger an event of given type on all matched elements, with given [...]
triggerEvent(QueryEvent event) → void
Trigger the given event on all matched elements, with given data if [...]
triggerHandler(String type, {dynamic data}) → void
Trigger an event of given type on the first (if any) matched element, [...]
where(bool test(T element)) Iterable<T>
Returns a new lazy Iterable with all elements that satisfy the predicate test. [...]
inherited
whereType<T>() Iterable<T>
Returns a new lazy Iterable with all elements that have type T. [...]
inherited

Operators

operator +(List<T> other) List<T>
Returns the concatenation of this list and other. [...]
inherited
operator ==(Object other) bool
The equality operator. [...]
inherited
operator [](int index) → T
The object at the given index in the list. [...]
inherited
operator []=(int index, T value) → void
Sets the value at the given index in the list to value. [...]
inherited

Static Methods

unique(List<Element> elements) List<Element>
Return a sorted List of elements with duplicated items removed.