DOM(Document Object Model,文件物件模型)是針對 HTML 與 XML 文件的 API。它描繪出一個層次化的節點樹,讓開發人員能新增、移除與修改頁面的任一部分。
document 物件。加載 HTML 頁面時,瀏覽器會建立一個樹形結構來表示頁面的內部結構。html 是根節點,head 是 html 的子節點,而 meta 與 title 之間是兄弟關係。
<div title="元素屬性">測試 Div</div>
divtitle="元素屬性"測試 Div| 方法 | 說明 |
|---|---|
| getElementById() | 取得特定 ID 的元素節點 |
| getElementsByTagName() | 取得相同標籤名的節點集合 |
| getElementsByName() | 取得相同 name 的節點集合 |
| getAttribute() | 取得特定元素節點某屬性的值 |
| setAttribute() | 設定特定元素節點某屬性的值 |
| removeAttribute() | 移除特定元素節點的屬性 |
// 找到則回傳該元素物件,找不到回傳 null
document.getElementById('box'); // [object HTMLDivElement]
// 取得後即可存取它的一系列屬性
document.getElementById('box').tagName; // => 'DIV'
document.getElementById('box').innerHTML; // => 元素內的內容(非 W3C 標準)
document.getElementById('box').id; // id 名稱
document.getElementById('box').title; // title 屬性值
document.getElementById('box').className; // class 名稱
document.getElementById('box').className = 'pox';
// style 會回傳 CSSStyleDeclaration 物件
document.getElementById('box').style.color; // 讀取行內樣式
document.getElementById('box').style.color = 'red'; // 設定行內樣式
document.getElementsByTagName('*'); // 用萬用字元取得所有元素
document.getElementsByTagName('li'); // [object HTMLCollection]
document.getElementsByTagName('li')[0]; // 第一個 li
注意 IE 使用萬用字元時,會把文件開頭的 DOCTYPE 聲明當作第一個元素節點。
document.getElementsByName('add'); // 取得 name="add" 的元素集合
對於並非 HTML 合法屬性的自訂 name,各瀏覽器的相容性存在差異。
document.getElementById('box').getAttribute('mydiv'); // 自訂屬性,僅 IE 支援點式寫法
document.getElementById('box').setAttribute('align', 'center');
document.getElementById('box').removeAttribute('style');
setAttribute() 若屬性已存在則會覆蓋。IE7 及以下使用它設定 class 與 style 無效。
上面這些方法都是集合式的,取單一元素很不方便。CSS 選擇器才是現代標準:
document.querySelector('#box'); // 單一元素
document.querySelectorAll('.item'); // 集合(NodeList)
document.querySelector('#list li:first-child');
| 節點類型 | nodeName | nodeType | nodeValue |
|---|---|---|---|
| 元素 | 標籤名稱 | 1 | null |
| 屬性 | 屬性名稱 | 2 | 屬性值 |
| 文本 | #text | 3 | 文本內容 |
| 註解 | #comment | 8 | 註解內容 |
| 文件 | #document | 9 | null |

| 屬性 | 說明 |
|---|---|
| childNodes | 所有子節點 |
| firstChild / lastChild | 第一個/最後一個子節點 |
| ownerDocument | 該節點所屬文件的根節點,等同 document |
| parentNode | 父節點 |
| previousSibling / nextSibling | 前一個/後一個同級節點 |
| attributes | 該元素所有屬性節點的集合 |
var box = document.getElementById('box');
for (var i = 0; i < box.childNodes.length; i++) {
if (box.childNodes[i].nodeType === 1) {
console.log('元素節點:' + box.childNodes[i].nodeName);
} else if (box.childNodes[i].nodeType === 3) {
console.log('文本節點:' + box.childNodes[i].nodeValue);
}
}
childNodes[n] 可能回傳元素子節點(HTMLElement),也可能是文本子節點(Text)。前者用 nodeName 或 tagName 取標籤名,後者用 nodeValue 取內容。
差異一:取得文本節點時無法使用 innerHTML。這個非標準屬性只能在元素節點上使用。
差異二:賦值時,nodeValue 會把 HTML 轉義成純文本,innerHTML 則會解析 HTML:
box.childNodes[0].nodeValue = '<strong>abc</strong>'; // 畫面上顯示 <strong>abc</strong>
box.innerHTML = '<strong>abc</strong>'; // 畫面上顯示粗體的 abc
var body = document.getElementsByTagName('body')[0];
alert(body.childNodes.length); // 非 IE 可能是 7;IE 只有 3
標準 DOM 會識別空白文本節點,IE 則自動忽略。這導致同一份 HTML 在不同瀏覽器下 childNodes 的長度不同,硬編碼索引必然出錯。三種處理方式:
// 方式一:過濾後組新陣列
function filterSpaceNode1(nodes) {
var ret = [];
for (var i = 0; i < nodes.length; i++) {
if (nodes[i].nodeType === 3 && /^\s+$/.test(nodes[i].nodeValue)) continue;
ret.push(nodes[i]);
}
return ret;
}
// 方式二:直接從父節點移除
function filterSpaceNode2(nodes) {
for (var i = 0; i < nodes.length; i++) {
if (nodes[i].nodeType === 3 && /^\s+$/.test(nodes[i].nodeValue)) {
nodes[i].parentNode.removeChild(nodes[i]);
}
}
return nodes;
}
// 方式三:專門處理 firstChild / lastChild 取到空白節點的情況
function removeWhileNode(nodes) {
for (var i = 0; i < nodes.childNodes.length; i++) {
if (nodes.childNodes[i].nodeType === 3 && /^\s+$/.test(nodes.childNodes[i].nodeValue)) {
nodes.childNodes[i].parentNode.removeChild(nodes.childNodes[i]);
}
}
return nodes;
}
更簡單的替代方案是用 children(只含元素節點)或 firstElementChild / lastElementChild / nextElementSibling 這組「元素版」的層次屬性,它們天生就跳過非元素節點。
| 方法 | 說明 |
|---|---|
| write() | 把字串插入文件 |
| createElement() | 建立元素節點 |
| createTextNode() | 建立文本節點 |
| appendChild() | 附加到子節點列表的末尾 |
| insertBefore() | 插入到指定節點之前 |
| replaceChild() | 以新節點取代舊節點 |
| cloneNode() | 複製節點 |
| removeChild() | 移除節點 |
document.write('<p>這是一個段落!</p>');
var p = document.createElement('p');
var text = document.createTextNode('段落');
p.appendChild(text);
var box = document.getElementById('box');
box.appendChild(p); // 附加到 box 子節點列表的末尾
box.parentNode.insertBefore(p, box); // 在 <div> 之前插入 <p>
box.insertBefore(newNode, null); // 等同 appendChild
這個方法只能「在當前元素之前」插入,沒有提供「之後」。要達到往後插入的效果,可以自己組裝:
function insertAfter(newElement, targetElement) {
var parent = targetElement.parentNode;
if (parent.lastChild === targetElement) {
parent.appendChild(newElement); // 目標是最後一個,直接附加
} else {
parent.insertBefore(newElement, targetElement.nextSibling);
}
}
box.parentNode.replaceChild(p, box); // 把 <div> 換成 <p>
// cloneNode(true) 深複製:含整個子節點樹
// cloneNode(false) 淺複製:只有節點本身
var clone = box.firstChild.cloneNode(true);
box.appendChild(clone);
box.parentNode.removeChild(box); // 刪除節點
複製後回傳的節點副本屬於文件所有,但尚未指定父節點,必須自行附加才會出現在頁面上。
上面這些 API 大多仍有其位置,但日常開發中更常使用的是:
// 建立元素並設定內容
const div = document.createElement('div');
div.textContent = '純文字'; // 安全,會轉義 HTML
div.innerHTML = '<b>粗體</b>'; // 會解析 HTML,注意 XSS
// 插入位置的現代寫法
parent.prepend(first); // 插入到最前面
parent.append(a, b, c); // 附加到最後,可一次多個節點或字串
child.before(newNode); // 插入到自己之前
child.after(newNode); // 插入到自己之後
child.replaceWith(newNode); // 取代自己
child.remove(); // 移除自己
// 一次建立多層結構
const ul = document.createElement('ul');
['A', 'B', 'C'].forEach(function(text) {
const li = document.createElement('li');
li.textContent = text;
ul.append(li);
});
append() 與 appendChild() 的差別:前者接受多個參數,也接受字串(會自動轉為文本節點);後者只能附加一個節點,且必須先 createElement。
另外請避免在文件尚未完成解析時呼叫 document.write(),它會清空整個頁面。動態插入內容一律用上面的方法。