CKTIS / HTML
srclang — langue de la piste textuelle
L’attribut srclang de track indique la langue des données de la piste textuelle au moyen d’une balise de langue BCP 47. Il est obligatoire pour les sous-titres, même si kind est omis.
Version : WHATWG HTML Living Standard; index snapshot date recorded separately
Syntaxe
<track src="…" kind="subtitles" srclang="pl" label="Polski">L’attribut srclang de track indique la langue des données de la piste textuelle, et non celle de la piste audio. Sa valeur doit être une balise de langue BCP 47 valide, par exemple pl, en ou en-GB. Il ne traduit pas le contenu.
Cet attribut est obligatoire lorsque kind est à l’état subtitles. C’est également le cas si kind est omis, car sa valeur par défaut en l’absence d’indication est subtitles. Pour les autres types de pistes, srclang est facultatif. Un attribut absent ou une chaîne vide signifie qu’aucune langue n’est précisée pour la piste ; toutefois, une chaîne vide n’est pas une balise BCP 47 valide.
Ne confondez pas srclang avec src, qui indique la ressource de la piste, ni avec label, qui fournit un nom lisible par l’utilisateur. Dans l’exemple, la langue du document est en, tandis que celle de la piste est pl. La lecture de l’attribut ne nécessite pas la lecture de la vidéo.
Exemples
<!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>Résultat
pl
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.