# Langue de la page : déclarer la langue par défaut

Source: https://allyway.ai/fr/glossary/langue-de-la-page

Le critère de succès WCAG 3.1.1, Langue de la page, exige que la langue humaine par défaut de chaque page web puisse être déterminée par un programme informatique ; en HTML, au moyen de l’attribut lang de l’élément html.

Le critère WCAG Langue de la page impose que chaque page web déclare sa langue principale dans le code. Les navigateurs, les outils de traduction et les [lecteurs d’écran](https://allyway.ai/fr/glossary/lecteur-d-ecran) lisent cette déclaration pour choisir les règles de prononciation, les polices et la césure. Sans elle, une page en allemand peut être lue avec une prononciation anglaise, et personne ne la comprend.

## 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) : la langue humaine par défaut de chaque page web doit pouvoir être déterminée par un programme informatique. En HTML, la technique suffisante est H57, c’est-à-dire l’attribut `lang` sur l’élément `html`. Une langue définie dans l’en-tête HTTP (SVR5) n’est qu’un complément conseillé ; les lecteurs d’écran s’appuient sur l’attribut.

La **langue par défaut** est celle qui est la plus utilisée sur la page. Si plusieurs langues sont utilisées à parts égales, le W3C indique que c’est la première utilisée qui compte. Les mots isolés ou les passages dans une autre langue ne relèvent pas du critère 3.1.1 : ils relèvent du critère 3.1.2 [Langue d’un passage](https://allyway.ai/fr/glossary/langue-d-un-passage).

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

| Qui | Ce que permet la langue déclarée de la page |
|---|---|
| Utilisateurs de lecteurs d’écran et de synthèse vocale | Les bonnes règles de prononciation sont chargées |
| Personnes qui ont du mal à lire couramment | Les outils de lecture à voix haute prononcent correctement les mots |
| Personnes ayant des troubles cognitifs, du langage ou de l’apprentissage | La synthèse vocale reste compréhensible |
| Utilisateurs de sous-titres | Les lecteurs multimédias affichent correctement les sous-titres |

> **Note:** > **Langue de la page ou attribut lang manquant**
> La langue de la page est l’exigence. « [Attribut lang manquant](https://allyway.ai/fr/glossary/attribut-lang-manquant) » est l’erreur que signalent les outils d’analyse lorsqu’une page ne la respecte pas : pas de `lang`, une valeur vide ou un code qui n’est pas une véritable étiquette de langue.

Comme le critère 3.1.1 fait partie de la [norme européenne EN 301 549](https://allyway.ai/fr/regulations/en-301-549) (article 9.3.1.1), il compte aussi pour l’[acte européen sur l’accessibilité](https://allyway.ai/fr/regulations/eaa).

## Exemples

```html title="Exemple"
<!-- Good: English page, US English -->
<html lang="en-US">

<!-- Good: German page with an English quote -->
<html lang="de">
  ...
  <p>Ihr Slogan: <span lang="en">Made for everyone</span></p>

<!-- Bad: no language declared -->
<html>

<!-- Bad: wrong language – the site is in Spanish -->
<html lang="en">
```

Le deuxième exemple satisfait au critère 3.1.1 parce que la langue de la page est l’allemand ; l’attribut `lang="en"` de la citation correspond à ce que demande le critère 3.1.2.

**Do:** À faire

Définissez `lang` sur l’élément `html` de chaque modèle de page, y compris les pages d’erreur, les étapes du tunnel de commande et les pages générées par des extensions. Utilisez une étiquette BCP 47 valide comme `en`, `en-GB`, `de` ou `de-AT`, et donnez à chaque version linguistique d’un site multilingue sa propre valeur.

**Don't:** À éviter

Copier un même modèle avec `lang="en"` dans toutes les versions linguistiques, laisser la valeur vide, utiliser un code pays seul (`at` n’est pas une langue) ou inventer des codes comme `english`.

## Comment vérifier la langue de la page



## Questions fréquentes

Q: Qu’est-ce que la langue de la page dans les WCAG ?
A: C’est le critère de succès 3.1.1, de niveau A. Chaque page web doit déclarer sa langue humaine principale d’une manière lisible par les logiciels : en HTML, avec l’attribut `lang` sur l’élément `html`.

Q: Où indiquer la langue de la page en HTML ?
A: Sur la balise d’ouverture `html`, par exemple `<html lang="en">`. La plupart des thèmes de CMS la génèrent à partir du réglage de langue du site : vérifiez donc d’abord ce réglage avant de modifier le modèle.

Q: Faut-il utiliser « en » ou « en-US » ?
A: Les deux sont valides. Le code principal (`en`) suffit pour le critère 3.1.1 ; une région (`en-US`, `en-GB`) est utile lorsque l’orthographe ou la prononciation diffère d’un pays à l’autre.

Q: Que faire si ma page utilise deux langues ?
A: Déclarez comme langue de la page celle qui est la plus utilisée. Balisez les passages dans l’autre langue avec leur propre attribut `lang` : c’est le critère 3.1.2 Langue d’un passage.

Q: La langue de la page a-t-elle un impact sur le référencement (SEO) ?
A: Les moteurs de recherche détectent surtout la langue à partir du contenu, mais un attribut `lang` correct aide les navigateurs à proposer une traduction et assure la cohérence de la page avec son [titre de page](https://allyway.ai/fr/glossary/titre-de-page) et sa [structure des titres](https://allyway.ai/fr/glossary/structure-des-titres) pour les technologies d’assistance.
