Método importNode() do XML DOM

Manual de referência do objeto Document

Definição e uso

O método importNode() copia um nó de outro documento para o documento atual para aplicação.

Sintaxe:

importNode(importedNode,}deep)
Parâmetro Descrição
importedNode Nó a ser importado.
deep se for true, também será copiado recursivamente todos os descendentes do nó importedNode.

Retorno

importedNode uma cópia (possivelmente seus descendentes), com o atributo ownerDocument definido para o documento.

lançar

se importedNode é nó Document ou nó DocumentType, o método lançará uma exceção NOT_SUPPORTED_ERR com código Exceção DOMExceptionporque não é possível importar esses tipos de nós.

Descrição

O parâmetro deste método é o nó definido em outro documento, e o valor retornado é a cópia do nó adequada para ser inserida no documento. Se deep Se o valor for true, também será copiado todos os descendentes do nó. De qualquer forma, o nó original e seus descendentes não serão modificados.

O atributo ownerDocument do cópia retornada é definido como o documento atual, mas o atributo parentNode é null, pois ainda não foi inserido no documento. As funções de ouvinte de eventos registradas no nó original ou na árvore não serão copiadas.

Quando importar o nó Element, apenas os atributos explicitamente definidos no documento de origem serão importados. Quando importar o nó Attr, o atributo specified será automaticamente definido como true.

Ver

Node.cloneNode()

Manual de referência do objeto Document