HTMLTrackElement

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, HTMLElement.

Évènements

Hérite des évènements de son parent, HTMLElement.

Écoutez ces évènements en utilisant addEventListener() ou en assignant un gestionnaire d'évènement à la propriété oneventname de cette interface :

cuechange

Envoyé lorsque le TextTrack sous-jacent a modifié les repères actuellement présentés. Cet évènement est toujours envoyé au TextTrack mais est aussi envoyé à HTMLTrackElement si un tel élément est associé à la piste. Vous pouvez également utiliser le gestionnaire d'évènement oncuechange pour établir un gestionnaire pour cet évènement.

Notes d'utilisation

Chargement de la ressource texte de la piste

Les données WebVTT ou TTML décrivant les repères réels pour la piste de texte ne sont pas chargées si le mode de la piste est initialement à l'état disabled. Si vous devez effectuer un traitement sur la piste après la mise en place du <track>, vous devez vous assurer que le mode de la piste est soit hidden (si vous ne souhaitez pas qu'elle soit présentée à l'utilisateur·ice au départ) soit showing (pour afficher la piste dès le début). Vous pouvez ensuite changer le mode comme vous le souhaitez par la suite.

Spécifications

Compatibilité des navigateurs

Voir aussi

• L'élément HTML implémentant cette interface : <track>.