<track>: Das Embed Text Track Element

Dieses Element umfasst die globalen Attribute.

default

Dieses Attribut gibt an, dass der Track aktiviert werden sollte, es sei denn, die Benutzereinstellungen geben an, dass ein anderer Track geeigneter ist. Dies darf nur auf ein track-Element pro Medienelement angewendet werden.

kind

Wie der Texttrack verwendet werden soll. Wenn es weggelassen wird, ist der Standardtyp 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 der Betrachter nicht verstehen kann. Zum Beispiel gesprochener Text oder Text, der in einem englischsprachigen Film nicht auf Englisch ist.
  • Untertitel können zusätzliche Inhalte 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 Audiodateien.
  • 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 gehörlos sind oder wenn der Ton stummgeschaltet ist.

• chapters

  • Kapiteltitel sollen verwendet werden, wenn der Benutzer die Medienressource navigiert.

• metadata

  • Tracks, die von Skripten verwendet werden. Für den Benutzer nicht sichtbar.

label

Ein für den Benutzer lesbarer Titel des Texttracks, der vom Browser verwendet wird, wenn verfügbare Texttracks aufgelistet werden.

src

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

srclang

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

Der Typ der Daten, die track dem Medium hinzufügt, wird im kind-Attribut festgelegt, das Werte von subtitles, captions, chapters oder metadata annehmen kann. Das Element verweist auf eine Quelldatei, die zeitlich abgestimmten Text enthält, den der Browser bereitstellt, wenn der Benutzer zusätzliche Daten anfordert.

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

Das zugrunde liegende TextTrack, angezeigt durch die track-Eigenschaft, erhält ein cuechange-Ereignis jedes Mal, wenn der aktuell angezeigte Hinweis geändert wird. Dies geschieht auch dann, wenn der Track nicht mit einem Medienelement verbunden ist.

Wenn der Track mit einem Medienelement assoziiert ist, 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 mit einem Element assoziierte Texttrack kann von der HTMLTrackElement.track-Eigenschaft abgerufen werden und ist vom Typ TextTrack.

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

• WebVTT-Texttrack-Format
• HTMLMediaElement.textTracks