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 der HTMLElement-Schnittstelle gibt die Basissprache der Attributwerte und des Textinhalts eines Elements an, in Form eines RFC 5646: BCP 47 Sprachidentifikator-Tags. Sie entspricht dem lang-Attribut des Elements; das xml:lang-Attribut beeinflusst diese Eigenschaft nicht.

Beachten Sie, dass, wenn das lang-Attribut nicht angegeben ist, das Element selbst die Sprache möglicherweise vom übergeordneten Element erbt. Diese geerbte Sprache wird jedoch nicht im 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

BCD tables only load in the browser