<source>

Une source alternative d’image, d’audio ou de vidéo pour `<picture>`, `<audio>` et `<video>`.

Affichage
non affiché
Balise fermante
Aucune, élément vide
Contenu autorisé
Aucun, élément vide
Sur cette page

Exemple

#
HTML
<video controls width="300" height="200" preload="none" poster="/collections/covers/jak-nauczyc-sie-programowac.webp">
  <source src="/media/zapowiedz-kursu.webm" type="video/webm">
  <source src="/media/zapowiedz-kursu.mp4" type="video/mp4">
  <a href="/media/zapowiedz-kursu.mp4">Télécharger la bande-annonce de la formation (MP4)</a>
</video>
Aperçu

Les fichiers vidéo sont absents de l’aperçu, c’est pourquoi le lecteur n’affiche que l’affiche et les commandes.

Définition et utilisation

#

L’élément <source> indique l’une des sources possibles d’un média. Il se place dans <picture>, <audio> ou <video>, et le navigateur parcourt les sources dans l’ordre et choisit la première qu’il sait utiliser. C’est un élément vide qui n’affiche rien par lui-même.

Dans <picture>, vous désignez le fichier avec l’attribut srcset, et vous fixez les conditions de sélection avec les attributs media (une requête de média) et type (le format du fichier). Dans <audio> et <video>, vous utilisez les attributs src et type, ce qui permet de proposer la même vidéo en plusieurs formats, par exemple WebM et MP4.

Il est utile d’indiquer toujours l’attribut type. Le navigateur ignore alors immédiatement les sources dans des formats qu’il ne gère pas, au lieu de télécharger un morceau de chaque fichier pour le vérifier.

Syntaxe

#
Syntaxe
<source src="…" type="…">
<source srcset="…" media="…">

Attributs

#
  • src

    URL

    L’adresse du fichier audio ou vidéo. Utilisé dans <audio> et <video>.
  • type

    type MIME, p. ex. `video/webm`, `audio/mpeg`, `image/avif`

    Le format du fichier. Le navigateur ignore les sources dans des formats qu’il ne connaît pas. Vous pouvez ajouter un paramètre codecs, par exemple video/webm; codecs="vp9", pour préciser le codec exact.
  • srcset

    adresse d’image ou liste de versions avec une largeur ou une densité

    Le fichier image de cette source, voire plusieurs de ses versions, écrites comme dans le srcset de l’élément <img>. Utilisé uniquement dans <picture>.
  • media

    requête de média, p. ex. `(min-width: 768px)`

    Une condition que l’écran doit remplir pour que la source soit choisie. Elle fonctionne comme les requêtes @media en CSS. La première source qui correspond l’emporte, donc avec des conditions min-width, commencez par la plus grande largeur.
  • sizes

    liste de conditions et de largeurs

    Fonctionne avec un srcset fondé sur les largeurs (800w) et indique au navigateur quelle sera la largeur de l’image dans la page. Uniquement dans <picture>.
  • width / height

    nombre de pixels

    Les dimensions de l’image de cette source. Elles sont utiles avec des cadrages différents : le navigateur réserve une place aux proportions de la source qu’il a réellement choisie. Uniquement dans <picture>.

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

Attributs en pratique

#

src

URL

L’adresse du fichier audio ou vidéo. Utilisé dans <audio> et <video>.

HTML
<audio controls preload="none">
  <source src="/podcast/odcinek-12.ogg" type="audio/ogg">
  <source src="/podcast/odcinek-12.mp3" type="audio/mpeg">
</audio>
Aperçu

Les fichiers audio sont absents de l’aperçu, seules les commandes du lecteur sont visibles.

media

requête de média, p. ex. `(min-width: 768px)`

Une condition que l’écran doit remplir pour que la source soit choisie. Elle fonctionne comme les requêtes @media en CSS. La première source qui correspond l’emporte, donc avec des conditions min-width, commencez par la plus grande largeur.

HTML
<picture>
  <source media="(min-width: 480px)" srcset="/collections/covers/vibe-coding.webp" width="240" height="160">
  <img src="/collections/cursor.png" alt="Une formation de vibe coding avec l’éditeur Cursor" width="72" height="72">
</picture>
Aperçu

Réduisez la fenêtre sous 480 pixels et l’image se transforme en logo.

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

#
  • Dans <video> et <audio>, listez les sources du format le plus moderne et le plus léger vers le plus compatible, qui vient généralement en dernier (par exemple MP4).
  • Dans <picture>, utilisez srcset, pas src. L’attribut src sur <source> ne fonctionne que dans les éléments audio et vidéo.
  • Modifier src sur un <source> existant avec un script ne suffit pas. Il faut aussi appeler video.load() pour que le lecteur charge le nouveau fichier.

Entrées associées

#

Pratiquer dans les leçons

#

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