<track>

Résumé

L'élément HTML <track> est utilisé en tant qu'élément appartenant aux éléments  media qui sont <audio> et <video>. Cet élément isolé ne représente rien. Il permet de définir des données dépendant du temps et liées aux médias.

Le type de donnée que l'élément track ajoute au media est donné par l'attribut kind. Cet attribut peut prendre les valeurs suivantes : subtitles, captions, descriptions, chapters ou metadata. Cet élément redirige vers un fichier contenant du texte chronométré que le navigateur affiche lorsque l'utilisateur demande des données supplémentaires.

Un élément media ne peut pas avoir plus d'un élément track avec les mêmes kind, srclang, et label.

• Catégories de contenu Aucune
• Contenu autorisé Aucun, c'est un élément vide
• Omission de balises En tant qu'élément vide, la balise de début doit être présente et la balise de fin doit ne pas être présente.
• Élément parents autorisés Un élément media avant tout contenu de flux
• Interface DOM HTMLTrackElement

Attributs

Cet élément possède les attributs globaux.

default

Cet attribut indique si cet élément doit être activé à moins que les réglages de l'utilisateur ne montrent qu'un autre élément track doit être choisi en priorité. Cet attribut ne peut être utilisé que pour un seul élément track pour chaque élément media.

kind

La façon dont le texte du fichier doit être utilisé. Si cet attribut n'est pas utilisé, la valeur par défaut sera subtitles. Les mots-clés suivant sont autorisés :

• subtitles
  • Les sous-titres fournissent une traduction du contenu pouvant ne pas être compris par l'utilisateur. Par exemple un texte en espagnol pour un film en anglais.
  • Les sous-titres peuvent parfois contenir du contenu supplémentaire comme des informations contextuelles (par exemple la date et le lieu d'une certaine scène).
• captions
  • Des légendes (captions) fournissent une transcription et éventuellement une traduction du son associé au media.
  • Cet attribut peut inclure des informations non-orales commes des indications sur la musique ou les sons joués. Il peut également indiquer l'origine d'un son (la musique, un texte lu, le nom du personnage qui parle).
  • Utilisé pour les utilisateurs malentendants ou pour ceux ayant coupé le son.
• descriptions
  • Description textuelle du contenu vidéo.
  • Peut être utilisé par les utilisateurs aveugles ou dont la vidéo ne peut pas être vue.
• chapters
  • Les titres de chapitres sont utilisés pour naviguer au sein de la ressource multimedia.
• metadata
  • Pistes utilisées par les scripts. N'est pas visible par l'utilisateur.

label

Le titre, lisible par l'utilisateur, de l'élément track utilisé par le navigateur lorsque celui-ci affiche les différents éléments tracks disponibles.

src

L'adresse du fichier contenant les informations. Cet attribut doit être une URL valide et doit être défini.

srclang

La langue du texte contenu dans l'élément track. Cet attribut doit être une étiquette BCP 47 valide. Si l'attribut kind vaut subtitles, alors l'attribut srclang doit être défini.

Exemple

<video controls>
   <source src="sample.ogv" type="video/ogv">
   <track kind="captions" src="legendes.srt" srclang="en">
   <track kind="descriptions" src="descriptions.srt" srclang="en">
   <track kind="chapters" src="chapitres.srt" srclang="en">
   <track kind="subtitles" src="sous_titres_de.srt" srclang="de">
   <track kind="subtitles" src="sous_titres_en.srt" srclang="en">
   <track kind="subtitles" src="sous_titres_ja.srt" srclang="ja">
   <track kind="subtitles" src="sous_titres_oz.srt" srclang="oz">
   <track kind="metadata" src="etape1.srt" srclang="en" label="Étape 1">
   <track kind="metadata" src="etape2.srt" srclang="en" label="Étape 2">
   <track kind="metadata" src="etape3.srt" srclang="en" label="Étape 3">
</video>

Spécifications

Compatibilité des navigateurs

Notes de compatibilités

En ce qui concerne Chrome pour Android, l'élément <track> ne fonctionne pas en mode plein écran jusqu'à présent

Voir également

• Format text track de WebVTT