浏览器与 Web API / 系统课时
cloneNode 与节点移动
cloneNode 与节点移动
复制节点和移动节点看起来都能让内容出现在新位置,但两者对对象身份、子树、事件监听器和原位置的影响完全不同。本课用同一个课程卡片验证浅复制、深复制与重复插入的真实行为。
学习目标
- 区分
cloneNode(false)与cloneNode(true)的复制范围 - 理解同一节点再次插入时发生的是移动
- 处理重复
id和事件监听器未复制等风险
复制与移动的本质区别
cloneNode(false) 只复制当前节点及其属性,不复制子节点;cloneNode(true) 会递归复制整个子树。无论使用哪种方式,返回值都是一个新的节点对象,与原节点不相等。
把同一个节点传给 append()、prepend() 或 replaceChildren() 时,浏览器不会创建副本,而是先把它从原父节点中移除,再插入新位置。原变量仍指向同一个对象,只是它的父节点发生了变化。

主示例:复制卡片并移动原节点
下面的页面深复制一张课程卡片,修改副本内容后插入目标容器,再把原卡片移动到同一容器。代码还会验证事件监听器是否随复制保留。
<!doctype html>
<html lang="zh-CN">
<head>
<meta charset="UTF-8">
<title>cloneNode 与节点移动</title>
</head>
<body>
<section id="source">
<article id="course-card">
<h3>DOM 基础</h3>
<button type="button">报名</button>
</article>
</section>
<section id="target"></section>
<script>
const source = document.querySelector("#source");
const target = document.querySelector("#target");
const card = document.querySelector("#course-card");
let originalClicks = 0;
card.querySelector("button").addEventListener("click", () => {
originalClicks += 1;
});
const copy = card.cloneNode(true);
copy.id = "course-card-copy";
copy.querySelector("h3").textContent = "DOM 进阶";
target.append(copy);
// 再次插入原节点会移动它,并保留原节点上的监听器。
target.append(card);
copy.querySelector("button").click();
card.querySelector("button").click();
console.log(source.children.length);
console.log(target.children.length);
console.log([...target.querySelectorAll("h3")].map((item) => item.textContent).join(" | "));
console.log(card === target.lastElementChild);
console.log(originalClicks);
</script>
</body>
</html>预期输出
0
2
DOM 进阶 | DOM 基础
true
1source 变为空容器,说明原卡片被移动而非复制。目标容器中有副本和原节点两个对象;副本按钮的点击没有增加计数,原按钮的点击增加了计数,说明通过 addEventListener() 注册的监听器不会被 cloneNode() 复制,而移动原节点不会丢失监听器。
深复制仍不是完整副本
深复制会复制元素、文本和属性,因此原节点上的 id 也会被复制。副本插入同一文档前应修改或移除重复 id,否则 getElementById()、标签关联和 CSS 选择器可能得到含糊结果。
cloneNode(true) 不会复制通过 addEventListener() 或事件属性赋值注册的监听器。需要让副本可交互时,应在复制后重新绑定,或把监听统一委托给稳定的祖先元素。
安全使用时,先决定需要外壳还是完整子树,再选择 false 或 true;随后修改副本中的唯一标识和可变内容;最后补充副本所需的事件行为并插入页面。若目标只是调整原节点位置,不要克隆,直接把原节点插入目标位置即可。