Das lang-Attribut im <html> Element muss einen gültigen Wert haben

Casandra Visser

Autor

Yotam Flohr

Forscher

Ritvik Shrivastava

Experte

Juli 29, 2024

Betroffene Behinderungen: Blind Hören

Standards: WCAG 2.2 Level A

Laut Webzugänglichkeitsstandards muss ein HTML-Dokument ein gültiges lang-Attribut haben, damit mehrsprachige Screenreader-Nutzer den Inhalt korrekt verstehen.

Warum es wichtig ist

Beim Einrichten eines Screenreaders müssen Benutzer eine Standardsprache auswählen. Wenn die Sprache einer Website nicht angegeben ist, verwendet der Screenreader die vom Benutzer festgelegte Standardsprache.

Durch das Festlegen der Sprache einer Webseite stellen Sie sicher, dass der Inhalt korrekt ausgesprochen wird.

Behebung des Problems

Das <html>-Element muss ein lang– oder xml:lang-Attribut enthalten (z. B. <html lang=”de”> oder <html xml:lang=”de”>), das die Hauptsprache des Dokuments festlegt.

Die Sprache muss im öffnenden <html>-Element angegeben und korrekt geschrieben sein.

Dialekte können mit Codes wie de-AT (Österreichisches Deutsch) oder fr-CA (Kanadisches Französisch) angegeben werden.

Gutes Code-Beispiel

Codebeispiel

<html lang="de">
<!-- Dokumentenkopf und -körper -->
</html>

Kopieren

Wenn sich die Sprache innerhalb eines Dokuments ändert, können Sie dies wie folgt angeben:

<p>Text in einer Sprache <span lang=”es”>Text in einer anderen Sprache</span></p>

Wenn Sie eine Sprache verwenden, die von rechts nach links geschrieben wird, sollten Sie dies mit dem dir-Attribut angeben:

Codebeispiel

<p lang="ar" dir="rtl">Arabischer Text hier</p>

Kopieren

Wenn Sie angeben möchten, dass eine Sprache von links nach rechts geschrieben wird, können Sie den Wert des dir-Attributs mit „ltr“ füllen.

Testfälle

Für weitere Beispiele besuchen Sie die ATC Rules-Bibliothek auf GitHub von W3C.