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.