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.

EventTarget Node Element HTMLElement HTMLTrackElement

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 oder metadata.

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 die TextTrack gesendet, aber auch an das HTMLTrackElement, wenn eines mit der Spur verknüpft ist. Sie können auch den oncuechange-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>.