WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / HTML

srclang — Sprache der Textspur

Das Attribut srclang von track gibt die Sprache der Textspurdaten mit einem BCP-47-Sprach-Tag an. Bei Untertiteln ist es erforderlich, auch wenn kind weggelassen wird.

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

Syntax

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

Das Attribut srclang von track gibt die Sprache der Textspurdaten an, nicht die Sprache der Audiospur. Sein Wert muss ein gültiger BCP-47-Sprach-Tag sein, zum Beispiel pl, en oder en-GB. Es übersetzt den Inhalt nicht.

Das Attribut ist erforderlich, wenn kind den Zustand subtitles hat. Das gilt auch, wenn kind weggelassen wird, denn der Standardwert bei fehlender Angabe ist subtitles. Bei anderen Spurtypen ist srclang optional. Ein fehlendes Attribut oder eine leere Zeichenfolge bedeutet, dass für die Spur keine Sprache angegeben ist; eine leere Zeichenfolge ist jedoch kein gültiger BCP-47-Tag.

Verwechsle srclang nicht mit src, das die Spurressource angibt, oder mit label, das einen für Nutzer lesbaren Namen bereitstellt. Im Beispiel ist die Dokumentsprache en, während die Spur die Sprache pl hat. Zum Auslesen des Attributs muss das Video nicht abgespielt werden.

Beispiele

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

Ergebnis

pl

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen