Cette page a été traduite à partir de l'anglais par la communauté. Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.

View in English Always switch to English

HTMLTrackElement : propriété kind

Baseline Widely available

Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis ⁨juillet 2015⁩.

La propriété kind de l'interface HTMLTrackElement représente le type de piste, ou la façon dont la piste de texte doit être utilisée. Elle reflète l'attribut énuméré kind de l'élément HTML <track>.

Si aucun kind n'est défini, subtitles est utilisé. Si l'attribut n'est pas défini sur l'une des valeurs énumérées valides, il est invalide et metadata est utilisé. Les autres valeurs valides incluent captions, descriptions et chapters.

Valeur

Une chaîne de caractères ; en minuscules captions, descriptions, chapters, subtitles ou metadata.

Exemple

À partir de l'exemple suivant :

html
<track src="track.vtt" id="exampleTrack" />

On obtient les résultats suivants :

js
const trackElement = document.getElementById("exampleTrack");
// valeur manquante
console.log(trackElement.kind); // "subtitles"
trackElement.kind = "INVALID";
// valeur invalide
console.log(trackElement.kind); // "metadata"
trackElement.kind = "CAPTIONS";
// valeur valide
console.log(trackElement.kind); // "captions"

Spécifications

Specification
HTML
# dom-track-kind

Compatibilité des navigateurs

Voir aussi