大网数据广告活动
Web 标准与前端开发

Node.replaceChild()

· 52CE 我爱测

`Node.replaceChild()`** 方法用指定的节点替换当前节点的一个子节点,并返回被替换掉的节点。

DOM

Node.replaceChild() 方法用指定的节点替换当前节点的一个子节点,并返回被替换掉的节点。

语法

replaceChild(newChild, oldChild)

参数

  • newChild
    • : 用来替换 oldChild 的新节点。如果该节点已经存在于 DOM 树中,则它首先会被从原始位置删除。
  • oldChild
    • : 被替换掉的原始节点。

返回值

返回值为被替换的Node,与 oldChild 为同一个节点。

示例

// <div>
//   <span id="childSpan">foo bar</span>
// </div>

// 创建一个空的 span 元素节点
// 没有 id,没有任何属性和内容
const sp1 = document.createElement("span");

// 添加一个 id 属性,值为 'newSpan'
sp1.setAttribute("id", "newSpan");

// 创建一个文本节点
const sp1_content = document.createTextNode("新的 span 元素的内容。");

// 将文本节点插入到 span 元素中
sp1.appendChild(sp1_content);

// 获得被替换节点和其父节点的引用。
const sp2 = document.getElementById("childSpan");
const parentDiv = sp2.parentNode;

// 用新的 span 元素 sp1 来替换掉 sp2
parentDiv.replaceChild(sp1, sp2);

// 结果:
// <div>
//   <span id="newSpan">新的 span 元素的内容。</span>
// </div>

规范

浏览器兼容性

参见

  • Node.removeChild
  • Element.replaceWith

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。