# ARIA (WAI-ARIA) : rôles, états et propriétés expliqués

Source: https://allyway.ai/fr/glossary/aria

ARIA (WAI-ARIA, Accessible Rich Internet Applications) est une spécification du W3C qui définit des attributs HTML (rôles, états et propriétés) indiquant aux technologies d’assistance ce qu’est un élément personnalisé, quel est son nom et dans quel état il se trouve.

ARIA, abréviation de WAI-ARIA (Accessible Rich Internet Applications), est un standard du W3C qui ajoute du sens au HTML à l’intention des technologies d’assistance. Grâce aux attributs ARIA, un [système d’onglets](https://allyway.ai/fr/glossary/onglets-accessibles), un [accordéon](https://allyway.ai/fr/glossary/accordeon-accessible) ou un menu personnalisé peut indiquer à un lecteur d’écran ce qu’il est (« onglet »), comment il s’appelle et s’il est ouvert ou sélectionné. ARIA modifie uniquement ce que perçoivent les technologies d’assistance, pas l’apparence ni le comportement d’un élément.

## Ce que cela signifie

ARIA comprend trois types d’attributs :

| Type | Fonction | Exemples |
|---|---|---|
| Rôles | Ce qu’est un élément | `role="tab"`, `role="dialog"`, `role="navigation"` |
| États | Conditions qui changent à l’usage | `aria-expanded`, `aria-checked`, `aria-pressed` |
| Propriétés | Noms, descriptions et relations | `aria-label`, `aria-labelledby`, `aria-describedby`, `aria-controls` |

[WCAG 4.1.2 Nom, rôle et valeur](https://www.w3.org/WAI/WCAG22/Understanding/name-role-value.html), critère de niveau A des [WCAG 2.2](https://allyway.ai/fr/regulations/wcag-2-2), exige que le nom, le rôle, les états et les valeurs de chaque composant d’interface utilisateur soient disponibles pour les technologies d’assistance. Selon le W3C, les contrôles HTML standard remplissent déjà cette exigence lorsqu’ils sont utilisés conformément à la spécification. Les contrôles personnalisés demandent un travail supplémentaire, et c’est ARIA qui permet de le fournir : la technique ARIA4 expose le rôle, ARIA5 l’état, ARIA14 et ARIA16 le nom. Une `div` transformée en contrôle par un script sans recevoir de rôle correspond au cas d’échec F59.

> **Warning:** > **Le HTML natif d’abord**
> Le guide du W3C « Using ARIA » énonce comme première règle : s’il existe un élément HTML natif qui offre le comportement voulu, utilisez-le plutôt que d’ajouter un rôle. `role="button"` sur une `div` n’apporte aucune prise en charge du clavier : vous devez ajouter vous-même le focus avec Tab ainsi que les touches Entrée et Espace. Un vrai `<button>` intègre déjà tout cela.

Un ARIA erroné est pire que pas d’ARIA du tout : un rôle mal orthographié, un `aria-hidden="true"` sur un élément qui a le focus ou un `aria-expanded` jamais mis à jour transmettent de fausses informations aux utilisateurs de lecteurs d’écran.

## Exemples

```html title="Exemple"
<!-- Accordion button: native button + state -->
<button aria-expanded="false" aria-controls="faq-1">Shipping costs</button>
<div id="faq-1" hidden>Shipping is free from 50 euros.</div>

<!-- Landmark with a name -->
<nav aria-label="Main">…</nav>

<!-- Don't: fake button without keyboard support -->
<div role="button" onclick="save()">Save</div>
```

Quand l’accordéon s’ouvre, le script doit définir `aria-expanded="true"` et retirer `hidden` : l’état doit toujours refléter ce qui est affiché à l’écran.

**Do:** À faire

Utiliser d’abord les éléments natifs, puis ajouter ARIA uniquement pour ce que le HTML ne sait pas exprimer : des états comme `aria-expanded`, des noms via [aria-label](https://allyway.ai/fr/glossary/aria-label), des zones via les [repères ARIA](https://allyway.ai/fr/glossary/reperes-aria). Maintenir chaque état synchronisé avec l’interface. Suivre les modèles de l’[ARIA Authoring Practices Guide](https://www.w3.org/WAI/ARIA/apg/).

**Don't:** À éviter

Ajouter `role="button"` ou `role="link"` à des éléments qui devraient être de vrais boutons ou de vrais liens, utiliser des rôles qui n’existent pas, répéter le rôle natif (`<button role="button">`) ou masquer du contenu focalisable avec `aria-hidden="true"`.

## Comment vérifier ARIA sur votre site



## Questions fréquentes

Q: Que signifie ARIA ?
A: Accessible Rich Internet Applications. Le nom complet de la spécification du W3C est WAI-ARIA, d’après la Web Accessibility Initiative qui la publie.

Q: Quand faut-il utiliser ARIA ?
A: Quand le HTML ne propose aucun élément natif pour ce que vous construisez (onglets, arborescences, combobox), ou pour ajouter un état ou un nom que le HTML ne peut pas exprimer. Pour les boutons, les liens, les champs de formulaire et les titres, utilisez l’élément HTML.

Q: ARIA modifie-t-il l’apparence ou le fonctionnement de mon site ?
A: Non. ARIA modifie uniquement ce que les navigateurs transmettent aux technologies d’assistance. Le comportement au clavier, le focus et les états visuels doivent toujours être réalisés en HTML, CSS et JavaScript.

Q: ARIA est-il obligatoire selon les WCAG ?
A: Non. Les WCAG exigent que le nom, le rôle et la valeur soient disponibles ; le HTML natif les fournit généralement. ARIA fait partie des différentes techniques suffisantes, surtout pour les composants personnalisés.

Q: Comment détecter les erreurs ARIA sur mon site ?
A: Lancez le [vérificateur WCAG gratuit](https://allyway.ai/fr/free-wcag-accessibility-scanner-for-websites) sur votre page d’accueil : il effectue une vérification selon les WCAG 2.2 AA, y compris le nom, le rôle et la valeur de vos contrôles.
