Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / HTML

track — zsynchronizowane ścieżki tekstowe

Element track dołącza do audio lub video zewnętrzną ścieżkę tekstową powiązaną z czasem odtwarzania, na przykład napisy dialogowe, napisy uwzględniające dźwięki albo metadane. Sam nie tworzy osobnego widocznego elementu.

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

Składnia

<video controls src="movie.webm">
  <track kind="subtitles" src="subtitles.en.vtt" srclang="en" label="English" default>
</video>

track jest bezpośrednim dzieckiem audio lub video, umieszczanym po ewentualnych elementach source, przed treścią zastępczą. To element pusty: nie ma zawartości ani znacznika końcowego. Wymagany src wskazuje dane ścieżki, zwykle WebVTT.

kind rozróżnia subtitles (dialog), captions (dialog i istotne dźwięki), descriptions (opis obrazu przeznaczony do syntezy mowy), chapters (metadane rozdziałów) oraz metadata (dane dla skryptów). Brak kind oznacza subtitles; nieprawidłowa wartość oznacza metadata.

srclang to znacznik języka BCP 47, wymagany dla subtitles. label jest nazwą dla użytkownika i, jeśli występuje, nie może być pusty. Atrybut logiczny default sugeruje włączenie ścieżki, lecz preferencje użytkownika mogą mieć pierwszeństwo. Dla jednego medium najwyżej jedna ścieżka z łącznej grupy subtitles i captions może mieć default.

W DOM element.track udostępnia obiekt TextTrack, a nie element HTML. Przykład odczytuje jego właściwości bez odtwarzania medium; nie sprawdza ładowania ani wyświetlania napisów.

Przykłady

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>Track inspection</title>
<video>
  <track id="captions" kind="captions" srclang="en" label="English" src="data:text/vtt,WEBVTT%0A%0A00%3A00%3A00.000%20--%3E%2000%3A00%3A02.000%0AHello.%0A">
</video>
<pre id="result"></pre>
<script>
  const element = document.getElementById('captions');
  document.getElementById('result').textContent = [
    element.tagName,
    element.track.kind,
    element.track.language,
    element.track.label
  ].join(' | ');
</script>
</html>

Wynik

TRACK | captions | en | English

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła