Collection

Collections of elements can recieve notifications upon change updates.

Description

In many cases data is processed by user is a collection of elements. It is required while modifying collection that changes are properly indicated in UI. To resolve this Collection type can be implemented. It has all methods required to work with the collection and list of events to get notified about all changes that occured to the collection.

Syntax

new Collection(items, idProperty, comparator)

Parameters

Name	Type	Description
items	Array	Array to initialize collection.
idProperty	String	Property identificator of collection elements.
comparator	comparator	Function that compares collection of elements.

Properties

Name	Type	Description
length	Integer	Returns number of elements in collection.
idProperty	String	Returns identificator property of element in collection.
comparator	comparator	Returns function of comparison of elements in collection.

Methods

Name	Description
size	Возвращает количество элементов в коллекции.
push	Добавляет элемент в конец коллекции.
add	Добавляет элемент в конец коллекции.
addAll	Добавляет элементы в конец коллекции.
insert	Вставляет элемент в указанную позицию коллекции.
insertAll	Вставляет элементы, начиная с указанной позиции коллекции.
reset	Устанавливает список элементов коллекции.
set	Обновляет список элементов коллекции.
replace	Заменяет элемент коллекции на указанный.
pop	Удаляет последний элемент из коллекции.
remove	Удаляет указанный элемент из коллекции.
removeById	Удаляет элемент с указанным идентификатором из коллекции.
removeAt	Удаляет элемент с указанным индексом из коллекции.
removeAll	Удаляет указанные элементы из коллекции.
removeRange	Удаляет диапазон элементов из коллекции.
removeEvery	Удаляет все элементы из коллекции, удовлетворяющие указанному условию.
clear	Удаляет все элементы из коллекции.
getById	Возвращает элемент коллекции с заданным идентификатором.
getByIndex	Возвращает элемент коллекции с заданным индексом.
find	Возвращает первый найденный элемент коллекции, удовлетворяющий условию.
indexOf	Возвращает индекс первого найденного элемента коллекции при поиске с начала.
lastIndexOf	Возвращает индекс первого найденного элемента коллекции при поиске с конца.
findIndex	Возвращает индекс первого найденного элемента коллекции, удовлетворяющего условию.
contains	Проверяет наличие указанного элемента в коллекции.
contains	Проверяет наличие указанного элемента в коллекции.
every	Проверяет, что каждый элемент коллекции удовлетворяет указанному условию.
some	Проверяет, что некоторый элемент коллекции удовлетворяет указанному условию.
forEach	Перечисляет все элементы коллекции.
filter	Возвращает элементы коллекции, удовлетворяющие указанному условию.
take	Возвращает указанный диапазон элементов коллекции.
toArray	Возвращает массив всех элементов коллекции.
move	Перемещает элемент коллекции в позицию с указанным индексом.
sort	Сортирует список элементов коллекции.
clone	Создает копию коллекции элементов.
setProperty	Устанавливает значение атрибута для элемента.
getProperty	Возвращает значение атрибута элемента.

Events

Name	Description
onAdd	Устанавливает обработчик события о том, что произошло добавление элементов.
onReplace	Устанавливает обработчик события о том, что произошла замена элементов.
onRemove	Устанавливает обработчик события о том, что произошло удаление элементов.
onMove	Устанавливает обработчик события о том, что произошло перемещение элементов.
onReset	Устанавливает обработчик события о том, что произошли существенные изменения.
onChange	Устанавливает обработчик события о том, что произошли какие-то изменения.