Scan gratuit

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.

À éviter
<div role="button" tabindex="0">
  <svg>…</svg>
</div>
Correct
<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

  1. 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-label est pertinent ;

    S’il est présent, le passage de texte lié au bouton via un attribut WAI-ARIA aria-labelledby est pertinent ;

    S’il est présent, le contenu de l’attribut value d’une balise <input> de type submit, reset ou button est pertinent ;

    S’il est présent, le contenu de la balise <button> est pertinent ;

    S’il est présent, le contenu de l’attribut alt d’une balise <input> de type image est pertinent ;

    S’il est présent, le contenu de l’attribut title est pertinent.

  2. 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-label contient au moins l’intitulé visible ;

    S’il est présent, le passage de texte lié au bouton via un attribut WAI-ARIA aria-labelledby contient au moins l’intitulé visible ;

    S’il est présent, le contenu de l’attribut value d’une balise <input> de type submit, reset ou button contient 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 alt d’une balise <input> de type image contient au moins l’intitulé visible ;

    S’il est présent, le contenu de l’attribut title contient 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

Autres corrections — Formulaires