上一章介紹了 DOM 的基礎操作,本文進一步說明 DOM 自身的型別體系、幾個實用擴充,以及操作內容的四個屬性。
| 型別名 | 說明 |
|---|---|
| Node | 所有型別值的統一介面,IE 不支援 |
| Document | 文件型別 |
| Element | 元素節點型別 |
| Text | 文本節點型別 |
| Comment | 註解型別 |
| CDATASection | CDATA 區域型別 |
| DocumentType | 文件宣告型別 |
| DocumentFragment | 文件片段型別 |
| Attr | 屬性節點型別 |
DOM1 級定義了一個 Node 介面,由 DOM 中的所有節點型別實作。這個介面在 JavaScript 中作為 Node 型別存在,除 IE 之外的所有瀏覽器都能存取到。
document; // #document
document.nodeType; // 9
document.childNodes[0]; // DocumentType
document.childNodes[1]; // HTMLHtmlElement
// 直接取得 <html> 元素節點
document.documentElement; // HTMLHtmlElement
// 取得 <body>
document.body; // HTMLBodyElement
// 舊寫法:document.getElementsByTagName('body')[0]
// <!DOCTYPE> 會作為瀏覽器的第一個節點處理
document.doctype; // DocumentType
document.title; // 讀寫 <title> 的內容
document.URL; // 目前頁面 URL
document.domain; // 網域名稱
document.referrer; // 連結到目前頁面的那一頁 URL
document.anchors; // 帶 name 屬性的 <a> 集合
document.links; // 帶 href 屬性的 <a> 集合
document.forms; // <form> 集合
document.images; // <img> 集合
設定 document.domain 在頁面包含來自其他子網域的框架時很方便。由於跨網域安全限制,來自不同子網域的頁面無法透過 JavaScript 互相通訊;把雙方的 document.domain 設為相同的值,就能彼此存取對方的 JavaScript 物件。不過這種做法已不建議,跨網域溝通請改用 postMessage 或 CORS。
Element 型別用於表現 HTML 中的元素節點,其 nodeType 為 1、nodeName 為標籤名。在非 IE 瀏覽器中,元素節點物件會回傳具體的型別:
| 元素 | 型別 |
|---|---|
| HTML | HTMLHtmlElement |
| DIV | HTMLDivElement |
| BODY | HTMLBodyElement |
| P | HTMLParagraphElement |
// Text 型別用於表現文本節點,內容不包含 HTML,或已轉義後的 HTML
// 文本節點的 nodeType 為 3
var box = document.createElement('div');
var text1 = document.createTextNode('Mr');
var text2 = document.createTextNode('Lee!');
box.appendChild(text1);
box.appendChild(text2);
document.body.appendChild(box);
alert(box.childNodes.length); // => 2,兩個獨立節點
box.normalize(); // 合併相鄰的文本節點
box.firstChild.splitText(3); // 將一個節點分離為兩個
Text 節點還提供了一組操作字元的方法:
var box = document.getElementById('box');
box.firstChild.deleteData(0, 2); // 刪除從位置 0 開始的 2 個字元
box.firstChild.insertData(0, 'Hello'); // 從位置 0 插入指定字串
box.firstChild.replaceData(0, 2, 'Miss'); // 從位置 0 取代 2 個字元
box.firstChild.substringData(0, 2); // 從位置 0 取 2 個字元
alert(box.firstChild.nodeValue); // 輸出操作後的結果
// Comment 的 nodeType 是 8,nodeName 是 #comment,nodeValue 是註解內容
var box = document.getElementById('box');
alert(box.firstChild); // [object Comment]
Attr 型別表示元素中的屬性,nodeType 為 2,nodeName 為屬性名,nodeValue 為屬性值。
// 從 IE6 開始區分標準模式與混雜模式(怪異模式),主要取決於 DOCTYPE 宣告
// IE 為 document 添加了 compatMode 屬性
// 標準模式回傳 CSS1Compat;混雜模式回傳 BackCompat
if (document.compatMode == 'CSS1Compat') {
alert(document.documentElement.clientWidth);
} else {
alert(document.body.clientWidth);
}
document.getElementById('box').scrollIntoView(); // 捲動到該元素可見
// 可傳入 { behavior: 'smooth', block: 'center' } 做平滑捲動與對齊控制
var box = document.getElementById('box');
alert(box.children.length); // 只取得有效的元素子節點
由於空白文本節點在不同瀏覽器的解釋不一致,children 是個很方便的解法。它原是非標準屬性,但已被 HTML 標準收錄,現在所有瀏覽器都支援。
var box = document.getElementById('box');
alert(box.contains(box.firstChild)); // => true,判斷是否為自己的後代
document.getElementById('box').innerText; // 取得純文字(HTML 會被過濾)
document.getElementById('box').innerText = 'Mr.Lee'; // 設定時 HTML 會被轉義
除 Firefox 之外的所有瀏覽器都支援這個屬性。Firefox 的 DOM3 級提供了類似的 textContent,跨瀏覽器的相容寫法:
function getInnerText(element) {
return (typeof element.textContent == 'string') ? element.textContent : element.innerText;
}
function setInnerText(element, text) {
if (typeof element.textContent == 'string') {
element.textContent = text;
} else {
element.innerText = text;
}
}
兩者仍有細微差異:innerText 會回傳「渲染後看得到的文字」(受 CSS 影響,隱藏的元素不含在內,且會保留換行),textContent 則回傳原始的所有文字節點內容。效能上 textContent 較快,因為不需要觸發 reflow。
document.getElementById('box').innerHTML; // 取得內容,不過濾 HTML
document.getElementById('box').innerHTML = '<b>123</b>'; // 加粗的 123
雖然 innerHTML 能插入 HTML,但有所謂的「作用域元素」限制:
box.innerHTML = "<script>alert('Lee');</script>"; // script 不會被執行
box.innerHTML = "<style>background:red;</style>"; // style 也不會生效
這個限制實際上是好事——它擋掉了最直白的 XSS 手法。但並非萬無一失:透過 <img src=x onerror=...> 這類事件屬性仍然可以執行任意程式碼。因此凡是內容含使用者輸入,請一律用 textContent,或先經過跳脫/消毒處理。
outerText 取值時和 innerText 一樣,Firefox 不支援。而且賦值行為相當危險——它不只取代文字內容,還會把元素本身一併抹去:
var box = document.getElementById('box');
box.outerText = '<b>123</b>';
alert(document.getElementById('box')); // => null,元素已不存在
不建議使用。
var box = document.getElementById('box');
box.outerHTML = '123';
alert(document.getElementById('box')); // => null,同樣會抹去元素
取值行為與 innerHTML 一致(包含元素自身的標籤),但賦值後該元素會從文件中被移除。若確實需要取代元素本身,用 replaceWith() 會清楚得多。
在插入大量 HTML 標記時,innerHTML 的效率明顯高於逐一 createElement 加 appendChild。因為設定 innerHTML 時,瀏覽器會啟用一個解析器層級的 HTML parser,直接由 C++ 建構整棵子樹,比 JavaScript 逐節點呼叫快得多。
但建立與銷毀 HTML parser 本身也有成本,不適合在迴圈中反覆呼叫:
// 不好:每次迭代都重新解析
for (var i = 0; i < 10; i++) {
ul.innerHTML = '<li>item</li>';
}
// 較好:先在記憶體中組好字串,最後一次設定
var html = '';
for (var i = 0; i < 10; i++) {
html += '<li>item</li>';
}
ul.innerHTML = html;
更好的做法是使用 DocumentFragment,或直接組好字串後一次插入:
const frag = document.createDocumentFragment();
for (var i = 0; i < 1000; i++) {
const li = document.createElement('li');
li.textContent = 'item ' + i;
frag.appendChild(li);
}
ul.appendChild(frag); // 只觸發一次 reflow
DOM 是語言中立的 API,用於存取與操作 HTML 和 XML 文件。DOM1 級將文件視為一個層次化的節點樹,可用 JavaScript 操作這個樹狀結構,進而改變底層文件的外觀與結構。
document 物件就是它的實例,可用多種方式查詢與取得節點。今天開發時,操作元素內容有幾個更好用的 API:
el.textContent = 'text'; // 取代 innerText,效能更好且行為可預期
el.innerHTML = html; // 大量插入 HTML 時仍是最快的
el.replaceChildren(a, b, c); // 一次清空並插入多個節點
el.insertAdjacentHTML('beforeend', html); // 在指定位置插入 HTML
new DOMParser().parseFromString(str, 'text/html'); // 解析 HTML 字串為文件
// 樣板標籤:真正的 inert 內容容器
const tpl = document.getElementById('row-template');
const clone = tpl.content.cloneNode(true);
tbody.appendChild(clone);
<template> 搭配 cloneNode(true) 是建立重複結構的首選,因為樣板內容完全惰性,不會觸發任何請求或腳本執行。