TextTrackList

Baseline Weitgehend verfügbar

Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Juli 2015 browserübergreifend verfügbar.

Das TextTrackList-Interface wird verwendet, um eine Liste der für das zugehörige Video- oder Audioelement definierten Textspuren darzustellen. Jede Spur wird dabei durch ein separates TextTrack-Objekt in der Liste repräsentiert.

Textspuren können einem Medienelement deklarativ mit dem <track>-Element oder programmatisch mit der Methode HTMLMediaElement.addTextTrack() hinzugefügt werden.

Eine Instanz dieses Objekts kann über die textTracks-Eigenschaft eines HTMLMediaElement-Objekts abgerufen werden.

Für ein gegebenes HTMLMediaElement-Objekt media können die einzelnen Spuren wie folgt abgerufen werden:

media.TextTracks[n], um die n-te Textspur aus der Liste der Textspuren des Objekts zu erhalten
mit der Methode media.textTracks.getTrackById()

EventTarget TextTrackList

In diesem Artikel

Instanz-Eigenschaften

Dieses Interface erbt auch Eigenschaften von seinem übergeordneten Interface EventTarget.

length Schreibgeschützt

Die Anzahl der Spuren in der Liste.

Instanz-Methoden

Dieses Interface erbt auch Methoden von seinem übergeordneten Interface EventTarget.

getTrackById()

Gibt die TextTrack zurück, die innerhalb der TextTrackList gefunden wird, deren id mit dem angegebenen String übereinstimmt. Wenn keine Übereinstimmung gefunden wird, wird null zurückgegeben.

Ereignisse

addtrack

Wird ausgelöst, wenn eine neue Textspur dem Medienelement hinzugefügt wurde. Auch über die onaddtrack-Eigenschaft verfügbar.

change

Wird ausgelöst, wenn eine Textspur aktiv oder inaktiv gemacht wurde. Auch über die onchange-Eigenschaft verfügbar.

removetrack

Wird ausgelöst, wenn eine neue Textspur vom Medienelement entfernt wurde. Auch über die onremovetrack-Eigenschaft verfügbar.

Verwendungsnotizen

Zusätzlich dazu, direkten Zugriff auf die auf einem Medienelement vorhandenen Textspuren zu erhalten, erlaubt TextTrackList das Setzen von Ereignis-Handlern für die addtrack und removetrack Ereignisse, sodass Sie erkennen können, wann Spuren zum Stream des Medienelements hinzugefügt oder davon entfernt werden.

js
textTracks.onaddtrack = updateTrackCount;
textTracks.onremovetrack = updateTrackCount;

function updateTrackCount(event) {
  trackCount = textTracks.length;
  drawTrackCountIndicator(trackCount);
}