element.cloneNode

  • Raccourci de la révision : DOM/element.cloneNode
  • Titre de la révision : element.cloneNode
  • ID de la révision : 177707
  • Créé :
  • Créateur : Mgjbot
  • Version actuelle ? Non
  • Commentaire robot Ajoute: [[pt:DOM:element.cloneNode]] <<langbot>>

Contenu de la révision

{{template.DomRef()}}

Résumé

Renvoie une copie du nœud courant.

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).

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 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.

Spécification

{{ wiki.languages( { "en": "en/DOM/element.cloneNode", "pl": "pl/DOM/element.cloneNode", "pt": "pt/DOM/element.cloneNode" } ) }}

Source de la révision

<p>
{{template.DomRef()}}
</p>
<h3 name="R.C3.A9sum.C3.A9"> Résumé </h3>
<p>Renvoie une copie du nœud courant.
</p>
<h3 name="Syntaxe"> Syntaxe </h3>
<pre class="eval"><i>dupNode</i> = <i>element</i>.cloneNode(<i>profond</i>);
</pre>
<ul><li> <code>profond</code> est une valeur booléenne obligatoire, elle indique si la copie doit se faire en profondeur ou non (voir les <a href="#Notes">notes</a> ci-dessous).
</li></ul>
<h3 name="Exemple"> Exemple </h3>
<pre>p = document.getElementById("para1"); 
p_prime = p.cloneNode(true);
</pre>
<h3 name="Notes"> Notes </h3>
<p>Cloner un nœud copie tous ses attributs ainsi que leurs valeurs.
</p><p>Le nœud dupliqué renvoyé par <code>cloneNode</code> ne fera pas partie du document tant qu'il n'y est pas ajouté via la méthode <a href="fr/DOM/element.appendChild">appendChild</a> 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.
</p><p>Si <code>profond</code> est défini à <code>false</code>, aucun des nœuds enfants n'est copié. <i>Le texte contenu dans le nœud contient n'est pas copié non plus</i>, car il fait partie d'un ou plusieurs nœuds <code>Text</code> enfants.
</p><p>Si <code>profond</code> est évalué à <code>true</code>, le sous-arbre entier est copié également (en ce compris le texte qui peut être contenu dans des nœuds <code>Text</code> enfants). Pour les nœuds vides (par exemple les éléments <code>img</code> et <code>input</code>) le fait de mettre <code>profond</code> à <code>true</code> ou <code>false</code> n'a aucune incidence sur la copie, mais il est tout de même nécessaire de fournir une valeur.
</p>
<h3 name="Sp.C3.A9cification"> Spécification </h3>
<ul><li> <a class="external" href="http://www.w3.org/TR/DOM-Level-2-Core/core.html#ID-3A0ED0A4">DOM Level 2 Core : cloneNode</a> — <small><a class="external" href="http://www.yoyodesign.org/doc/w3c/dom2-core/core.html#ID-3A0ED0A4">traduction en français</a> (non normative)</small>
</li></ul>
<div class="noinclude">
</div>
{{ wiki.languages( { "en": "en/DOM/element.cloneNode", "pl": "pl/DOM/element.cloneNode", "pt": "pt/DOM/element.cloneNode" } ) }}
Revenir à cette révision