動態新增元素是 DOM 操作的基本功,需要三個步驟:建立元素、放入內容、掛到頁面上。
<!DOCTYPE html>
<html>
<body>
<div id="div1">
<p id="p1">這是一個段落。</p>
<p id="p2">這是另一個段落。</p>
</div>
<script>
// 1. 建立一個 h1 元素
var para = document.createElement("h1");
// 2. 建立文字節點
var node = document.createTextNode("這是新段落。");
// 3. 把文字放進 h1,結果相當於 <h1>這是新段落</h1>
para.appendChild(node);
// 4. 取得容器並掛上去
var element = document.getElementById("div1");
element.appendChild(para);
</script>
</body>
</html>
因為文字與元素是兩種不同的節點型別。createTextNode 產生的節點無法設定 style、className 這類屬性,而元素節點則可以。分開建立的好處是,文字內容即使含有 <、> 這類字元也會被視為純文字,不會被當成標籤解析——這在處理使用者輸入時,反而是重要的安全特性。
若只是要設定簡單的文字,用 textContent 更省事,效果等同於上面的 createTextNode 加 appendChild:
para.textContent = "這是新段落。";
appendChild 永遠加在最後。若要插在指定位置,用 insertBefore:
element.insertBefore(newNode, element.firstChild); // 插到最前面
Modern 的 insertAdjacent 系列語意最清楚,可指定插入方位:
element.insertAdjacentHTML('beforeend', '<li>新項目</li>');
// beforebegin / afterbegin / beforeend / afterend
一次加入多個節點時,用 DocumentFragment 打包,只觸發一次排版重繪,效能明顯更好:
var frag = document.createDocumentFragment();
for (var i = 0; i < 1000; i++) {
var li = document.createElement('li');
li.textContent = '項目 ' + i;
frag.appendChild(li);
}
document.querySelector('ul').appendChild(frag); // 只重繪一次
迴圈中直接呼叫 appendChild 一千次,會觸發一千次 DOM 更新;用 fragment 則只有最後一次。這個差異在資料量大的列表上非常有感。
最簡潔的寫法則是 insertAdjacentHTML 或 element.innerHTML += ...。但後者會重新解析整個內容區,既慢又會讓該元素上既有的監聽器與狀態全部遺失;若插入的內容含有使用者提供的資料,也可能成為 XSS 的入口。能建立節點就建立節點,別圖一時方便。