需要複製一整段 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>
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 重複的問題。