做表單相關的功能時,你一定遇過這種情況:頁面上有一整排 name 相同的輸入框、核取方塊或單選按鈕,需要一次全部取出來批次處理。這時 document.getElementsByName() 就是最直覺、最省事的選擇。
第一,它回傳的是「集合」,不是單一元素。這個集合(NodeList)內容是節點物件,本質上就是一個 NodeList 物件集合。
第二,它可以當陣列用。透過 length 屬性得知元素個數,再用索引 [i] 逐一存取,搭配 for 迴圈就能完成遍歷。
第三,方法名是複數的 Elements,不是 Element。原因很單純:在一份 HTML 文件裡,name 屬性天生就不具唯一性,同一個名字底下可以掛任意多個元素,所以 API 設計上必然回傳集合。
下面的例子準備了四個 name="luck" 的文字框,我們要一次完成三件事:讀出每個框的值、判斷每個框的類型、並且為每個框掛上點擊事件。
<!DOCTYPE html>
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>getElementsByName 示範</title>
</head>
<body>
<p><input type="text" name="luck" value="我中獎了,中了一個億" id="luck1" /></p>
<p><input type="text" name="luck" value="我交了女朋友" id="luck2" /></p>
<p><input type="text" name="luck" value="我升遷了" id="luck3" /></p>
<p><input type="text" name="luck" value="我買房了" id="luck4" /></p>
<script>
// 第一步:取出所有 name 為 luck 的節點集合
var luckElements = document.getElementsByName("luck");
// 第二步:遍歷集合
for (var i = 0; i < luckElements.length; i++) {
// 讀取值
alert(luckElements[i].value);
// 讀取類型
alert(luckElements[i].type);
// 為每個元素掛上點擊事件
luckElements[i].onclick = function () {
alert(this.value);
};
}
</script>
</body>
</html>
迴圈裡的 this 指向「被點擊的那個元素」,所以 this.value 永遠拿到當前對話框的內容,不需要額外做閉包處理。
另外要留意:getElementsByName 回傳的是動態集合。如果你在迴圈中新增或刪除同 name 的元素,length 會即時改變,迴圈就可能失準。若要在操作過程中保持穩定,建議先轉成真陣列:
var arr = Array.prototype.slice.call(document.getElementsByName("luck"));
掌握以上幾點,你就能用一行程式碼搞定整組表單元素的讀取、驗證與事件綁定,不必再一個一個寫 id。