element.removeChild

  • Raccourci de la révision : DOM/element.removeChild
  • Titre de la révision : element.removeChild
  • ID de la révision : 120894
  • Créé :
  • Créateur : Julien STUBY
  • Version actuelle ? Non
  • Commentaire no wording changes

Contenu de la révision

{{ DomRef() }}

Résumé

Retire un nœud enfant de l'abre DOM.

Syntaxe

ancienEnfant = element.removeChild(enfant) 
  • enfant est le nœud enfant à retirer du DOM.
  • element est le nœud parent de enfant.
  • ancienEnfant conserve une référence au nœud enfant retiré. ancienEnfant == enfant.

Le nœud retiré existe toujours en mémoire, mais ne fait plus partie du DOM. Il peut être réutilisé plus tard dans votre code, via la référence à l'objet ancienEnfant.

Si enfant n'est en fait pas un enfant du nœud element, la méthode provoque une exception.

Exemple

// <div id="haut" align="center">
//   <div id="interne"></div> 
// </div>

var d = document.getElementById("haut"); 
var d_interne = document.getElementById("interne"); 
var anciennoeud = d.removeChild(d_interne);
// retire tous les enfants d'un élément
var element = document.getElementById("haut");
while (element.firstChild) {
  element.removeChild(element.firstChild);
}
// retire un element par son id
var element = document.getElementById("element_a_supprimer");
element.parentNode.removeChild(element);

Spécification

{{ languages( { "en": "en/DOM/element.removeChild", "ja": "ja/DOM/element.removeChild", "pl": "pl/DOM/element.removeChild" } ) }}

Source de la révision

<p>{{ DomRef() }}</p>
<h3 name="R.C3.A9sum.C3.A9">Résumé</h3>
<p>Retire un nœud enfant de l'abre DOM.</p>
<h3 name="Syntaxe">Syntaxe</h3>
<pre class="eval"><em>ancienEnfant</em> = <em>element</em>.removeChild(<em>enfant</em>) 
</pre>
<ul> <li><code>enfant</code> est le nœud enfant à retirer du DOM.</li> <li><code>element</code> est le nœud parent de <code>enfant</code>.</li> <li><code>ancienEnfant</code> conserve une référence au nœud enfant retiré. <code>ancienEnfant</code> == <code>enfant</code>.</li>
</ul>
<p>Le nœud retiré existe toujours en mémoire, mais ne fait plus partie du DOM. Il peut être réutilisé plus tard dans votre code, via la référence à l'objet <code>ancienEnfant</code>.</p>
<p>Si <code>enfant</code> n'est en fait pas un enfant du nœud <code>element</code>, la méthode provoque une exception.</p>
<h3 name="Exemple">Exemple</h3>
<pre>// &lt;div id="haut" align="center"&gt;
//   &lt;div id="interne"&gt;&lt;/div&gt; 
// &lt;/div&gt;

var d = document.getElementById("haut"); 
var d_interne = document.getElementById("interne"); 
var anciennoeud = d.removeChild(d_interne);
</pre>
<pre>// retire tous les enfants d'un élément
var element = document.getElementById("haut");
while (element.firstChild) {
  element.removeChild(element.firstChild);
}</pre>
<pre>// retire un element par son id
<a href="mks://localhost/fr/Référence_de_JavaScript_1.5_Core/Instructions/var" title="fr/Référence de JavaScript 1.5 Core/Instructions/var">var</a> element = <a href="mks://localhost/fr/DOM/document" title="fr/DOM/document">document</a>.<a href="mks://localhost/fr/DOM/document.getElementById" title="fr/DOM/document.getElementById">getElementById</a>("element_a_supprimer");
element.<a href="mks://localhost/fr/DOM/element.parentNode" title="fr/DOM/element.parentNode">parentNode</a>.<a href="mks://localhost/fr/DOM/element.removeChild" title="fr/DOM/element.removeChild">removeChild</a>(element);
</pre><h3 name="Sp.C3.A9cification">Spécification</h3>
<ul> <li><a class="external" href="http://www.w3.org/TR/REC-DOM-Level-1/level-one-core.html#method-removeChild">DOM Level 1 Core: removeChild</a> — <a class="external" href="http://xmlfr.org/w3c/TR/REC-DOM-Level-1/level-one-core.html#method-removeChild">traduction en français</a> (non normative)</li> <li><a class="external" href="http://www.w3.org/TR/DOM-Level-2-Core/core.html#ID-1734834066">DOM Level 2 Core: removeChild</a> — <a class="external" href="http://www.yoyodesign.org/doc/w3c/dom2/core/core.html#ID-1734834066">traduction en français</a> (non normative)</li>
</ul> <p>{{ languages( { "en": "en/DOM/element.removeChild", "ja": "ja/DOM/element.removeChild", "pl": "pl/DOM/element.removeChild" } ) }}</p>
Revenir à cette révision