HTMLElement: lang property
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.
The HTMLElement.lang
property gets or sets the base
language of an element's attribute values and text content.
The language code returned by this property is defined in RFC 5646: Tags for Identifying Languages (also known as BCP 47).
Common examples include "en" for English, "ja" for
Japanese, "es" for Spanish and so on. The default value of this attribute is
unknown
. Note that this attribute, though valid at the individual element
level described here, is most often specified for the root element of the document.
This also only works with the lang
attribute and not with
xml:lang
.
Value
A string.
Examples
// 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";
}
Specifications
Specification |
---|
HTML Standard # dom-lang |
Browser compatibility
BCD tables only load in the browser