From 218934fa2ed1c702a6d3923d2aa2cc6b43c48684 Mon Sep 17 00:00:00 2001 From: Peter Bengtsson Date: Tue, 8 Dec 2020 14:43:23 -0500 Subject: initial commit --- .../global_objects/array/splice/index.html | 162 +++++++++++++++++++++ 1 file changed, 162 insertions(+) create mode 100644 files/uk/web/javascript/reference/global_objects/array/splice/index.html (limited to 'files/uk/web/javascript/reference/global_objects/array/splice') diff --git a/files/uk/web/javascript/reference/global_objects/array/splice/index.html b/files/uk/web/javascript/reference/global_objects/array/splice/index.html new file mode 100644 index 0000000000..0565d3f266 --- /dev/null +++ b/files/uk/web/javascript/reference/global_objects/array/splice/index.html @@ -0,0 +1,162 @@ +--- +title: Array.prototype.splice() +slug: Web/JavaScript/Reference/Global_Objects/Array/splice +tags: + - Array + - JavaScript + - Масив + - метод + - прототип +translation_of: Web/JavaScript/Reference/Global_Objects/Array/splice +--- +
{{JSRef}}
+ +

Метод splice() змінює вміст масиву, видаляючи існуючі та/або додаючи нові елементи.

+ +

{{EmbedInteractiveExample("pages/js/array-splice.html")}}

+ + + +

Синтаксис

+ +
var arrDeletedItems = array.splice(start[, deleteCount[, item1[, item2[, ...]]]])
+
+ +

Параметри

+ +
+
start
+
Індекс елемента, з якого розпочнеться зміна масиву. Якщо індекс більший за розмір масиву, start буде рівним довжині масиву. Якщо індекс від'ємний, позначатиме кількість елементів з кінця масиву (починаючи з -1, тобто -n означатиме індекс n-го елемента з кінця, і таким чином є еквівалентом array.length - n). Якщо абсолютна величина start є більшою за довжину масиву, зміни почнуться з індексу 0.
+
deleteCount{{optional_inline}}
+
Число, що вказує на кількість елементів масиву, які необхідно видалити, починаючи з індексу start.
+
Якщо аргумент deleteCount не заданий, або його значення більше чи дорівнює arr.length - start (тобто, більше чи дорівнює кількості елементів, які залишились у масиві, починаючи зі start), тоді будуть видалені всі елементи, починаючи зі start і до кінця масиву.
+
Якщо deleteCount рівний 0 або від'ємний, жоден елемент не буде видалений. У цьому випадку необхідно вказати хоча б один новий елемент для вставки (див. нижче).
+
item1, item2, ...{{optional_inline}}
+
Елементи, що будуть додані до масиву, починаючи з індексу start. Якщо не вказати жодного нового елемента, splice() лише видалить елементи з масиву.
+
+ +

Значення, що повертається

+ +

Масив видалених елементів. Якщо видалено лише один елемент, метод поверне масив з одним елементом. Якщо жоден з елементів не видалявся, метод повертає пустий масив.

+ +

Опис

+ +

Якщо задана кількість елементів для вставлення відрізняється від кількості елементів на видалення, довжина масиву зміниться після виконання функції.

+ +

Приклади

+ +

Видалення 0 елементів, починаючи з індексу 2, і вставлення "drum"

+ +
var myFish = ['angel', 'clown', 'mandarin', 'sturgeon'];
+var removed = myFish.splice(2, 0, 'drum');
+
+// myFish дорівнює ["angel", "clown", "drum", "mandarin", "sturgeon"] 
+// removed дорівнює [], жодний елемент не було видалено
+
+ +

Видалення 0 елементів, починаючи з індексу 2, і вставлення "drum" та "guitar"

+ +
var myFish = ['angel', 'clown', 'mandarin', 'sturgeon'];
+var removed = myFish.splice(2, 0, 'drum', 'guitar');
+
+// myFish дорівнює ["angel", "clown", "drum", "guitar", "mandarin", "sturgeon"]
+// removed дорівнює [], жодний елемент не було видалено
+ +

Видалення 1 елемента, починаючи з індексу 3

+ +
var myFish = ['angel', 'clown', 'drum', 'mandarin', 'sturgeon'];
+var removed = myFish.splice(3, 1);
+
+// removed дорівнює ["mandarin"]
+// myFish дорівнює ["angel", "clown", "drum", "sturgeon"]
+ +

Видалення 1 елементу, починаючи з індексу 2, і вставлення "trumpet"

+ +
var myFish = ['angel', 'clown', 'drum', 'sturgeon'];
+var removed = myFish.splice(2, 1, 'trumpet');
+
+// myFish дорівнює ["angel", "clown", "trumpet", "sturgeon"]
+// removed дорівнює ["drum"]
+ +

Видалення 2-ох елементів, починаючи з індексу 0, і вставлення у масив елементів "parrot", "anemone" і "blue"

+ +
var myFish = ['angel', 'clown', 'trumpet', 'sturgeon'];
+var removed = myFish.splice(0, 2, 'parrot', 'anemone', 'blue');
+
+// myFish дорівнює ["parrot", "anemone", "blue", "trumpet", "sturgeon"] 
+// removed дорівнює ["angel", "clown"]
+ +

Видалення 2-ох елементів, починаючи з індексу 2

+ +
var myFish = ['parrot', 'anemone', 'blue', 'trumpet', 'sturgeon'];
+var removed = myFish.splice(2, 2);
+
+// myFish дорівнює ["parrot", "anemone", "sturgeon"] 
+// removed дорівнює ["blue", "trumpet"]
+
+ +

Видалення 1-го елемента, починаючи з індексу -2

+ +
var myFish = ['angel', 'clown', 'mandarin', 'sturgeon'];
+var removed = myFish.splice(-2, 1);
+
+// myFish дорівнює ["angel", "clown", "sturgeon"]
+// removed дорівнює ["mandarin"]
+ +

Видалення всіх елементів, починаючи з індексу 2 (включно).

+ +
var myFish = ['angel', 'clown', 'mandarin', 'sturgeon'];
+var removed = myFish.splice(2);
+
+// myFish дорівнює ["angel", "clown"] 
+// removed дорівнює ["mandarin", "sturgeon"]
+ +

Специфікації

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
СпецифікаціяСтатусКоментар
{{SpecName('ES3')}}{{Spec2('ES3')}}Початкове визначення. Реалізовано у JavaScript 1.2.
{{SpecName('ES5.1', '#sec-15.4.4.12', 'Array.prototype.splice')}}{{Spec2('ES5.1')}}
{{SpecName('ES6', '#sec-array.prototype.splice', 'Array.prototype.splice')}}{{Spec2('ES6')}}
{{SpecName('ESDraft', '#sec-array.prototype.splice', 'Array.prototype.splice')}}{{Spec2('ESDraft')}}
+ +

Підтримка веб-переглядачів

+ + + +

{{Compat("javascript.builtins.Array.splice")}}

+ +

Див. також

+ + -- cgit v1.2.3-54-g00ecf