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.

EventTarget Node Element HTMLElement HTMLTrackElement

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

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

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