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
- 2011
<details>arrive dans Chrome 12. - 2020Edge passe sur Chromium : le support devient universel.
- 2023Attribut
namepour 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.
Article de blog
Voir la maquetteFiche produit
Voir la maquettePage tarifs
Voir la maquetteCode
<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
namesur plusieursdetailsdonne un accordéon exclusif (un seul ouvert), natif depuis fin 2023. - Pour animer la hauteur :
interpolate-size: allow-keywordset le pseudo-élément::details-content, dans les navigateurs récents. - Le contenu fermé reste trouvable avec Ctrl+F : le navigateur ouvre le bon
detailstout seul.
Accessibilité
Prioritaire
- Utiliser
<details>/<summary>, ou un vrai<button>avecaria-expandedetaria-controlssi 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 lesummary, 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-motionsi tu animes l'ouverture. - Ouvrir automatiquement la section ciblée par l'ancre de l'URL.