element.childNodes

La propriété en lecture seule  Node.childNodes renvoie une NodeList (liste de noeuds) de noeuds enfants de l'élément donné avec le premier noeud enfant affecté à l'index 0.

Syntaxe

var collNoeuds = elementDeReference.childNodes;

Exemples

Utilisation simple

// parg est une référence d'objet pour un élément <p>

// D'abord vérifier que l'élément a des noeuds enfants
if (parg.hasChildNodes()) {
  var children = parg.childNodes;

  for (var i = 0; i < children.length; i++) {
    // faire quelque chose avec chaque enfant[i]
    // NOTE: La liste est en ligne, l'ajout ou la suppression des enfants changera la liste
  }
}

Supprimer tous les enfants d'un nom

// 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 de noeuds sont des objets et non des chaînes de caractères. Pour en obtenir les données, vous devez utiliser leurs propriétés (par exemple elementNodeReference.childNodes[1].nodeName pour obtenir son nom, etc.)

L'objet document lui-même a deux enfants : la déclaration Doctype et l'élément racine, généralement appelés  documentElement . (Dans les documents (X)HTML il s'agit d'éléments  HTML).

childNodes  inclut tous les noeuds enfants, y compris les noeuds qui ne sont pas des éléments comme les noeuds texte et commentaire. Pour obtenir une collection des seuls éléments, utilisez ParentNode.children à la place.

Spécification

Spécification Statut Commentaire
DOM
La définition de 'Node.childNodes' dans cette spécification.
Standard évolutif Pas de changement
Document Object Model (DOM) Level 3 Core Specification
La définition de 'Node.childNodes' dans cette spécification.
Obsolete Pas de changement
Document Object Model (DOM) Level 2 Core Specification
La définition de 'Node.childNodes' dans cette spécification.
Obsolete Pas de changement
Document Object Model (DOM) Level 1 Specification
La définition de 'Node.childNodes' dans cette spécification.
Obsolete Définition initiale

Compatibilité des navigateurs

BCD tables only load in the browser

Voir aussi