Attribut lang manquant : l’erreur expliquée et corrigée
Autres noms: Élément html sans attribut lang, Langue de la page non définie, Langue du document manquante
Définition
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 est un critère de niveau A des 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 | Des sous-titres affichés correctement |
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
<!-- 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>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.
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é, 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 dans l’en-tête ou un niveau de titre sauté dans le pied de page.
Questions fréquentes
Que signifie « L’élément html n’a pas d’attribut lang » ?
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.
Un attribut lang manquant est-il une erreur WCAG ?
Oui. Il ne satisfait pas au critère 3.1.1 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.
Faut-il utiliser « en » ou « en-US » ?
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.
Chaque page a-t-elle besoin de son propre attribut lang ?
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.
Comment détecter un attribut lang manquant sur toutes les pages ?
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 la signale dès la première analyse, avec d’autres problèmes de niveau A.
Termes associés
Attribut alt manquant : l’erreur expliquée et corrigée
Un attribut alt manquant signifie qu’un élément img (ou un bouton image, ou une zone de carte image) n’a aucun attribut alt. Les technologies d’assistance ne peuvent pas savoir si l’image est informative ou décorative et risquent de lire le nom du fichier à la place.
Lire la définition: Attribut alt manquant : l’erreur expliquée et corrigéeBouton vide : comprendre et corriger l’erreur
Un bouton vide est un élément bouton sans nom accessible : ni texte, ni aria-label, ni texte alternatif sur une image qu’il contient. Les lecteurs d’écran annoncent seulement qu’il s’agit d’un bouton, pas ce qu’il fait.
Lire la définition: Bouton vide : comprendre et corriger l’erreurNiveau de titre sauté : comprendre et corriger l’alerte
Un niveau de titre sauté est un saut de plus d’un rang vers le bas dans la hiérarchie des titres, par exemple d’un h2 directement à un h4. Les utilisateurs de lecteurs d’écran qui naviguent par les titres peuvent croire qu’il manque une section.
Lire la définition: Niveau de titre sauté : comprendre et corriger l’alerteLangue de la page : déclarer la langue par défaut
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.
Lire la définition: Langue de la page : déclarer la langue par défaut