element.childNodes

Résumé

Renvoie une collection de nœuds enfants de l'élément donné.

Syntaxe et valeurs

var collNoeuds = elementDeReference.childNodes; 

collNoeuds est une collection ordonnée d'objets node qui sont enfants de l'élément courant. Si l'élément n'a pas d'enfants, collNoeuds ne contiendra aucun nœud.

La variable collNoeuds stocke la liste des nœuds renvoyée par childNodes. Cette liste est de type NodeList. L'attribut childNodes est en lecture seule.

Exemple

// para est une référence à un élément <p>
if (para.hasChildNodes())
// On vérifie d'abord si l'objet n'est pas vide, c.-à-d. s'il a des enfants
{
  var collEnfants = para.childNodes;
  for (var i = 0; i < collEnfants.length; i++) 
  {
   // faire quelque chose avec chaque enfant en tant que collEnfants[i]
   // NOTE : la liste n'est pas une copie, l'ajout ou le retrait 
   // d'éléments modifiera la liste
  }
}

// Voici une manière de supprimer tous les enfants d'un nœud
// (boite est une référence à un élément ayant des enfants)
while( boite.firstChild) {
    // La liste n'est pas une copie, elle sera donc réindexée à chaque appel
    boite.removeChild( boite.firstChild);
}

Notes

Les éléments de la collection sont des objets, et non des chaînes de caractères. Pour en obtenir les données, vous devez utiliser leurs attributs (c'est-à-dire elementDeReference.childNodes[1].nodeName pour obtenir son nom, etc.)

Dans un document HTML, l'objet document lui-même a deux enfants : la déclaration Doctype et l'élément HTML.

Voir aussi

firstChild, lastChild et previousSibling

Spécification

• W3C DOM 2 Core : childNodes — Traduction en français (non normative)
• W3C DOM 3 Core : childNodes
• L'interface NodeList de DOM 3