<track>: Das Textspur-Element zum Einbetten

Dieses Element umfasst die globalen Attribute.

default

Dieses Attribut zeigt an, dass die Spur aktiviert werden soll, es sei denn, die Benutzerpräferenzen zeigen an, dass eine andere Spur besser geeignet ist. Dieses Attribut darf nur auf einem track Element pro Medienelement verwendet werden.

kind

Wie die Textspur verwendet werden soll. Wenn 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 in einem englischsprachigen Film nicht auf Englisch ist.
  • Untertitel können zusätzlichen Inhalt 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

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

• metadata

  • Von Skripten verwendete Spuren. Nicht für den Benutzer sichtbar.

label

Ein für den Benutzer lesbarer 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 der Wert der URL muss den gleichen Ursprung wie das Dokument haben — es sei denn, das <audio> oder <video> Eltern-Element des track Elements hat ein crossorigin Attribut.

srclang

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

Der Datentyp, den track zu dem Medium hinzufügt, wird im kind Attribut festgelegt, das Werte von subtitles, captions, chapters oder metadata annehmen kann. Das Element zeigt auf eine Quelldatei, die zeitlich festgelegte Texte enthält, die der Browser freigibt, wenn der Benutzer zusätzliche Daten anfordert.

Ein Medienelement kann nicht mehr als eine track mit derselben 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 selbst dann, wenn die Spur nicht mit einem Medienelement verknüpft ist.

Wenn die Spur mit einem Medienelement verknüpft ist, wobei 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 darstellt, ist HTMLTrackElement. Die Textspur, die mit einem Element verknüpft ist, kann aus 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 Medienelement verbunden sind, werden in einer TextTrackList gespeichert, die mittels der HTMLMediaElement.textTracks Eigenschaft abgerufen werden kann.

• WebVTT Textspur-Format
• HTMLMediaElement.textTracks