Votre site web est-il accessible ?Vérifier gratuitement
WCAG 4.1.2Niveau ARobuste

Accordéon accessible : boutons, titres et état

Autres noms: Sections repliables accessibles, Accordéon de FAQ, Composant disclosure (afficher/masquer), Sections dépliables

Définition

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 (niveau A) s’applique donc : son nom, son rôle et sa 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 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 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.

Exemples

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 fonctionne sans code supplémentaire.

À 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.

À é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

    Comment rendre un accordéon accessible ?

    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.

    Les en-têtes d’un accordéon doivent-ils être des titres ou des boutons ?

    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.

    Puis-je utiliser details et summary pour un accordéon ?

    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.

    Un accordéon doit-il se commander avec les flèches du clavier ?

    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.

    Les accordéons conviennent-ils aux pages de FAQ ?

    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.

    • Nom, rôle et valeur : bien compris des lecteurs d’écran

      Nom, rôle et valeur est le critère de succès WCAG 4.1.2 : pour chaque composant d’interface utilisateur, le nom et le rôle peuvent être déterminés par un programme informatique, les états, propriétés et valeurs modifiables par l’utilisateur peuvent être définis par un programme, et les changements sont signalés aux technologies d’assistance. Il est de niveau A.

      Lire la définition: Nom, rôle et valeur : bien compris des lecteurs d’écran
    • Structure des titres : créer un plan de page clair

      La structure des titres est le plan qu’une page forme avec ses éléments h1 à h6. Chaque titre marque le début d’une section, et son niveau indique la place de cette section dans la hiérarchie.

      Lire la définition: Structure des titres : créer un plan de page clair
    • Navigation au clavier : le critère WCAG 2.1.1 expliqué

      La navigation au clavier signifie que chaque fonction d’un site web peut être atteinte et utilisée uniquement au clavier, généralement avec Tab, Maj+Tab, Entrée, Espace et les touches fléchées. Le critère WCAG 2.1.1 l’exige au niveau A.

      Lire la définition: Navigation au clavier : le critère WCAG 2.1.1 expliqué
    • Onglets accessibles : rôles ARIA et flèches du clavier

      Des onglets accessibles forment une interface à onglets dont les onglets sont exposés comme une liste d’onglets avec un état sélectionné, se commandent au clavier et sont reliés au panneau qu’ils affichent. Ils relèvent du critère WCAG 4.1.2 Nom, rôle et valeur, au niveau A, car les widgets à onglets personnalisés doivent indiquer leur rôle et leur état aux technologies d’assistance.

      Lire la définition: Onglets accessibles : rôles ARIA et flèches du clavier

    Confiez l’accessibilité de votre site web à l’IA

    Conçu en Europe. Installation en 2 minutes, sans développeur. Mettez l’accessibilité de votre site web en pilote automatique grâce aux corrections par IA et à la surveillance automatisée.

    1. 1Choisir votre offre
    2. 2Installation en 2 min
    3. 3L’IA corrige votre site
    4. Terminé