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

document.importNode

· 52CE 我爱测

`externalNode` - : 导入当前文档的外部 Node 或 DocumentFragment。 - `deep` - : 一个布尔值,默认为 `false`。表明是否要导入 `externalNode` 的整个 DOM 子树。 - `deep` 设置为 `true`,则拷贝 `externalNode` 和它的所有后代。 - `deep` 设置为 `false`,则仅拷贝 `externalNode`——新的节点没有后代。

DOM

将外部文档的一个节点拷贝一份,然后可以把这个拷贝的节点插入到当前文档中。

语法

importNode(externalNode)
importNode(externalNode, deep)
  • externalNode
    • : 导入当前文档的外部 Node 或 DocumentFragment。
  • deep
    • : 一个布尔值,默认为 false。表明是否要导入 externalNode 的整个 DOM 子树。
      • deep 设置为 true,则拷贝 externalNode 和它的所有后代。
      • deep 设置为 false,则仅拷贝 externalNode——新的节点没有后代。

示例

const iframe = document.querySelector("iframe");
const oldNode = iframe.contentWindow.document.getElementById("myNode");
const newNode = document.importNode(oldNode, true);
document.getElementById("container").appendChild(newNode);

备注

源节点不会从外部文档中删除,被导入的节点是源节点的一个拷贝。

将外部文档的节点插入当前文档之前,你必须使用 document.importNode() 从外部文档导入源节点,或者使用 document.adoptNode()导入源节点,想要了解更多的 Node.ownerDocument 问题,请参考 W3C DOM FAQ.

即使你不执行导入动作,就执行插入外部文档中的节点.Firefox 目前也不会报错 (如果严格按标准执行,很多已有的网站都无法正常运行). 我们鼓励开发者严格按标准修改自己已有的不符合上述标准的代码。

浏览器兼容性

规范

参见

  • document.adoptNode()

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

资料来源与适用范围

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

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

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