Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła