HTMLTrackElement

Proprits d'instance

Hrite des proprits de son parent, HTMLElement.

HTMLTrackElement.kind

Une chane de caractres qui reflte l'attribut HTML kind, indiquant comment la piste de texte doit tre utilise. Les valeurs possibles sont : subtitles, captions, descriptions, chapters ou metadata.

HTMLTrackElement.src

Une chane de caractres qui reflte l'attribut HTML src, indiquant l'adresse des donnes de la piste de texte.

HTMLTrackElement.srclang

Une chane de caractres qui reflte l'attribut HTML srclang, indiquant la langue des donnes de la piste de texte.

HTMLTrackElement.label

Une chane de caractres qui reflte l'attribut HTML label, indiquant un titre lisible par l'utilisateurice pour la piste.

HTMLTrackElement.default

Une valeur boolenne refltant l'attribut default, indiquant que la piste doit tre active si les prfrences de l'utilisateurice n'indiquent pas qu'une autre piste serait plus approprie.

HTMLTrackElement.readyState Lecture seule

Retourne un unsigned short qui indique l'tat de prparation de la piste :

Constante	Valeur	Description
NONE	0	Indique que les repres 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 rencontre jusqu' prsent. D'autres repres peuvent encore tre ajouts la piste par l'analyseur.
LOADED	2	Indique que la piste de texte a t charge sans erreur fatale.
ERROR	3	Indique que la piste de texte a t active, mais que lorsque l'agent utilisateur a tent de l'obtenir, cela a chou d'une manire ou d'une autre. Certains ou tous les repres sont probablement manquants et ne seront pas obtenus.

HTMLTrackElement.track Lecture seule

Retourne un objet TextTrack qui correspond aux donnes de la piste de texte de l'lment de piste.

Mthodes d'instance

Pas de mthode spcifique ; hrite des mthodes de son parent, HTMLElement.

vnements

Hrite des vnements de son parent, HTMLElement.

coutez ces vnements en utilisant addEventListener() ou en assignant un gestionnaire d'vnement la proprit oneventname de cette interface :

cuechange

Envoy lorsque le TextTrack sous-jacent a modifi les repres actuellement prsents. Cet vnement est toujours envoy au TextTrack mais est aussi envoy HTMLTrackElement si un tel lment est associ la piste. Vous pouvez galement utiliser le gestionnaire d'vnement oncuechange pour tablir un gestionnaire pour cet vnement.

Notes d'utilisation

Chargement de la ressource texte de la piste

Les donnes WebVTT ou TTML dcrivant les repres rels pour la piste de texte ne sont pas charges si le mode de la piste est initialement l'tat disabled. Si vous devez effectuer un traitement sur la piste aprs 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 prsente l'utilisateurice au dpart) soit showing (pour afficher la piste ds le dbut). Vous pouvez ensuite changer le mode comme vous le souhaitez par la suite.

Spcifications

Spcification
HTML # htmltrackelement

Compatibilit des navigateurs

Voir aussi

• L'lment HTML implmentant cette interface : <track>.