Die schreibgeschütztetextTracks-Eigenschaft vonHTMLMediaElement-Objekten gibt einTextTrackList-Objekt zurück, das alleTextTrack-Objekte auflistet, die die Textspuren des Media-Elements darstellen, in der gleichen Reihenfolge wie in der Liste der Textspuren.

Sie können erkennen, wann Spuren zu einem<audio>- oder<video>-Element hinzugefügt oder daraus entfernt werden, indem Sie dieaddtrack- undremovetrack-Ereignisse verwenden. Diese Ereignisse werden jedoch nicht direkt an das Media-Element selbst gesendet. Stattdessen werden sie an das Spurenlistenobjekt desHTMLMediaElement gesendet, das dem Typ der Spur entspricht, die zum Element hinzugefügt wurde.

Die zurückgegebene Liste istlive; das heißt, während Spuren zum Media-Element hinzugefügt oder daraus entfernt werden, ändert sich der Inhalt der Liste dynamisch. Sobald Sie eine Referenz zur Liste haben, können Sie sie auf Änderungen überwachen, um zu erkennen, wann neue Textspuren hinzugefügt werden oder vorhandene entfernt werden.

Sehen Sie sichTextTrackList-Ereignisse an, um mehr darüber zu erfahren, wie Sie Änderungen an der Spurenliste eines Media-Elements überwachen können.

Wert

EinTextTrackList-Objekt, das die Liste der in das Media-Element aufgenommenen Textspuren darstellt. Die Liste der Spuren kann mittextTracks[n] zugegriffen werden, um die n-te Textspur aus der Objektsliste der Textspuren zu erhalten, oder durch die Verwendung dertextTracks.getTrackById()-Methode.

Jede Spur wird durch einTextTrack-Objekt dargestellt, das Informationen über die Spur bereitstellt.

Beispiele

Wir beginnen mit einem<video>, dasmehrere<track>Kinder hat.

<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>

HTMLMediaElement.textTracks gibt eineTextTrackList zurück, durch die wir iterieren können. Hier stellen wir sicher, dass alle drei Spuren gleichzeitig angezeigt werden.

const tracks = document.querySelector("video").textTracks;for (const track of tracks) {  track.mode = "showing";}

Spezifikationen

Browser-Kompatibilität

Siehe auch

• HTMLMediaElement: Schnittstelle zur Definition derHTMLMediaElement.textTracks-Eigenschaft
• <audio>,<video>
• AudioTrack,AudioTrackList
• VideoTrack,VideoTrackList
• addtrack,change,removetrack: AudioTrackList-Ereignisse
• addtrack,change,removetrack: VideoTrackList-Ereignisse