Método importNode() do DOM HTML

定义和用法

definição e uso importNode()

o método importa nós de outro documento. o segundo parâmetro é definido como true

ao importar, os descendentes também serão importados.

Dica

O nó importado não será removido do documento original.

O nó importado é uma cópia do nó original.

Veja também:

método document.adoptNode()

método element.cloneNode()

instância

Importar o primeiro <h1> do iframe (outro documento):
const frame = document.getElementsById("myFrame");
const h1 = frame.contentWindow.document.getElementsByTagName("H1")[0];

const node = document.importNode(h1, true);

Experimente você mesmo

sintaxeo métododocument.importNode( O parâmetro é um nó definido em outro documento, e o valor retornado é uma cópia do nó adequada para ser inserida no documento. Se,

)

) tipo
o método parâmetro
O parâmetro é um nó definido em outro documento, e o valor retornado é uma cópia do nó adequada para ser inserida no documento. Se

necessário. Nó proveniente de outro documento.

  • necessário.
  • false: apenas o nó em si será importado.

true: os descendentes (filhos) também serão importados.

retorno tipo
descrição nó

o nó importado.

lançar o método se é nó Document ou nó DocumentType, o método lançará um código de NOT_SUPPORTED_ERR

da exceção DOMException, pois não é possível importar esses tipos de nós.

detalhes técnicos o método node O parâmetro é um nó definido em outro documento, e o valor retornado é uma cópia do nó adequada para ser inserida no documento. Se deep

Quando importar um nó Elemento, apenas os atributos explicitamente definidos no documento de origem serão importados. Quando importar um nó Attr, automaticamente seu atributo specified será definido como true. Se o valor for true, então também serão copiados todos os descendentes do nó. De qualquer maneira, o nó original e seus descendentes não serão modificados. O atributo ownerDocument do cópia retornado será definido como o documento atual, mas o atributo parentNode será null, pois ainda não foi inserido no documento. As funções de ouvinte de eventos registradas no nó original não serão copiadas.

Suporte do navegador

document.importNode() é uma característica do DOM Level 2 (2001).

Todos os navegadores suportam isso:

Chrome IE Edge Firefox Safari Ópera
Chrome IE Edge Firefox Safari Ópera
Suporte 9-11 Suporte Suporte Suporte Suporte