操作 DOM 的第一步永遠是「先找到它」。JavaScript 提供了幾組查找介面,各有不同的回傳型別與適用場景,用錯了往往會得到意料之外的結果。
document.getElementById('container');
回傳單一元素物件,找不到時回傳 null。id 在文件中應該唯一,因此這是最精準、效能也最好的查找方式,日常開發應優先採用。
document.getElementsByTagName('div');
回傳一個集合(HTMLCollection,本質上是類陣列物件),必須用索引取值,例如 [0] 才是第一個元素。找不到時回傳長度為 0 的集合,而不是 null——這個行為差異經常被忽略。
值得注意的是,這個集合是動態的:一旦文件結構改變,集合內容會即時反映。在迴圈中一邊刪節點一邊依 length 迭代,是常見的 bug 來源。
document.getElementsByName('username');
回傳同樣是集合。這個方法主要用在表單元素上。
部分瀏覽器已把 getElementsByName() 擴充到 div、p 等一般元素——只要該元素帶有 name 屬性就能查到。但 IE 只支援表單元素的 name 查詢。為了維持跨瀏覽器相容性,建議把這個方法限制在表單場景中使用。
如果目標環境允許,document.querySelector() 與 document.querySelectorAll() 提供了 CSS 選擇器語法,能一次取代上述三種查找方式,且表達能力更強:
document.querySelector('#container'); // 等同 getElementById
document.querySelectorAll('ul li'); // 等同 getElementsByTagName 鏈式
document.querySelector('[name="username"]'); // 等同 getElementsByName
唯一的差別是:querySelectorAll() 回傳的是靜態的 NodeList,不會隨文件變動而更新——這在許多情況下反而更安全。