append() 方法向每個匹配元素內部末尾插入內容。與 after() 類似,它支持多參數混合傳入,可一次追加 HTML 字符串、jQuery 對象、DOM 元素等不同來源的內容。
// 基本語法
$(selector).append(content1, content2, content3, ...);
// 支持的內容類型:
// 1. HTML 字符串: "Text
"
// 2. jQuery 對象: $("").text("Text")
// 3. DOM 元素: document.createElement("p")
// 4. 文本節點: document.createTextNode("Text")
// 5. 數組: ["1
", "2
"]
三種創建方式生成的段落同時追加到 body 末尾:
<!DOCTYPE html>
<html>
<head>
<script src="js/jquery.min.js"></script>
<script>
function appendText() {
var txt1 = "<p>Text.</p>"; // HTML 字符串
var txt2 = $("<p></p>").text("Text."); // jQuery 創建
var txt3 = document.createElement("p"); // DOM 原生創建
txt3.innerHTML = "Text.";
$("body").append(txt1, txt2, txt3); // 多參數追加
}
</script>
</head>
<body>
<p>This is a paragraph.</p>
<button onclick="appendText()">Append text</button>
</body>
</html>
| 方法 | 插入位置 | 多參數 | 返回值 |
|---|---|---|---|
append() | 內部末尾 | ✓ | 目標元素 |
prepend() | 內部開頭 | ✓ | 目標元素 |
after() | 外部之後 | ✓ | 目標元素 |
before() | 外部之前 | ✓ | 目標元素 |
appendTo() | 內部末尾 | ✗ | 新元素 |
prependTo() | 內部開頭 | ✗ | 新元素 |
const frag = document.createDocumentFragment();
data.forEach(item => {
const el = createElement(item);
frag.appendChild(el);
});
$("#list").append(frag);
$("#log").append($("").text(userInput));
- 鏈式調用:
$("#box").append("1
").addClass("updated")
與 appendTo() 選擇指南
- 目標固定、內容多變 →
append()
- 內容固定、目標多變 →
appendTo()
- 需獲取新元素引用 →
appendTo() 返回新元素更方便
靈活運用 append() 的多參數特性,能編寫出既簡潔又高效的動態內容構建代碼。
- 上一篇程序編程: jQuery before() 與 after() 方法元素前後插入內容完整教學
- 下一篇程序編程: jQuery prepend() 方法在元素內部開頭插入內容完整教學