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