Skip to main content

Visit Mozilla.org

DOM:element.cloneNode

Un article de MDC.

« Référence du DOM Gecko

Sommaire

[modifier] Résumé

Renvoie une copie du nœud courant.

[modifier] Syntaxe 

dupNode = element.cloneNode(profond);
  • profond est une valeur booléenne obligatoire, elle indique si la copie doit se faire en profondeur ou non (voir les notes ci-dessous).

[modifier] Exemple 

p = document.getElementById("para1"); 
p_prime = p.cloneNode(true);

[modifier] Notes

Cloner un nœud copie tous ses attributs ainsi que leurs valeurs.

Le nœud dupliqué renvoyé par cloneNode ne fera pas partie du document tant qu'il n'y est pas ajouté via la méthode appendChild ou une méthode similaire. De même, il n'aura pas d'élément parent tant qu'il n'a pas été ainsi ajouté à un autre nœud.

Si profond est défini à false, aucun des nœuds enfants n'est copié. Le texte contenu dans le nœud contient n'est pas copié non plus, car il fait partie d'un ou plusieurs nœuds Text enfants.

Si profond est évalué à true, le sous-arbre entier est copié également (en ce compris le texte qui peut être contenu dans des nœuds Text enfants). Pour les nœuds vides (par exemple les éléments img et input) le fait de mettre profond à true ou false n'a aucune incidence sur la copie, mais il est tout de même nécessaire de fournir une valeur.

[modifier] Spécification

Récupérée de « http://developer.mozilla.org/fr/docs/DOM:element.cloneNode »