La propriété en lecture seule  Node.childNodes renvoie une collection 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

Nous convertissons les données de compatibilité dans un format JSON. Ce tableau de compatibilité utilise encore l'ancien format car nous n'avons pas encore converti les données qu'il contient. Vous pouvez nous aider en contribuant !

Fonctionnalité Chrome Edge Firefox (Gecko) Internet Explorer Opera Safari
Basic support 1.0 20 (12.10240) 1.0 (1.7 ou moins) (Oui) (Oui) (Oui)
Fonctionnalité Android Chrome for Android Edge Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
Basic support (Oui) 1.0 20 (12.10240) 1.0 (1.0) (Oui) (Oui) (Oui)

Voir aussi

 

Étiquettes et contributeurs liés au document

Étiquettes : 
 Contributeurs à cette page : loella16, fscholz, teoli, khalid32, time132, Julien STUBY, BenoitL, Mgjbot, Takenbot, GT
 Dernière mise à jour par : loella16,