Represents a base class for normal list modifying operations.
Gets the IListDataSource for the list. The only purpose of this property is to adapt a List to the data model that is used by ListView and FlipView.
Adds an event listener to the control.
The type (name) of the event.
The listener to invoke when the event gets raised.
If true, initiates capture, otherwise false.
Adds an event listener to the control.
The type (name) of the event.
The listener to invoke when the event gets raised.
If true, initiates capture, otherwise false.
Links the specified action to the property specified in the name parameter. This function is invoked when the value of the property may have changed. It is not guaranteed that the action will be called only when a value has actually changed, nor is it guaranteed that the action will be called for every value change. The implementation of this function coalesces change notifications, such that multiple updates to a property value may result in only a single call to the specified action.
The name of the property to which to bind the action.
The function to invoke asynchronously when the property may have changed.
any
A reference to this observableMixin object.
Links the specified action to the property specified in the name parameter. This function is invoked when the value of the property may have changed. It is not guaranteed that the action will be called only when a value has actually changed, nor is it guaranteed that the action will be called for every value change. The implementation of this function coalesces change notifications, such that multiple updates to a property value may result in only a single call to the specified action.
The name of the property to which to bind the action.
The function to invoke asynchronously when the property may have changed.
any
A reference to this observableMixin object.
Returns a new list consisting of a combination of two arrays.
Additional items to add to the end of the list.
Array<T>
An array containing the concatenation of the list and any other supplied items.
Returns a new list consisting of a combination of two arrays.
Additional items to add to the end of the list.
Array<T>
An array containing the concatenation of the list and any other supplied items.
Creates a live filtered projection over this list. As the list changes, the filtered projection reacts to those changes and may also change.
A function that accepts a single argument. The createFiltered function calls the callback with each element in the list. If the function returns true, that element will be included in the filtered list. This function must always return the same results, given the same inputs. The results should not depend on values that are subject to change. You must call notifyMutated each time an item changes. Do not batch change notifications.
A filtered projection over the list.
Creates a live filtered projection over this list. As the list changes, the filtered projection reacts to those changes and may also change.
A function that accepts a single argument. The createFiltered function calls the callback with each element in the list. If the function returns true, that element will be included in the filtered list. This function must always return the same results, given the same inputs. The results should not depend on values that are subject to change. You must call notifyMutated each time an item changes. Do not batch change notifications.
A filtered projection over the list.
Creates a live grouped projection over this list. As the list changes, the grouped projection reacts to those changes and may also change. The grouped projection sorts all the elements of the list to be in group-contiguous order. The grouped projection also contains a .groups property, which is a List representing the groups that were found in the list.
A function that accepts a single argument. The function is called with each element in the list, the function should return a string representing the group containing the element. This function must always return the same results, given the same inputs. The results should not depend on values that are subject to change. You must call notifyMutated each time an item changes. Do not batch change notifications.
A function that accepts a single argument. The function is called once, on one element per group. It should return the value that should be set as the data of the .groups list element for this group. The data value usually serves as summary or header information for the group.
A function that accepts two arguments. The function is called with pairs of group keys found in the list. It must return one of the following numeric values: negative if the first argument is less than the second (sorted before), zero if the two arguments are equivalent, positive if the first argument is greater than the second (sorted after).
A grouped projection over the list.
Creates a live grouped projection over this list. As the list changes, the grouped projection reacts to those changes and may also change. The grouped projection sorts all the elements of the list to be in group-contiguous order. The grouped projection also contains a .groups property, which is a List representing the groups that were found in the list.
A function that accepts a single argument. The function is called with each element in the list, the function should return a string representing the group containing the element. This function must always return the same results, given the same inputs. The results should not depend on values that are subject to change. You must call notifyMutated each time an item changes. Do not batch change notifications.
A function that accepts a single argument. The function is called once, on one element per group. It should return the value that should be set as the data of the .groups list element for this group. The data value usually serves as summary or header information for the group.
A function that accepts two arguments. The function is called with pairs of group keys found in the list. It must return one of the following numeric values: negative if the first argument is less than the second (sorted before), zero if the two arguments are equivalent, positive if the first argument is greater than the second (sorted after).
A grouped projection over the list.
Creates a live sorted projection over this list. As the list changes, the sorted projection reacts to those changes and may also change.
A function that accepts two arguments. The function is called with elements in the list. It must return one of the following numeric values: negative if the first argument is less than the second, zero if the two arguments are equivalent, positive if the first argument is greater than the second. This function must always return the same results, given the same inputs. The results should not depend on values that are subject to change. You must call notifyMutated each time an item changes. Do not batch change notifications.
A sorted projection over the list.
Creates a live sorted projection over this list. As the list changes, the sorted projection reacts to those changes and may also change.
A function that accepts two arguments. The function is called with elements in the list. It must return one of the following numeric values: negative if the first argument is less than the second, zero if the two arguments are equivalent, positive if the first argument is greater than the second. This function must always return the same results, given the same inputs. The results should not depend on values that are subject to change. You must call notifyMutated each time an item changes. Do not batch change notifications.
A sorted projection over the list.
Raises an event of the specified type and with the specified additional properties.
The type (name) of the event.
The set of additional properties to be attached to the event object when the event is raised.
boolean
true if preventDefault was called on the event.
Raises an event of the specified type and with the specified additional properties.
The type (name) of the event.
The set of additional properties to be attached to the event object when the event is raised.
boolean
true if preventDefault was called on the event.
Checks whether the specified callback function returns true for all elements in a list.
A function that accepts up to three arguments. This function is called for each element in the list until it returns false or the end of the list is reached.
An object to which the this keyword can refer in the callback function. If thisArg is omitted, undefined is used.
boolean
true if the callback returns true for all elements in the list.
Checks whether the specified callback function returns true for all elements in a list.
A function that accepts up to three arguments. This function is called for each element in the list until it returns false or the end of the list is reached.
An object to which the this keyword can refer in the callback function. If thisArg is omitted, undefined is used.
boolean
true if the callback returns true for all elements in the list.
Returns the elements of a list that meet the condition specified in a callback function.
A function that accepts up to three arguments. The function is called for each element in the list. This function must always return the same results, given the same inputs. The results should not depend on values that are subject to change. You must call notifyMutated each time an item changes. Do not batch change notifications.
An object to which the this keyword can refer in the callback function. If thisArg is omitted, undefined is used.
Array<T>
An array containing the elements that meet the condition specified in the callback function.
Returns the elements of a list that meet the condition specified in a callback function.
A function that accepts up to three arguments. The function is called for each element in the list. This function must always return the same results, given the same inputs. The results should not depend on values that are subject to change. You must call notifyMutated each time an item changes. Do not batch change notifications.
An object to which the this keyword can refer in the callback function. If thisArg is omitted, undefined is used.
Array<T>
An array containing the elements that meet the condition specified in the callback function.
Calls the specified callback function for each element in a list.
A function that accepts up to three arguments. The function is called for each element in the list. The arguments are as follows: value, index, array.
An object to which the this keyword can refer in the callback function. If thisArg is omitted, undefined is used.
Calls the specified callback function for each element in a list.
A function that accepts up to three arguments. The function is called for each element in the list. The arguments are as follows: value, index, array.
An object to which the this keyword can refer in the callback function. If thisArg is omitted, undefined is used.
Gets the value at the specified index.
The index of the value to get.
T in WinJS.Binding.ListBase<T>
The value at the specified index.
Gets the value at the specified index.
The index of the value to get.
T in WinJS.Binding.ListBase<T>
The value at the specified index.
Gets the index of the first occurrence of the specified value in a list.
The value to locate in the list.
The index at which to begin the search. If fromIndex is omitted, the search starts at index 0.
number
The index of the first occurrence of a value in a list or -1 if not found.
Gets the index of the first occurrence of the specified value in a list.
The value to locate in the list.
The index at which to begin the search. If fromIndex is omitted, the search starts at index 0.
number
The index of the first occurrence of a value in a list or -1 if not found.
Returns a string consisting of all the elements of a list separated by the specified separator string.
A string used to separate the elements of a list. If this parameter is omitted, the list elements are separated with a comma.
string
The elements of a list separated by the specified separator string.
Returns a string consisting of all the elements of a list separated by the specified separator string.
A string used to separate the elements of a list. If this parameter is omitted, the list elements are separated with a comma.
string
The elements of a list separated by the specified separator string.
Gets the index of the last occurrence of the specified value in a list.
The value to locate in the list.
The index at which to begin the search. If fromIndex is omitted, the search starts at the last index in the list.
number
The index of the last occurrence of a value in a list, or -1 if not found.
Gets the index of the last occurrence of the specified value in a list.
The value to locate in the list.
The index at which to begin the search. If fromIndex is omitted, the search starts at the last index in the list.
number
The index of the last occurrence of a value in a list, or -1 if not found.
Calls the specified callback function on each element of a list, and returns an array that contains the results.
A function that accepts up to three arguments. The function is called for each element in the list.
n object to which the this keyword can refer in the callback function. If thisArg is omitted, undefined is used.
Array<G>
An array containing the result of calling the callback function on each element in the list.
Calls the specified callback function on each element of a list, and returns an array that contains the results.
A function that accepts up to three arguments. The function is called for each element in the list.
n object to which the this keyword can refer in the callback function. If thisArg is omitted, undefined is used.
Array<G>
An array containing the result of calling the callback function on each element in the list.
Notifies listeners that a property value was updated.
The name of the property that is being updated.
The new value for the property.
The old value for the property.
A promise that is completed when the notifications are complete.
Notifies listeners that a property value was updated.
The name of the property that is being updated.
The new value for the property.
The old value for the property.
A promise that is completed when the notifications are complete.
Forces the list to send a reload notification to any listeners.
Forces the list to send a reload notification to any listeners.
An item in the list has changed its value.
An object that contains information about the event. The detail contains the following information: index, key, newItem, newValue, oldItem, oldValue.
An item in the list has changed its value.
An object that contains information about the event. The detail contains the following information: index, key, newItem, newValue, oldItem, oldValue.
A new item has been inserted into the list.
An object that contains information about the event. The detail contains the following information: index, key, value.
A new item has been inserted into the list.
An object that contains information about the event. The detail contains the following information: index, key, value.
An item has been changed locations in the list.
An object that contains information about the event. The detail contains the following information: index, key, value.
An item has been changed locations in the list.
An object that contains information about the event. The detail contains the following information: index, key, value.
An item has been mutated. This event occurs as a result of calling the notifyMutated method.
An object that contains information about the event. The detail contains the following information: index, key, value.
An item has been mutated. This event occurs as a result of calling the notifyMutated method.
An object that contains information about the event. The detail contains the following information: index, key, value.
An item has been removed from the list.
An object that contains information about the event. The detail contains the following information: index, key, value.
An item has been removed from the list.
An object that contains information about the event. The detail contains the following information: index, key, value.
The list has been refreshed. Any references to items in the list may be incorrect.
An object that contains information about the event. The detail property of this object is null.
The list has been refreshed. Any references to items in the list may be incorrect.
An object that contains information about the event. The detail property of this object is null.
Removes the last element from a list and returns it.
T in WinJS.Binding.ListBaseWithMutators<T>
The last element from the list.
Appends new element(s) to a list, and returns the new length of the list.
The element to insert at the end of the list.
number
The new length of the list.
Accumulates a single result by calling the specified callback function for all elements in a list. The return value of the callback function is the accumulated result, and is provided as an argument in the next call to the callback function.
A function that accepts up to four arguments. These arguments are: previousValue, currentValue, currentIndex, array. The function is called for each element in the list.
If initialValue is specified, it is used as the value with which to start the accumulation. The first call to the function provides this value as an argument instead of a list value.
T in WinJS.Binding.ListBase<T>
The return value from the last call to the callback function.
Accumulates a single result by calling the specified callback function for all elements in a list. The return value of the callback function is the accumulated result, and is provided as an argument in the next call to the callback function.
A function that accepts up to four arguments. These arguments are: previousValue, currentValue, currentIndex, array. The function is called for each element in the list.
If initialValue is specified, it is used as the value with which to start the accumulation. The first call to the function provides this value as an argument instead of a list value.
T in WinJS.Binding.ListBase<T>
The return value from the last call to the callback function.
Accumulates a single result by calling the specified callback function for all elements in a list, starting with the last member of the list. The return value of the callback function is the accumulated result, and is provided as an argument in the next call to the callback function.
A function that accepts up to four arguments. These arguments are: previousValue, currentValue, currentIndex, array. The function is called for each element in the list.
If initialValue is specified, it is used as the value with which to start the accumulation. The first call to the callback function provides this value as an argument instead of a list value.
T in WinJS.Binding.ListBase<T>
The return value from the last call to callback function.
Accumulates a single result by calling the specified callback function for all elements in a list, starting with the last member of the list. The return value of the callback function is the accumulated result, and is provided as an argument in the next call to the callback function.
A function that accepts up to four arguments. These arguments are: previousValue, currentValue, currentIndex, array. The function is called for each element in the list.
If initialValue is specified, it is used as the value with which to start the accumulation. The first call to the callback function provides this value as an argument instead of a list value.
T in WinJS.Binding.ListBase<T>
The return value from the last call to callback function.
Removes an event listener from the control.
The type (name) of the event.
The listener to remove.
true if capture is to be initiated, otherwise false.
Removes an event listener from the control.
The type (name) of the event.
The listener to remove.
true if capture is to be initiated, otherwise false.
Removes the first element from a list and returns it.
T in WinJS.Binding.ListBaseWithMutators<T>
The first element from the list.
Extracts a section of a list and returns a new list.
The index that specifies the beginning of the section.
The index that specifies the end of the section.
Array<T>
Returns a section of list.
Extracts a section of a list and returns a new list.
The index that specifies the beginning of the section.
The index that specifies the end of the section.
Array<T>
Returns a section of list.
Checks whether the specified callback function returns true for any element of a list.
A function that accepts up to three arguments. The function is called for each element in the list until it returns true, or until the end of the list.
An object to which the this keyword can refer in the callback function. If thisArg is omitted, undefined is used.
boolean
true if callback returns true for any element in the list.
Checks whether the specified callback function returns true for any element of a list.
A function that accepts up to three arguments. The function is called for each element in the list until it returns true, or until the end of the list.
An object to which the this keyword can refer in the callback function. If thisArg is omitted, undefined is used.
boolean
true if callback returns true for any element in the list.
Removes one or more listeners from the notification list for a given property.
The name of the property to unbind. If this parameter is omitted, all listeners for all events are removed.
The function to remove from the listener list for the specified property. If this parameter is omitted, all listeners are removed for the specific property.
any
This object is returned.
Removes one or more listeners from the notification list for a given property.
The name of the property to unbind. If this parameter is omitted, all listeners for all events are removed.
The function to remove from the listener list for the specified property. If this parameter is omitted, all listeners are removed for the specific property.
any
This object is returned.
Appends new element(s) to a list, and returns the new length of the list.
The element to insert at the start of the list.
number
The new length of the list.