document.createElement() 是在物件中「建立」一個元素,它本身並不會讓元素出現在頁面上,必須搭配 appendChild() 或 insertBefore() 使用。前者把新節點加到子節點列表的末端,後者則能插入到任意位置。以下用幾個例子說明。
<script type="text/javascript">
var board = document.getElementById("board");
var e = document.createElement("input");
e.type = "button";
e.value = "這是測試加載的小例子";
var object = board.appendChild(e);
</script>
效果:在 board 這個容器中插入一個文字為「這是測試加載的小例子」的按鈕。
<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";
var object = board.appendChild(e2);
</script>
效果:插入一個含「加載項1」「加載項2」兩個選項、顯示列數為 2 的下拉選單。
<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!');");
var object = board.appendChild(e3);
</script>
效果:插入一個值為「使用setAttribute」的文字框,點擊後跳出「This is a test!」。
對照這三個例子可以看出:直接指派屬性與用 setAttribute 設定,效果是一致的,e.type="text" 與 e.setAttribute("type","text") 並無差別。不過要注意,IE 在 type 以外的少數屬性(如 style、class)上用 setAttribute 曾有相容問題,實務上直接指派 e.className、e.style.cssText 更保險。
假設要在下面這個 div 中插入一個新的 p:
<div id="test"><p id="x1">Node</p><p>Node</p></div>
<script type="text/javascript">
var oTest = document.getElementById("test");
var newNode = document.createElement("p");
newNode.innerHTML = "This is a test";
//appendChild方法:
oTest.appendChild(newNode);
//insertBefore方法:
oTest.insertBefore(newNode,null);
</script>
這兩種寫法都會把新節點插到 div 的最後,也就是說 insertBefore(node, null) 的效果等同於 appendChild(node)。
insertBefore 的第二個參數是它特有的,除了 null,還可以指定參考節點:
<script type="text/javascript">
var oTest = document.getElementById("test");
var refChild = document.getElementById("x1");
var newNode = document.createElement("p");
newNode.innerHTML = "This is a test";
oTest.insertBefore(newNode,refChild);
</script>
效果:在 x1 節點之前插入新節點。
又或:
<script type="text/javascript">
var oTest = document.getElementById("test");
var refChild = document.getElementById("x1");
var newNode = document.createElement("p");
newNode.innerHTML = "This is a test";
oTest.insertBefore(newNode,refChild.nextSibling);
</script>
效果:在 x1 的下一個節點之前插入,等同於插在 x1 之後。
還可以:
<script type="text/javascript">
var oTest = document.getElementById("test");
var newNode = document.createElement("p");
newNode.innerHTML = "This is a test";
oTest.insertBefore(newNode,oTest.childNodes[0]);
</script>
效果:在第一個子節點之前插入。改動 childNodes[0] 的索引,就能插到任意位置。
· appendChild() 只能在子節點列表的末端添加新節點。
· insertBefore() 可以在子節點列表的任意位置插入新節點,第二個參數傳 null 時等同 append。
實務上還有一點值得知道:這兩個方法都會回傳被插入的那個節點,所以可以直接拿回傳值繼續操作(例如 var el = parent.appendChild(child); el.className = 'x';)。若要一次插入多個節點,先把它們放進 DocumentFragment 再一次 appendChild,能大幅減少瀏覽器的重排次數。