浏览器与 Web API / 系统课时
replaceWith、remove 与 replaceChildren
replaceWith、remove 与 replaceChildren
现代 DOM 提供了三个职责清晰的节点操作方法:替换当前节点、删除当前节点,以及一次性重置容器内容。本课通过一个可运行示例串联它们,并重点说明旧引用、字符串参数和节点移动等边界。
学习目标
- 区分
replaceWith()、remove()与replaceChildren()的操作范围 - 使用三个 API 完成节点替换、删除和容器重置
- 判断操作后旧节点引用与页面连接状态
三个 API 分别解决什么
| API | 调用者 | 结果 |
|---|---|---|
node.replaceWith(...items) |
将被替换的节点 | 用节点或字符串替换调用者 |
node.remove() |
将被删除的节点 | 把调用者从父节点中移除 |
container.replaceChildren(...items) |
内容容器 | 清空现有子节点,再插入新内容 |
这三个方法都直接修改当前 DOM,返回值都是 undefined。它们接收的字符串会被转换为文本节点,不会按 HTML 字符串解析,因此插入普通文本时比 innerHTML 更直接。
主示例:重置课程列表
下面的页面先替换第一项,再删除最后一项,最后用新节点重置整个列表。示例可保存为 HTML 文件并直接在浏览器中打开。
<!doctype html>
<html lang="zh-CN">
<head>
<meta charset="UTF-8">
<title>现代 DOM 节点操作</title>
</head>
<body>
<ul id="course-list">
<li>旧课程 A</li>
<li>旧课程 B</li>
</ul>
<script>
const list = document.querySelector("#course-list");
const oldItem = list.firstElementChild;
const replacement = document.createElement("li");
replacement.textContent = "DOM 节点操作";
oldItem.replaceWith(replacement);
list.lastElementChild.remove();
const fragment = document.createDocumentFragment();
for (const title of ["DOM 节点操作", "事件处理"]) {
const item = document.createElement("li");
item.textContent = title;
fragment.append(item);
}
list.replaceChildren(fragment);
console.log([...list.children].map((item) => item.textContent).join(" | "));
console.log(oldItem.isConnected);
</script>
</body>
</html>预期输出
DOM 节点操作 | 事件处理
false页面最终只显示两条新课程。oldItem 变量仍然指向原来的节点对象,但该节点已经不在文档中,所以 isConnected 为 false;删除或替换节点不会自动销毁仍被 JavaScript 引用的对象。
关键边界
replaceWith() 和 replaceChildren() 可以同时接收多个节点或字符串。传入已经位于页面中的节点时,浏览器会移动该节点,而不是自动复制;需要保留原位置时,应先使用 cloneNode() 创建副本。
不带参数调用 replaceChildren() 等价于清空容器。相比循环调用 remove(),它更能直接表达“容器内容整体失效并重新建立”的意图。
已经脱离文档的节点再次调用 remove() 不会报错,只是没有可见变化。若后续逻辑依赖节点仍在页面中,可先检查 node.isConnected 或 node.parentNode。
选择方法时,只替换一个确定节点应使用 replaceWith();只删除当前节点时使用 remove();旧子节点需要整体作废时使用 replaceChildren()。不要为了删除单个节点先查父元素再调用旧式 removeChild(),除非代码必须兼容较老环境或确实需要父节点引用。