CKTIS / HTML
track — faixas de texto temporizadas
O elemento track associa a áudio ou vídeo uma faixa de texto externa sincronizada no tempo, como legendas de diálogo, legendas que incluem informações sobre sons ou metadados. Por si só, não cria um elemento visível separado.
Versão: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaxe
<video controls src="movie.webm">
<track kind="subtitles" src="subtitles.en.vtt" srclang="en" label="English" default>
</video>track é um elemento filho direto de audio ou video. É colocado depois de eventuais elementos source e antes do conteúdo alternativo. É um elemento vazio: não tem conteúdo nem etiqueta de fecho. O atributo obrigatório src aponta para os dados da faixa, normalmente em formato WebVTT.
kind distingue subtitles (diálogo), captions (diálogo e sons relevantes), descriptions (descrições visuais destinadas à síntese de voz), chapters (metadados de capítulos) e metadata (dados para scripts). Se kind for omitido, o valor é subtitles; um valor inválido significa metadata.
srclang é uma etiqueta de idioma BCP 47, obrigatória para subtitles. label é um nome apresentado aos utilizadores e não pode estar vazio quando é indicado. O atributo booleano default sugere a ativação da faixa, mas as preferências do utilizador podem prevalecer. Para um elemento multimédia, no máximo uma faixa do grupo combinado subtitles e captions pode ter default.
No DOM, element.track expõe um objeto TextTrack, não um elemento HTML. O exemplo lê as respetivas propriedades sem reproduzir multimédia; não verifica o carregamento de cues nem a apresentação de legendas.
Exemplos
<!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>Resultado
TRACK | captions | en | English
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.