本文整理了 JavaScript 操作 DOM 時許多容易被忽略的細節,從 Node 型別、節點關係,一路談到 Document、Element、Text 型別以及動態載入腳本與樣式,適合想打好基礎的讀者參考。
DOM 第一級定義了一個 Node 介面,由所有節點型別實作。每個節點都有一個 nodeType 屬性用來標示類型,常見的有以下幾種:
Node.ELEMENT_NODE(1); // 元素節點 Node.ATTRIBUTE_NODE(2); // 屬性節點 Node.TEXT_NODE(3); // 文本節點 Node.DOCUMENT_NODE(9); // 文件節點
其他還有很多類型,但並不常用,理解這四種即可。以下面這段 HTML 為例:
<div id="test"> <p>aaaaaa</p> <p>bbbbbb</p> <p>cccccc</p> </div>
若直接比較 Node 常數:
var test = document.getElementById("test");
if(test.nodeType === Node.ELEMENT_NODE) {
alert(1);
}
這段程式在 IE8 及以下會出錯,因為 IE 並未公開 Node 型別的建構子。實務上更保險的做法是直接用數值比較,元素節點為 1、屬性節點為 2、文本節點為 3:
var test = document.getElementById("test");
// 下列寫法所有瀏覽器都支援
if(test.nodeType == 1) {
alert(1);
}
元素節點的 nodeName 保存的是標籤名稱,而 nodeValue 通常為 null:
var test = document.getElementById("test");
if(test.nodeType == 1) {
console.log(test.nodeName); // 印出 DIV
console.log(test.nodeValue); // 印出 null
}
在一份 HTML 文件中,head 與 body 是 html 的子元素,html 則是他們的父節點,head 與 body 互為兄弟節點。每個節點都有 childNodes 屬性,它保存的是類似陣列的集合,也有 length 屬性,但並不是 Array 的實例。
標準瀏覽器與 IE9+ 會把標籤之間的空白也計入文本節點,因此 childNodes.length 可能是 7;而 IE8 及以下不計入空白節點,長度為 3。若要統一行為,可將 HTML 標籤之間的空白去除。
可用中括號索引或 item() 方法取得子節點,兩者效果相同:
console.log(test.childNodes[1]); // <p>bbbbbb</p> console.log(test.childNodes.item(1)); // <p>bbbbbb</p>
但 childNodes 並不是陣列:
console.log(Object.prototype.toString.call(test.childNodes) === "[object Array]"); // false
若需要轉成真正的陣列,IE8 及以下需另外封裝,因為它把 NodeList 實作成 COM 物件:
function convertToArray(nodes){
var array = null;
try {
array = Array.prototype.slice.call(nodes, 0); // 適用非 IE 瀏覽器
} catch (ex) {
array = new Array();
for (var i=0, len=nodes.length; i < len; i++){
array.push(nodes[i]);
}
}
return array;
}
var test = document.getElementById("test");
var testArray = convertToArray(test.childNodes);
console.log(testArray instanceof Array); // true
每個節點都有 parentNode 指向父節點,previousSibling 指向前一個兄弟節點,nextSibling 指向下一個兄弟節點:
<div id="test"><p>aaaaaa</p><p>bbbbbb</p><p>cccccc</p></div>
var test = document.getElementById("test");
if(test.nodeType == 1) {
var secodeChild = test.childNodes[1];
console.log(secodeChild); // <p>bbbbbb</p>
console.log(secodeChild.previousSibling); // <p>aaaaaa</p>
console.log(secodeChild.nextSibling); // <p>cccccc</p>
}
父節點的 firstChild 永遠等於 childNodes[0],lastChild 永遠等於 childNodes[childNodes.length - 1];若沒有子節點,兩者皆為 null。此外可用 hasChildNodes() 判斷是否有子節點,回傳布林值。
所有節點的最後一個屬性是 ownerDocument,指向整個文件節點,讓我們能直接存取文件,而不必逐層回溯。
appendChild():在 childNodes 末尾新增節點,回傳新增的節點。
var test = document.getElementById("test");
var newNode = document.createElement("p");
var returnNode = test.appendChild(newNode);
console.log(returnNode === newNode); // true
insertBefore():將新節點插入到參照節點前面,接收「要插入的節點」與「參照節點」兩個參數。若參照節點為 null,則會插到最後。
var test = document.getElementById("test");
var newNode = document.createElement("div");
var returnNode = test.insertBefore(newNode, test.childNodes[0]);
console.log(returnNode === newNode); // true
replaceChild():以新節點取代舊節點,回傳被替換並移除的節點。
var returnNode = test.replaceChild(newNode, test.firstChild);
removeChild():移除指定節點並回傳該節點。
var returnNode = test.removeChild(test.firstChild);
cloneNode():複製節點,傳入 true 為深層複製(含所有子節點),false 則只複製節點本身。
var deeplist = test.cloneNode(true); // 深層複製 var shallow = test.cloneNode(false); // 淺層複製,僅節點本身
JS 以 Document 型別表示文件,document 繼承自 HTMLDocument,代表整個 HTML 頁面。其特性為:nodeType 為 9、nodeName 為 "#document"、nodeValue 為 null、parentNode 與 ownerDocument 皆為 null。
documentElement 屬性永遠指向 html 元素;childNodes 可存取文件節點;title 可讀寫網頁標題;URL 取得完整網址;domain 取得或設定網域(常應用於跨子域情境)。此外 namedItem() 可依 name 屬性取得集合項目,getElementsByName() 則回傳具有指定 name 的所有元素。
Element 節點 nodeType 為 1、nodeName 為標籤名稱、nodeValue 為 null、parentNode 可能是 Document 或 Element。取得標籤名可用 tagName 或 nodeName,兩者回傳相同值。
所有 HTML 元素由 HTMLElement 型別表示,它直接繼承 Element。取得屬性用 getAttribute()、設定用 setAttribute()、刪除用 removeAttribute()。要注意 IE7 及以下取得與刪除類名需用 className 而非 class。
Element 是唯一具備 attributes 屬性的節點型別,它包含一個 NamedNodeMap 集合,每個節點的 nodeName 是特性名稱、nodeValue 是特性值。可用 getNamedItem()、removeNamedItem() 等方法操作。當你想遍歷某元素上的所有屬性時,attributes 就派上用場:
function outputAttributes(element) {
var arrs = new Array();
var attrName, attrValue, i, len;
for(i = 0, len = element.attributes.length; i < len; i++) {
attrName = element.attributes[i].nodeName;
attrValue = element.attributes[i].nodeValue;
if(element.attributes[i].specified) {
arrs.push(attrName + "='" + attrValue + "'");
}
}
return arrs.join(" ");
}
需留意兩點:不同瀏覽器回傳特性的順序不同;IE7 及更早版本會回傳所有可能的特性,因此可透過 specified 屬性過濾掉未實際指定的項目。
元素的 childNodes 可能包含元素、文本、註解或處理指令。由於標準瀏覽器會把空白計為文本節點,實務上建議在遍歷時判斷是否為元素節點:
var list = document.getElementById("list");
var arrs = [];
for(var i = 0, ilen = list.childNodes.length; i < ilen; i++) {
var curElement = list.childNodes[i];
if(curElement.nodeType === 1){
arrs.push(curElement);
}
}
console.log(arrs.length); // 3
Text 節點 nodeType 為 3、nodeName 為 "#text"、nodeValue 為節點文本、parentNode 為 Element,且沒有子節點。可用 document.createTextNode() 建立;用 splitText(offset) 可從指定位置將一個文本節點切分成兩個。
var element = document.createElement("div");
var text = document.createTextNode("aabbbccc");
element.appendChild(text);
document.body.appendChild(element);
var newNode = element.firstChild.splitText(5);
console.log(element.firstChild.nodeValue); // aabbb
console.log(newNode.nodeValue); // ccc
console.log(element.childNodes.length); // 2
動態插入 JS 的常見寫法如下,這種方式不會阻塞瀏覽器載入:
function loadScript(url) {
var script = document.createElement("script");
script.type = "text/javascript";
script.src = url;
document.body.appendChild(script);
}
loadScript("a.js");
由於動態載入等同非同步,若要確保載入完成後才執行動作,可利用 script 元素的 load 事件(IE8 及以下不支援,需搭配 readystatechange 事件處理):
EventUtil.addHandler(window,'load',function(){
var script = document.createElement("script");
EventUtil.addHandler(script,'load',function(event){
console.log(script.src);
});
script.src = 'a.js';
document.body.appendChild(script);
});
IE 為 DOM 提供了 readystatechange 事件,可能的值有:uninitialized、loading、loaded、interactive、complete。此外,IE8 及以下將 script 視為特殊元素,不允許存取其子節點,因此需改用 script.text 指定程式碼。
與動態腳本類似,動態樣式指的是頁面載入後才加入的樣式:
function loadStyles(url) {
var link = document.createElement("link");
link.rel = "stylesheet";
link.type = "text/css";
link.href = url;
document.getElementsByTagName("head")[0].appendChild(link);
}
loadStyles("style.css");
若要跨瀏覽器判斷載入完成,標準瀏覽器用 load 事件,IE 則用 readystatechange,Safari 對 link 的 load 事件支援不佳。另一種做法是直接建立 style 標籤並寫入 CSS 文字,同樣需針對 IE8 及以下用 styleSheet.cssText 做相容處理。
選擇器方面,querySelector() 接收 CSS 選擇器並回傳第一個符合的元素,找不到則回傳 null;querySelectorAll() 則回傳所有符合元素的 NodeList。matchesSelector() 用來判斷元素是否符合選擇器(各家瀏覽器有 ms、moz、webkit 前綴差異)。getElementsByClassName() 回傳具指定類名的集合。
HTML5 新增的 classList 屬性讓操作類名更簡潔,提供 add()、contains()、remove()、toggle() 等方法:
var div = document.getElementById("div");
div.classList.remove("aa");
div.classList.add("current");
div.classList.toggle("aa");
console.log(div.classList.contains("aa")); // true
HTML5 也允許以 data- 前綴添加自訂屬性,並可透過元素的 dataset 屬性(DOMStringMap 實例)讀取與設定:
var div = document.getElementById("myDiv");
console.log(div.dataset.value); // 讀取 data-value
div.dataset.value = 23456; // 設定值
以上即為 JavaScript 操作 DOM 的核心細節整理,掌握這些觀念,才能在跨瀏覽器開發時游刃有餘。
