Cette page a été traduite à partir de l'anglais par la communauté. Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.

View in English Always switch to English

HTMLElement : propriété lang

Baseline Widely available

Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis ⁨juillet 2015⁩.

La propriété lang de l'interface HTMLElement indique la langue de base des valeurs d'attribut et du contenu textuel d'un élément, sous la forme d'une étiquette de langue BCP 47. Elle reflète l'attribut lang de l'élément ; l'attribut xml:lang n'a aucun effet sur cette propriété.

Notez que si l'attribut lang n'est pas précisé, l'élément peut tout de même hériter de la langue de son parent. Cependant, cette langue héritée n'est pas reflétée par la valeur de cette propriété.

Valeur

Une chaîne de caractères. Les exemples courants sont « en » pour anglais, « ja » pour japonais, « es » pour espagnol, etc. Si non précisé, la valeur est une chaîne vide.

Exemples

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 = "Some_document.html.en";
} else if (document.documentElement.lang === "ru") {
  window.location.href = "Some_document.html.ru";
}

Spécifications

Specification
HTML
# dom-lang

Compatibilité des navigateurs