Name
Document.importNode( ): copy a node from another document for use in this document — DOM Level 2 Core:
Synopsis
Node importNode(NodeimportedNode, booleandeep) throws DOMException;
Arguments
-
importedNode The node to be imported.
-
deep If
true, recursively copy all descendants ofimportedNodeas well.
Returns
A copy of importedNode (and
possibly all of its descendants) with its ownerDocument set to this
document.
Throws
This method throws a DOMException with a code of NOT_SUPPORTED_ERR if
importedNode is a Document or
DocumentType node, because those types of nodes cannot be
imported.
Description
This method is passed a node defined in another document and
returns a copy of the node that is suitable for insertion into this
document. If deep is true, all descendants of the node are also
copied. The original node and its descendants are not modified in
any way. The returned copy has its ownerDocument property set to this
document but has a parentNode of
null because it has not yet been
inserted into the document. Event-listener functions registered on
the original node or tree are not copied.
When an Element node is imported, only the attributes that are
explicitly specified in the source document are imported with it.
When an Attr node is imported, its specified property is automatically set to
true.
See Also
Node.cloneNode( )
Become an O’Reilly member and get unlimited access to this title plus top books and audiobooks from O’Reilly and nearly 200 top publishers, thousands of courses curated by job role, 150+ live events each month,
and much more.
Read now
Unlock full access