<track>: Das eingebettete Text-Track-Element

Dieses Element beinhaltet die globalen Attribute.

default

Dieses Attribut gibt an, dass der Track aktiviert sein sollte, es sei denn, die Benutzereinstellungen zeigen, dass ein anderer Track geeigneter ist. Dieses Attribut darf nur auf einem track-Element pro Media-Element verwendet werden.

kind

Wie der Text-Track verwendet werden soll. Wenn es weggelassen wird, ist die Standardart subtitles. Wenn das Attribut einen ungültigen Wert enthält, wird metadata verwendet. Die folgenden Schlüsselwörter sind erlaubt:

• subtitles

  • Untertitel bieten eine Übersetzung von Inhalten, die vom Betrachter nicht verstanden werden können. Zum Beispiel Sprache oder Text, der in einem englischsprachigen Film nicht auf Englisch ist.
  • Untertitel können zusätzlichen Inhalt enthalten, normalerweise zusätzliche Hintergrundinformationen. Zum Beispiel der Text am Anfang der Star Wars-Filme oder das Datum, die Uhrzeit und der Ort einer Szene.

• captions

  • Geschlossene Untertitel bieten eine Transkription und möglicherweise eine Übersetzung von Audio.
  • Sie können wichtige nonverbale Informationen wie Musikhinweise oder Soundeffekte enthalten. Sie können die Quelle des Hinweises angeben (z. B. Musik, Text, Charakter).
  • Geeignet für Benutzer, die taub sind oder wenn der Ton stummgeschaltet ist.

• chapters

  • Kapitelüberschriften sind gedacht, um dem Benutzer bei der Navigation innerhalb der Medienressource zu helfen.

• metadata

  • Tracks, die von Skripten verwendet werden. Nicht sichtbar für den Benutzer.

label

Ein benutzerlesbarer Titel des Text-Tracks, der vom Browser beim Auflisten verfügbarer Text-Tracks verwendet wird.

src

Adresse des Tracks (.vtt-Datei). Muss eine gültige URL sein. Dieses Attribut muss angegeben werden und sein URL-Wert muss denselben Ursprung wie das Dokument haben — es sei denn, das <audio> oder <video> Eltern-Element des track-Elements hat ein crossorigin Attribut.

srclang

Sprache der Track-Textdaten. Es muss ein gültiges BCP 47 Sprach-Tag sein. Wenn das kind Attribut auf subtitles gesetzt ist, muss srclang definiert werden.

Die Art der Daten, die track dem Medium hinzufügt, wird im kind Attribut festgelegt, das Werte wie subtitles, captions, chapters oder metadata annehmen kann. Das Element verweist auf eine Quelldatei, die zeitgesteuerten Text enthält, den der Browser anzeigt, wenn der Benutzer zusätzliche Daten anfordert.

Ein Media-Element kann nicht mehr als einen track mit demselben kind, srclang und label haben.

Der zugrunde liegende TextTrack, angezeigt durch die track Eigenschaft, erhält ein cuechange Ereignis jedes Mal, wenn der aktuell dargestellte Cue geändert wird. Dies passiert auch dann, wenn der Track nicht mit einem Media-Element verknüpft ist.

Wenn der Track ist mit einem Media-Element verknüpft, indem das <track>-Element als Kind des <audio> oder <video> Elements verwendet wird, wird das cuechange Ereignis auch an das HTMLTrackElement gesendet.

let textTrackElem = document.getElementById("text-track");

textTrackElem.addEventListener("cuechange", (event) => {
  let cues = event.target.track.activeCues;
});

Das JavaScript-Interface, das das <track>-Element repräsentiert, ist HTMLTrackElement. Der Texttrack, der einem Element zugeordnet ist, kann von der HTMLTrackElement.track Eigenschaft erhalten werden und ist vom Typ TextTrack.

TextTrack Objekte können auch zu einem HTMLVideoElement oder HTMLAudioElement Elementen mit der Methode HTMLMediaElement.addTextTrack() hinzugefügt werden. Die TextTrack Objekte, die mit einem Media-Element verbunden sind, werden in einer TextTrackList gespeichert, die über die HTMLMediaElement.textTracks Eigenschaft abgerufen werden kann.

• WebVTT-Text-Track-Format
• HTMLMediaElement.textTracks