Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / HTML

kind — tipo di traccia testuale

L’attributo kind dell’elemento track indica lo scopo di una traccia testuale. Se omesso, il valore è subtitles; un valore non valido o vuoto corrisponde a metadata.

Versione: WHATWG HTML Living Standard; index snapshot date recorded separately

Sintassi

<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 è un attributo enumerato dell’elemento track, usato all’interno di audio o video. Indica lo scopo di una traccia testuale temporizzata esterna, non la lingua o il formato del file.

subtitles fornisce la trascrizione o la traduzione dei dialoghi; captions include anche i suoni e la musica rilevanti. descriptions offre descrizioni testuali degli elementi visivi destinate alla sintesi vocale. chapters fornisce indicatori di capitolo per navigare nel contenuto multimediale; il browser può presentarli come elenco interattivo. metadata identifica una traccia destinata agli script che il browser non visualizza.

Se kind è omesso, il valore è subtitles; un valore non valido, incluso kind="", corrisponde a metadata. Questo valore di ripiego non rende conforme un valore non valido. src è obbligatorio; per subtitles è necessario anche srclang con un tag di lingua BCP 47 valido.

L’esempio confronta il valore grezzo restituito da getAttribute('kind') con il tipo effettivo della traccia testuale in track.track.kind. Impostare solo kind non attiva la visualizzazione dei sottotitoli.

Esempi

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);

Risultato

subtitles
captions
invalid
metadata
metadata

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.

Fonti