DOM 是 JavaScript 與頁面溝通的橋樑。以下從節點模型談到實際操作,把最常查的 API 一次整理清楚。
| 類型 | 說明 |
|---|---|
| Document | 最頂層節點,所有其他節點都附屬於它 |
| DocumentType | DOCTYPE 宣告的物件形式,無子節點 |
| DocumentFragment | 可像 Document 一樣保存其他節點,用於批次操作 |
| Element | 起始標籤與結束標籤之間的內容,唯一可同時擁有屬性與子節點的類型 |
| Attr | 一組屬性名與屬性值,無子節點 |
| Text | 標籤之間或 CDATA 內的文字,無子節點 |
| CDATASection | <![CDATA[]]> 的形式,僅能包含 Text 子節點 |
| Comment | XML 註解,無子節點 |
| ProcessingInstruction | PI 節點,無子節點 |
| 成員 | 說明 |
|---|---|
| nodeName / nodeValue | 節點名稱與值,含義依類型而定 |
| nodeType | 節點類型的常數值 |
| ownerDocument | 指向所屬文件 |
| firstChild / lastChild | childNodes 中的第一/最後一個節點 |
| childNodes | 所有子節點的 NodeList |
| previousSibling / nextSibling | 前/後一個兄弟節點,無則為 null |
| hasChildNodes() | 是否有一個以上的子節點 |
| attributes | NamedNodeMap,僅用於 Element |
| appendChild(node) | 附加到 childNodes 末尾 |
| removeChild(node) | 從 childNodes 移除 |
| replaceChild(new, old) | 替換子節點 |
| insertBefore(new, ref) | 在 ref 之前插入 |
另有兩個輔助物件:NodeList(以數字索引的節點陣列,表示子節點)與 NamedNodeMap(同時支援數字與名稱索引,表示元素屬性)。
var oHtml = document.documentElement; // <html> var oHead = oHtml.firstChild; var oBody = oHtml.lastChild; // childNodes 可當陣列用,正式方法是 item() var oHead2 = oHtml.childNodes[0]; var oBody2 = oHtml.childNodes.item(1); // HTML DOM 提供的捷徑 var oBody3 = document.body; // 驗證彼此關係 alert(oHead.parentNode == oHtml); // true alert(oBody.previousSibling == oHead); // true alert(oHead.ownerDocument == document); // true
只有 Element 節點才有屬性,其 attributes 是 NamedNodeMap,提供:
getNamedItem(name):取得 nodeName 相符的節點removeNamedItem(name):刪除指定節點setNamedItem(node):依 nodeName 加入item(pos):依位置取得注意這些方法回傳的是 Attr 節點,不是屬性值。取值要再讀 nodeValue:
var sId = oP.attributes.getNamedItem("id").nodeValue;
oP.attributes.getNamedItem("id").nodeValue = "newId";
Attr 節點的 value 屬性與 nodeValue 完全同步,name 與 nodeName 也一樣。因為這種寫法太繁瑣,DOM 另外提供了三個捷徑:
oP.getAttribute("id"); // 等同 attributes.getNamedItem(name).value
oP.setAttribute("id", "newId");
oP.removeAttribute("id");
getElementsByTagName() 回傳所有標籤名相符的元素的 NodeList:
var oImgs = document.getElementsByTagName("img");
alert(oImgs[0].tagName); // "IMG"
// 也可從特定元素往下找
var oPs = document.getElementsByTagName("p");
var oImgsInp = oPs[0].getElementsByTagName("img");
// 星號代表全部(但 IE6 不支援,得用 document.all)
var oAll = document.getElementsByTagName("*");
getElementsByName() 取得所有 name 屬性相符的元素。
getElementById() 回傳 id 相符的單一元素。由於 HTML 中 id 是唯一的,這也是從文件樹中取單一元素最快的方法。(注意:IE6 若找不到 id 會誤比對 name,這是一個必須小心的 bug。)
document.createDocumentFragment(); document.createElement(tagName); document.createTextNode(text);
function createMessage() {
var oP = document.createElement("p");
var oText = document.createTextNode("Hello World!");
oP.appendChild(oText);
document.body.appendChild(oP);
}
// 刪除:注意要從「父節點」呼叫
function removeMessage() {
var oP = document.body.getElementsByTagName("p")[0];
oP.parentNode.removeChild(oP);
}
// 替換
function replaceMessage() {
var oNewP = document.createElement("p");
oNewP.appendChild(document.createTextNode("Hello Universe!"));
var oOldP = document.body.getElementsByTagName("p")[0];
oOldP.parentNode.replaceChild(oNewP, oOldP);
}
// 插入到某節點之前
function insertMessage() {
var oNewP = document.createElement("p");
oNewP.appendChild(document.createTextNode("Hello Universe!"));
var oOldP = document.getElementsByTagName("p")[0];
document.body.insertBefore(oNewP, oOldP);
}
節點一旦附加到 body,頁面就會立即更新。少量操作沒問題,但要一次加入大量內容時,逐個插入會非常慢。解法是先塞進文件碎片,最後一次性附加:
function addMessages() {
var arrText = ["first", "second", "third", "fourth", "fifth",
"sixth", "seventh", "eighth", "ninth", "tenth"];
var oFragment = document.createDocumentFragment();
for (var i = 0; i < arrText.length; i++) {
var oP = document.createElement("p");
oP.appendChild(document.createTextNode(arrText[i]));
oFragment.appendChild(oP);
}
document.body.appendChild(oFragment); // 只觸發一次 reflow
}
這是本文實用價值最高的一段:把 N 次版面重排壓縮成 1 次。
HTML DOM 元素上的屬性,大多可作為同名屬性直接存取:
alert(oImg.getAttribute("src"));
oImg.setAttribute("src", "mypicture2.jpg");
// 等價寫法
alert(oImg.src);
oImg.src = "mypicture2.jpg";
唯一的例外是 class——它在 ECMAScript 中是保留字,因此對應的屬性名改為 className。(IE 在 setAttribute 上有已知問題,盡量使用屬性寫法。)
HTML DOM 為 table、tbody、tr 加了一組便利成員:
| table 元素 | 說明 |
|---|---|
| caption / tHead / tFoot | 指向對應子元素 |
| tBodies | 所有 tbody 的集合 |
| rows | 表格中所有列的集合 |
| insertRow(pos) / deleteRow(pos) | 插入/刪除列 |
| createTHead() / createTFoot() / createCaption() | 建立並附加對應元素 |
| deleteTHead() / deleteTFoot() / deleteCaption() | 刪除對應元素 |
| tbody 元素 | 說明 |
|---|---|
| rows | 該 tbody 中所有列 |
| insertRow(pos) / deleteRow(pos) | 插入/刪除列 |
| tr 元素 | 說明 |
|---|---|
| cells | 該列所有儲存格的集合 |
| insertCell(pos) / deleteCell(pos) | 插入/刪除儲存格 |
使用這些專用方法比手動 createElement + appendChild 簡潔得多,效能也更好。
這是 DOM Level 2 提供的節點走訪器,可自訂過濾條件遍歷文件樹。當年只有 Mozilla 與 Konqueror/Safari 支援,如今則是標準 API,處理大型文件的走訪時比遞迴 childNodes 更有效率。
這份整理反映的是那個年代的做法,今天有幾個 API 已經成為日常主力:
querySelector / querySelectorAll:直接用 CSS 選擇器選取,取代絕大多數 getElementsBy* 的場合。closest():向上尋找符合選擇器的祖先,事件委派時非常好用。dataset:以 el.dataset.foo 取代 getAttribute("data-foo")。classList:add / remove / toggle / contains,比字串拼接 className 安全。Element.append() / prepend() / replaceChildren():可直接接受字串與多個節點,不必每個文字都包一層 createTextNode。最後提醒一個跨國常見的效能陷阱:getElementsByTagName 回傳的是即時的 NodeList,迴圈中若有新增或刪除元素,長度會動態改變而導致漏抓或無限迴圈。querySelectorAll 回傳的是靜態 NodeList,這點差異在實務上比任何 API 名稱都更值得記住。