CKTIS / HTML
track — časované textové stopy
Prvek track připojuje k audiu nebo videu externí textovou stopu synchronizovanou s časem, například titulky dialogů, titulky zahrnující informace o zvucích nebo metadata. Sám o sobě nevytváří samostatný viditelný prvek.
Verze: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntaxe
<video controls src="movie.webm">
<track kind="subtitles" src="subtitles.en.vtt" srclang="en" label="English" default>
</video>track je přímým potomkem prvku audio nebo video. Umisťuje se za případné prvky source a před náhradní obsah. Jde o prázdný prvek: nemá obsah ani ukončovací značku. Povinný atribut src odkazuje na data stopy, obvykle ve formátu WebVTT.
kind rozlišuje subtitles (dialog), captions (dialog a důležité zvuky), descriptions (vizuální popisy určené pro syntézu řeči), chapters (metadata kapitol) a metadata (data pro skripty). Pokud kind chybí, platí subtitles; neplatná hodnota znamená metadata.
srclang je jazykový tag BCP 47 a pro subtitles je povinný. label je název určený uživatelům a pokud je uveden, nesmí být prázdný. Logický atribut default navrhuje stopu zapnout, přednost však mohou mít uživatelská nastavení. Pro jeden mediální prvek může mít atribut default nejvýše jedna stopa ze společné skupiny subtitles a captions.
V DOM zpřístupňuje element.track objekt TextTrack, nikoli prvek HTML. Příklad čte jeho vlastnosti bez přehrávání médií; neověřuje načítání cue ani zobrazování titulků.
Příklady
<!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>Výsledek
TRACK | captions | en | English
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.