DOM 操作是前端的基本功,但方法名稱多、行為細節雜,很多人寫了好一陣子還是會把 insertBefore 的第二個參數搞錯。這篇把常用的 API 整理成一份可查的清單,並用同一個清單結構示範每個方法的實際差異。
建立節點:createDocumentFragment() 建立文件片段、createElement() 建立元素、createTextNode() 建立文字節點。
新增與移除:appendChild()、removeChild()、replaceChild()、insertBefore()。
查詢:getElementsByTagName() 依標籤名、getElementsByName() 依 name 屬性、getElementById() 依 id(具唯一性)。
以下範例統一的 HTML 起點:
<ul id="myList"> <li>項目一</li> <li>項目二</li> <li>項目三</li> </ul>
var div = document.createElement("div"); // 建立 div
div.id = "myDiv"; // 設定 id
div.className = "box"; // 設定 class
建立完只是產生了一個游離節點,必須掛進文件樹才會出現在畫面上。
var ul = document.getElementById("myList");
var li = document.createElement("li");
li.innerHTML = "項目四";
ul.appendChild(li); // 掛到子節點末尾
值得一提的是,如果傳入的是「已存在於文件中的元素」,appendChild 不會複製它,而是把它從原位置搬過來。這在排序、搬移節點時經常被誤解。
第一個參數是要插入的節點,第二個是參照節點,新節點會被放在參照節點之前。
var ul = document.getElementById("myList");
var li = document.createElement("li");
li.innerHTML = "項目四";
ul.insertBefore(li, ul.firstChild); // 變成第一項
// 想插到最後,可以把 lastChild 當參照
ul.insertBefore(li, ul.lastChild);
var ul = document.getElementById("myList");
var removed = ul.removeChild(ul.firstChild);
被移除的節點並沒有被銷毀,只是脫離了文件樹,你仍可以用 removed 這個變數把它插回去。
var ul = document.getElementById("myList");
var li = document.createElement("li");
li.innerHTML = "項目四";
var old = ul.replaceChild(li, ul.getElementsByTagName("li")[1]);
var ul = document.getElementById("myList");
var deepList = ul.cloneNode(true); // 深複製:含所有子節點
var shallowList = ul.cloneNode(false); // 淺複製:只有節點本身

下面這個例子示範如何走訪節點、印出子節點結構,以及複製整棵子樹——在製作樹狀選單時特別好用。
<script language="JavaScript">
function printChilds(objNode) {
var strMsg = "節點名稱 = " + objNode.nodeName + "\n";
if (objNode.hasChildNodes()) {
var nodeCount = objNode.childNodes.length;
strMsg += "子節點數 = " + nodeCount + "\n";
for (var i = 0; i < nodeCount; i++) {
strMsg += "標記名稱 = " + objNode.childNodes[i].nodeName + "\n";
}
alert(strMsg);
}
}
function copyNode(objNode, objDupNode, deep) {
var tempNode = objDupNode.cloneNode(deep);
objNode.appendChild(tempNode);
}
</script>
<ul id="myUL">
<li>項目1
<li>項目2
<ol id="myOL">
<li>次項目1
<li>次項目2
</ol>
<li>項目3
</ul>
<form>
<input type="button" value="顯示列表的子節點" onclick="printChilds(myUL)">
<input type="button" value="複製節點" onclick="copyNode(myUL, myUL.childNodes[1], false)">
<input type="button" value="複製節點樹" onclick="copyNode(myUL.lastChild, myOL, true)">
</form>
第一,迴圈中大量新增節點會反覆觸發瀏覽器重排,效能很差。正確做法是先塞進 DocumentFragment,最後再一次掛進文件。第二,innerHTML 拼接字串時,若內容來自使用者輸入,務必先做跳脫處理,否則等於替攻擊者開了一扇門;能改用 createElement 加 textContent 就盡量用。