Résumé
Renvoie une copie du nœud courant.
Syntaxe
dupNode =element.cloneNode(profond);
profondest une valeur booléenne obligatoire, elle indique si la copie doit se faire en profondeur ou non (voir les notes ci-dessous).
Exemple
p = document.getElementById("para1");
p_prime = p.cloneNode(true);
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 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 (y 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.
Spécification
- DOM Level 2 Core : cloneNode — traduction en français (non normative)