HTMLTrackElement

Instanz-Eigenschaften

Erbt Eigenschaften von seinem Elternteil, HTMLElement.

HTMLTrackElement.kind

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

HTMLTrackElement.src

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

HTMLTrackElement.srclang

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

HTMLTrackElement.label

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

HTMLTrackElement.default

Ein boolescher Wert, der das Attribut default 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.readyState Schreibgeschützt

Gibt ein unsigned 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.track Schreibgeschützt

Gibt TextTrack 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 mit addEventListener() abhören oder indem Sie einen Ereignis-Listener der oneventname-Eigenschaft dieses Interfaces zuweisen:

cuechange

Wird gesendet, wenn die zugrunde liegenden TextTrack die aktuell präsentierten Cues geändert wurden. Dieses Ereignis wird immer an das TextTrack gesendet, wird aber auch an das HTMLTrackElement gesendet, wenn eines mit dem Track verbunden ist. Sie können auch den oncuechange-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 der mode des Tracks anfänglich im disabled-Zustand ist. Wenn Sie eine Verarbeitung des Tracks nach dem Einrichten des <track> benötigen, sollten Sie stattdessen sicherstellen, dass der mode des Tracks entweder hidden ist (wenn er nicht sofort angezeigt werden soll) oder showing (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>.