萬盛學電腦網

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

DOM cloneNode() 深度克隆節點完整指南與實戰陷阱

DOM cloneNode() 深/淺克隆全解析:事件、ID、表單狀態的處理藝術

cloneNode(deep) 是節點複製的核心 API。deep=true 遞歸複製整棵子樹,deep=false 僅複製節點本身(無子節點)。但複製後的「副作用」往往被忽視。

基本語法與行為

const clone = node.cloneNode(deep);

// 參數:
// deep = true  (深度克隆):複製節點 + 所有屬性 + 所有後代
// deep = false (淺度克隆):僅複製節點本身 + 屬性,無子節點

// 返回:新節點,未掛載到文檔 (parentNode === null)

完整演示代碼

<html>
<head>
  <script>
    function cloneDemo() {
      // 獲取源節點
      const sourceUl = document.getElementsByTagName('ul')[0];
      
      // 深度克隆 (true)
      const clonedUl = sourceUl.cloneNode(true);
      
      // 插入到目標容器
      const target = document.getElementById('copyul');
      target.appendChild(clonedUl);
    }
  </script>
</head>
<body>
  <div id="container">
    <ul>
      <li>春天</li>
      <li>夏天</li>
      <li>秋天</li>
      <li>冬天</li>
    </ul>
  </div>
  <div id="copyul"></div>
  <hr>
  <button onclick="cloneDemo()">深度克隆 UL</button>
</body>
</html>

⚠️ 關鍵副作用與處理對策

副作用影響處理方案
ID 重複 文檔出現多個相同 ID,違反唯一性,getElementById 失效 克隆後立即修改/移除 ID:clone.id = '' 或 clone.removeAttribute('id')
事件丟失 addEventListener 綁定的事件不會複製 (內聯 onxxx 會複製) 克隆後重新綁定,或使用事件代理
表單狀態複製 input.value、select.selectedIndex、textarea.value 會被複製 若需重置:clone.value = ''、clone.selectedIndex = 0
Canvas/WebGL 內容 畫布像素數據不會複製,僅複製標籤 需手動 ctx.drawImage(sourceCanvas, 0, 0)
自定義屬性/數據 dataset、expando properties 會複製 按需清理 delete clone.dataset.xxx

實戰:安全克隆模板並實例化

function instantiateTemplate(templateId, data) {
  const template = document.getElementById(templateId);
  if (!template) return null;
  
  // 1. 深度克隆
  const clone = template.content ? 
    template.content.cloneNode(true) :  //