Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / HTML

terme ou valeur HTML: lang

L’attribut `lang` déclare la langue naturelle d’un élément et de son contenu afin que navigateurs et technologies d’assistance choisissent la prononciation et la typographie appropriées.

Version : WHATWG HTML Living Standard; index snapshot date recorded separately

Syntaxe

<article lang="fr">…</article>

Une valeur lang non vide doit être une balise linguistique BCP 47 valide comme fr ou pt-PT ; la valeur vide n’est permise que pour une langue explicitement inconnue. L’absence hérite de la langue d’un ancêtre.

Dans un document HTML, lang="" déclare la langue inconnue ; la sérialisation XML emploie xml:lang et, si les deux attributs existent, leurs valeurs doivent correspondre sans tenir compte de la casse ASCII. Déclarez la langue par défaut sur la racine et ne la remplacez que pour un passage dans une autre langue.

La langue influence notamment la prononciation du lecteur d’écran, l’orthographe, la césure et les guillemets. Le sélecteur :lang() tient compte de l’héritage, alors que [lang] ne trouve que les éléments portant leur propre attribut.

Dans l’exemple, x.lang renvoie "" car le paragraphe n’a pas d’attribut propre ; closest("[lang]") trouve le fr hérité, tandis que document.documentElement.lang révèle l’absence sur la racine. Il distingue réflexion et langue effective.

Exemples

<!doctype html><meta charset="utf-8"><article id="a" lang="fr"><p id="x">Bonjour</p></article><output id="result"></output><script>result.textContent=`own=${x.lang}; inheritedFrom=${x.closest("[lang]").lang}; document=${document.documentElement.lang}`;</script>

Résultat

own=; inheritedFrom=fr; document=

L’exemple exécuté vérifie que la propriété IDL reflète seulement l’attribut propre, même si le contenu hérite de la langue du plus proche ancêtre.

Sources