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

Node:cloneNode() 方法

· 52CE 我爱测

Node 接口的 **`cloneNode()`** 方法会返回调用该方法的节点的一个副本。该方法的参数用于控制是否同时克隆节点中包含的子树。

DOM

Node 接口的 cloneNode() 方法会返回调用该方法的节点的一个副本。该方法的参数用于控制是否同时克隆节点中包含的子树。

克隆一个节点会复制它的所有属性及其对应的值,包括内联事件监听器。它不会复制通过 addEventListener() 添加的事件监听器,或赋值给元素属性的事件处理器(例如 node.onclick = someFunction)。此外,对于 canvas 元素,绘制的图像不会被复制。

[!WARNING] cloneNode() 可能会导致文档中出现重复的元素 ID!

如果原始节点具有 id 属性,并且克隆节点将被放置在同一文档中,则应修改克隆节点的 ID 以确保其唯一性。

此外,name 属性可能需要修改,具体取决于是否预期会有重复的名称。

要将节点克隆并插入到另一个文档中,请改用 Document.importNode()。

语法

cloneNode()
cloneNode(deep)

参数

  • deep
    • : 如果为 true,则节点及其整个子树,包括可能存在于 Text 子节点中的文本,也会被复制。

      如果为 false,则仅复制节点本身。子树,包括节点包含的任何文本,将不会被复制。

      请注意,deep 对void element没有影响,例如 img 和 input 元素。

返回值

新的、被克隆的 Node。克隆的节点没有父节点,并且在被添加到文档中其他节点之前,不会成为文档的一部分,直到它通过 Node.appendChild() 或类似的方法被添加到文档中的其他节点。

示例

let p = document.getElementById("para1");
let p_prime = p.cloneNode(true);

规范

浏览器兼容性

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

资料来源与适用范围

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

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

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