Metodo importNode() del Documento DOM HTML

Definizione e uso

importNode() Il metodo importa nodi da un altro documento.

Il secondo parametro viene impostato su true anche i nodi figli vengono importati.

Suggerimento

Il nodo importato non viene rimosso dal documento originale.

Il nodo importato è una copia del nodo originale.

Vedi anche:

Metodo document.adoptNode()

Metodo element.cloneNode()

Esempio

Importa il primo <h1> elemento da iframe (un altro documento):

const frame = document.getElementsById("myFrame");
const h1 = frame.contentWindow.document.getElementsByTagName("H1")[0];
const node = document.importNode(h1, true);

Prova a fare tu stesso

Sintassi

document.importNode(node, deep)

Parametro

Parametro Descrizione
node Obbligatorio. Nodo proveniente da un altro documento.
deep

Obbligatorio.

  • false: viene importato solo il nodo stesso.
  • true: anche i nodi figli (discendenti) vengono importati.

Valore restituito

Tipo Descrizione
Nodo nodo importato.

lancia

Se node È un nodo Document o nodo DocumentType, il metodo lancia un codice di NOT_SUPPORTED_ERR L'eccezione DOMException, poiché è impossibile importare questo tipo di nodo.

Dettagli tecnici

Metodo node Il parametro è un nodo definito in un altro documento, il valore restituito è un duplicato del nodo adatto per essere inserito in questo documento. Se deep Se il valore è true, devono essere copiati tutti i nodi discendenti del nodo. In ogni caso, il nodo originale e i suoi nodi discendenti non vengono modificati. L'attributo ownerDocument del duplicato restituito viene impostato sul documento corrente, ma l'attributo parentNode è null perché non è stato ancora inserito nel documento. Le funzioni di ascolto degli eventi registrate nelbero del nodo originale non vengono copiate.

Quando si importano nodi Element, solo le proprietà impostate espressamente nel documento sorgente vengono importate. Quando si importano nodi Attr, l'attributo specified viene automaticamente impostato su true.

Supporto del browser

document.importNode() È una caratteristica di DOM Level 2 (2001).

Tutti i browser lo supportano:

Chrome IE Edge Firefox Safari Opera
Chrome IE Edge Firefox Safari Opera
Supporto 9-11 Supporto Supporto Supporto Supporto