Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / HTML

kind — tipo de faixa de texto

O atributo kind do elemento track indica a finalidade de uma faixa de texto. Se for omitido, o valor é subtitles; um valor inválido ou vazio corresponde a metadata.

Versão: WHATWG HTML Living Standard; index snapshot date recorded separately

Sintaxe

<track kind="subtitles" src="track.vtt" srclang="en">
<track kind="captions" src="track.vtt">
<track kind="descriptions" src="track.vtt">
<track kind="chapters" src="track.vtt">
<track kind="metadata" src="track.vtt">

kind é um atributo enumerado do elemento track, usado dentro de audio ou video. Indica a finalidade de uma faixa de texto temporizada externa, não o respetivo idioma nem o formato do ficheiro.

subtitles fornece uma transcrição ou tradução dos diálogos; captions inclui também sons e música relevantes. descriptions fornece descrições textuais dos elementos visuais destinadas à síntese de voz. chapters fornece marcadores de capítulos para navegar no conteúdo multimédia; o navegador pode apresentá-los como uma lista interativa. metadata identifica uma faixa destinada a scripts que o navegador não apresenta.

Se kind for omitido, o valor é subtitles; um valor inválido, incluindo kind="", corresponde a metadata. Este valor de recurso não torna válido um valor inválido. src é obrigatório; para subtitles, também é necessário srclang com uma etiqueta de idioma BCP 47 válida.

O exemplo compara o valor bruto de getAttribute('kind') com o tipo efetivo da faixa de texto em track.track.kind. Definir apenas kind não ativa a apresentação de legendas.

Exemplos

const track = document.createElement('track');
console.log(track.track.kind);
track.setAttribute('kind', 'captions');
console.log(track.track.kind);
track.setAttribute('kind', 'invalid');
console.log(track.getAttribute('kind'));
console.log(track.track.kind);
track.setAttribute('kind', '');
console.log(track.track.kind);

Resultado

subtitles
captions
invalid
metadata
metadata

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.

Fontes