CKTIS / HTML
srclang — idioma da faixa de texto
O atributo srclang de track indica o idioma dos dados da faixa de texto através de uma etiqueta de idioma BCP 47. É obrigatório para legendas, mesmo quando kind é omitido.
Versão: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaxe
<track src="…" kind="subtitles" srclang="pl" label="Polski">O atributo srclang de track indica o idioma dos dados da faixa de texto, não o idioma da faixa de áudio. O seu valor tem de ser uma etiqueta de idioma BCP 47 válida, como pl, en ou en-GB. Não traduz o conteúdo.
O atributo é obrigatório quando kind está no estado subtitles. Isto também se aplica quando kind é omitido, pois o valor predefinido na ausência do atributo é subtitles. Para os outros tipos de faixa, srclang é opcional. A ausência do atributo ou uma cadeia vazia significa que não é indicado um idioma para a faixa; contudo, uma cadeia vazia não é uma etiqueta BCP 47 válida.
Não confundas srclang com src, que identifica o recurso da faixa, nem com label, que fornece um nome legível para o utilizador. No exemplo, o idioma do documento é en, enquanto o idioma da faixa é pl. A leitura do atributo não requer a reprodução do vídeo.
Exemplos
<!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>Resultado
pl
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.