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) : // 標籤
template.cloneNode(true); // 普通元素
// 2. 移除/重置 ID
const allWithId = clone.querySelectorAll('[id]');
allWithId.forEach(el => el.removeAttribute('id'));
// 3. 數據綁定 (簡易版)
clone.querySelectorAll('[data-bind]').forEach(el => {
const key = el.dataset.bind;
if (data[key] !== undefined) {
if (el.tagName === 'INPUT' || el.tagName === 'TEXTAREA') el.value = data[key];
else el.textContent = data[key];
}
});
// 4. 返回文檔片段 (高效批量插入)
return clone;
}
// 使用
const fragment = instantiateTemplate('user-card-tpl', { name: '張三', age: 25 });
document.getElementById('list').appendChild(fragment);
function cloneMultiple(source, count, modifier) {
const frag = document.createDocumentFragment();
for (let i = 0; i < count; i++) {
const clone = source.cloneNode(true);
if (modifier) modifier(clone, i);
frag.appendChild(clone);
}
return frag;
}
// 一次性掛載
container.appendChild(cloneMultiple(itemTemplate, 100, (el, i) => {
el.dataset.index = i;
el.querySelector('.num').textContent = i + 1;
}));
<template id="card-tpl">
<div class="card">
<h3 data-bind="title"></h3>
<p data-bind="desc"></p>
</div>
</template>
// 使用
const tpl = document.getElementById('card-tpl');
const clone = tpl.content.cloneNode(true); // 直接獲取 content 片段
掌握 cloneNode 的副作用邊界,是構建高性能、無 Bug 模板系統的關鍵。