DIV CSS 佈局教程網

cloneNode() 深度克隆:複製 DOM 節點的正確姿勢
編輯:關於JavaScript     

需要複製一整段 DOM 結構時,cloneNode() 是最直接的答案。但它的 deep 參數究竟改了什麼,值得仔細說清楚。

完整範例

<html>
<head>
<script type="text/javascript">
  function t() {
    var nodeul = document.getElementsByTagName('ul')[0]; // 取得要複製的 UL
    var newul = nodeul.cloneNode(true); // true 表示深度複製,底下的 li 和文字也一起
                                        // 如果是 false,則只複製 ul 本身

    var node_copy = document.getElementById('copyul');
    node_copy.appendChild(newul);
  }
</script>
</head>
<body>
<div id="container">
  <ul>
    <li>春天</li>
    <li>夏天</li>
    <li>秋天</li>
    <li>冬天</li>
  </ul>
</div>
<div id="copyul"></div>
<hr />
<button onclick="t()" value="">複製節點</button>
</body>
</html>

deep 參數的實際差異

cloneNode(true) 會複製該節點及其所有後代,上表範例得到的是一個結構完整、四個項目都在的新 ul。

cloneNode(false) 只複製節點本身,得到的是一個空的 <ul></ul>。這在你想「建立同類型容器但內容另行填充」時反而更好用。

無論哪種情況,屬性都會被複製,包含 id、class、style、自定義 data-* 等。

四個必須知道的行為

1. 事件監聽器不會被複製。透過 addEventListener 綁定的處理器完全不會跟著複製過來。若複製後需要互動,得重新綁定——這也是為什麼事件委派在動態 DOM 場景中特別有價值:監聽器綁在父容器上,新增多少子節點都不用重綁。

注意:以 HTML 行內屬性方式(onclick="...")設定的處理器會被保留,因為那本質上是一個屬性。

2. id 會重複。複製帶 id 的節點會產生文件中兩個相同 id,這違反 HTML 規範,會讓 getElementById 與 label 的關聯失效。複製後應立即改掉:

var clone = nodeul.cloneNode(true);
clone.id = 'ul-copy';
clone.querySelectorAll('[id]').forEach(function (el, i) {
  el.id = el.id + '-copy-' + i;
});

3. 表單元素的當前值不會完整保留。文字輸入框中使用者輸入但未提交的內容、勾選框的動態狀態,在部分情況下不會被複製(屬性與 property 不同步)。若需要保留,得複製後手動同步:

clone.querySelector('input').value = original.querySelector('input').value;

4. 副本是游離的。克隆出來的新節點還不在文件中,必須自行掛到 DOM 上才會顯示。

現代替代方案

若你的目的是「用一段 HTML 字串產生多份節點」,<template> 元素是更合適的工具:

<template id="row-tpl">
  <li class="item"></li>
</template>

<script>
var tpl = document.getElementById('row-tpl');
['春天', '夏天', '秋天'].forEach(function (name) {
  var node = tpl.content.cloneNode(true);
  node.textContent = name;
  document.querySelector('ul').appendChild(node);
});
</script>

模板內容放在 content 這個文件片段中,本身不會被渲染、也不會下載其中的資源,克隆時才真正進入文件。相比複製一個既有節點,這在語意上更清楚,也避開了 id 重複的問題。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved