Node.appendChild - Web API 接口参考 编辑

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

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

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

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

语法

element.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);

规范

规范状态备注
DOM
Node.appendChild()
Living Standard 未对Document Object Model (DOM) Level 3 Core Specification进行更改
Document Object Model (DOM) Level 3 Core Specification
Node.appendChild()
Obsolete 未对Document Object Model (DOM) Level 2 Core Specification进行更改
Document Object Model (DOM) Level 2 Core Specification
Node.appendChild()
Obsolete 未对Document Object Model (DOM) Level 1 Specification进行更改
Document Object Model (DOM) Level 1 Specification
Node.appendChild()
ObsoleteInitial definition.

浏览器兼容性

BCD tables only load in the browser

The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.

参见

如果你对这篇内容有疑问,欢迎到本站社区发帖提问 参与讨论,获取更多帮助,或者扫码二维码加入 Web 技术交流群。

扫码二维码加入Web技术交流群

发布评论

需要 登录 才能够评论, 你可以免费 注册 一个本站的账号。
列表为空,暂无数据

词条统计

浏览:92 次

字数:6333

最后编辑:7 年前

编辑次数:0 次

    我们使用 Cookies 和其他技术来定制您的体验包括您的登录状态等。通过阅读我们的 隐私政策 了解更多相关信息。 单击 接受 或继续使用网站,即表示您同意使用 Cookies 和您的相关数据。
    原文