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écifications
Specification |
---|
DOM Standard # ref-for-dom-node-childnodes① |
Compatibilité des navigateurs
BCD tables only load in the browser