# Attribut lang manquant : l’erreur expliquée et corrigée

Source: https://allyway.ai/fr/glossary/attribut-lang-manquant

Un attribut lang manquant signifie que l’élément html d’une page n’a pas d’attribut lang, ou qu’il est vide ou invalide. Les navigateurs et les lecteurs d’écran ne peuvent alors pas savoir dans quelle langue la page est rédigée.

Un attribut lang manquant est l’erreur que signalent les outils d’analyse lorsque l’élément `<html>` d’une page ne déclare pas la langue de la page. Les outils l’affichent par exemple sous la forme « L’élément html n’a pas d’attribut lang » ou « Langue de la page non définie ». La correction tient en un seul attribut, mais sans lui, un lecteur d’écran risque de lire toute votre page avec les mauvaises règles de prononciation.

## Ce que cela signifie

Le critère [WCAG 3.1.1 Langue de la page](https://www.w3.org/WAI/WCAG22/Understanding/language-of-page.html) est un critère de niveau A des [WCAG 2.2](https://allyway.ai/fr/regulations/wcag-2-2). Il exige que la langue humaine par défaut de chaque page web puisse être déterminée par un programme informatique. En HTML, c’est le rôle de l’attribut `lang` de l’élément `html` (technique H57 du W3C).

Pourquoi c’est important : les lecteurs d’écran et la synthèse vocale chargent les règles de prononciation de la langue déclarée. Si la langue de la page n’est pas définie, le logiciel utilise la voix par défaut de l’utilisateur. Une page en allemand lue par une voix anglaise est difficile à suivre, et l’inverse ne vaut pas mieux. Les navigateurs utilisent aussi la langue pour afficher correctement les caractères et pour la traduction automatique, et les lecteurs multimédias s’en servent pour afficher les sous-titres.

Le W3C cite ces groupes comme principaux bénéficiaires :

| Qui | Ce que l’attribut lang leur apporte |
|---|---|
| Utilisateurs de lecteurs d’écran et de synthèse vocale | Une prononciation et une voix correctes |
| Personnes qui ont du mal à lire un texte écrit | La synthèse vocale lit correctement les mots |
| Personnes en situation de handicap cognitif ou ayant des troubles du langage ou de l’apprentissage | Une lecture à voix haute fiable |
| Personnes qui ont besoin de [sous-titres](https://allyway.ai/fr/glossary/sous-titres) | Des sous-titres affichés correctement |

> **Note:** > **Quelle est la langue « par défaut » ?**
> Le W3C la définit comme la langue la plus utilisée sur la page. Si plusieurs langues sont utilisées à parts égales, la première utilisée est la langue par défaut. Les passages dans une autre langue relèvent d’un critère distinct, de niveau AA : 3.1.2 [Langue d’un passage](https://allyway.ai/fr/glossary/langue-d-un-passage).

Les outils d’analyse signalent aussi l’attribut lorsqu’il est présent mais vide (`lang=""`) ou qu’il ne contient pas une étiquette de langue valide. La valeur doit respecter la norme BCP 47, c’est-à-dire les codes courts habituels comme `en`, `de` ou `en-GB`.

## Exemples

```html title="Exemple"
<!-- Missing lang attribute: language unknown -->
<!DOCTYPE html>
<html>
  <head><title>Opening hours</title></head>

<!-- Fixed: English page -->
<html lang="en">

<!-- Fixed: British English with a region subtag -->
<html lang="en-GB">

<!-- A French quote inside the English page (3.1.2) -->
<p>Our motto: <span lang="fr">savoir-faire</span></p>
```

**Do:** À faire

Définissez `lang` sur l’élément `html` de chaque page, utilisez la langue dans laquelle est rédigée la majeure partie du contenu et donnez à chaque version linguistique d’un site multilingue son propre code.

**Don't:** À éviter

Ne laissez pas `lang` vide, n’inventez pas de codes comme `lang="english"` et ne copiez pas le même `lang="en"` dans un template traduit dont le contenu est désormais en allemand.

## Comment corriger un attribut lang manquant



L’attribut lang est un gain rapide pour tout audit au regard de l’[acte européen sur l’accessibilité](https://allyway.ai/fr/regulations/eaa), car le même réglage manquant concerne généralement toutes les pages d’un site. Tant que vous êtes dans le template, vérifiez d’autres problèmes communs à tout le site, comme un [bouton vide](https://allyway.ai/fr/glossary/bouton-vide) dans l’en-tête ou un [niveau de titre sauté](https://allyway.ai/fr/glossary/niveau-de-titre-saute) dans le pied de page.

## Questions fréquentes

Q: Que signifie « L’élément html n’a pas d’attribut lang » ?
A: La balise `<html>` de la page n’indique pas dans quelle langue le contenu est rédigé. Les technologies d’assistance devinent alors la langue ou utilisent leur langue par défaut, ce qui entraîne souvent une mauvaise prononciation.

Q: Un attribut lang manquant est-il une erreur WCAG ?
A: Oui. Il ne satisfait pas au critère 3.1.1 [Langue de la page](https://allyway.ai/fr/glossary/langue-de-la-page), de niveau A, car la langue de la page ne peut pas être déterminée par un programme informatique. Le niveau A est le niveau minimal de conformité aux WCAG.

Q: Faut-il utiliser « en » ou « en-US » ?
A: Les deux sont valides. Le code principal (`en`) satisfait aux WCAG. Une sous-étiquette de région comme `en-US` ou `en-GB` ajoute une précision que certaines voix et certains correcteurs orthographiques peuvent exploiter, mais elle est facultative.

Q: Chaque page a-t-elle besoin de son propre attribut lang ?
A: Oui. Le critère s’applique à chaque page web : chaque page doit donc déclarer sa langue par défaut. En pratique, vous le définissez une seule fois dans le template commun, et chaque version linguistique du template génère son propre code.

Q: Comment détecter un attribut lang manquant sur toutes les pages ?
A: Les templates provoquent généralement l’erreur sur tout le site : tester une page par template et par langue est donc un bon début. Le [vérificateur WCAG gratuit](https://allyway.ai/fr/free-wcag-accessibility-scanner-for-websites) la signale dès la première analyse, avec d’autres problèmes de niveau A.
