萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

JavaScript cloneNode() 深淺拷貝節點完整指南

語法與參數

node.cloneNode(deep)
  • deep (Boolean):true = 深拷貝(含所有後代節點),false = 淺拷貝(僅複製節點本身,不含子節點)。
  • 回傳值:複製後的新節點,屬於文檔但無父節點(需 appendChild 等掛載)。

範例:深拷貝 vs 淺拷貝

<div id="guoDiv">
  <span>1</span>
  <span>2</span>
  <span>3</span>
</div>

<script>
var oDiv = document.getElementById("guoDiv");

// 深拷貝:複製整棵子樹
var deepClone = oDiv.cloneNode(true);
console.log("深拷貝 childNodes 長度:", deepClone.childNodes.length); 
// 現代瀏覽器: 7 (3 元素 + 4 文字節點),IE8-: 3 (僅元素節點)

// 淺拷貝:僅複製 div 本身
var shallowClone = oDiv.cloneNode(false);
console.log("淺拷貝 childNodes 長度:", shallowClone.childNodes.length); // 0

// 掛載到文檔
document.body.appendChild(deepClone);
document.body.appendChild(shallowClone); // 顯示空 div
</script>

childNodes 長度差異說明

標準 DOM 中 childNodes 包含所有節點類型(元素、文字、註解等)。瀏覽器對換行縮進的文字節點處理不同,導致長度差異:

  • 現代瀏覽器:保留換行縮進文字節點 → 3 <span> + 4 文字節點 = 7
  • 舊版 IE:忽略元素間空白文字節點 → 僅 3 元素節點

解決:遍歷時檢查 nodeType === 1 (ELEMENT_NODE) 或使用 children 集合(僅元素節點)。

實際應用場景

場景使用深/淺拷貝說明
複製模板節點渲染列表深拷貝保留內部結構與事件(需重新綁定)
移動節點到新容器淺拷貝 + appendChild或直接 appendChild 移動原節點
建立影子 DOM 範本深拷貝複製 <template> 內容
撤銷/重做功能備份狀態深拷貝序列化前先 cloneNode(true)

注意事項

  • 事件不會被複製:addEventListener 綁定的事件、onclick 等屬性事件不會隨節點複製。需重新綁定或使用事件代理。
  • ID 重複問題:深拷貝會複製所有子孫元素的 id,掛載前必須修改 ID 避免重複。
  • 輸入框值:<input>、<textarea> 的使用者輸入值會被複製(屬於 defaultValue/value 屬性)。
  • Canvas/WebGL 內容:<canvas> 繪圖內容不會被複製,需手動 drawImage。

現代替代方案

  • element.cloneNode(true) 仍為原生最快複製方式。
  • 框架中:React React.cloneElement、Vue cloneVNode 處理虛擬節點複製。
  • 需序列化時:outerHTML + DOMParser 或 Range.createContextualFragment。
copyright © 萬盛學電腦網 all rights reserved