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

CKTIS / HTML

source — ressources alternatives pour les images et les médias

L’élément `source` déclare des ressources alternatives pour `picture`, `audio` ou `video`. Il n’affiche rien à lui seul. Dans `picture`, il nécessite `srcset` ; dans `audio` et `video`, il nécessite `src`. Il ne faut pas confondre ces usages.

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

Syntaxe

<picture>
  <source srcset="image.svg" type="image/svg+xml">
  <img src="fallback.png" alt="Description">
</picture>

source est un élément vide : il ne contient rien et n’a pas de balise de fermeture. Dans picture, placez-le avant l’élément img obligatoire. Dans audio et video, les éléments enfants source ne sont autorisés que si l’élément parent n’a pas d’attribut src. Ils doivent précéder les éléments track et le contenu de remplacement. Si le parent possède un attribut src, la sélection de la ressource utilise cet attribut plutôt que les éléments enfants source.

Dans picture, srcset est obligatoire et src est interdit. img affiche l’image et fournit aussi le texte alt ainsi qu’une source de remplacement. sizes décrit la taille de l’image pour les candidats avec des descripteurs de largeur ; il est obligatoire, sauf si img autorise les tailles automatiques. width et height peuvent définir les dimensions et le rapport hauteur/largeur de la variante sélectionnée.

Dans audio et video, chaque source nécessite une URL src non vide. L’attribut facultatif type indique un type MIME et permet d’ignorer un format non pris en charge sans le télécharger. media contient des requêtes média : dans picture, la sélection réagit aux changements de l’environnement, tandis que, pour les éléments multimédias, la condition n’est évaluée qu’une fois lors de la sélection de la ressource.

Modifier simplement src ou type d’une source existante dans audio ou video ne change pas la lecture ; définissez le src de l’élément parent. Dans l’exemple, les images intégrées évitent toute dépendance au réseau : si la fenêtre d’affichage mesure au moins 600 pixels CSS de large, la variante bleue est sélectionnée ; en dessous, la variante orange l’est.

Exemples

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>source demo</title>
<picture>
  <source media="(min-width: 600px)" type="image/svg+xml"
    srcset="data:image/svg+xml,%3Csvg%20xmlns='http://www.w3.org/2000/svg'%20width='120'%20height='80'%3E%3Cpath%20fill='blue'%20d='M0,0H120V80H0Z'/%3E%3C/svg%3E">
  <img width="120" height="80" alt="Color sample"
    src="data:image/svg+xml,%3Csvg%20xmlns='http://www.w3.org/2000/svg'%20width='120'%20height='80'%3E%3Cpath%20fill='orange'%20d='M0,0H120V80H0Z'/%3E%3C/svg%3E">
</picture>
</html>

Résultat

Viewport >= 600 CSS px: blue rectangle, 120 × 80 CSS px.
Viewport < 600 CSS px: orange rectangle, 120 × 80 CSS px.

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