HTMLTrackElement
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.
Das HTMLTrackElement
-Interface repräsentiert ein HTML <track>
-Element innerhalb des DOM. Dieses Element kann als Kind von entweder <audio>
oder <video>
verwendet werden, um eine Textspur anzugeben, die Informationen wie Untertitel oder Captions enthält.
Instanz-Eigenschaften
Erbt Eigenschaften von seinem Elternteil, HTMLElement
.
HTMLTrackElement.kind
-
Ein String, der das HTML-Attribut
kind
widerspiegelt und angibt, wie die Textspur verwendet werden soll. Mögliche Werte sind:subtitles
,captions
,descriptions
,chapters
odermetadata
. HTMLTrackElement.src
-
Ein String, der das HTML-Attribut
src
widerspiegelt und die Adresse der Textspur-Daten angibt. HTMLTrackElement.srclang
-
Ein String, der das HTML-Attribut
srclang
widerspiegelt und die Sprache der Textspur-Daten angibt. HTMLTrackElement.label
-
Ein String, der das HTML-Attribut
label
widerspiegelt und einen benutzerlesbaren Titel für die Spur angibt. HTMLTrackElement.default
-
Ein boolescher Wert, der das Attribut
default
widerspiegelt und anzeigt, dass die Spur aktiviert werden soll, wenn die Präferenzen des Nutzers nicht anzeigen, dass eine andere Spur geeigneter wäre. HTMLTrackElement.readyState
Schreibgeschützt-
Gibt einen
unsigned short
zurück, der den Bereitschaftszustand der Spur anzeigt:Konstante Wert Beschreibung NONE
0 Zeigt an, dass die Hinweise der Textspur nicht abgerufen wurden. LOADING
1 Zeigt an, dass die Textspur geladen wird und bisher keine schwerwiegenden Fehler aufgetreten sind. Weitere Hinweise könnten noch per Parser zur Spur hinzugefügt werden. LOADED
2 Zeigt an, dass die Textspur ohne schwerwiegende Fehler geladen wurde. ERROR
3 Zeigt an, dass die Textspur aktiviert war, aber als der Benutzeragent versuchte, sie abzurufen, dies auf irgendeine Weise fehlschlug. Einige oder alle Hinweise fehlen möglicherweise und werden nicht abgerufen. HTMLTrackElement.track
Schreibgeschützt-
Gibt
TextTrack
zurück, das die Textspur-Daten des Spur-Elements darstellt.
Instanz-Methoden
Keine spezifische Methode; erbt Methoden von seinem Elternteil, HTMLElement
.
Ereignisse
Erbt Ereignisse von seinem Elternteil, HTMLElement
.
Diese Ereignisse können mit addEventListener()
überwacht werden oder durch Zuweisen eines Ereignis-Listeners zur oneventname
-Eigenschaft dieses Interfaces:
cuechange
-
Wird gesendet, wenn die zugrunde liegende
TextTrack
die aktuell dargestellten Hinweise geändert hat. Dieses Ereignis wird immer an dieTextTrack
gesendet, aber auch an dasHTMLTrackElement
, wenn eines mit der Spur verknüpft ist. Sie können auch denoncuechange
-Ereignishandler verwenden, um einen Handler für dieses Ereignis festzulegen.
Verwendungshinweise
Laden der Text-Ressource der Spur
Die WebVTT- oder TTML-Daten, die die tatsächlichen Hinweise für die Textspur beschreiben, werden nicht geladen, wenn der mode
der Spur ursprünglich im disabled
-Zustand ist. Wenn Sie in der Lage sein müssen, nach der Einrichtung des <track>
-Elements eine Verarbeitung auf der Spur durchzuführen, sollten Sie stattdessen sicherstellen, dass der mode
der Spur entweder hidden
ist (wenn Sie nicht möchten, dass sie dem Nutzer zu Beginn angezeigt wird) oder showing
(um die Spur initial anzuzeigen). Sie können den Modus dann später nach Bedarf ändern.
Spezifikationen
Specification |
---|
HTML # htmltrackelement |
Browser-Kompatibilität
Siehe auch
- Das HTML-Element, das dieses Interface implementiert:
<track>
.