document.importNode

Résumé

importNode renvoie le clone d'un nœud provenant d'un autre document.

Syntaxe

noeud = document.importNode(noeudExterne, profondeur) 

Paramètres

• noeudExterne est le nœud à importer d'un autre document.
• profondeur est soit true soit false. Dans le premier cas le nœud sera importé avec tous ses enfants. Dans le second, le nœud sera importé sans aucun de ses enfants.

Valeur de retour

• noeud est le nouveau nœud qui a été importé dans le document. Son nœud parent parentNode est null, étant donné qu'il n'a pas encore été inséré dans l'arbre du document.

Exemple

var iframe = document.getElementsByTagName("iframe")[0];
var ancienNoeud = iframe.contentDocument.getElementById("monNoeud");
var nouveauNoeud = document.importNode(ancienNoeud, true);
document.getElementById("conteneur").appendChild(nouveauNoeud);

Notes

Le nœud n'est pas retiré de son document d'origine. Le nœud importé est un clone de l'original. Les nœuds provenant d'autres documents doivent toujours être importés avant de pouvoir être insérés dans le document courant.

Spécification

• Spécification DOM Level 2 Core : importNode
• Traduction en français (non normative) : importNode