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

View in English Always switch to English

Document : propriété images

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 juin 2018.

La propriété en lecture seule images de l'interface Document retourne une collection des images dans le document HTML courant.

Valeur

Une collection (HTMLCollection) fournissant une liste dynamique de toutes les images contenues dans le document courant. Chaque entrée de la collection est un HTMLImageElement représentant un élément image unique.

Notes d'utilisation

Vous pouvez utiliser soit la notation de tableau JavaScript, soit la méthode item() sur la collection retournée pour accéder aux éléments de la collection. Les deux exemples suivants sont équivalents :

js
firstImage = imageCollection.item(0);

firstImage = imageCollection[0];

Exemples

Cet exemple parcourt la liste des images et trouve celles nommées "banner.gif".

js
for (const image of document.images) {
  if (image.src === "banner.gif") {
    console.log("Bannière trouvée");
  }
}

Spécifications

Specification
HTML
# dom-document-images-dev

Compatibilité des navigateurs