<track>: Das eingebettete Textspur-Element

Dieses Element beinhaltet die globalen Attribute.

default

Dieses Attribut zeigt an, dass die Spur aktiviert werden sollte, es sei denn, die Benutzerpräferenzen deuten darauf hin, dass eine andere Spur geeigneter ist. Dies darf nur auf einem track-Element pro Medienelement verwendet werden.

kind

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

• subtitles

  • Untertitel bieten eine Übersetzung von Inhalten, die der Betrachter nicht versteht. Zum Beispiel gesprochene Sprache oder Text, der nicht in Englisch in einem englischen Film 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 musikalische Hinweise 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 sind dazu gedacht, verwendet zu werden, wenn der Benutzer die Medienressource navigiert.

• metadata

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

label

Ein für den Benutzer lesbarer Titel der Textspur, der vom Browser verwendet wird, um verfügbare Textspuren aufzulisten.

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 übergeordnete Element <audio> oder <video> des track-Elements hat ein crossorigin Attribut.

srclang

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

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 bereitstellt, 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 ein cuechange-Ereignis jedes Mal, wenn sich der aktuell präsentierte Hinweis ändert. Dies geschieht auch dann, wenn die Spur nicht mit einem Medienelement verknüpft ist.

Wenn die Spur mit einem Medienelement verknüpft 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;
});

Die JavaScript-Schnittstelle, die das <track>-Element repräsentiert, ist HTMLTrackElement. Die der zugehörigen Textspur kann vom HTMLTrackElement.track-Eigenschaft erhalten werden und ist vom Typ TextTrack.

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

• WebVTT Textspur-Format
• HTMLMediaElement.textTracks