HTML Audio/Video DOM textTracks Propriété

❮ Référence HTML Audio/Video DOM

Exemple

Obtenez le nombre de pistes de texte disponibles :

let vid = document.getElementById("myVideo");
alert(vid.textTracks.length);
Essayez-le vous-même »

Définition et Utilisation

La propriété textTracks renvoie un objet TextTrackList.

Cet objet TextTrackList représente les pistes de texte disponibles pour l'audio/vidéo.

Chaque piste de texte disponible est représentée par un objet TextTrack.

Support des Navigateurs

Les numéros dans le tableau indiquent la première version du navigateur qui prend entièrement en charge la propriété.

Propriété
textTracks Oui 10.0 33.0 6.0 Oui

Syntaxe

audio|video .textTracks

Valeur de Retour

Type Description
Objet TextTrackList Représente les pistes de texte disponibles pour l'audio/vidéo.

Objet TextTrackList :

  • length - obtenir le nombre de pistes de texte disponibles dans l'audio/vidéo
  • [ index ] - obtenir l'objet TextTrack par index

Remarque : Le premier objet TextTrack disponible est index 0

Objet TextTrack Représente une piste de texte.

Propriétés de l'objet TextTrack :

  • kind - obtenir le type de la piste de texte (peut être : "sous-titres", "légende", "descriptions", "chapitres", ou "métadonnées")
  • label - obtenir l'étiquette de la piste de texte
  • language - obtenir la langue de la piste de texte
  • mode - obtenir ou définir si la piste est active ("disabled"|"hidden"|"showing")
  • cues - obtenir une liste de repères sous forme d'objet TextTrackCueList
  • activeCues - obtenir les repères de la piste de texte actuellement active sous forme d'objet TextTrackCueList
  • addCue( cue ) - ajouter un repère à la liste des repères
  • removeCue( cue ) - retirer un repère de la liste des repères
❮ Référence HTML Audio/Video DOM