HTMLElement: lang-Eigenschaft

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

Die lang-Eigenschaft des HTMLElement-Interfaces gibt die Basissprache der Attributwerte und des Textinhalts eines Elements an, in Form eines RFC 5646: BCP 47 Sprachkennzeichens. Sie spiegelt das lang-Attribut des Elements wider; das xml:lang-Attribut beeinflusst diese Eigenschaft nicht.

Beachten Sie, dass, wenn das lang-Attribut nicht angegeben ist, das Element selbst möglicherweise die Sprache von seinem übergeordneten Element erbt. Diese geerbte Sprache wird jedoch nicht durch den Wert dieser Eigenschaft widergespiegelt.

Wert

Ein String. Häufige Beispiele sind "en" für Englisch, "ja" für Japanisch, "es" für Spanisch und so weiter. Wenn nicht angegeben, ist der Wert ein leerer String.

Beispiele

js
// this snippet compares the base language and
// redirects to another URL based on language
if (document.documentElement.lang === "en") {
  window.location.href = "Some_document.html.en";
} else if (document.documentElement.lang === "ru") {
  window.location.href = "Some_document.html.ru";
}

Spezifikationen

Specification
HTML
# dom-lang

Browser-Kompatibilität