element.cloneNode

概要

返回当前结点的拷贝。

语法

dupNode = element.cloneNode(deep);

• deep 是一个必需的 boolean 值，指定是否采用深层次克隆（参见下方的 注记）。

示例

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

注记

克隆一个结点会复制它所有的属性及相关的值。

在使用 appendChild 或其他类似的方法添加到另一个结点上之前，cloneNode 返回的拷贝不是 document 的一部分。同样地，在附加到其他结点之前，它没有父结点。

如果 deep 设为 false，则不克隆它的任何子结点。该结点所包含的所有文本也不会被克隆，因为文本被包含于一个或多个 Text 子节点中。

如果 deep 为 true，则复制整棵子树（包含可能会在 Text 子结点中的文本）。对于空结点（例如 IMG 和INPUT 元素），deep 无论设为 true 还是 false 都没有影响，但是仍然要为它指定一个值。

注意 cloneNode 可能会导致一个 document 中有重复的的元素 ID！

要克隆一个结点以附加到不同的 document中，请使用 importNode 代替本方法。

规范

DOM Level 2 Core: cloneNode