動態操作 DOM 時,插入節點是最常見的需求。以下用同一個結構,把 jQuery 與原生 JavaScript 的對應方法並列比較。
起始結構:
<div> <p>面朝大海,春暖花開</p> </div>
| 方法 | 說明 |
|---|---|
| append() | 向每個匹配元素的內部「尾端」追加內容 |
| appendTo() | 把選到的元素追加到另一個指定元素集合中,等同顛倒 append() 的用法。$(A).append(B) 與 $(B).appendTo(A) 等價 |
| prepend() | 向每個匹配元素的內部「開頭」前置內容 |
| prependTo() | 把選到的元素前置到另一個指定元素集合中,等同顛倒 prepend() 的用法 |
$("div").append("<p>這是 append() 添加的內容</p>"); // 插入為最後一個子節點
$("div").prepend("<p>這是 prepend() 添加的內容</p>"); // 插入為第一個子節點
下面這兩種寫法更貼近一般思考順序,效果相同:
$("<p>這是 appendTo 添加的內容</p>").appendTo("div");
$("<p>這是 prependTo 添加的內容</p>").prependTo("div");

| 方法 | 說明 |
|---|---|
| after() | 在每個匹配元素「之後」插入內容 |
| before() | 在每個匹配元素「之前」插入內容 |
| insertAfter() | 把選到的元素插入到另一個指定元素集合的後面 |
| insertBefore() | 把選到的元素插入到另一個指定元素集合的前面 |
$("div").after("<p>這是 after() 添加的內容</p>"); // 在 div 後面插入
$("div").before("<p>這是 before() 添加的內容</p>"); // 在 div 前面插入

appendTo、prependTo、insertBefore、insertAfter 這四個方法具有搬移效果:若選到的元素已存在於文件中,把它們插入到目標位置時,原位置的元素會被移走而非複製。下例把原本在 div 裡的段落移到 div 之後:
$("p").insertAfter("div");

| 需求 | 原生方法 | jQuery 對應 |
|---|---|---|
| 插入為最後一個子節點 | appendChild() | append() |
| 插入為第一個子節點 | insertBefore() | prepend() |
var div = document.querySelector("div");
// 相當於 append()
var p1 = document.createElement("p");
p1.textContent = "這是 appendChild 添加的內容";
div.appendChild(p1);
// 相當於 prepend()
var p2 = document.createElement("p");
p2.textContent = "這是 insertBefore 添加的內容";
div.insertBefore(p2, div.firstChild);
若要插在「外部」,原生做法則是取得父節點後操作:
div.parentNode.insertBefore(newNode, div); // 等同 before() div.parentNode.insertBefore(newNode, div.nextSibling); // 等同 after()
ES6 之後有了更直觀的 insertAdjacentHTML 與 insertAdjacentElement,語意與 jQuery 的方法幾乎一一對應:
div.insertAdjacentHTML("beforeend", "<p>內容</p>"); // 等同 append
div.insertAdjacentHTML("afterbegin", "<p>內容</p>"); // 等同 prepend
div.insertAdjacentHTML("afterend", "<p>內容</p>"); // 等同 after
div.insertAdjacentHTML("beforebegin", "<p>內容</p>"); // 等同 before
而 newer 的 Element.append()、prepend()、before()、after() 甚至可直接接受字串與多個節點,讓原生寫法終於追上 jQuery 的簡潔度:
div.append("純文字也可以", document.createElement("span"));
至於自訂 DOM 擴充功能的實作,則留待後續討論。