Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / HTML

img — intégrer une image

L’élément img intègre une image dans un document HTML. Les attributs src et srcset indiquent les ressources, tandis que alt fournit un texte qui remplace les informations transmises par l’image.

Version : WHATWG HTML Living Standard; index snapshot date recorded separately

Syntaxe

<img src="image-url" alt="text alternative" width="160" height="100">

img représente une image. C’est un élément vide : il n’a ni contenu enfant ni balise de fin. Au moins l’un des attributs src ou srcset est obligatoire ; src doit contenir une URL d’image non vide.

En règle générale, renseignez alt pour transmettre la signification de l’image dans son contexte, plutôt que son nom de fichier. Pour une image purement décorative, utilisez alt="". L’absence de alt n’équivaut pas à un texte alternatif vide ; son omission n’est autorisée que dans les cas limités définis par la norme.

width et height aident le navigateur à réserver de l’espace avant le chargement de l’image. srcset propose des variantes parmi lesquelles le navigateur peut choisir. Avec des descripteurs de largeur w, l’attribut sizes est obligatoire, sauf si l’élément img permet de déterminer automatiquement la taille. Par exemple, avec loading="lazy", qui permet de différer le chargement de l’image, sizes peut être omis.

L’exemple intègre une image SVG dans une URL data: ; il ne nécessite donc ni fichier séparé ni connexion réseau. Le résultat attendu est un rectangle bleu de 160 × 100 pixels CSS.

Exemples

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>Image example</title>
<img
  src="data:image/svg+xml,%3Csvg%20xmlns='http://www.w3.org/2000/svg'%20width='160'%20height='100'%3E%3Crect%20width='160'%20height='100'%20fill='blue'/%3E%3C/svg%3E"
  alt="Blue rectangle"
  width="160"
  height="100">
</html>

Résultat

A blue rectangle, 160 CSS pixels wide and 100 CSS pixels high.

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources