HTMLTrackElement

Baseline

Large disponibilité

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.

Voir la compatibilité complète
En savoir plus

L'interface HTMLTrackElement représente un élément HTML <track> dans le DOM. Cet élément peut être utilisé comme enfant de <audio> ou <video> pour définir une piste de texte contenant des informations telles que des sous-titres ou des légendes.

Propriétés d'instance

Hérite des propriétés de son parent, HTMLElement.

HTMLTrackElement.kind

Une chaîne de caractères qui reflète l'attribut HTML kind, indiquant comment la piste de texte doit être utilisée. Les valeurs possibles sont : subtitles, captions, descriptions, chapters ou metadata.

HTMLTrackElement.src

Une chaîne de caractères qui reflète l'attribut HTML src, indiquant l'adresse des données de la piste de texte.

HTMLTrackElement.srclang

Une chaîne de caractères qui reflète l'attribut HTML srclang, indiquant la langue des données de la piste de texte.

HTMLTrackElement.label

Une chaîne de caractères qui reflète l'attribut HTML label, indiquant un titre lisible par l'utilisateur·ice pour la piste.

HTMLTrackElement.default

Une valeur booléenne reflétant l'attribut default, indiquant que la piste doit être activée si les préférences de l'utilisateur·ice n'indiquent pas qu'une autre piste serait plus appropriée.

HTMLTrackElement.readyState Lecture seule

Retourne un unsigned short qui indique l'état de préparation de la piste :

Constante	Valeur	Description
`NONE`	0	Indique que les repères du texte de piste n'ont pas été obtenus.
`LOADING`	1	Indique que la piste de texte est en cours de chargement et qu'aucune erreur fatale n'a été rencontrée jusqu'à présent. D'autres repères peuvent encore être ajoutés à la piste par l'analyseur.
`LOADED`	2	Indique que la piste de texte a été chargée sans erreur fatale.
`ERROR`	3	Indique que la piste de texte a été activée, mais que lorsque l'agent utilisateur a tenté de l'obtenir, cela a échoué d'une manière ou d'une autre. Certains ou tous les repères sont probablement manquants et ne seront pas obtenus.

HTMLTrackElement.track Lecture seule

Retourne un objet TextTrack qui correspond aux données de la piste de texte de l'élément de piste.

Méthodes d'instance

Pas de méthode spécifique ; hérite des méthodes de son parent,