Corriger « Commande ARIA sans intitulé » en HTML
Pourquoi c'est un problème
Un élément porteur d'un rôle button, link ou menuitem mais dépourvu de texte est annoncé « bouton » sans plus. C'est le cas typique du bouton composé d'une seule icône. Avec 576 occurrences mesurées sur 49 pages, c'est le manquement qui se répète le plus à l'intérieur d'une même page.
Comment corriger — HTML
Donnez un nom accessible à la commande : du texte visible, un aria-label, ou un aria-labelledby renvoyant à un libellé existant. Le titre de l'icône ne suffit pas, et une icône seule doit porter aria-hidden pour ne pas être annoncée deux fois.
<div role="button" tabindex="0">
<svg>…</svg>
</div><button type="button" aria-label="Fermer la fenêtre">
<svg aria-hidden="true">…</svg>
</button>
<!-- Ou, si un libellé existe déjà dans la page : -->
<h2 id="titre-panneau">Filtres</h2>
<button type="button" aria-labelledby="titre-panneau">
<svg aria-hidden="true">…</svg>
</button>Critère RGAA 11.9 — Formulaires
Dans chaque formulaire, l’intitulé de chaque bouton est-il pertinent (hors cas particuliers) ?
Comment vérifier : tests officiels
Test 11.9.1
L’intitulé de chaque bouton vérifie-t-il ces conditions (hors cas particuliers) ?
S’il est présent, le contenu de l’attribut WAI-ARIA
aria-labelest pertinent ;S’il est présent, le passage de texte lié au bouton via un attribut WAI-ARIA
aria-labelledbyest pertinent ;S’il est présent, le contenu de l’attribut
valued’une balise<input>de typesubmit,resetoubuttonest pertinent ;S’il est présent, le contenu de la balise
<button>est pertinent ;S’il est présent, le contenu de l’attribut
altd’une balise<input>de typeimageest pertinent ;S’il est présent, le contenu de l’attribut
titleest pertinent.Test 11.9.2
Chaque bouton affichant un intitulé visible vérifie-t-il ces conditions (hors cas particuliers) ?
S’il est présent, le contenu de l’attribut WAI-ARIA
aria-labelcontient au moins l’intitulé visible ;S’il est présent, le passage de texte lié au bouton via un attribut WAI-ARIA
aria-labelledbycontient au moins l’intitulé visible ;S’il est présent, le contenu de l’attribut value d’une balise
<input>de typesubmit,resetoubuttoncontient au moins l’intitulé visible ;S’il est présent, le contenu de la balise
<button>contient au moins l’intitulé visible ;S’il est présent, le contenu de l’attribut
altd’une balise<input>de typeimagecontient au moins l’intitulé visible ;S’il est présent, le contenu de l’attribut
titlecontient au moins l’intitulé visible.
Fiche complète du critère 11.9 · Texte officiel : Référentiel général d'amélioration de l'accessibilité (RGAA) 4.1, DINUM, Licence Ouverte 2.0.
Vérifiez votre site en 30 secondes
Conformly détecte ce type de problème sur toutes vos pages, en continu, et vous alerte à chaque régression.
Scan gratuit