HTML 文件在瀏覽器中會被解析成一棵 DOM 樹,這棵樹由一連串的 Node 節點組成,它定義了文件的結構,也提供了程式操作頁面的入口。以下把常用的 API 整理成一份可以隨時回頭翻的清單。
Node.ELEMENT_NODE(1); // 元素節點,最常用 Node.ATTRIBUTE_NODE(2); // 屬性節點,較常用 Node.TEXT_NODE(3); // 文本節點,較常用 Node.CDATA_SECTION_NODE(4); Node.ENTITY_REFERENCE_NODE(5); Node.ENTITY_NODE(6); Node.PROCESSING_INSTRUCTION_NODE(7); Node.COMMENT_NODE(8); // 註解節點 Node.DOCUMENT_NODE(9); // 文件節點,較常用 Node.DOCUMENT_TYPE_NODE(10); Node.DOCUMENT_FRAGMENT_NODE(11); Node.NOTATION_NODE(12);
document.getElementById('element'); // 回傳單一元素
document.getElementsByTagName('element'); // 回傳類陣列集合
document.getElementsByName('element'); // 回傳類陣列集合
document.getElementsByClassName('className'); // 回傳類陣列集合,IE7 及以下不支援
document.querySelectorAll('class' | 'element'); // 回傳類陣列集合
element.childNodes // 所有子節點,回傳類陣列集合 element.firstChild // 第一個子節點 element.lastChild // 最後一個子節點 element.parentNode // 父節點 element.previousSibling // 前一個兄弟節點 element.nextSibling // 後一個兄弟節點
elementNode.nodeName // 元素或屬性節點的標籤名稱 textNode.nodeValue // 文本節點的內容 elementNode.innerHTML // 讀寫內容,可能包含 HTML 標籤 element.innerText (IE) | element.textContent (FF) // 讀寫純文字內容 attrNode.getAttribute(attrName); // 取得屬性值 attrNode.setAttribute(attrName, attrValue); // 設定屬性值 node.nodeType; // 取得節點類型:元素 1、屬性 2、文本 3、註解 8、文件 9
document.createElement('element'); // 建立元素節點
document.createTextNode('text'); // 建立文本節點
document.createAttribute('attribute'); // 建立屬性節點
node.remove(); // 刪除節點
parentNode.removeChild(childNode); // 刪除子節點
parentNode.appendChild(childNode); // 附加到父節點末端
parentNode.insertBefore(newNode, existingNode);// 插入到既有節點之前
node.cloneNode(true); // 複製節點,傳入 true 為深層複製
parentNode.replaceChild(newNode, oldNode); // 取代節點
由於舊版 IE 與其他瀏覽器在 DOM 處理上存在差異,實務上通常會做一層簡單的封裝。最典型的例子是:childNodes 會把空白與換行也當成文本節點,因此「只取出元素子節點」就成了必要的動作;而 firstChild/nextSibling 拿到的東西,往往不是我們真正想要的那個元素。
// 取得所有「元素類型」的子節點
function getElementChildren(element) {
var children = [], oldChildNodes = element.childNodes;
for (var i = 0, len = oldChildNodes.length; i < len; i += 1) {
if (oldChildNodes[i].nodeType == 1) {
children.push(oldChildNodes[i]);
}
}
return children;
}
// 取得下一個元素兄弟
function getElementNext(element) {
var next = element.nextSibling || null;
if (next) {
if (next.nodeType == 1) { return next; }
return arguments.callee(next);
}
throw new Error("下一個兄弟元素不存在!");
}
// 取得上一個元素兄弟
function getElementPrev(element) {
var prev = element.previousSibling || null;
if (prev) {
if (prev.nodeType == 1) { return prev; }
return arguments.callee(prev);
}
throw new Error("上一個兄弟元素不存在!");
}
讀取「實際套用的樣式」是另一個經典的相容性問題:標準瀏覽器用 getComputedStyle,舊 IE 則要用 currentStyle。
// 取得元素某個樣式的實際值
function getElementStyle(element, styleName) {
if (typeof getComputedStyle != 'undefined') {
return getComputedStyle(element, null)[styleName];
}
return element.currentStyle[styleName];
}
function addClass(element, className) {
element.className += ' ' + className;
}
function removeClass(element, removeClassName) {
var classStr = element.className;
element.className = classStr.replace(removeClassName, '')
.split(/\s+/).join(' ').replace(/^\s+/, '').replace(/\s+$/, '');
}
把這些片段整理成自己的工具函式庫,之後寫業務邏輯時會乾淨很多,也不必每次遇到節點操作都重新查一次 API。