DOM 樹的操作可以歸納成五個動作:建立、附加、插入、移除、替換、複製。以下用同一份 HTML 貫穿說明。
<ul id="myList"> <li>項目一</li> <li>項目二</li> <li>項目三</li> </ul>
document.createElement() 接受標籤名稱,回傳一個新的元素節點。要注意:建立出來的節點此時還不屬於任何文件樹,必須後續附加才有意義。
var div = document.createElement("div");
div.id = "myDiv";
div.className = "box";
var ul = document.getElementById("myList");
var li = document.createElement("li");
li.innerHTML = "項目四";
ul.appendChild(li);
執行後:
<ul id="myList"> <li>項目一</li> <li>項目二</li> <li>項目三</li> <li>項目四</li> </ul>
更有趣的是,appendChild() 也能接受「已經存在於文件中的節點」,此時它會把該節點從原位置搬移到新位置:
var ul = document.getElementById("myList");
ul.appendChild(ul.firstChild); // 把第一個子節點移到尾端
結果變成「項目二、項目三、項目一」。
需要精準控制位置時用它,接受兩個參數:要插入的節點,以及作為參照的節點。
var ul = document.getElementById("myList");
var li = document.createElement("li");
li.innerHTML = "項目四";
ul.insertBefore(li, ul.firstChild); // 插到第一個子節點之前
結果:
<ul id="myList"> <li>項目四</li> <li>項目一</li> <li>項目二</li> <li>項目三</li> </ul>
若第二個參數傳入 null,效果等同於附加到尾端:
ul.insertBefore(li, null); // 等同 ul.appendChild(li)
也可以指定某個既有節點作為參照:
var ul = document.getElementById("myList");
var li = document.createElement("li");
li.innerHTML = "項目四";
var lis = ul.getElementsByTagName("li");
ul.insertBefore(li, lis[1]); // 插到原本第二個 li 之前
結果:
<ul id="myList"> <li>項目一</li> <li>項目四</li> <li>項目二</li> <li>項目三</li> </ul>
removeChild() 接受要移除的節點,回傳被移除者。注意:被移除的節點並沒有被銷毀,只是從文件樹中脫離,你手上仍握著它的參考。
var ul = document.getElementById("myList");
var removed = ul.removeChild(ul.firstChild); // 移除第一個子節點
實務上更穩健的寫法是先取出目標集合再移除,避免直接依賴 firstChild 這類會受空白文字節點影響的屬性:
var ul = document.getElementById("myList");
var lis = ul.getElementsByTagName("li");
ul.removeChild(lis[0]);
replaceChild(newNode, oldNode) 用新節點換掉舊節點,回傳被替換掉的節點。
var ul = document.getElementById("myList");
var li = document.createElement("li");
li.innerHTML = "項目四";
var lis = ul.getElementsByTagName("li");
var returned = ul.replaceChild(li, lis[1]); // 用新 li 換掉原本第二個
cloneNode(deep) 接受一個布林值:true 為深層複製(連同所有子節點),false 為淺層複製(只複製節點本身)。
var ul = document.getElementById("myList");
var deepList = ul.cloneNode(true); // 深層複製
var shallowList = ul.cloneNode(false); // 淺層複製
第一,firstChild/lastChild 會把縮排產生的空白文字節點也算進去,跨瀏覽器行為曾經不一致。要穩定取得元素子節點,建議搭配 children、或逐一檢查 nodeType === 1。
第二,頻繁操作節點會反覆觸發版面重排。若需要一次加入大量節點,先用 document.createDocumentFragment() 在記憶體中組裝,最後再一次附加到文件,效能差異相當明顯。