Collection.insert

Вставляет элемент в указанную позицию коллекции.

Description

Метод insert() добавляет указанный элемент в заданную позицию коллекции. Успешное выполнение данного метода приводит к возникновению события onAdd. Вместе с этим событием также генерируется событие onChange, которое информирует о наличии любых изменений. Аргументы обеих событий в данном случае будут идентичны.

Syntax

Collection.insert(index, newItem)

Parameters

Name Type Description
index Integer Индекс вставляемого элемента.
newItem * Элемент, который необходимо добавить в коллекцию.

Returns

Возвращает true, если коллекция была изменена, иначе - false.

Examples

var collection = new Collection();
collection.insert(0, 'A'); // [ 'A' ]
collection.insert(0, 'B'); // [ 'B', 'A' ]
collection.insert(0, 'C'); // [ 'C', 'B', 'A' ]