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

Node.appendChild

· 52CE 我爱测

`Node.appendChild()`** 方法将一个节点附加到指定父节点的子节点列表的末尾处。如果将被插入的节点已经存在于当前文档的文档树中,那么 `appendChild()` 只会将它从原先的位置移动到新的位置(不需要事先移除要移动的节点)。

DOM

Node.appendChild() 方法将一个节点附加到指定父节点的子节点列表的末尾处。如果将被插入的节点已经存在于当前文档的文档树中,那么 appendChild() 只会将它从原先的位置移动到新的位置(不需要事先移除要移动的节点)。

这意味着,一个节点不可能同时出现在文档的不同位置。所以,如果某个节点已经拥有父节点,在被传递给此方法后,它首先会被移除,再被插入到新的位置。若要保留已在文档中的节点,可以先使用 Node.cloneNode() 方法来为它创建一个副本,再将副本附加到目标父节点下。请注意,用 cloneNode 制作的副本不会自动保持同步。

如果给定的子节点是 DocumentFragment,那么 DocumentFragment 的全部内容将转移到指定父节点的子节点列表中。

[!NOTE] 有更加新的 API 可供使用!ParentNode.append() 方法支持多个参数,接受字符串作为参数,会将字符串转换为文本节点再附加。

语法

appendChild(aChild)

参数

  • aChild
    • : 要追加给父节点(通常为一个元素)的节点。

返回值

返回追加后的子节点(aChild),除非 aChild 是一个文档片段(DocumentFragment),这种情况下将返回空文档片段(DocumentFragment)。

附注

如果你需要保留这个子节点在原先位置的显示,则你需要先用Node.cloneNode方法复制出一个节点的副本,然后在插入到新位置。

这个方法只能将某个子节点插入到同一个文档的其他位置,如果你想跨文档插入,你需要先调用document.importNode方法。

备注

由于 appendChild() 返回的是被附加的子元素,所以链式调用可能无法按照你的预期去执行:

let aBlock = document
  .createElement("block")
  .appendChild(document.createElement("b"));

(上述代码)只会将 aBlock 设置为 <b></b> ,这可能不是你所想要的。

示例

// 创建一个新的段落元素 <p>,然后添加到 <body> 的最尾部
var p = document.createElement("p");
document.body.appendChild(p);

规范

浏览器兼容性

参见

  • Node.removeChild
  • Node.replaceChild
  • Node.insertBefore
  • Node.hasChildNodes

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

资料来源与适用范围

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

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

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