Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / HTML

srclang — język ścieżki tekstowej

Atrybut srclang elementu track określa język danych ścieżki tekstowej za pomocą znacznika BCP 47. Jest wymagany dla napisów typu subtitles, również gdy pominięto kind.

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

Składnia

<track src="…" kind="subtitles" srclang="pl" label="Polski">

Atrybut srclang elementu track określa język danych ścieżki tekstowej, a nie język ścieżki dźwiękowej. Wartość musi być poprawnym znacznikiem języka BCP 47, na przykład pl, en lub en-GB. Nie tłumaczy on treści.

Atrybut jest wymagany, gdy kind ma stan subtitles. Dotyczy to także pominięcia kind, ponieważ jego domyślnym stanem jest subtitles. Dla pozostałych rodzajów ścieżek srclang jest opcjonalny. Brak atrybutu lub pusty ciąg oznacza brak określonego języka ścieżki; pusty ciąg nie jest jednak poprawnym znacznikiem BCP 47.

Nie myl srclang z src, który wskazuje zasób ścieżki, ani z label, który nadaje jej nazwę dla użytkownika. W przykładzie dokument ma język en, a ścieżka — pl. Odczyt atrybutu nie wymaga odtwarzania filmu.

Przykłady

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>srclang example</title>
<video controls>
  <track id="subtitles" kind="subtitles" srclang="pl" label="Polski"
    src="data:text/vtt,WEBVTT%0A%0A00:00.000%20--%3E%2000:02.000%0ACze%C5%9B%C4%87!%0A">
</video>
<pre id="result"></pre>
<script>
  const track = document.getElementById('subtitles');
  document.getElementById('result').textContent = track.getAttribute('srclang');
</script>
</html>

Wynik

pl

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

Źródła