先釐清一個常見誤會: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;
因為 id 在頁面中應該是唯一的,這個方法用來精準定位單一元素。
document.getElementById(id)
參數 id 為字串;回傳對應的單一元素,找不到則回傳 null。
document.getElementById("id1").value;
依 name 屬性查找,回傳一個同類集合。
document.getElementsByName(name)
參數 name 為字串;回傳 NodeList 類陣列,找不到則回傳空集合,順序依文件中出現的先後。
document.getElementsByName("name1")[0].value;
document.getElementsByName("name1")[1].value;
幾個容易踩的細節:
undefined,但仍然能取得同 name 標籤的數量:document.getElementsByName(name).length。<span id="CBylawIndexName" value="all"> 這種非標準寫法在舊環境下也能被 getElementsByName("CBylawIndexName") 找到。但 span 本來就沒有 name 與 value 屬性,請不要依賴這種行為。依 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;
getElementsByClassName 或 querySelectorAll。document.querySelector('#id1'); // 單一元素
document.querySelectorAll('.item'); // 集合
document.querySelectorAll('ul li[data-id]'); // 複合條件
CSS 選擇器能表達的條件遠比這三個方法豐富(後代、屬性、偽類別),API 也只有一組,不必記住三種回傳型別的差異。
務必注意回傳型別不同:getElementById 回傳元素或 null,而所有 getElementsBy* 與 querySelectorAll 回傳的是集合,必須用索引或迴圈取值,不能直接 .value。這是初學時最常犯的錯誤之一。