Un aria-label sur un div : pourquoi JAWS et NVDA le taisent, et quoi écrire à la place


Avec VoiceOver sur Mac, le développeur entend l'aria-label de son div, que JAWS et NVDA taisent. Sans role, un div ou un span est un conteneur qu'ARIA interdit de nommer. S'il contient du texte, ces deux lecteurs ne lisent que ce texte. Sur ordinateur, près de neuf répondants sur dix à l'enquête WebAIM 2026 utilisent d'abord l'un d'eux. Le nom passe en texte ou sur un élément nommable.
Treize attributs sur la page d'un disquaire
#Pourquoi un aria-label sur un div ne marche pas partout ?
Sur un div ou un span sans attribut role, un aria-label n'est annoncé que par quelques lecteurs d'écran, et JAWS n'en fait pas partie. L'attribut donne à l'élément son nom accessible, celui qu'annonce le lecteur d'écran. Sauf qu'un div sans attribut role a le rôle générique, un conteneur que la spécification ARIA interdit de nommer.
Le silence tombe sur les lecteurs les plus répandus : sur ordinateur, 55,0 % des répondants de l'enquête WebAIM 2026 utilisent d'abord JAWS. NVDA, muet lui aussi quand le div contient du texte, suit avec 32,9 %, loin devant VoiceOver et ses 6,5 %.
Sur la page « Arrivages » de Sillon Rouge, un disquaire de démo, le développeur a posé 13 aria-label. Le bloc des nouveautés en porte un, et chaque carte de disque deux : un sur sa pastille de stock, un sur son format abrégé, « 33 T » ou « 45 T ». La personne qui parcourt cette page avec JAWS n'entend aucun nom pour le bloc, ne rencontre aucune pastille et entend « 33 T ».
Repère 1. Le bloc « Arrivages de la semaine », un div qui porte un aria-label. Repère 2. La pastille verte de la première carte, sans aucun mot. Repère 3. La mention « 33 T » de la première carte.#Ce que lit chaque lecteur d'écran, avec ou sans texte dans le div
Le spécialiste de l'accessibilité Manuel Matuzović a testé huit couples de lecteur d'écran et de navigateur en mai 2026 : trois seulement annoncent le nom d'un élément qui contient du texte. Sur un élément vide, comme la pastille, NVDA lit le nom faute d'autre chose à dire, et JAWS ne trouve rien.
| Lecteur d'écran et navigateur | Un div qui contient du texte | Un div vide |
|---|---|---|
| JAWS et Chrome | Texte seul | Rien |
| NVDA et Chrome ou Firefox | Texte seul | Nom |
| VoiceOver et Safari sur Mac | Nom et rôle de groupe | Nom et rôle de groupe vide |
| VoiceOver et Safari sur iPhone | Texte seul | Rien |
| TalkBack et Chrome | Nom à la place du texte | Nom |
| TalkBack et Firefox | Texte seul | Rien |
| Narrateur et Chrome | Nom, rôle de groupe et texte | Rien |
#Pourquoi NVDA et JAWS ne lisent pas l'aria-label d'un div ?
Le navigateur calcule bien le nom et le transmet au lecteur d'écran, qui décide s'il l'annonce. Faut-il attendre une prochaine version ? En 2018, NVDA a ajouté la lecture de ces noms à son code, puis l'a retirée deux jours plus tard, au motif que trop de sites détournent aria-label.
Chez Freedom Scientific, l'éditeur de JAWS, le ticket qui demandait de lire un élément vide nommé par aria-label est classé « Not a JAWS bug ». Ce silence est donc un choix des éditeurs, appuyé par la spécification. C'est le code de la page qu'il faut corriger.
#Quoi écrire à la place d'un aria-label sur un div
La correction dépend de ce que le div devait dire.
Ce que le div devait dire | Ce qu'on écrit à la place |
|---|---|
| Nommer une zone | Une section et aria-labelledby vers son titre |
| Remplacer un visuel sans texte | Un mot visible, à défaut un attribut title, déconseillé |
| Préciser un texte abrégé | Le texte complet, masqué à l'écran |
#Comment nommer une zone de la page ?
Une section qui a un nom devient une région, un repère : une zone que le lecteur d'écran permet d'atteindre au clavier. Sans nom, elle reste générique. Sur la page de démo de Sillon Rouge, le div du bloc devient une section reliée à son titre par aria-labelledby.
Avec le div, JAWS et NVDA lisaient le titre et les cartes sans annoncer de zone, et l'outil de test axe rangeait le bloc « à vérifier ». Avec la section, nous avons vérifié que Chrome fait du bloc une région nommée « Arrivages de la semaine », et qu'axe ne signale plus son attribut.
Repère 1. Le titre visible « Arrivages de la semaine », que l'aria-label du div répète.À éviter
<div class="arrivages" aria-label="Arrivages de la semaine">
<h2>Arrivages de la semaine</h2>
<p>Reçus le jeudi 5 novembre : six disques, neufs et d'occasion.</p>
<ul class="grille">…</ul>
</div>Correct
<section class="arrivages" aria-labelledby="titre-arrivages">
<h2 id="titre-arrivages">Arrivages de la semaine</h2>
<p>Reçus le jeudi 5 novembre : six disques, neufs et d'occasion.</p>
<ul class="grille">…</ul>
</section>Le nom vient alors du titre visible, et il le suivra le jour où quelqu'un renommera le bloc.
#Comment faire lire une pastille de couleur ?
Sur chaque carte, une pastille vide dit la disponibilité : verte avec aria-label="En stock", orange avec « Sur commande ». JAWS n'annonce rien, NVDA lit le nom, et axe compte chaque pastille en erreur.
Ici, l'aspect doit changer, parce que la disponibilité n'est donnée que par la couleur. Le RGAA l'interdit à son critère 3.1. Les WCAG font de même, au critère 1.4.1. La règle protège d'abord la personne qui voit la page sans distinguer le vert de l'orange, et qui n'utilise pas forcément d'aide technique : réparer le nom de la pastille ne suffit donc pas.
#Mot visible ou attribut title : quelle solution choisir
Le mot à côté de la pastille, que nous recommandons. La pastille devient un décor. Pour : chacun voit le mot, à la souris, au clavier comme au doigt, et le lecteur d'écran le lit sans dépendre d'un attribut. Contre : il prend de la place. Sur Sillon Rouge, il tient : quatre fois « En stock », deux fois « Sur commande ».
À éviter
Repère 1. La pastille verte, sans aucun mot à côté.<span class="pastille stock" aria-label="En stock"></span>Correct
Repère 1. La pastille verte suivie des mots « En stock ».<span class="dispo">
<span class="pastille stock"></span>En stock
</span>Lecteur d'écran : « En stock »
Un attribut title sur la pastille, conforme mais fortement déconseillé. Il affiche une bulle « En stock » au survol de la souris, et la méthode de test du RGAA cite la « présence d'un attribut title » parmi les autres moyens de récupérer l'information. Pour : hors survol, la carte garde son aspect. Contre : au clavier comme au doigt, la bulle n'apparaît pas, et c'est justement pour cela que la norme HTML déconseille de s'y fier. Les lecteurs d'écran, eux, ne lisent pas le title de façon uniforme, note Steve Faulkner, qui a coédité la spécification HTML du W3C. C'est légal, pas recommandé.
Avec cette solution, ajoutez role="img" et aria-label="En stock" : la pastille devient une image porteuse d'information, que Chrome nomme ainsi et qu'axe ne signale plus. Ici, l'aria-label est bien lu : avec role="img", la pastille n'est plus un span générique mais une image, que la spécification ARIA permet de nommer. Le title sert à la souris, l'aria-label au lecteur d'écran.
<span class="pastille stock" role="img" aria-label="En stock" title="En stock"></span>#Comment préciser une abréviation comme 33 T ?
La mention « 33 T » porte aria-label="33 tours" pour que le lecteur d'écran dise le mot entier. JAWS et NVDA lisent pourtant « 33 T », et axe la range « à vérifier ».
Ici, l'écran ne change pas : « 33 T » reste affiché, caché aux lecteurs d'écran par aria-hidden="true". Le mot entier passe dans un texte masqué visuellement, un span de classe sr-only, que seul le lecteur d'écran lit.
À éviter
Repère 1. La mention abrégée « 33 T ».<span class="format" aria-label="33 tours">33 T</span>Lecteur d'écran : « 33 T »
Correct
Repère 1. La mention « 33 T », inchangée à l'écran.<span class="format">
<span aria-hidden="true">33 T</span><span class="sr-only">33 tours</span>
</span>Lecteur d'écran : « 33 tours »
Les deux captures sont identiques, et c'est voulu : à l'écran, rien ne change.
L'attribut aria-label : quand l'utiliser et comment l'écrire
#Comment retrouver les aria-label interdits et vérifier la correction ?
Le validateur du W3C met chacun de ces attributs en erreur. Le moteur axe n'en met qu'une partie, et l'onglet Accessibilité de Chrome comme l'écoute au lecteur d'écran en laissent passer.
#Comment retrouver ces attributs dans une page ou dans le code ?
Le validateur HTML du W3C les compte tous en erreur, avec ou sans texte. La règle d'axe aria-prohibited-attr les met en erreur sur un élément vide, « à vérifier » (incomplete) sur un élément qui contient du texte.
En passant à axe la page de démo de Sillon Rouge, nous avons obtenu six erreurs, une par pastille, et sept résultats à vérifier, le bloc et les six formats. Des développeurs collent tel quel dans Google le premier des deux messages d'axe :
- en erreur, pour une pastille :
aria-label attribute cannot be used on a span with no valid role attribute. - à vérifier, pour le bloc :
aria-label attribute is not well supported on a div with no valid role attribute.
Depuis axe 4.14, ces messages disent on "span" elements ou on "div" elements.
Un div rempli de texte, le cas courant, n'apparaît jamais parmi les erreurs d'axe : ouvrez toujours la liste « à vérifier ». Dans le code, cette recherche trouve ces attributs, aria-labelledby compris :
grep -rnoE '<(div|span)[^>]*aria-label' src/Sur nos fichiers de démo, elle relève 13 attributs avant correction, aucun après. Elle sort aussi les balises qui ont un role, à trier. Elle rate un attribut écrit sur une autre ligne que sa balise, courant en JSX.
#Pourquoi une seule vérification ne suffit pas ?
Dans Chrome, l'onglet Accessibilité du panneau Éléments affiche pour le bloc la ligne Name « Arrivages de la semaine » et le rôle generic. Le navigateur a donc calculé le nom. Pour un div générique, ni cette ligne ni l'écoute avec VoiceOver sur Mac ne disent si JAWS et NVDA l'annonceront. Pour le savoir depuis un Mac, NVDA s'écoute dans une machine virtuelle Windows.
Repère 1. La ligne Name, qui affiche « Arrivages de la semaine ». Repère 2. La ligne Rôle, qui affiche generic.Même l'écoute avec NVDA, le lecteur gratuit que nous conseillons pour ce contrôle, se laisse tromper par la pastille. D'après le test de Manuel Matuzović, NVDA tait le nom du bloc et lit « 33 T ». Sur la pastille vide, il lit pourtant « En stock », là où JAWS, le plus répandu, n'annonce rien.
Le moteur axe fait l'inverse, avec les pastilles en erreur et le reste « à vérifier » : chaque contrôle laisse passer ce que l'autre attrape.
Sur la page corrigée, axe ne signale plus rien sous aria-prohibited-attr, la recherche grep non plus. Les 13 aria-label ont laissé place à un seul aria-labelledby, sur la section, un élément nommable. Le mot « En stock », que JAWS taisait, s'écrit maintenant à l'écran, et le format « 33 tours », que NVDA ignorait comme lui, passe par un texte masqué.
Lecteur d'écran NVDA : installer, régler et tester une page avec Firefox
Sur un site publié, le scan d'Includdy liste les non-conformités d'une page, dont les éléments vides nommés par un aria-label, comme les pastilles de Sillon Rouge. Pour chacune, la correction guidée propose un composant corrigé, à relire avant de l'intégrer.


