TextTrackList
Baseline
Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since Juli 2015.
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()
Instanz-Eigenschaften
Dieses Interface erbt auch Eigenschaften von seinem übergeordneten Interface EventTarget.
lengthSchreibgeschützt-
Die Anzahl der Spuren in der Liste.
Instanz-Methoden
Dieses Interface erbt auch Methoden von seinem übergeordneten Interface EventTarget.
getTrackById()-
Gibt die
TextTrackzurück, die innerhalb derTextTrackListgefunden wird, derenidmit dem angegebenen String übereinstimmt. Wenn keine Übereinstimmung gefunden wird, wirdnullzurü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.
Beispiele
Abrufen der Textspur-Liste eines Videoelements
Um die TextTrackList eines Medienelements zu erhalten, verwenden Sie seine textTracks-Eigenschaft.
const textTracks = document.querySelector("video").textTracks;
Überwachung von Änderungen der Spurenanzahl
In diesem Beispiel haben wir eine App, die Informationen über die Anzahl der verfügbaren Kanäle anzeigt. Um sie aktuell zu halten, werden Handler für die addtrack und removetrack Ereignisse eingerichtet.
textTracks.onaddtrack = updateTrackCount;
textTracks.onremovetrack = updateTrackCount;
function updateTrackCount(event) {
trackCount = textTracks.length;
drawTrackCountIndicator(trackCount);
}
Spezifikationen
| Specification |
|---|
| HTML # text-track-api |
Browser-Kompatibilität
Loading…