FRENEnglish version

Affichage

Accordéon

Accordion

Démo

Chargement de la démo…

Une liste de titres qui se déplient pour révéler leur contenu. Il réduit la longueur d'une page sans rien cacher pour de bon : l'utilisateur ouvre seulement ce qui l'intéresse.

Histoire

Le saviez-vous

Le nom vient de l'instrument : le soufflet se plie et se déplie. Pendant quinze ans, chaque dev a recodé son accordéon en jQuery alors que <details> faisait déjà le travail tout seul.

Historique

  1. 2011<details> arrive dans Chrome 12.
  2. 2020Edge passe sur Chromium : le support devient universel.
  3. 2023Attribut name pour les accordéons exclusifs (Chrome 120).

Vocabulaire

Noms

FR
Accordéon, volet dépliable, replier / déplier
EN
Accordion, disclosure, collapsible, expander

Usages courants

  • FAQ
  • Filtres de recherche (prix, taille, marque)
  • Formulaires longs découpés en blocs
  • Réglages avancés masqués par défaut

Souvent associé à

Les composants qu'on retrouve avec lui, par type de page, dans l'ordre de lecture.

Code

<details name="faq" open>
  <summary>Do you deliver on Sundays?</summary>
  <p>No, Monday to Saturday only.</p>
</details>
<details name="faq">
  <summary>Can I return an item?</summary>
  <p>Yes, within 30 days.</p>
</details>

<!-- Same "name" = only one open at a time. No JS needed. -->

À savoir

  • <details> / <summary> gèrent l'ouverture, le clavier et l'état sans une ligne de JS.
  • Le même attribut name sur plusieurs details donne un accordéon exclusif (un seul ouvert), natif depuis fin 2023.
  • Pour animer la hauteur : interpolate-size: allow-keywords et le pseudo-élément ::details-content, dans les navigateurs récents.
  • Le contenu fermé reste trouvable avec Ctrl+F : le navigateur ouvre le bon details tout seul.

Accessibilité

Prioritaire

  • Utiliser <details>/<summary>, ou un vrai <button> avec aria-expanded et aria-controls si tu le codes à la main.
  • Le titre cliquable doit être atteignable au clavier et s'ouvrir avec Entrée et Espace.

Souvent oublié

  • Garder un vrai niveau de titre : mettre un <h3> dans le bouton ou le summary, pour la navigation par titres des lecteurs d'écran.
  • Ne pas supprimer le marqueur sans en remettre un autre : l'icône dit que c'est dépliable.

Bonus

  • Respecter prefers-reduced-motion si tu animes l'ouverture.
  • Ouvrir automatiquement la section ciblée par l'ancre de l'URL.

Qui l'utilise