HTML lang attribute

Die Sprache steht in zwei Zeilen HTML

html-Element und einzelne Zitate: zwei Stellen für die Sprachangabe.

Website prüfen
Beispiel im Prüfbericht Markierter Befund
Markierter Befund · Kritisch · WCAG 3.1.1 · html ohne langDokumentsprache fehlt

Sprache im DOM

Ein Attribut legt die Lesespur

lang beginnt am Dokument, fließt durch seine Kinder und wechselt nur dort, wo der Inhalt wirklich die Sprache ändert.

Vererbung sichtbar gemacht

Vom Element zur gesprochenen Passage

Deutsch Englisch

01 · Markup

Dokumentwurzel<html lang="de">setzt de
Kind<body>erbt de
Satz<p>erbt de
Sprachwechsel<span lang="en">setzt en

02 · Aufgelöste Sprache

de · vom html-ElementDer Hersteller nennt das
en · lokal gesetzttension release system
de · Vererbung greift wiederin der Anleitung.
Mögliche Verarbeitung

Browser können damit Rechtschreibung und Textverarbeitung steuern. Sprachausgaben können an der markierten Stelle die Ausspracheregeln wechseln.

Ein inneres lang überschreibt die geerbte Sprache nur für das Element und seine Nachkommen. Nach dem span gilt wieder de vom umgebenden Absatz.

Kopierfähige Basis

Das vollständige Dokument

index.html
<!doctype html>
<html lang="de">
  <head>
    <meta charset="utf-8">
    <title>Montageanleitung</title>
  </head>
  <body>
    <h1>Montageanleitung</h1>

    <p>
      Der Hersteller nennt das
      <span lang="en">tension release system</span>
      in der Anleitung.
    </p>

    <p lang="de-CH">
      Die Schweizer Fassung verwendet „Strasse“.
    </p>

    <nav aria-label="Sprachauswahl">
      <a href="/en/" lang="en" hreflang="en">English</a>
      <a href="/fr/" lang="fr" hreflang="fr">Français</a>
    </nav>
  </body>
</html>

BCP 47 lesen

Erst Sprache, dann nur nötige Details

Für eine allgemein deutsche Seite reicht de. Ergänzen Sie Region oder Schrift nur, wenn der Inhalt diese Unterscheidung wirklich braucht.

deSprache · Deutsch
CHRegion · Schweiz

Allgemeindeenfr

Wenn relevantde-CHen-GB

Nicht gültigde_DEen UK

Prüfen statt vermuten

Markup, Wert und Ausgabe getrennt testen

Ein ausbleibender Stimmenwechsel beweist allein keinen Markup-Fehler. Stimmen, Einstellungen und Kombinationen aus Browser und Hilfstechnik beeinflussen das Ergebnis.

  1. 01
    Dokumentwurzel ansehen

    Im Elemente-Panel muss am html-Element lang="de" stehen.

  2. 02
    Attributwerte abfragen
    document.documentElement.lang
    document.querySelector('[lang="en"]').lang

    Erwartet werden de und en.

  3. 03
    Mit Sprachausgabe gegenhören

    Automatischen Sprachwechsel aktivieren, passende Stimmen installieren und den ganzen Satz lesen. Auf einen Wechsel an der englischen Passage achten.

Aus dem Prüfbericht

Vier Regeln, vier Befunde

Kritisch Das html-Element trägt kein lang Regel html-has-lang

Ohne Hauptsprache wählt die Sprachausgabe die Aussprache selbst. Ein lang="de" am html-Element gilt für die ganze Seite.

Anleitung: Die Sprache der Seite angeben

Zum Mitnehmen

Die Sprachangaben, korrigiert

Eine Zeile für das Dokument, eine für den Sprachwechsel.

Korrektur in 2 Schritten ansehen
  1. Die Hauptsprache gültig angeben

    Der Sprachcode nach BCP 47 lautet de. Das widersprechende xml:lang entfällt; eine gewöhnliche HTML-Seite braucht es nicht.

    KorrekturvergleichSchritt 1 · HTML

    Vorher

    <!doctype html>
    <html lang="deutsch" xml:lang="en">

    Nachher

    <!doctype html>
    <html lang="de">

    Markierte Zeilen wurden geändert

    So prüfen Sie es Prüfen Sie im Elemente-Panel lang="de" am html-Element. Testen Sie die Aussprache zusätzlich mit verfügbaren deutschen Stimmen.

  2. Den Sprachwechsel im Satz auszeichnen

    Nur die fremdsprachige Passage bekommt ein eigenes lang. Der deutsche Satz darum herum behält die Sprache des Dokuments.

    KorrekturvergleichSchritt 2 · HTML

    Vorher

    <p>Der Hersteller nennt das
      <span lang="xx">tension release system</span>.</p>

    Nachher

    <p>Der Hersteller nennt das
      <span lang="en">tension release system</span>.</p>

    Markierte Zeilen wurden geändert

    So prüfen Sie es Aktivieren Sie den automatischen Sprachwechsel und passende Stimmen. Achten Sie beim Vorlesen auf den Wechsel an der markierten Passage.

Werbung

Kostenloser Website-Barrierefreiheits-Check

Website auf Barrierefreiheit prüfen.

Technische WCAG-Warnsignale erkennen. Kritische Stellen zuerst prüfen.

Der Website-Check ist bereit.

Werbung

Ein letzter Schritt

Prüfen, bevor Sie gehen.

Finden Sie automatisch erkennbare Barrieren auf Ihrer eigenen Website.

Website prüfen

Kostenlos starten · keine Installation

Automatisches Screening. Tastaturbedienung und Screenreader bleiben manuelle Prüfung.