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

CKTIS / HTML

track — pistes de texte synchronisées

L’élément track associe à un audio ou une vidéo une piste de texte externe synchronisée dans le temps, par exemple des sous-titres de dialogue, des sous-titres incluant des informations sonores ou des métadonnées. À lui seul, il ne crée pas d’élément visible distinct.

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

Syntaxe

<video controls src="movie.webm">
  <track kind="subtitles" src="subtitles.en.vtt" srclang="en" label="English" default>
</video>

track est un enfant direct de audio ou de video. Il se place après les éventuels éléments source et avant le contenu de remplacement. C’est un élément vide : il n’a ni contenu ni balise de fermeture. L’attribut src, obligatoire, pointe vers les données de la piste, généralement au format WebVTT.

kind distingue subtitles (dialogue), captions (dialogue et sons pertinents), descriptions (descriptions visuelles destinées à la synthèse vocale), chapters (métadonnées de chapitres) et metadata (données destinées aux scripts). Si kind est omis, la valeur est subtitles ; une valeur non valide signifie metadata.

srclang est une balise de langue BCP 47, obligatoire pour subtitles. label est un nom destiné aux utilisateurs et ne doit pas être vide lorsqu’il est présent. L’attribut booléen default suggère d’activer la piste, mais les préférences de l’utilisateur peuvent prévaloir. Pour un même élément multimédia, au plus une piste du groupe combiné subtitles et captions peut avoir l’attribut default.

Dans le DOM, element.track expose un objet TextTrack, et non un élément HTML. L’exemple lit ses propriétés sans lire le média ; il ne vérifie ni le chargement des cues ni l’affichage des sous-titres.

Exemples

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>Track inspection</title>
<video>
  <track id="captions" kind="captions" srclang="en" label="English" src="data:text/vtt,WEBVTT%0A%0A00%3A00%3A00.000%20--%3E%2000%3A00%3A02.000%0AHello.%0A">
</video>
<pre id="result"></pre>
<script>
  const element = document.getElementById('captions');
  document.getElementById('result').textContent = [
    element.tagName,
    element.track.kind,
    element.track.language,
    element.track.label
  ].join(' | ');
</script>
</html>

Résultat

TRACK | captions | en | English

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