<img>

Une image intégrée à la page.

Affichage
inline (élément remplacé)
Balise fermante
Aucune, élément vide
Contenu autorisé
Aucun, élément vide
Sur cette page

Exemple

#
HTML
<img
  src="/collections/covers/jak-zostac-programista.webp"
  alt="Une personne avec un sac à dos marche sur un chemin vers une ville au crépuscule"
  width="320"
  height="213"
>
Aperçu

Définition et utilisation

#

L’élément <img> insère une image. C’est un élément vide (il n’a pas de balise fermante), et c’est l’attribut src qui décide de ce qui s’affiche. Les formats pris en charge comprennent notamment JPEG, PNG, GIF, SVG, WebP et AVIF.

L’attribut alt est obligatoire. C’est le texte qu’un lecteur d’écran lit à la place de l’image, et celui qui s’affiche lorsque l’image ne se charge pas. Pour les images purement décoratives, laissez-le vide (alt="") : les technologies d’assistance l’ignoreront.

Indiquez toujours width et height. Le navigateur réserve alors la place de l’image avant son téléchargement, et le contenu de la page ne saute pas pendant le chargement. Vous pourrez ensuite modifier la taille d’affichage en CSS.

Syntaxe

#
Syntaxe
<img src="adresse-de-l-image" alt="description de l’image" width="…" height="…">

Attributs

#
  • src

    URL

    L’adresse du fichier image. C’est le seul attribut sans lequel l’image ne s’affiche pas du tout.
  • alt

    texte

    Le texte alternatif. Décrivez ce qui figure sur l’image et pourquoi elle est là. Quand le fichier ne se charge pas, c’est ce texte que vous voyez, comme dans l’exemple avec une adresse invalide.
  • width / height

    nombre de pixels

    Les dimensions intrinsèques de l’image en pixels, sans unité. Elles permettent au navigateur de connaître les proportions de l’image avant de la télécharger, et d’éviter de décaler le contenu.
  • loading

    eager | lazy

    lazy retarde le téléchargement de l’image jusqu’à ce qu’elle approche de la partie visible de la page. C’est une façon simple d’économiser de la bande passante pour les images situées sous le premier écran. Ne marquez pas comme lazy une image visible dès l’arrivée sur la page.
  • srcset

    liste d’adresses avec une largeur ou une densité

    Un ensemble de versions de la même image en différentes tailles. Le navigateur choisit la meilleure pour l’écran, par exemple image-2x.png 2x pour les écrans à haute densité de pixels.
  • sizes

    liste de conditions et de largeurs

    Fonctionne avec un srcset fondé sur les largeurs (800w). Il indique au navigateur quelle sera la largeur de l’image dans la page selon la largeur de la fenêtre, par exemple (min-width: 768px) 50vw, 100vw.
  • decoding

    sync | async | auto

    Une indication précisant si le décodage de l’image peut se faire indépendamment du reste de la page. async permet d’afficher le contenu sans attendre l’image.
  • fetchpriority

    high | low | auto

    Suggère l’urgence du téléchargement de l’image. Il vaut la peine de mettre high sur l’image principale en haut de la page pour qu’elle apparaisse plus vite.

L’élément accepte aussi tous les attributs globaux, comme class, id, style ou hidden.

Attributs en pratique

#

src

URL

L’adresse du fichier image. C’est le seul attribut sans lequel l’image ne s’affiche pas du tout.

HTML
<img src="/collections/covers/vibe-coding.webp" alt="Un développeur avec un casque devant un écran" width="240" height="160">
Aperçu

alt

texte

Le texte alternatif. Décrivez ce qui figure sur l’image et pourquoi elle est là. Quand le fichier ne se charge pas, c’est ce texte que vous voyez, comme dans l’exemple avec une adresse invalide.

HTML
<img src="data:," alt="Graphique de la croissance du nombre d’élèves en 2026" width="240" height="120">
Aperçu

width / height

nombre de pixels

Les dimensions intrinsèques de l’image en pixels, sans unité. Elles permettent au navigateur de connaître les proportions de l’image avant de la télécharger, et d’éviter de décaler le contenu.

HTML
<img src="/collections/covers/python-czy-javascript.webp" alt="Deux bureaux : analyse de données et conception de sites web" width="180" height="120">
<img src="/collections/covers/python-czy-javascript.webp" alt="" width="90" height="60">
Aperçu

loading

eager | lazy

lazy retarde le téléchargement de l’image jusqu’à ce qu’elle approche de la partie visible de la page. C’est une façon simple d’économiser de la bande passante pour les images situées sous le premier écran. Ne marquez pas comme lazy une image visible dès l’arrivée sur la page.

HTML
<img src="/collections/covers/darmowa-nauka-programowania.webp" alt="Une bibliothèque la nuit" width="240" height="160" loading="lazy">
Aperçu

srcset

liste d’adresses avec une largeur ou une densité

Un ensemble de versions de la même image en différentes tailles. Le navigateur choisit la meilleure pour l’écran, par exemple image-2x.png 2x pour les écrans à haute densité de pixels.

HTML
<img
  src="/collections/covers/kurs-html-css-od-podstaw.webp"
  srcset="/collections/covers/kurs-html-css-od-podstaw.webp 1x, /collections/covers/kurs-html-css-od-podstaw.webp 2x"
  alt="Un mur de temple agencé comme la mise en page d’un site web"
  width="240"
  height="160"
>
Aperçu

Compatibilité des navigateurs

#

Largement disponible

Fonctionne dans tous les navigateurs modernes, y compris sur mobile. Vous pouvez l’utiliser sans crainte.

  • Chrome
  • Edge
  • Firefox
  • Safari

Bonnes pratiques

#
  • Rédigez le texte alt comme si vous décriviez l’image à quelqu’un au téléphone. Ne commencez pas par « image de ».
  • Enregistrez les photos en WebP ou en AVIF. Elles pèsent généralement environ moitié moins qu’un JPEG à qualité égale.
  • Placez une image avec légende dans un <figure> accompagné d’un <figcaption>.

Entrées associées

#

Pratiquer dans les leçons

#

Vous voyez une erreur ou il manque un exemple ? Écrivez-nous.