# Langue d’un passage : balisez le texte en langue étrangère

Source: https://allyway.ai/fr/glossary/langue-d-un-passage

La langue d’un passage correspond au critère de succès WCAG 3.1.2. La langue humaine de chaque passage ou expression du contenu doit pouvoir être déterminée par un programme informatique, sauf pour les noms propres, les termes techniques, les mots dont la langue est indéterminée et les mots entrés dans l’usage de la langue environnante.

La langue d’un passage est la règle WCAG selon laquelle un texte rédigé dans une autre langue que le reste de la page est balisé dans le code. Une citation en allemand sur une page en anglais, un nom de produit français accompagné de sa description ou l’entrée « Deutsch » d’un sélecteur de langue reçoivent leur propre attribut `lang`. Les lecteurs d’écran changent alors de prononciation au lieu de lire les mots étrangers avec les règles de l’anglais.

## Ce que cela signifie

Le critère [WCAG 3.1.2 Langue d’un passage](https://www.w3.org/WAI/WCAG22/Understanding/language-of-parts.html) est un critère de niveau AA des [WCAG 2.2](https://allyway.ai/fr/regulations/wcag-2-2). Il prolonge la [langue de la page](https://allyway.ai/fr/glossary/langue-de-la-page) (3.1.1) : la page déclare sa langue par défaut, et chaque passage ou expression dans une autre langue déclare la sienne. Un texte sans langue indiquée hérite de celle de la page ; une page rédigée dans une seule langue respecte donc le critère d’office.

Le critère vaut pour les passages longs comme pour les mots isolés. Le W3C nomme quatre exceptions :

| Cas | Exemple | `lang` nécessaire ? |
|---|---|---|
| Noms propres | Le nom d’un philosophe dans un texte en anglais | Non |
| Termes techniques | Homo sapiens, hertz, habeas corpus | Non |
| Mots dont la langue est indéterminée | Mots qui n’appartiennent à aucune langue en particulier | Non |
| Mots entrés dans l’usage de la langue environnante | « rendezvous » en anglais, « podcast » en français | Non |
| Phrase ou citation entière dans une autre langue | Une expression allemande dans un article en anglais | Oui |
| Noms de langues dans un sélecteur de langue | « Deutsch », « Français », « Español » | Oui |

Il n’est pas obligatoire de baliser les exceptions, mais le W3C y voit une bonne pratique. En cas de doute sur un mot emprunté, vérifiez s’il se prononce de la même façon dans la langue environnante.

Qui en bénéficie ? Les utilisateurs de [lecteurs d’écran](https://allyway.ai/fr/glossary/lecteur-d-ecran) entendent la bonne prononciation, les plages braille et les navigateurs vocaux peuvent appliquer les règles de la langue concernée, et les navigateurs et les outils de traduction traitent correctement le passage. Les personnes ayant des difficultés de lecture qui utilisent la synthèse vocale en dépendent aussi.

> **Tip:** > **Un attribut sur l’élément le plus proche**
> Utilisez l’attribut HTML `lang` (technique H58 du W3C) sur l’élément qui entoure le texte étranger : `span`, `blockquote`, `p` ou `a`. MDN explique l’[attribut lang](https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes/lang) et ses codes de langue.

## Exemples

```html title="Exemple"
<html lang="en">
…
<p>As the Austrians say, <span lang="de">"Schau ma mal"</span> – let's wait and see.</p>

<!-- Language switcher: each name in its own language -->
<ul>
  <li><a href="/de" lang="de" hreflang="de">Deutsch</a></li>
  <li><a href="/fr" lang="fr" hreflang="fr">Français</a></li>
</ul>

<!-- Not needed: proper name and vernacular word -->
<p>Our café near Mozartplatz offers a croissant breakfast.</p>
```

Le W3C montre aussi un cas de langues mélangées : un lien dont l’attribut `title` est en anglais contient le mot « Español » dans un `span` avec `lang="es"`. Seul le texte espagnol est balisé, l’attribut reste donc en anglais.

**Do:** À faire

Balisez avec `lang` les citations, les slogans, les titres de chansons et les phrases entières dans une autre langue. Donnez à chaque entrée d’un sélecteur de langue la langue dans laquelle elle est écrite. Utilisez des codes de langue valides comme `de`, `fr` ou `es-MX`.

**Don't:** À éviter

Baliser comme étranger chaque mot emprunté, comme « kindergarten » ou « café », utiliser des codes invalides comme `lang="german"` ou `en_US` que les navigateurs ne savent pas lire, se contenter d’un drapeau pour indiquer la langue d’un lien.

## Comment vérifier la langue d’un passage



## Questions fréquentes

Q: Dois-je baliser chaque mot étranger avec lang ?
A: Non. Les noms propres, les termes techniques, les mots dont la langue est indéterminée et les mots entrés dans l’usage de la langue environnante sont des exceptions. Balisez les expressions et les passages entiers dans une autre langue ; baliser aussi les exceptions reste une bonne pratique facultative.

Q: Quelle est la différence entre la langue de la page et la langue d’un passage ?
A: La langue de la page (3.1.1, niveau A) exige la langue par défaut sur l’élément `html`. La langue d’un passage (3.1.2, niveau AA) exige un attribut `lang` sur les passages qui diffèrent de cette langue par défaut.

Q: lang est-il la même chose que hreflang ?
A: Non. `lang` indique dans quelle langue est le contenu d’un élément. `hreflang` sur un lien indique dans quelle langue est la page cible. Un lien de sélecteur de langue peut utiliser les deux.

Q: Les noms de langues d’un sélecteur de langue ont-ils besoin de lang ?
A: Oui. Le W3C donne précisément cet exemple : « Deutsch » doit être balisé comme de l’allemand, « Français » comme du français. Sinon, un lecteur d’écran configuré en anglais les lit avec une prononciation anglaise.
