浏览器与 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 文件并直接在浏览器中打开。

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>

预期输出

text
DOM 节点操作 | 事件处理
false

页面最终只显示两条新课程。oldItem 变量仍然指向原来的节点对象,但该节点已经不在文档中,所以 isConnected 为 false;删除或替换节点不会自动销毁仍被 JavaScript 引用的对象。

关键边界

replaceWith() 和 replaceChildren() 可以同时接收多个节点或字符串。传入已经位于页面中的节点时,浏览器会移动该节点,而不是自动复制;需要保留原位置时,应先使用 cloneNode() 创建副本。

不带参数调用 replaceChildren() 等价于清空容器。相比循环调用 remove(),它更能直接表达“容器内容整体失效并重新建立”的意图。

已经脱离文档的节点再次调用 remove() 不会报错,只是没有可见变化。若后续逻辑依赖节点仍在页面中,可先检查 node.isConnected 或 node.parentNode。

选择方法时,只替换一个确定节点应使用 replaceWith();只删除当前节点时使用 remove();旧子节点需要整体作废时使用 replaceChildren()。不要为了删除单个节点先查父元素再调用旧式 removeChild(),除非代码必须兼容较老环境或确实需要父节点引用。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

replaceWith、remove 与 replaceChildren

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通