CKTIS / HTML
kind — rodzaj ścieżki tekstowej
Atrybut kind elementu track określa przeznaczenie ścieżki tekstowej. Brak atrybutu oznacza subtitles, a wartość nieprawidłowa lub pusta — metadata.
Wersja: WHATWG HTML Living Standard; index snapshot date recorded separately
Składnia
<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 jest atrybutem wyliczeniowym elementu track, używanego wewnątrz audio lub video. Określa przeznaczenie zewnętrznej ścieżki tekstowej zsynchronizowanej z materiałem, a nie jej język czy format pliku.
subtitles oznacza transkrypcję lub tłumaczenie dialogów; captions uwzględnia także istotne dźwięki i muzykę. descriptions zawiera tekstowe opisy obrazu przeznaczone do syntezy mowy. chapters oznacza ścieżkę z rozdziałami ułatwiającymi nawigację po materiale; przeglądarka może przedstawić je jako interaktywną listę. metadata oznacza ścieżkę przeznaczoną dla skryptów, której przeglądarka nie wyświetla.
Brak kind oznacza subtitles; nieprawidłowa wartość, także kind="", oznacza metadata. To nie czyni błędnej wartości poprawną. src jest wymagany; dla subtitles wymagany jest również srclang z poprawnym znacznikiem języka BCP 47.
Przykład porównuje surową wartość z getAttribute('kind') z efektywnym rodzajem ścieżki w track.track.kind. Samo kind nie włącza wyświetlania napisów.
Przykłady
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);Wynik
subtitles captions invalid metadata metadata
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.