<track>
Un fichier de sous-titres, de descriptions ou de chapitres pour `<video>` et `<audio>`.
- 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/nauka-javascript-dla-poczatkujacych.webp">
<source src="/media/lekcja-js.mp4" type="video/mp4">
<track kind="captions" src="/media/lekcja-js-pl.vtt" srclang="pl" label="Polonais" default>
<track kind="subtitles" src="/media/lekcja-js-en.vtt" srclang="en" label="English">
</video>Le fichier vidéo et les fichiers de sous-titres sont omis de l’aperçu.
Définition et utilisation
#L’élément <track> associe à une vidéo ou à un enregistrement une piste de texte au format WebVTT (un fichier .vtt). Il s’agit le plus souvent de sous-titres, mais ce peut aussi être des descriptions de scènes pour les personnes aveugles ou une liste de chapitres. C’est un élément vide, placé dans <video> ou <audio>, après les éléments <source>.
L’attribut kind définit le type de piste : subtitles est une traduction des dialogues dans une autre langue, et captions est une transcription complète pour les personnes sourdes, avec la description des sons, par exemple « [musique] ». L’attribut srclang indique la langue, et label le nom affiché dans le menu du lecteur.
Le fichier de sous-titres doit provenir du même domaine que la page ou être servi avec des en-têtes CORS (auquel cas vous ajoutez l’attribut crossorigin au <video>). C’est une cause fréquente de sous-titres qui « ne fonctionnent pas ».
Syntaxe
#<track kind="subtitles" src="sous-titres.vtt" srclang="fr" label="Français">Attributs
#kind
subtitles | captions | descriptions | chapters | metadata
Le type de piste,subtitlespar défaut.descriptionscontient des descriptions textuelles de ce qui se passe à l’écran,chaptersdes titres de chapitres pour la navigation, etmetadatades données pour les scripts, invisibles pour l’utilisateur.src
URL du fichier .vtt
L’adresse du fichier WebVTT contenant la piste. Cet attribut est obligatoire.srclang
code de langue, p. ex. `pl`, `en`
La langue de la piste. Obligatoire lorsquekindvautsubtitles.label
texte
Le nom de la piste affiché dans le menu de sélection des sous-titres, par exemple « Polonais » ou « English ».default
attribut booléen
Active cette piste par défaut. Parmi les pistes d’un même lecteur, une seule peut l’avoir.
L’élément accepte aussi tous les attributs globaux, comme class, id, style ou hidden.
Plus d’exemples
#WEBVTT
00:00:00.000 --> 00:00:03.500
Salut ! Dans cette leçon, vous allez découvrir les variables.
00:00:04.000 --> 00:00:08.000
Une variable est une boîte étiquetée dans laquelle vous stockez une valeur.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
#- Un fichier
.vttdoit commencer par le motWEBVTT, et vous écrivez les durées au format00:00:04.000 --> 00:00:08.000. - Si vous fournissez des sous-titres en plusieurs langues, ne définissez
defaultque sur une seule piste. - Les sous-titres ne s’affichent que dans
<video>. Dans<audio>, les pistes de texte sont accessibles aux scripts, par exemple pour afficher votre propre transcription.
Entrées associées
#Pratiquer dans les leçons
#Vous voyez une erreur ou il manque un exemple ? Écrivez-nous.