Méthode importNode() de l'objet DOM Document HTML

Définition et utilisation

importNode() La méthode importe des nœuds à partir d'un autre document.

le second paramètre est défini sur true les descendants sont également importés.

Lorsque

Astuces

Le nœud importé n'est pas supprimé du document original.

Le nœud importé est une copie du nœud original.

Voir également :

Méthode document.adoptNode()

Méthode element.cloneNode()

Exemple

Importez le premier élément <h1> de l'iframe (un autre document) :
const frame = document.getElementsById("myFrame");
const h1 = frame.contentWindow.document.getElementsByTagName("H1")[0];

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

Essayez-le vous-même

SyntaxeLa méthodedocument.importNode( Le paramètre est un nœud défini dans un autre document, et la valeur de retour est une copie du nœud adaptée à l'insertion dans ce document. Si,

)

) Type
La méthode Paramètre
Le paramètre est un nœud défini dans un autre document, et la valeur de retour est une copie du nœud adaptée à l'insertion dans ce document. Si

Obligatoire. Nœud provenant d'un autre document.

  • Obligatoire.
  • false : ne sont importés que le nœud lui-même.

true : les descendants (descendants) du nœud sont également importés.

Valeur de retour Type
Description nœud

le nœud importé.

lève La méthode Si est un nœud Document ou un nœud DocumentType, et la méthode lève un code NOT_SUPPORTED_ERR

de l'exception DOMException, car ces types de nœuds ne peuvent pas être importés.

Détails techniques La méthode node Le paramètre est un nœud défini dans un autre document, et la valeur de retour est une copie du nœud adaptée à l'insertion dans ce document. Si deep

Lorsque vous importez un nœud Element, seules les propriétés explicitement définies dans le document source sont importées. Lorsque vous importez un nœud Attr, son attribut specified est automatiquement défini sur true. Si la valeur est true, toutes les descendants du nœud sont également copiés. En tout cas, le nœud original et ses descendants ne sont pas modifiés. L'attribut ownerDocument du copié est défini sur le document actuel, mais l'attribut parentNode est null, car il n'a pas été inséré dans le document. Les fonctions d'écouteur d'événements enregistrées sur le nœud original ne sont pas copiées.

Support du navigateur

document.importNode() C'est une caractéristique du niveau DOM 2 (2001).

Tous les navigateurs le supportent :

Chrome IE Edge Firefox Safari Opéra
Chrome IE Edge Firefox Safari Opéra
Support 9-11 Support Support Support Support