push() 方法可以往陣列末尾添加一個或多個元素,並回傳添加後的新長度。換句話說,它的返回值就是「把指定值加入陣列後,這個陣列的新長度」。
arrayObject.push(newelement1, newelement2, ...., newelementX)
push() 會把參數依序添加到 arrayObject 的尾部,直接修改原陣列,而不是建立一個新陣列。push() 與 pop() 搭配使用,就能實現陣列「後進先出」的堆疊(stack)功能。此外,這個方法會改變陣列的長度。
下面這個例子透過一組核取方塊,示範如何用 push() 把使用者勾選的項目收集到陣列中,並統計數量:
<!doctype html>
<meta charset="utf-8">
<body>
<input type="checkbox" value="1" name="check" checked="checked"/>
<input type="checkbox" value="1" name="check"/>
<input type="checkbox" value="1" name="check" checked="checked"/>
<input type="checkbox" value="1" name="check" />
<input type="button" value="你選中的個數" id="btn" />
<script>
var btn = document.getElementById('btn');
btn.onclick = function () {
var arrays = new Array();
var checkitem = document.getElementsByName("check");
for (var i = 0; i < checkitem.length; i++) {
if (checkitem[i].checked) {
arrays.push(checkitem[i].value); // 把值傳入 arrays 陣列
}
}
alert(arrays.length);
}
</script>
</body>
每次點擊按鈕時,程式會遍歷所有核取方塊,把已勾選項的值用 push() 收進陣列,最後再以 arrays.length 取得勾選數量。這正是 push() 在日常開發中最典型的應用方式之一。