Cette page a été traduite à partir de l'anglais par la communauté. Vous pouvez également contribuer en rejoignant la communauté francophone sur MDN Web Docs.

ParentNode.childElementCount

La propriété ParentNode.childElementCount en lecture seule renvoie un unsigned long (long non signé) représentant le nombre d'élèments fils de l'élément donné.

Cette propriété a été définie dans la pure interface ElementTraversal.
Comme cette interface contenait deux différents jeux de propriétés, l'un visant les  Node (noeuds) qui ont des enfants, l'autre les enfants, ils ont été déplacés dans deux interfaces pures, ParentNode et ChildNode. Dans ce cas, childElementCount a été rattaché à ParentNode. C'est un changement assez technique qui ne devrait pas affecter la compatibilité.

Syntaxe

var count = node.childElementCount;
count
détient la valeur de retour, un type unsigned long (long non signé) (simplement un nombre entier)
node
est un objet représentant un Document, un DocumentFragment ou un Element.

Exemple

var foo = document.getElementById("foo");
if (foo.childElementCount > 0) {
    // faire quelque chose
}

Polyfill pour IE8 & IE9 & Safari

Cette propriété n'est pas supportée par les versions antérieures à IE9 ni par IE9 ni par Safari. Ainsi, les objets Document, DocumentFragment dans ces navigateurs ne l'ont pas.

;(function(constructor) {
    if (constructor &&
        constructor.prototype &&
        constructor.prototype.childElementCount == null) {
        Object.defineProperty(constructor.prototype, 'childElementCount', {
            get: function() {
                var i = 0, count = 0, node, nodes = this.childNodes;
                while (node = nodes[i++]) {
                    if (node.nodeType === 1) count++;
                }
                return count;
            }
        });
    }
})(window.Node || window.Element);

Spécification

Spécification Statut Commentaire
DOM
La définition de 'ParentNode.childElementCount' dans cette spécification.		 Standard évolutif Divise l'interface ElementTraversal en ChildNode et ParentNode. La propriété est maintenant définie sur cette dernière.
Les Document et DocumentFragment implémentent la nouvelle interface.
Element Traversal Specification
La définition de 'ElementTraversal.childElementCount' dans cette spécification.		 Obsolete Ajout de sa définition initiale à la pure interface ElementTraversal et de son utilisation sur Element.

Compatibilité des navigateurs

No compatibility data found for api.ParentNode.childElementCount.
Check for problems with this page or contribute missing data to mdn/browser-compat-data.

Voir aussi