HTMLMediaElement : propriété textTracks
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.
La propriété en lecture seule textTracks de l'interface HTMLMediaElement retourne un objet TextTrackList répertoriant tous les objets TextTrack représentant les pistes textuelles de l'élément multimédia, dans le même ordre que dans la liste des pistes textuelles.
Vous pouvez détecter lorsque des pistes sont ajoutées ou supprimées d'un élément HTML <audio> ou <video> en utilisant les événements addtrack et removetrack. Cependant, ces événements ne sont pas envoyés directement à l'élément multimédia lui-même. Ils sont envoyés à l'objet de liste de pistes de l'élément HTMLMediaElement correspondant au type de piste ajouté à l'élément.
La liste retournée est dynamique ; c'est-à-dire que, lorsque des pistes sont ajoutées ou supprimées de l'élément multimédia, le contenu de la liste change dynamiquement. Une fois que vous avez une référence à la liste, vous pouvez la surveiller pour détecter quand de nouvelles pistes textuelles sont ajoutées ou lorsque des pistes existantes sont supprimées.
Voir les évènements de TextTrackList pour en savoir plus sur la surveillance des modifications de la liste des pistes d'un élément multimédia.
Valeur
Un objet TextTrackList représentant la liste des pistes textuelles incluses dans l'élément multimédia. La liste des pistes peut être consultée en utilisant textTracks[n] pour obtenir la n-ième piste textuelle de la liste des pistes de l'objet, ou en utilisant la méthode textTracks.getTrackById().
Chaque piste est représentée par un objet TextTrack qui fournit des informations sur la piste.
Exemples
Nous commençons avec une <video> qui contient plusieurs enfants <track> :
<video controls>
<source src="/shared-assets/videos/sintel-short.webm" type="video/webm" />
<source src="/shared-assets/videos/sintel-short.mp4" type="video/mp4" />
<track
kind="subtitles"
src="/shared-assets/misc/sintel-en.vtt"
srclang="en"
label="English" />
<track
kind="subtitles"
src="/shared-assets/misc/sintel-de.vtt"
srclang="de"
label="Deutsch" />
<track
kind="subtitles"
src="/shared-assets/misc/sintel-es.vtt"
srclang="es"
label="Español" />
</video>
La propriété HTMLMediaElement.textTracks retourne un objet TextTrackList que nous pouvons parcourir. Ici, nous définissons les trois pistes pour qu'elles s'affichent simultanément.
const tracks = document.querySelector("video").textTracks;
for (const track of tracks) {
track.mode = "showing";
}
Spécifications
| Spécification |
|---|
| HTML # dom-media-texttracks-dev |
Compatibilité des navigateurs
Voir aussi
- L'interface
HTMLMediaElement: utilisée pour définir la propriétéHTMLMediaElement.textTracks - Les éléments HTML
<audio>,<video> - Les interfaces
AudioTrack,AudioTrackList - Les interfaces
VideoTrack,VideoTrackList - Les évènements de
AudioTrackList:addtrack,change,removetrack - Les évènements de
VideoTrackList:addtrack,change,removetrack