document.createElement() 只是在記憶體中造出一個節點,要讓它出現在頁面上,必須搭配 appendChild() 或 insertBefore()。兩者的差別就在插入位置。
appendChild():把新節點加到子節點列表的最尾端。insertBefore():把新節點插入子節點列表的任意位置。目標容器:
<div id="board"></div>
加入一個按鈕:
<script type="text/javascript">
var board = document.getElementById("board");
var e = document.createElement("input");
e.type = "button";
e.value = "這是測試加載的小例子";
board.appendChild(e);
</script>
加入一個下拉選單:
<script type="text/javascript">
var board = document.getElementById("board");
var e2 = document.createElement("select");
e2.options[0] = new Option("加載項1", "");
e2.options[1] = new Option("加載項2", "");
e2.size = "2";
board.appendChild(e2);
</script>
用 setAttribute 設定屬性,效果與直接指派相同:
<script type="text/javascript">
var board = document.getElementById("board");
var e3 = document.createElement("input");
e3.setAttribute("type", "text");
e3.setAttribute("name", "q");
e3.setAttribute("value", "使用setAttribute");
e3.setAttribute("onclick", "javascript:alert('This is a test!');");
board.appendChild(e3);
</script>
由此可見 e.type = "text" 與 e.setAttribute("type","text") 是等價的。差別在於 className、style 這類屬性用直接指派較自然,而自訂屬性(data-*)則該用 setAttribute 或 dataset。
要在既有節點中插入:
<div id="test"><p id="x1">Node</p><p>Node</p></div>
兩種寫法都能把新節點放到最後:
var oTest = document.getElementById("test");
var newNode = document.createElement("p");
newNode.innerHTML = "This is a test";
oTest.appendChild(newNode);
// 或
oTest.insertBefore(newNode, null);
insertBefore 的第二個參數是「參考節點」,新節點會插在它前面;傳 null 等同於 appendChild。它也可以傳其他值:
// 插在 x1 節點之前
var refChild = document.getElementById("x1");
oTest.insertBefore(newNode, refChild);
// 插在 x1 的下一個節點之前(實際效果是排在 x1 之後) oTest.insertBefore(newNode, refChild.nextSibling);
// 插在第一个子節點之前,也就是成為最前面 oTest.insertBefore(newNode, oTest.childNodes[0]);
改變 childNodes[0]、childNodes[1]… 就能把節點放到任意位置。
appendChild() 永遠加在最後;insertBefore() 靠第二個參數決定精確位置,傳 null 時等同 appendChild。
要留意的是,頻繁呼叫 appendChild 會造成多次瀏覽器重排。大量新增節點時,建議先用 DocumentFragment 收集,最後一次掛進 DOM。另外現代寫法已有更直覺的 insertAdjacentHTML()、prepend()、append()、before()、after() 等方法,能直接用字串插入,通常比 createElement 逐層組裝簡潔得多。