HTMLAllCollection
Obsolète: Cette fonctionnalité n'est plus recommandée. Même si certains navigateurs la prennent encore en charge, elle a peut-être déjà été supprimée des standards du web, est en passe d'être supprimée ou n'est conservée qu'à des fins de compatibilité. Évitez de l'utiliser et mettez à jour le code existant si possible ; consultez le tableau de compatibilité au bas de cette page pour vous aider à prendre votre décision. Sachez que cette fonctionnalité peut cesser de fonctionner à tout moment.
L'interface HTMLAllCollection représente une collection de tous les éléments du document, accessibles par index (comme un tableau) et par un id d'élément. Elle est retournée par la propriété document.all.
HTMLAllCollection a une forme très similaire à HTMLCollection, mais il existe de nombreuses différences subtiles de comportement — par exemple, HTMLAllCollection peut être appelé comme une fonction, et sa méthode item() peut être appelée avec une chaîne de caractères représentant l'attribut id ou name d'un élément.
Propriétés d'instance
HTMLAllCollection.lengthLecture seule-
Retourne le nombre d'éléments dans la collection.
Méthodes d'instance
HTMLAllCollection.item()-
Retourne l'élément situé au décalage défini dans la collection, ou l'élément dont la valeur de l'attribut
idounamecorrespond à la chaîne de caractères donnée. Retournenullsi aucun élément n'est trouvé. HTMLAllCollection.namedItem()-
Retourne le premier élément de la collection dont l'attribut
idounamecorrespond à la chaîne de caractères donnée, ounullsi aucun élément ne correspond.
Utiliser dans JavaScript
Accès indexé
En plus des méthodes ci-dessus, les éléments d'une HTMLAllCollection peuvent être accessibles par des indices entiers et des noms de propriétés sous forme de chaînes de caractères. L'attribut HTML id peut contenir : et . comme caractères valides, ce qui nécessiterait l'utilisation de la notation entre crochets pour l'accès aux propriétés. collection[i] est équivalent à collection.item(i), où i peut être un entier, une chaîne de caractères contenant un entier ou une chaîne de caractères représentant un id.
Appeler comme une fonction
Un objet HTMLAllCollection est appelable. Lorsqu'il est appelé sans arguments ou avec undefined, il retourne null. Sinon, il retourne la même valeur que la méthode item() lorsqu'elle est appelée avec les mêmes arguments.
Comportement spécial de conversion de type
Pour des raisons historiques, document.all est un objet qui se comporte de la manière suivante comme undefined :
- Il est faiblement égal à
undefinedetnull. - Il est équivalent à faux dans les contextes booléens.
- Son
typeofest"undefined".
Ces comportements spéciaux garantissent que le code suivant :
if (document.all) {
// En supposant que nous sommes dans IE ; fournir une logique spéciale
}
// En supposant que nous sommes dans un navigateur moderne
Ces comportements garantissent que le code continue de fonctionner correctement même si le code est exécuté dans un navigateur qui implémente document.all pour des raisons de compatibilité.
Cependant, dans tous les autres contextes, document.all reste un objet. Par exemple :
- Il n'est pas strictement égal à
undefinedounull. - Lorsqu'il est utilisé sur le côté gauche de l'opérateur de coalescence nulle (
??) ou de l'opérateur de chaînage optionnel (?.), il ne provoquera pas l'arrêt prématuré de l'expression.
Spécifications
| Spécification |
|---|
| HTML # the-htmlallcollection-interface |
Compatibilité des navigateurs
Voir aussi
- L'interface
HTMLCollection