# Accordéon accessible : boutons, titres et état

Source: https://allyway.ai/fr/glossary/accordeon-accessible

Un accordéon accessible est un ensemble de sections repliables dont les en-têtes sont des boutons placés dans des titres, exposent leur état déplié ou replié avec aria-expanded et s’ouvrent au clavier. Les accordéons personnalisés relèvent du critère WCAG 4.1.2 Nom, rôle et valeur, au niveau A.

Un accordéon accessible permet à chaque visiteur d’ouvrir et de fermer ses sections, à la souris, au clavier ou avec un lecteur d’écran. Les accordéons sont partout : pages de FAQ, fiches produit, menus mobiles, paramètres des cookies. Trop souvent, l’en-tête cliquable est une `div` dotée d’un gestionnaire de clic. Les utilisateurs du clavier ne peuvent alors pas l’ouvrir, et les utilisateurs de lecteurs d’écran ne savent jamais que du contenu se cache derrière.

## Ce que cela signifie

Un accordéon construit avec un script est un composant personnalisé. Le critère [WCAG 4.1.2 Nom, rôle et valeur](https://www.w3.org/WAI/WCAG22/Understanding/name-role-value.html) (niveau A) s’applique donc : son [nom, son rôle et sa valeur](https://allyway.ai/fr/glossary/nom-role-et-valeur) doivent pouvoir être déterminés par un programme informatique, et les changements d’état doivent parvenir aux technologies d’assistance. Le W3C cite expressément les composants de type disclosure (afficher/masquer) comme exemple. Le [modèle Accordion](https://www.w3.org/WAI/ARIA/apg/patterns/accordion/) des ARIA Authoring Practices décrit la structure :

| Élément | Ce qu’il faut |
|---|---|
| En-tête | Un `button` qui est le seul élément d’un titre (un `h2`, `h3` … adapté à la [structure des titres](https://allyway.ai/fr/glossary/structure-des-titres) de la page) |
| État | `aria-expanded="true"` quand le panneau est visible, `"false"` quand il est masqué |
| Lien avec le panneau | `aria-controls` avec l’ID du panneau |
| Panneau (facultatif) | `role="region"` avec `aria-labelledby` pointant vers son bouton – à éviter quand de nombreux panneaux peuvent être ouverts en même temps (environ plus de 6), pour que la page ne se remplisse pas de repères |
| Panneau impossible à refermer | `aria-disabled="true"` sur son bouton, si l’accordéon n’autorise pas le repli d’un panneau ouvert |

Au clavier : Entrée ou Espace ouvre ou ferme le panneau de l’en-tête qui a le focus. Tab et Maj + Tab parcourent tous les éléments pouvant recevoir le focus, y compris le contenu des panneaux ouverts.

> **Tip:** > **L’option native : details et summary**
> Pour une seule section dépliable, les éléments HTML `<details>` et `<summary>` apportent le rôle, l’état et la gestion du clavier, sans ARIA. Utilisez le modèle ARIA quand vous avez besoin du comportement complet d’un accordéon, par exemple un seul panneau ouvert à la fois.

## Exemples

```html title="Exemple"
<h3>
  <button type="button" id="acc-1" aria-expanded="false"
          aria-controls="acc-panel-1">
    How long does shipping take?
  </button>
</h3>
<div id="acc-panel-1" role="region" aria-labelledby="acc-1" hidden>
  <p>Orders within Austria arrive in 2–3 working days.</p>
</div>
```

Le script bascule ensemble `aria-expanded` et `hidden`. Un lecteur d’écran annonce quelque chose comme « How long does shipping take?, bouton, réduit, titre de niveau 3 ». On sait ainsi de quoi il s’agit, que l’élément peut s’ouvrir et où il se situe dans le plan de la page. Comme c’est un vrai `<button>`, la [navigation au clavier](https://allyway.ai/fr/glossary/navigation-au-clavier) fonctionne sans code supplémentaire.

**Do:** À faire

Placer un vrai bouton dans un titre, garder `aria-expanded` synchronisé avec ce qui est affiché, masquer les panneaux fermés avec `hidden` ou `display: none`, afficher un contour de focus visible sur les en-têtes.

**Don't:** À éviter

Rendre une `div` ou le titre lui-même cliquable, signaler l’état uniquement par une flèche qui pivote, définir des états comme `aria-selected` qu’un bouton ne peut pas avoir, masquer les panneaux fermés seulement visuellement, de sorte que les lecteurs d’écran les lisent encore.

## Comment vérifier un accordéon accessible



## Questions fréquentes

Q: Comment rendre un accordéon accessible ?
A: Utilisez un `<button>` dans un titre pour chaque en-tête, définissez `aria-expanded` sur `true` ou `false`, reliez le bouton à son panneau avec `aria-controls` et masquez les panneaux fermés avec `hidden`. Le navigateur se charge alors du clavier.

Q: Les en-têtes d’un accordéon doivent-ils être des titres ou des boutons ?
A: Les deux : le modèle du W3C place le bouton dans un titre. Le titre permet de passer d’une section à l’autre, le bouton permet de les ouvrir et de les fermer.

Q: Puis-je utiliser details et summary pour un accordéon ?
A: Oui. Pour de simples sections dépliables, `<details>` et `<summary>` sont accessibles d’emblée. Pour un fonctionnement « un seul panneau à la fois » ou des animations personnalisées, le modèle d’accordéon ARIA offre plus de contrôle.

Q: Un accordéon doit-il se commander avec les flèches du clavier ?
A: Ce n’est pas obligatoire. Entrée, Espace et Tab forment le cœur du modèle W3C pour les en-têtes d’accordéon ; passer d’un en-tête à l’autre avec les flèches est un plus facultatif. Dans les onglets, en revanche, les flèches sont attendues.

Q: Les accordéons conviennent-ils aux pages de FAQ ?
A: Ils raccourcissent les pages longues, mais les réponses masquées passent facilement inaperçues. Des questions clairement formulées en titres aident, tout comme la possibilité d’ouvrir toutes les sections d’un coup sur les longues FAQ.
