Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / HTML

srclang — lingua della traccia di testo

L’attributo srclang di track indica la lingua dei dati della traccia di testo usando un tag di lingua BCP 47. È obbligatorio per i sottotitoli, anche quando kind è omesso.

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

Sintassi

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

L’attributo srclang di track indica la lingua dei dati della traccia di testo, non quella della traccia audio. Il suo valore deve essere un tag di lingua BCP 47 valido, ad esempio pl, en o en-GB. Non traduce il contenuto.

L’attributo è obbligatorio quando kind è nello stato subtitles. Questo vale anche se kind è omesso, perché il suo valore predefinito in assenza dell’attributo è subtitles. Per gli altri tipi di traccia, srclang è facoltativo. Un attributo assente o una stringa vuota significa che per la traccia non è specificata alcuna lingua; tuttavia, una stringa vuota non è un tag BCP 47 valido.

Non confondere srclang con src, che identifica la risorsa della traccia, né con label, che fornisce un nome leggibile dall’utente. Nell’esempio, la lingua del documento è en, mentre quella della traccia è pl. Per leggere l’attributo non è necessario riprodurre il video.

Esempi

<!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>

Risultato

pl

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti