|
splice
Синтаксис
arrayObj.splice( start, deleteCount, [elem1[, elem2[, ...[, elemN]]]] )
Аргументы
-
start
-
Индекс в массиве, с которого начинать удаление.
-
deleteCount
-
Кол-во элементов, которое требуется удалить, начиная с индекса start.
- IE: если этот параметр не указан, то ни одни элемент не будет удалён.
- Firefox: если этот параметр не указан, то будут удалены все элементы, начиная с индекса start.
- Opera: (исследовано в версии 9.61) если этот параметр не указан, то будут удалён 1 элемент, имеющий индекс start+1. В этом же случае вместо удалённого элемента будет возвращена пустая строка.
elem1, elem2, ..., elemN
Добавляемые элементы в массив. Добавление начинается с позиции start.
Описание, примеры
Пожалуй, самый комплексный метод для работы с массивом.
Он объединяет в себе две разные функциональности: удаляет часть массива и добавляет новые элементы на место удаленных.
При этом можно свести к нулю количество удаляемых элементов - тогда это будет просто добавление.
И можно не добавлять элементов - тогда это будет просто удаление.
Метод возвращает массив из удаленных элементов.
Пример: Удаление
Выделить все
arr = [ "a", "b", "c", "d", "e" ]
removed = arr.splice(1,2)
// removed = [ "b", "c"] (2 элемента с arr[1])
// arr = ["a", "d", "e"] (те что остались)
Пример: Удаление одного элемента
arr = [ "a", "b", "c", "d", "e" ]
// удалим с индекса 2 один элемент
arr.splice(2,1)
// arr = ["a", "b", "d", "e"]
Пример: Добавление элементов
Выделить все
arr = [ "a", "b", "c", "d", "e" ]
// начиная с индекса 2 удалим 0 элементов
// и добавим "b+"
arr.splice(2,0,"b+")
// arr = ["a", "b", "b+", "c", "d", "e"]
Пример: С конца
arr = [ "a", "b", "c", "d", "e" ]
// удалим с индекса 1 начиная с конца 1 элемент
arr.splice(-1,1)
|