← Toutes les règles

ARIA

aria-roledescription a besoin d’un rôle à décrire

• Règle: aria-roledescription
• Gravité: Sérieux
• Niveau WCAG A

Pourquoi c’est important

L’attribut remplace le nom énoncé d’un rôle. Sur un élément sans rôle, il n’y a rien à remplacer : il est ignoré et la formulation choisie n’atteint personne.

Comment corriger

1. Donnez d’abord un rôle explicite à l’élément avant de le décrire.
2. Gardez la description courte et dans la langue de la page : elle est lue à chaque fois.
3. Ne renommez pas un rôle familier par coquetterie : « Diapositive » aide, « Belle boîte » non.

Dans le balisage

<div aria-roledescription="Slide">...</div>

<div role="group" aria-roledescription="Slide" aria-label="1 of 5">...</div>

L’exigence sous-jacente

Cette règle est une manière d’échouer aux critères de succès WCAG 2.2 suivants. Le W3C, qui rédige la norme, explique chacun d’eux :

• 4.1.2 Nom, rôle et valeur (s’ouvre dans un nouvel onglet) — Niveau WCAG A

Pour aller plus loin

Deque University sur aria-roledescription (s’ouvre dans un nouvel onglet)

Deque développe axe-core, le moteur open source utilisé par notre scanner. Sa page documente la règle telle que le moteur l’implémente.

Les contrôles automatiques trouvent les défaillances qu’un navigateur peut prouver. Ils ne peuvent pas juger si un sous-titrage est fidèle, si une alternative textuelle est utile, ni si une page s’utilise de bout en bout au clavier : cela demande une personne.