HTMLCollection : méthode item()
Baseline
Widely available
Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis juillet 2015.
La méthode item() de l'interface HTMLCollection retourne l'élément situé à la position définie dans la collection.
Note :
Parce que le contenu d'une HTMLCollection est dynamique, les modifications du DOM sous-jacent peuvent modifier la position des éléments individuels dans la collection, de sorte que la valeur de l'index ne restera pas nécessairement constante pour un même élément.
Syntaxe
item(index)
Paramètres
Valeur de retour
L'objet Element à la position définie, ou null si index est inférieur à zéro ou supérieur ou égal à la valeur de la propriété length.
Notes d'utilisation
La méthode item() retourne un élément numéroté d'une HTMLCollection. En JavaScript, il est plus simple de traiter la HTMLCollection comme un tableau et d'y accéder avec la notation crochets. Voir l'exemple ci‑dessous.
Exemples
const images = document.images; // Ceci est une HTMLCollection.
const img0 = images.item(0); // Vous pouvez utiliser la méthode item comme ceci
const img1 = images[1]; // Mais cette notation est plus simple et plus commune
Spécifications
| Specification |
|---|
| DOM # ref-for-dom-htmlcollection-item① |
Compatibilité des navigateurs
Voir aussi
- La méthode
NodeList.item()