在 jQuery 開發中,clone() 方法是實現 DOM 節點複製的核心工具。然而,許多開發者對「淺拷貝」與「深拷貝」的區別存在誤解,導致事件處理器無法正確複製,產生難以排查的 Bug。本文將透過完整範例,深入解析 clone() 與 clone(true) 的行為差異,幫助你精準掌握節點複製的最佳實踐。
| 參數 | 行為 | 複製內容 | 適用場景 |
|---|---|---|---|
無參數 / false | 淺拷貝 | 僅複製 DOM 結構、屬性、內文 | 靜態內容複製、模板渲染 |
true | 深拷貝 | 包含事件處理器、資料綁定 | 互動元件複製、表單欄位動態新增 |
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>jQuery clone() 深淺拷貝示範</title>
<style>
#main { width: 300px; margin: 50px auto; background: #ffd700; padding: 20px; border-radius: 8px; }
input { display: block; margin: 10px 0; padding: 8px; }
</style>
<script src="https://code.jquery.com/jquery-3.6.0.min.js"></script>
</head>
<body>
<div id="main">
<input type="text" id="txt1" value="我是原始輸入框" readonly>
<button id="btnShallow">淺拷貝 (不複製事件)</button>
<button id="btnDeep">深拷貝 (複製事件)</button>
</div>
<script>
$(function() {
const $original = $('#txt1');
// 為原始元素綁定點擊事件
$original.on('click', function() {
alert('原始元素:點擊事件觸發!');
});
// 淺拷貝:僅複製 DOM,不包含事件
$('#btnShallow').on('click', function() {
const $copy = $original.clone(); // 等同於 clone(false)
$copy.val('淺拷貝副本 - 點擊無反應').insertAfter(this);
});
// 深拷貝:複製 DOM + 事件處理器
$('#btnDeep').on('click', function() {
const $copy = $original.clone(true);
$copy.val('深拷貝副本 - 點擊會彈窗').insertAfter(this);
});
});
</script>
</body>
</html>
clone(true) 會複製:
.on()、.bind()、.click() 等綁定的事件.data())但 不會 複製:
onclick="...")addEventListener 綁定的事件 (除非經由 jQuery 封裝)複製後務必修改 ID,否則會導致 document.getElementById 行為異常:
const $copy = $original.clone(true)
.attr('id', 'txt1_copy_' + Date.now()) // 生成唯一 ID
.val('新副本');
深拷貝會遞迴複製事件處理器,大量節點複製時建議:
.on('click', '.dynamic', handler))$('#btn').after($('#txt').clone()) 若在迴圈中執行,所有副本共用同一事件處理器實例,導致 this 指向混亂。
$('#txt').clone(true),或使用 .clone(true).each(function(){ $(this).off('click').on('click', newHandler); }) 重綁事件。
理解 clone() 的深淺拷貝機制,是掌握 jQuery 動態 DOM 操作的關鍵。記住三原則:
靈活運用這些技巧,能讓你的 jQuery 程式碼更健壯、易維護。