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

CKTIS / HTML

kind — type de piste texte

L’attribut kind de l’élément track indique la fonction d’une piste texte. S’il est omis, la valeur est subtitles ; une valeur incorrecte ou vide correspond à metadata.

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

Syntaxe

<track kind="subtitles" src="track.vtt" srclang="en">
<track kind="captions" src="track.vtt">
<track kind="descriptions" src="track.vtt">
<track kind="chapters" src="track.vtt">
<track kind="metadata" src="track.vtt">

kind est un attribut à valeurs énumérées de l’élément track, utilisé dans audio ou video. Il indique la fonction d’une piste de texte temporisée externe, et non sa langue ni le format de son fichier.

subtitles fournit une transcription ou une traduction des dialogues ; captions inclut également les sons et la musique pertinents. descriptions fournit des descriptions textuelles des éléments visuels destinées à la synthèse vocale. chapters fournit des repères de chapitre pour naviguer dans le média ; le navigateur peut les présenter sous forme de liste interactive. metadata désigne une piste destinée aux scripts que le navigateur n’affiche pas.

Si kind est omis, la valeur est subtitles ; une valeur incorrecte, y compris kind="", correspond à metadata. Cette valeur de repli ne rend pas conforme une valeur incorrecte. src est obligatoire ; pour subtitles, srclang doit également contenir une étiquette de langue BCP 47 valide.

L’exemple compare la valeur brute obtenue avec getAttribute('kind') au type effectif de la piste texte dans track.track.kind. Définir kind seul n’active pas l’affichage des sous-titres.

Exemples

const track = document.createElement('track');
console.log(track.track.kind);
track.setAttribute('kind', 'captions');
console.log(track.track.kind);
track.setAttribute('kind', 'invalid');
console.log(track.getAttribute('kind'));
console.log(track.track.kind);
track.setAttribute('kind', '');
console.log(track.track.kind);

Résultat

subtitles
captions
invalid
metadata
metadata

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