element.removeChild

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);
}

Spécification

• DOM Level 1 Core: removeChild — traduction en français (non normative)
• DOM Level 2 Core: removeChild — traduction en français (non normative)