DOM
Document.adoptNode() 将node/dom从另一个Document转移至调用该方法的文档中。被转移的节点及其子树将会从原始文档(如果存在的话)中移除,并且它们的 Node.ownerDocument 会变更为当前文档。然后节点将被插入到当前文档中。
语法
adoptNode(externalNode)
参数
externalNode- : 将要从另一份文档中转移的节点。
返回值
在导入文档的作用域中复制的 importedNode。
调用此方法后,importedNode 和 externalNode 是同个对象。
[!NOTE]
importedNode的 Node.parentNode 为null,因为它尚未插入文档树中!
示例
const iframe = document.querySelector("iframe");
const iframeImages = iframe.contentDocument.querySelectorAll("img");
const newParent = document.getElementById("images");
iframeImages.forEach((imgEl) => {
newParent.appendChild(document.adoptNode(imgEl));
});
备注
在将来自外部文档的节点插入到当前文档之前,应该先进行以下操作之一:
- 使用 document.importNode() 进行克隆;或
- 使用
document.adoptNode()进行转移。
有关 Node.ownerDocument 问题的更多信息,请参阅 W3C DOM 常见问题。
规范
浏览器兼容性
参见
- document.importNode()
来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。
