DasHTMLTrackElement-Interface repräsentiert einHTML<track>-Element innerhalb desDOM. Dieses Element kann als Kind von entweder<audio> oder<video> verwendet werden, um einen Texttrack anzugeben, der Informationen wie Untertitel oder Bildunterschriften enthält.

Instanz-Eigenschaften

Erbt Eigenschaften von seinem Elternteil,HTMLElement.

HTMLTrackElement.kind

Ein String, der das HTML-Attributkind wiedergibt und angibt, wie der Texttrack verwendet werden soll. Mögliche Werte sind:subtitles,captions,descriptions,chapters odermetadata.

HTMLTrackElement.src

Ein String, der das HTML-Attributsrc wiedergibt und die Adresse der Texttrack-Daten angibt.

HTMLTrackElement.srclang

Ein String, der das HTML-Attributsrclang wiedergibt und die Sprache der Texttrack-Daten angibt.

HTMLTrackElement.label

Ein String, der das HTML-Attributlabel wiedergibt und einen benutzerlesbaren Titel für den Track angibt.

HTMLTrackElement.default

Ein boolescher Wert, der das Attributdefault wiedergibt und angibt, dass der Track aktiviert werden soll, wenn die Präferenzen des Benutzers nicht angeben, dass ein anderer Track geeigneter wäre.

HTMLTrackElement.readyStateSchreibgeschützt

Gibt einunsigned short zurück, das den Bereitschaftszustand des Tracks zeigt:

Konstante	Wert	Beschreibung
NONE	0	Gibt an, dass die Cues des Texttracks noch nicht beschafft wurden.
LOADING	1	Gibt an, dass der Texttrack geladen wird und bisher keine fatalen Fehler aufgetreten sind. Weitere Cues könnten vom Parser dem Track noch hinzugefügt werden.
LOADED	2	Gibt an, dass der Texttrack fehlerfrei geladen wurde.
ERROR	3	Gibt an, dass der Texttrack aktiviert wurde, jedoch das Abrufen durch den Benutzeragenten in irgendeiner Weise gescheitert ist. Einige oder alle Cues fehlen wahrscheinlich und werden nicht beschafft.

HTMLTrackElement.trackSchreibgeschützt

GibtTextTrack zurück, das die Texttrack-Daten des Track-Elements ist.

Instanz-Methoden

Keine spezifische Methode; erbt Methoden von seinem Elternteil,HTMLElement.

Ereignisse

Erbt Ereignisse von seinem Elternteil,HTMLElement.

Diese Ereignisse können Sie mitaddEventListener() abhören oder indem Sie einen Ereignis-Listener deroneventname-Eigenschaft dieses Interfaces zuweisen:

cuechange

Wird gesendet, wenn die zugrunde liegendenTextTrack die aktuell präsentierten Cues geändert wurden. Dieses Ereignis wird immer an dasTextTrack gesendet, wird aberauch an dasHTMLTrackElement gesendet, wenn eines mit dem Track verbunden ist. Sie können auch denoncuechange-Ereignishandler verwenden, um einen Handler für dieses Ereignis festzulegen.

Hinweise zur Verwendung

Laden der Textressource des Tracks

Die WebVTT- oder TTML-Daten, die die eigentlichen Cues für den Texttrack beschreiben, werden nicht geladen, wenn dermode des Tracks anfänglich imdisabled-Zustand ist. Wenn Sie eine Verarbeitung des Tracks nach dem Einrichten des<track> benötigen, sollten Sie stattdessen sicherstellen, dass dermode des Tracks entwederhidden ist (wenn er nicht sofort angezeigt werden soll) odershowing (um den Track anfänglich anzuzeigen). Sie können den Modus später nach Bedarf ändern.

Spezifikationen

Browser-Kompatibilität

Siehe auch

• Das HTML-Element, das dieses Interface implementiert:<track>.