DIV CSS 佈局教程網

getElementById、getElementsByName、getElementsByTagName 的差別與用法
編輯:關於JavaScript     

先釐清一個常見誤會:document 上並沒有 getElementByName 這個方法。取得單一元素用 getElementById,取得同名元素的集合則是 getElementsByName(注意是复数 Elements)。

基本對照

<form name="form_write">
  <input name="content" type="text">
</form>

// 先取得 form,再透過它取值
var fn = document.getElementsByName("form_write")[0];
fn.content.value;

一、getElementById

因為 id 在頁面中應該是唯一的,這個方法用來精準定位單一元素。

document.getElementById(id)

參數 id 為字串;回傳對應的單一元素,找不到則回傳 null。

document.getElementById("id1").value;

二、getElementsByName

依 name 屬性查找,回傳一個同類集合。

document.getElementsByName(name)

參數 name 為字串;回傳 NodeList 類陣列,找不到則回傳空集合,順序依文件中出現的先後。

document.getElementsByName("name1")[0].value;
document.getElementsByName("name1")[1].value;

幾個容易踩的細節:

  • 它取的是元素的 value 屬性。若某標籤沒有 value 屬性,取值會得到 undefined,但仍然能取得同 name 標籤的數量:document.getElementsByName(name).length。
  • 某些瀏覽器(舊 IE)對沒有 name 屬性的元素也會用 id 來比對,所以 <span id="CBylawIndexName" value="all"> 這種非標準寫法在舊環境下也能被 getElementsByName("CBylawIndexName") 找到。但 span 本來就沒有 name 與 value 屬性,請不要依賴這種行為。

三、getElementsByTagName

依 HTML 標籤名查詢,回傳同標籤的集合。

object.getElementsByTagName(tagname)

object 可以是 document,也可以是某個元素(例如 event.target.parentElement),後者能把搜尋範圍縮小,效能更好。參數 tagname 為字串;回傳 NodeList,找不到則為空集合。

document.getElementsByTagName("p")[0].childNodes[0].nodeValue;
document.getElementsByTagName("p")[1].childNodes[0].nodeValue;

該用哪一個

  • 知道 id → getElementById:最快、語意最明確,優先使用。
  • 需要一批同類控制項(例如一組 checkbox)→ getElementsByName。
  • 需要同類標籤 → getElementsByTagName,但通常你真正想要的是 class,這時請用 getElementsByClassName 或 querySelectorAll。

現代建議:統一用 querySelector

document.querySelector('#id1');                 // 單一元素
document.querySelectorAll('.item');             // 集合
document.querySelectorAll('ul li[data-id]');    // 複合條件

CSS 選擇器能表達的條件遠比這三個方法豐富(後代、屬性、偽類別),API 也只有一組,不必記住三種回傳型別的差異。

務必注意回傳型別不同:getElementById 回傳元素或 null,而所有 getElementsBy* 與 querySelectorAll 回傳的是集合,必須用索引或迴圈取值,不能直接 .value。這是初學時最常犯的錯誤之一。

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