jQuery 的 `append()`、`prepend()`、`after()`、`before()` 在操作**現有 DOM 元素**時,會將該元素從原位置**移動**到目標位置,而非複製。這是「移動節點」的關鍵行為。
<!DOCTYPE html>
<html>
<head>
<title>jQuery 移動節點</title>
<script src="https://code.jquery.com/jquery-3.6.0.min.js"></script>
<script>
$(function() {
$("button").click(function() {
$("div").append($("p")); // 將 移動到
內部末尾
});
});
</script>
<style>
h5 { color: blue; }
div { width: 300px; height: 60px; border: solid 1px green; padding: 10px; }
div p { color: red; }
p { color: black; }
</style>
</head>
<body>
<h5>jQuery 移動節點示範</h5>
<button>點我移動段落</button>
<div>這是 div 區塊</div>
<p>你太幽默了</p>
</body>
</html>
執行前後 DOM 結構對比
操作前 操作後
<div>這是 div 區塊</div>
<p>你太幽默了</p>
<div>這是 div 區塊<p>你太幽默了</p></div>
四大移動/插入方法對照
方法 插入位置 是否移動現有節點
$(target).append(source)目標內部末尾 是
$(target).prepend(source)目標內部開頭 是
$(target).after(source)目標之後 (同層) 是
$(target).before(source)目標之前 (同層) 是
$(source).appendTo(target)目標內部末尾 是 (鏈式語法反轉)
重要陷阱:重複移動同一節點
<div id="a">A</div>
<div id="b">B</div>
<div id="c">C</div>
<script>
$("#a").append($("#c")); // C 移到 A 裡
$("#b").append($("#c")); // C 從 A 移到 B 裡 (不會複製!)
// 最終結構: A(空), B(C), C(不存在於頂層)
</script>
**結論**:同一 jQuery 物件若多次被 `append` 到不同目標,**只會存在於最後一次的目標中**。
若需複製而非移動
// .clone() 建立副本
$("#b").append($("#c").clone(true)); // true = 連同事件處理器一起複製
// 現在: A(空), B(C的副本), C(仍在原處)
實戰場景:拖拉排序、標籤移動、購物車
<ul id="available"><li data-id="1">項目 1</li><li data-id="2">項目 2</li></ul>
<ul id="selected"></ul>
<script>
$("#available").on("click", "li", function() {
$(this).appendTo("#selected").addClass("selected");
});
$("#selected").on("click", "li", function() {
$(this).appendTo("#available").removeClass("selected");
});
</script>
效能提示
- 大量節點移動時,先 `detach()` 移離文件流操作,最後再 `append()` 回去,減少重排。
- 或使用 `DocumentFragment` 原生方式批次操作。
掌握「移動而非複製」的語意,是避免 DOM 操作邏輯錯誤的關鍵。
- 上一篇程序編程: jQuery 取得核取方塊值並以 JSON 格式 POST 提交
- 下一篇程序編程: jQuery 綁定單選按鈕 Radio 點擊事件:取得選中值即時回應