Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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.

Fontes