splice() 用於插入、刪除或替換陣列的元素。
arrayObject.splice(index, howmany, element1, ....., elementX)
| 參數 | 說明 |
|---|---|
| index | 必需。規定從何處開始新增/刪除元素,是起始元素的索引,必須是數字。 |
| howmany | 必需。規定要刪除多少個元素,必須是數字,但可以是 0。若省略此參數,則刪除從 index 到陣列結尾的所有元素。 |
| element1 | 可選。要插入的新元素,從 index 所指的位置開始插入。 |
| elementX | 可選。可一次添加多個元素。 |
如果從 arrayObject 中刪除了元素,則回傳一個含有「被刪除元素」的新陣列。
splice() 可以刪除從 index 開始的零個或多個元素,並用參數清單中宣告的一或多個值來替換那些被刪除的元素。
特別注意:splice() 與 slice() 名字相似但作用完全不同,splice() 會直接改動原陣列,slice() 則是回傳子陣列而不動原陣列。
<script type="text/javascript"> var arr = new Array(6) arr[0] = "George" arr[1] = "John" arr[2] = "Thomas" arr[3] = "James" arr[4] = "Adrew" arr[5] = "Martin" document.write(arr + "<br />") arr.splice(2, 0, "William") // 刪 0 個,純插入 document.write(arr + "<br />") </script>
輸出:
George,John,Thomas,James,Adrew,Martin George,John,William,Thomas,James,Adrew,Martin
howmany 為 0 是最常見的「純插入」用法。
<script type="text/javascript"> var arr = new Array(6) arr[0] = "George" arr[1] = "John" arr[2] = "Thomas" arr[3] = "James" arr[4] = "Adrew" arr[5] = "Martin" document.write(arr + "<br />") arr.splice(2, 1, "William") // 刪 1 個,補 1 個 document.write(arr) </script>
輸出:
George,John,Thomas,James,Adrew,Martin George,John,William,James,Adrew,Martin
<script type="text/javascript"> var arr = new Array(6) arr[0] = "George" arr[1] = "John" arr[2] = "Thomas" arr[3] = "James" arr[4] = "Adrew" arr[5] = "Martin" document.write(arr + "<br />") arr.splice(2, 3, "William") // 從索引 2 刪 3 個,補 1 個 document.write(arr) </script>
輸出:
George,John,Thomas,James,Adrew,Martin George,John,William,Martin
三個實例合起來就涵蓋了 splice 的全部語意:刪多少由 howmany 決定,補什麼由後面的參數決定,兩者互相獨立,這也是它比單純的 pop / shift 更靈活的原因。