Get to know MDN better
Cette page a été traduite à partir de l'anglais par la communauté. Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.
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.
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.
EventTarget Node Element HTMLElement HTMLTrackElementHérite des propriétés de son parent, HTMLElement.
HTMLTrackElement.kindUne 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.srcUne chaîne de caractères qui reflète l'attribut HTML src, indiquant l'adresse des données de la piste de texte.
HTMLTrackElement.srclangUne chaîne de caractères qui reflète l'attribut HTML srclang, indiquant la langue des données de la piste de texte.
HTMLTrackElement.labelUne chaîne de caractères qui reflète l'attribut HTML label, indiquant un titre lisible par l'utilisateur·ice pour la piste.
HTMLTrackElement.defaultUne 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 seuleRetourne un unsigned short qui indique l'état de préparation de la piste :
| 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. |
Retourne un objet TextTrack qui correspond aux données de la piste de texte de l'élément de piste.
Pas de méthode spécifique ; hérite des méthodes de son parent, HTMLElement.
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 :
cuechangeEnvoyé 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.
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.
| HTML # htmltrackelement |
Activez JavaScript pour afficher ce tableau de compatibilité des navigateurs.
Cette page a été modifiée le 20 janv. 2026 par les contributeur·ice·s du MDN.
Votre modèle pour un internet meilleur.
Visitez la société mère à but non lucratif de Mozilla Corporation, la Fondation Mozilla.
Certaines parties de ce contenu sont protégées par le droit d'auteur ©1998—2026 des contributeurs individuels de mozilla.org. Contenu disponible sous une licence Creative Commons.