<track>: Das Textspurelement für Einbettungen

Dieses Element umfasst die globalen Attribute.

default

Dieses Attribut zeigt an, dass die Spur aktiviert werden sollte, es sei denn, die Benutzereinstellungen geben an, dass eine andere Spur geeigneter ist. Dies darf nur auf einem track-Element pro Medienelement verwendet werden.

kind

Wie die Textspur verwendet werden soll. Wird es weggelassen, 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 der Betrachter nicht verstehen kann. Zum Beispiel Sprache oder Text, der nicht Englisch in einem englischsprachigen Film ist.
  • Untertitel können zusätzliche Inhalte enthalten, in der Regel zusätzliche Hintergrundinformationen. Zum Beispiel der Text zu Beginn 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 gehörlos sind oder wenn der Ton stummgeschaltet ist.

• chapters

  • Kapitelüberschriften sollen verwendet werden, wenn der Benutzer die Medienressource durchsucht.

• metadata

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

label

Ein benutzerlesbarer Titel der Textspur, der vom Browser verwendet wird, wenn verfügbare Textspuren aufgelistet werden.

src

Adresse der Spur (.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> Elternelement des track Elements hat ein crossorigin Attribut.

srclang

Sprache der Textspur-Daten. Es muss ein gültiges BCP 47 Sprach-Tag 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, welches 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 Medienelement kann nicht mehr als eine track mit demselben kind, srclang und label haben.

Das zugrunde liegende TextTrack, das durch die track Eigenschaft angezeigt wird, erhält jedes Mal ein cuechange Ereignis, wenn das derzeit präsentierte Cue geändert wird. Dies geschieht auch, wenn die Spur nicht mit einem Medienelement verbunden ist.

Wenn die Spur mit einem Medienelement verbunden 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. Die mit einem Element verknüpfte Textspur kann aus der HTMLTrackElement.track Eigenschaft abgerufen werden und ist vom Typ TextTrack.

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

• WebVTT-Textspurformat
• HTMLMediaElement.textTracks