Idées reçues

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

9 min de lecture
Mikhail ShaymardanovExpert en Qualité et Accessibilité Web

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 ».

Capture d'écran : page « Arrivages de la semaine » d'un disquaire, six pochettes de vinyles aux motifs rouges et noirs, chacune avec son groupe, son titre, la mention 33 T ou 45 T, son prix et une pastille verte ou orange.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.
Sur la page « Arrivages », le blocrepère 1, chaque pastillerepère 2 et chaque formatrepère 3 portent un aria-label sans attribut role ; à l'écran, la pastille ne montre que sa couleur.

#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.

Avec du texte dans le div, trois couples sur huit annoncent l'aria-label ; sans texte, NVDA le lit et JAWS le saute.
Lecteur d'écran et navigateurUn div qui contient du texteUn div vide
JAWS et ChromeTexte seulRien
NVDA et Chrome ou FirefoxTexte seulNom
VoiceOver et Safari sur MacNom et rôle de groupeNom et rôle de groupe vide
VoiceOver et Safari sur iPhoneTexte seulRien
TalkBack et ChromeNom à la place du texteNom
TalkBack et FirefoxTexte seulRien
Narrateur et ChromeNom, rôle de groupe et texteRien

#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.

Pour une zone, le nom vient du titre visible ; ailleurs, un texte remplace l'attribut, à l'écran ou masqué.
Ce que le div devait direCe qu'on écrit à la place
Nommer une zoneUne section et aria-labelledby vers son titre
Remplacer un visuel sans texteUn 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.

Capture d'écran : en-tête du bloc d'un disquaire, un grand 06 rouge à côté du titre « Arrivages de la semaine » et de la phrase « Reçus le jeudi 5 novembre : six disques, neufs et d'occasion », au-dessus de trois pochettes.Repère 1. Le titre visible « Arrivages de la semaine », que l'aria-label du div répète.
Le titre « Arrivages de la semaine »repère 1 est déjà à l'écran : la section le prend pour nom par aria-labelledby, et rien ne change à l'affichage.

À é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

Capture d'écran : carte d'un disque, la pochette rouge et noire, le groupe Orchestre Boréal, le titre Nuits de Valparaíso, la mention 33 T, le prix de 26 € et une pastille verte seule au bout de la ligne.Repère 1. La pastille verte, sans aucun mot à côté.
<span class="pastille stock" aria-label="En stock"></span>

Correct

Capture d'écran : la même carte, la pastille verte suivie des mots « En stock ».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 »

Sans mot, la pastillerepère 1 est sautée par JAWS et lue « En stock » par NVDA ; écrit à côté d'elle, « En stock »repère 1 se lit et se voit.

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

Capture d'écran : texte d'une carte de disque, Orchestre Boréal, Nuits de Valparaíso, puis la mention 33 T en blanc sur noir, le prix de 26 € et la pastille verte suivie de « En stock ».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

Capture d'écran : le même texte de carte, identique : la mention affiche toujours 33 T.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 »

Avec son aria-label, la mention « 33 T »repère 1 se lit « 33 T » avec JAWS et NVDA ; avec le texte masqué, elle s'affiche toujours « 33 T »repère 1 et se lit « 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.

Capture d'écran : outils de développement de Chrome, panneau Éléments, le div de classe arrivages sélectionné et, dans l'onglet Accessibilité, ses attributs ARIA et ses propriétés calculées.Repère 1. La ligne Name, qui affiche « Arrivages de la semaine ». Repère 2. La ligne Rôle, qui affiche generic.
Pour le div du bloc, Chrome affiche le nom « Arrivages de la semaine »repère 1 et le rôle genericrepère 2 : le nom existe, mais JAWS et NVDA ne l'annoncent pas.

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.


Partagez cet article

Questions fréquentes

Oui. La spécification ARIA interdit aria-labelledby comme aria-label sur un div ou un span sans rôle. Quand le div contient le titre que l'attribut désigne, l'outil de test axe le range parmi ses résultats « à vérifier ».

Sur une section, l'attribut a l'effet inverse : il lui donne un nom, et elle devient une région, un repère de la page.

L'attribut devient valide, sans garantie d'être lu. Sauf s'il est l'enfant direct d'une liste dl, un div accepte n'importe quel rôle, et group ne fait pas partie des rôles qui interdisent le nom. MDN note pourtant qu'en pratique aria-label n'est pris en charge que sur les éléments interactifs, les widgets, les repères, les images et les cadres.

Un groupe n'entre dans aucune de ces familles. Pour une zone, une section reliée à son titre reste plus sûre ; pour une information, un texte visible.

Ceux dont le rôle interdit le nom : le div et le span sans rôle, le paragraphe p, ou encore code, strong et em. La version 1.2 de la spécification ARIA compte onze rôles de ce type, dont generic, paragraph, code, strong et emphasis. Sa déclinaison pour le HTML marque les éléments correspondants « Naming Prohibited ».

Un li peut recevoir un nom, mais le guide de nommage du W3C le déconseille : les technologies d'assistance ne prennent pas ce nom en charge.