兩者都能取得表單元素,但回傳的型別與規則完全不同,特別是在「同名元素只有一個」與「有多個」這兩種情況下,行為會不一致,是實作全選功能時最常踩的坑。
<form name="buyerForm" method="post" action="/mysport/control/user/list.do"> <input type="checkbox" id="usernames" value="testtest" >testtest<br> <input type="checkbox" name="usernames" value="testtest" >testtest<br> <input type="text" id="usernames" value="testtest" >testtest<br> </form>
不論頁面有一個或多個 form,document.forms[0] 一律回傳 NodeList 型別的表單集合,取索引 0 即第一個表單。
接著 document.forms[0].usernames 這裡有個關鍵:屬性名可以是 id,也可以是 name,兩者在這個情境下等價,且不區分對象是文字框、單選鈕還是核取方塊。但回傳的內容取決於命中數量:
usernames 的元素:回傳該元素本身。此時 document.forms[0].usernames.length 是 undefined,因為單一 input 沒有 length 屬性。.length 才是元素個數(上例為 3)。因此寫全選時必須同時處理這兩種情況:
function allSelect() {
var form = document.forms[0];
var state = form.allselectbox.checked;
// 多個時回傳陣列長度;只有一個時回傳的是元素本身,length 為 undefined
var length = form.usernames.length;
if (length) {
for (var i = 0; i < length; i++) {
form.usernames[i].checked = state;
}
} else {
form.usernames.checked = state;
}
}
這裡利用了一個 JavaScript 特性:被判斷的運算式若為 0、null 或 undefined 一律視為 false,其餘為 true,所以 if (length) 正好能分流兩種情況。
document.getElementById('usernames'):無論有一個還是多個同 id 元素,一律只回傳「第一個」符合的元素,絕不回傳集合。因此它無法用來批次操作。document.getElementsByName('usernames'):無論一個或多個,一律回傳 NodeList 集合,型別行為是一致的,這點比 forms[0] 的屬性存取可靠。這個方法依標籤名稱取集合,不是依屬性值。所以這類寫法是錯的:
var names = document.getElementsByTagName("usernames"); // 永遠是空集合
alert(names[0]); // undefined
因為並不存在名稱為 usernames 的標籤。當索引超出集合範圍時,取值一律是 undefined,這是 JavaScript 陣列的固有行為:
var test = ['0','1','2']; alert(test[3]); // undefined
實務建議:批次操作核取方塊時,直接用 document.getElementsByName() 並以 Array.prototype.forEach.call() 迭代,可以避免 forms[0].xxx 這種「回傳型別隨數量而變」的不確定性。