JavaScript / TypeScript / 系统课时

删除与替换元素

删除与替换元素

本篇解决页面动态更新中的节点移除和替换问题。你将学习如何安全删除 DOM 元素,以及如何用新的节点替换旧节点,完成列表更新、内容刷新等常见交互。

学习目标

  • 掌握 remove() 删除节点的方法
  • 理解 replaceWith() 替换节点的使用场景
  • 学会在操作 DOM 前检查节点是否存在

使用 remove 删除元素

现代 DOM API 提供了 remove() 方法,可以直接删除当前节点。删除后,该节点会从页面 DOM 树中移除。

js
const message = document.querySelector("#message");

if (message) {
  message.remove();
}

预期结果

text
id 为 message 的元素从页面中消失。

相比旧方式 parentNode.removeChild(node),remove() 更符合当前 DOM API 的使用习惯,不需要先获取父节点。

替换已有节点

当页面中的旧内容需要整体更新时,可以使用 replaceWith()。它会用新的节点替换当前节点。

js
const oldTitle = document.querySelector("#title");

const newTitle = document.createElement("h2");
newTitle.textContent = "新的标题";

if (oldTitle) {
  oldTitle.replaceWith(newTitle);
}

预期结果

text
页面中的旧标题元素被新的 h2 元素替换。

替换操作会改变 DOM 结构,但新节点需要提前创建完成。如果只是修改文字内容,不需要替换节点,直接修改 textContent 会更简单。

安全清理动态内容

实际项目中经常需要清空列表、消息区域等动态区域。可以结合 remove() 遍历删除子节点。

js
const panel = document.querySelector("#panel");

if (panel) {
  while (panel.firstElementChild) {
    panel.firstElementChild.remove();
  }
}

预期结果

text
panel 元素仍然存在,但内部所有子元素被删除。

清理节点时要区分删除元素本身和删除元素内部内容。错误地调用 remove() 可能会把容器一起移除,导致后续代码无法继续使用该节点。

删除与替换时的常见边界

DOM 操作通常发生在用户交互之后,因此目标节点可能不存在。直接调用不存在节点的方法会导致运行时错误。

例如:

js
const button = document.querySelector("#submit");
button.remove();

如果页面没有 #submit,会出现类似错误:

text
TypeError: Cannot read properties of null

更安全的写法是在操作前判断节点是否获取成功。

删除适合处理不再需要的内容,替换适合整体更新结构。如果只是改变文本、样式或属性,应优先修改已有节点,避免不必要的 DOM 重建。

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

目录与阅读设置

阅读设置

17

记录一个想法

删除与替换元素

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

登录哪都通