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 Audiodeskriptionen enthält.
Instanz-Eigenschaften
Erbt Eigenschaften von seinem übergeordneten Element, HTMLElement
.
HTMLTrackElement.kind
-
Ein String, der das
kind
-HTML-Attribut widerspiegelt und angibt, wie die Textspur verwendet werden soll. Mögliche Werte sind:subtitles
,captions
,descriptions
,chapters
odermetadata
. HTMLTrackElement.src
-
Ein String, der das
src
-HTML-Attribut widerspiegelt und die Adresse der Textspurdaten angibt. HTMLTrackElement.srclang
-
Ein String, der das
srclang
-HTML-Attribut widerspiegelt und die Sprache der Textspurdaten angibt. HTMLTrackElement.label
-
Ein String, der das
label
-HTML-Attribut widerspiegelt und einen für den Nutzer lesbaren Titel für die Spur angibt. HTMLTrackElement.default
-
Ein Boolescher Wert, der das
default
-Attribut widerspiegelt und angibt, dass die Spur aktiviert werden soll, wenn die Benutzereinstellungen nicht anzeigen, dass eine andere Spur geeigneter wäre. HTMLTrackElement.readyState
Nur lesbar-
Gibt ein
unsigned short
zurück, das den Bereitschaftszustand der Spur anzeigt:Konstante Wert Beschreibung NONE
0 Zeigt an, dass die Cues der Textspur nicht abgerufen wurden. LOADING
1 Zeigt an, dass die Textspur geladen wird und noch keine schwerwiegenden Fehler aufgetreten sind. Weitere Cues könnten durch den Parser noch 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 wurde, aber als der User-Agent versuchte sie abzurufen, dies in irgendeiner Weise scheiterte. Einige oder alle Cues fehlen wahrscheinlich und werden nicht abgerufen. HTMLTrackElement.track
Nur lesbar-
Gibt
TextTrack
zurück, was die Textspurdaten des Track-Elements sind.
Instanz-Methoden
Keine spezifische Methode; erbt Methoden von seinem übergeordneten Element, HTMLElement
.
Ereignisse
Erbt Ereignisse von seinem übergeordneten Element, HTMLElement
.
Hören Sie diese Ereignisse mithilfe von addEventListener()
oder indem Sie einen Ereignis-Listener der oneventname
-Eigenschaft dieses Interfaces zuweisen:
cuechange
-
Wird gesendet, wenn die zugrunde liegende
TextTrack
die aktuell angezeigten Cues 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.
Anwendungshinweise
Laden der Textressource der Spur
Die WebVTT- oder TTML-Daten, die die tatsächlichen Cues für die Textspur beschreiben, werden nicht geladen, wenn sich der mode
der Spur anfangs im disabled
-Zustand befindet. Wenn Sie nach dem Einrichten des <track>
-Elements eine Verarbeitung der Spur durchführen müssen, sollten Sie stattdessen sicherstellen, dass sich der mode
der Spur entweder im hidden
-Zustand (wenn Sie nicht möchten, dass es dem Benutzer angezeigt wird) oder im showing
-Zustand befindet (um die Spur initial anzuzeigen). Sie können den Modus dann später nach Bedarf ändern.
Spezifikationen
Specification |
---|
HTML Standard # htmltrackelement |
Browser-Kompatibilität
BCD tables only load in the browser
Siehe auch
- Das HTML-Element, das dieses Interface implementiert:
<track>
.