<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
Sur cette page

Exemple

#
HTML
<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>
Aperçu

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

#
Syntaxe
<track kind="subtitles" src="sous-titres.vtt" srclang="fr" label="Français">

Attributs

#
  • kind

    subtitles | captions | descriptions | chapters | metadata

    Le type de piste, subtitles par défaut. descriptions contient des descriptions textuelles de ce qui se passe à l’écran, chapters des titres de chapitres pour la navigation, et metadata des 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 lorsque kind vaut subtitles.
  • 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

#
Un exemple de fichier de sous-titres WebVTT
Tekst
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 .vtt doit commencer par le mot WEBVTT, et vous écrivez les durées au format 00:00:04.000 --> 00:00:08.000.
  • Si vous fournissez des sous-titres en plusieurs langues, ne définissez default que 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.