CKTIS / HTML
track — zeitgesteuerte Textspuren
Das Element track fügt Audio oder Video eine externe, zeitlich synchronisierte Textspur hinzu, etwa Dialoguntertitel, Untertitel mit wichtigen Geräuschinformationen oder Metadaten. Es erzeugt selbst kein separates sichtbares Element.
Version: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
<video controls src="movie.webm">
<track kind="subtitles" src="subtitles.en.vtt" srclang="en" label="English" default>
</video>track ist ein direktes Kindelement von audio oder video. Es steht nach möglichen source-Elementen und vor Ersatzinhalten. Es ist ein leeres Element: Es hat weder Inhalt noch ein End-Tag. Das erforderliche src verweist auf die Spurdaten, meist im WebVTT-Format.
kind unterscheidet subtitles (Dialog), captions (Dialog und relevante Geräusche), descriptions (für die Sprachausgabe bestimmte Bildbeschreibungen), chapters (Kapitelmetadaten) und metadata (Daten für Skripte). Fehlt kind, gilt subtitles; ein ungültiger Wert bedeutet metadata.
srclang ist ein Sprach-Tag nach BCP 47 und für subtitles erforderlich. label ist ein für Nutzer sichtbarer Name und darf nicht leer sein, wenn er angegeben wird. Das boolesche Attribut default schlägt vor, die Spur zu aktivieren; Nutzereinstellungen können jedoch Vorrang haben. Für ein Medienelement darf höchstens eine Spur aus der gemeinsamen Gruppe subtitles und captions das Attribut default haben.
Im DOM stellt element.track ein TextTrack-Objekt bereit, kein HTML-Element. Das Beispiel liest dessen Eigenschaften aus, ohne Medien abzuspielen; es prüft weder das Laden von Cues noch die Anzeige von Untertiteln.
Beispiele
<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>Track inspection</title>
<video>
<track id="captions" kind="captions" srclang="en" label="English" src="data:text/vtt,WEBVTT%0A%0A00%3A00%3A00.000%20--%3E%2000%3A00%3A02.000%0AHello.%0A">
</video>
<pre id="result"></pre>
<script>
const element = document.getElementById('captions');
document.getElementById('result').textContent = [
element.tagName,
element.track.kind,
element.track.language,
element.track.label
].join(' | ');
</script>
</html>Ergebnis
TRACK | captions | en | English
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.