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.