Méthode importNode() de XML DOM

Manuel de référence de l'objet Document

Définition et utilisation

La méthode importNode() de XML DOM copie un nœud d'un autre document dans le document courant pour l'application.

Grammaire :

importNode(importedNode,deep)
Paramètres Description
importedNode Nœud à importer.
deep si true, il faudra également recopier tous les descendants du nœud importedNode.

Valeur de retour

importedNode duplicata du (peut-être avec ses descendants) et l'attribut ownerDocument de ce duplicata est réglé sur ce document.

lève

si importedNode est un nœud Document ou un nœud DocumentType, cette méthode lève une exception de code NOT_SUPPORTED_ERR. Exception DOMExceptionparce qu'il est impossible d'importer ces types de nœuds.

Description

Le paramètre de cette méthode est un nœud défini dans un autre document, et la valeur de retour est un duplicata du nœud adapté à l'insertion dans ce document. Si deep Si la valeur est true, il faudra également copier tous les descendants du nœud. De toute manière, le nœud original et ses descendants ne seront pas modifiés.

L'attribut ownerDocument du duplicata retourné est défini sur le document actuel, mais l'attribut parentNode est null, car il n'a pas encore été inséré dans le document. Les fonctions d'écouteur d'événements enregistrées sur le nœud original ou dans l'arbre ne seront pas copiées.

Lorsque vous importez un nœud Element, seules les propriétés explicitement définies dans le document source seront importées. Lorsque vous importez un nœud Attr, son attribut specified sera automatiquement défini sur true.

Voir

Node.cloneNode()

Manuel de référence de l'objet Document