Baseline Widely available
Die TextTrackList
Schnittstelle wird verwendet, um eine Liste der für das zugehörige <video>
- oder <audio>
-Element definierten Textspuren darzustellen, wobei jede Spur durch ein separates textTrack
-Objekt in der Liste repräsentiert wird.
Textspuren können einem Medienelement deklarativ mithilfe des <track>
-Elements oder programmgesteuert mithilfe 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 erhaltenmedia.textTracks.getTrackById()
Diese Schnittstelle erbt auch Eigenschaften ihrer übergeordneten Schnittstelle, EventTarget
.
length
Schreibgeschützt
Die Anzahl der Spuren in der Liste.
Diese Schnittstelle erbt auch Methoden ihrer übergeordneten Schnittstelle, EventTarget
.
getTrackById()
Gibt die innerhalb der TextTrackList
gefundene TextTrack
zurück, deren id
mit dem angegebenen String übereinstimmt. Wenn keine Ãbereinstimmung gefunden wird, wird null
zurückgegeben.
addtrack
Wird ausgelöst, wenn eine neue Textspur zum Medienelement hinzugefügt wurde. Auch über die onaddtrack
-Eigenschaft verfügbar.
change
Wird ausgelöst, wenn eine Textspur aktiv oder inaktiv gemacht wird. Auch über die onchange
-Eigenschaft verfügbar.
removetrack
Wird ausgelöst, wenn eine neue Textspur aus dem Medienelement entfernt wurde. Auch über die onremovetrack
-Eigenschaft verfügbar.
Zusätzlich zur Möglichkeit, direkten Zugriff auf die auf einem Medienelement vorhandenen Textspuren zu erhalten, ermöglicht TextTrackList
das Setzen von Ereignishandlern für die Ereignisse addtrack
und removetrack
, sodass Sie erkennen können, wenn Spuren zum oder vom Stream des Medienelements hinzugefügt oder entfernt werden.
Um die TextTrackList
eines Medienelements zu erhalten, verwenden Sie die textTracks
-Eigenschaft.
const textTracks = document.querySelector("video").textTracks;
Ãberwachung von Spurenzahlenänderungen
In diesem Beispiel haben wir eine App, die Informationen über die Anzahl der verfügbaren Kanäle anzeigt. Um sie auf dem neuesten Stand zu halten, werden Handler für die Ereignisse addtrack
und removetrack
eingerichtet.
textTracks.onaddtrack = updateTrackCount;
textTracks.onremovetrack = updateTrackCount;
function updateTrackCount(event) {
trackCount = textTracks.length;
drawTrackCountIndicator(trackCount);
}
Spezifikationen Browser-Kompatibilität
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4