element.lang

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.

Résumé

Cette propriété permet d'obtenir ou de définir la langue de base des valeurs d'attribut et du contenu textuel d'un élément.

Syntaxe et valeurs

js
var langueUtilisee = référenceElement.lang; // Récupérer la valeur de lang
référenceElement.lang = NouvelleLangue; // Définir la valeur de lang

langueUtilisee est une variable chaîne de caracteres recevant la langue dans laquelle le texte de l'élément courant est écrit. NouvelleLangue est une variable chaîne de caractères dont la valeur définit la langue dans laquelle le texte de l'élément courant est écrit.

Exemple

js
// ce bout de code compare la langue de base et
// redirige vers une autre URL suivant la langue
if (document.documentElement.lang === "en") {
  window.location.href = "un_document.html.en";
} else if (document.documentElement.lang === "ru") {
  window.location.href = "un_document.html.ru";
}

Notes

Les codes de langues renvoyés par cette propriété sont définis dans la RFC 1766. Par exemple, « en » pour anglais, « ja » pour japonais, « es » pour espagnol, « fr » pour français, etc. La valeur par défaut de cet attribut est unknown (inconnue). Notez que cet attribut, bien que valide au niveau de chaque élément individuel, et le plus souvent spécifié pour le nœud racine du document.

Ne marche qu'avec l'attribut lang, et non avec xml:lang.

Spécifications

Specification
HTML Standard
# dom-lang