CKTIS / HTML
track — tracce di testo temporizzate
L’elemento track associa ad audio o video una traccia di testo esterna sincronizzata nel tempo, come sottotitoli dei dialoghi, sottotitoli che includono informazioni sui suoni o metadati. Da solo non crea un elemento visibile separato.
Versione: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintassi
<video controls src="movie.webm">
<track kind="subtitles" src="subtitles.en.vtt" srclang="en" label="English" default>
</video>track è un elemento figlio diretto di audio o video. Si colloca dopo eventuali elementi source e prima del contenuto alternativo. È un elemento vuoto: non ha contenuto né tag di chiusura. L’attributo obbligatorio src indica i dati della traccia, di solito in formato WebVTT.
kind distingue subtitles (dialoghi), captions (dialoghi e suoni pertinenti), descriptions (descrizioni visive destinate alla sintesi vocale), chapters (metadati dei capitoli) e metadata (dati per gli script). Se kind è omesso, il valore è subtitles; un valore non valido significa metadata.
srclang è un tag di lingua BCP 47, obbligatorio per subtitles. label è un nome rivolto agli utenti e, se presente, non deve essere vuoto. L’attributo booleano default suggerisce di attivare la traccia, ma le preferenze dell’utente possono prevalere. Per un singolo elemento multimediale, al massimo una traccia del gruppo combinato subtitles e captions può avere default.
Nel DOM, element.track espone un oggetto TextTrack, non un elemento HTML. L’esempio ne legge le proprietà senza riprodurre contenuti multimediali; non verifica il caricamento dei cue né la visualizzazione dei sottotitoli.
Esempi
<!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>Risultato
TRACK | captions | en | English
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.