DIV CSS 佈局教程網

document.forms[0] 與 getElementsByName 的行為差異
編輯:關於JavaScript     

兩者都能取得表單元素,但回傳的型別與規則完全不同,特別是在「同名元素只有一個」與「有多個」這兩種情況下,行為會不一致,是實作全選功能時最常踩的坑。

示範頁面

<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>

document.forms[0]

不論頁面有一個或多個 form,document.forms[0] 一律回傳 NodeList 型別的表單集合,取索引 0 即第一個表單。

接著 document.forms[0].usernames 這裡有個關鍵:屬性名可以是 id,也可以是 name,兩者在這個情境下等價,且不區分對象是文字框、單選鈕還是核取方塊。但回傳的內容取決於命中數量:

  • 只有一個符合 id 或 name 為 usernames 的元素:回傳該元素本身。此時 document.forms[0].usernames.length 是 undefined,因為單一 input 沒有 length 屬性。
  • 有兩個以上符合:回傳 NodeList 陣列,.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) 正好能分流兩種情況。

getElementById 與 getElementsByName

  • document.getElementById('usernames'):無論有一個還是多個同 id 元素,一律只回傳「第一個」符合的元素,絕不回傳集合。因此它無法用來批次操作。
  • document.getElementsByName('usernames'):無論一個或多個,一律回傳 NodeList 集合,型別行為是一致的,這點比 forms[0] 的屬性存取可靠。

容易混淆的 getElementsByTagName

這個方法依標籤名稱取集合,不是依屬性值。所以這類寫法是錯的:

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 這種「回傳型別隨數量而變」的不確定性。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved