<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
Exemple
#<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>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
#<source src="…" type="…">
<source srcset="…" media="…">Attributs
#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ètrecodecs, par exemplevideo/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 lesrcsetde l’élément<img>. Utilisé uniquement dans<picture>.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@mediaen CSS. La première source qui correspond l’emporte, donc avec des conditionsmin-width, commencez par la plus grande largeur.sizes
liste de conditions et de largeurs
Fonctionne avec unsrcsetfondé 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
URLL’adresse du fichier audio ou vidéo. Utilisé dans <audio> et <video>.
<audio controls preload="none">
<source src="/podcast/odcinek-12.ogg" type="audio/ogg">
<source src="/podcast/odcinek-12.mp3" type="audio/mpeg">
</audio>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.
<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>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>, utilisezsrcset, passrc. L’attributsrcsur<source>ne fonctionne que dans les éléments audio et vidéo. - Modifier
srcsur un<source>existant avec un script ne suffit pas. Il faut aussi appelervideo.load()pour que le lecteur charge le nouveau fichier.
Entrées associées
#- <picture>Un conteneur pour plusieurs versions d’une image. Le navigateur choisit celle qui convient le mieux à l’écran et au format.
- <img>Une image intégrée à la page.
- <video>Un lecteur vidéo intégré directement à la page.
- <audio>Un lecteur audio : podcast, voix off, effet sonore.
- <track>Un fichier de sous-titres, de descriptions ou de chapitres pour `<video>` et `<audio>`.
Pratiquer dans les leçons
#Vous voyez une erreur ou il manque un exemple ? Écrivez-nous.