Aller au contenu
SkillCodex
Menu

Accordion

Accordéon

Un ensemble vertical d'en-têtes qui révèle ou masque chaque section de contenu associée.

Essayer le composant
Repères, sources et actions
Sources et révision
Mis à jour le
Version
v1.0.26 · r2
Sources
5 sources
Statut
Publié
Consulter les sources

Tu as peut-être cherché : des questions qui ouvrent les réponses dessouscliquer sur un titre pour développer sa sectionune liste verticale de contenu repliable

Toutes les formulations
Enregistrer et partager

Reconnaître

Changer de vue ou révéler du contenu

Essayer

Faut-il changer de vue, choisir un mode compact ou révéler du contenu dans le flux ?

Accordéon

Contexte commun aux essais

Un espace projet révèle du contenu associé sur place tout en conservant la position de l'utilisateur dans la page.

Accordéon

Mission

Accordéon - Accordion

Développer Remboursements, atteindre Moyens de paiement au clavier, l'ouvrir et replier Remboursements.

Informations essentielles, toujours ouvertes

Cette réponse doit rester visible pour terminer la procédure.

Résultat de l’essai

Seule la section obligatoire reste ouverte.

Étape 1 sur 3

Essayer

Manipule le composant. Le résultat de ton essai apparaît juste au-dessus. Avance à ton rythme.

Comportement et cas limite
À observer
L'en-tête développé expose son état et la réponse apparaît juste après.
Cas limite
Une section obligatoirement ouverte ne peut pas être repliée et communique cette règle sans faux contrôle.

Ce que cet essai montre

Accordion révèle les sections sous leurs en-têtes ; Tabs remplace un panneau de même niveau, tandis que Segmented control choisit une valeur compacte.

Lequel convient à ton besoin ?

Accordéon

Organiser des FAQ ou sections de détail facultatives

Onglets

Regrouper quelques vues de même niveau

Quel composant utilises-tu ici ?
Différence et sources

Accordion révèle les sections sous leurs en-têtes ; Tabs remplace un panneau de même niveau, tandis que Segmented control choisit une valeur compacte.

Consulter les sources

    Parties du spécimen

    Sélectionne un repère numéroté sur le schéma, ou utilise la liste ci-dessous, pour afficher son rôle. Le schéma montre l'état représentatif du concept.

    En-tête

    Un en-tête pertinent qui introduit le message ou le contenu révélé.

    Position dans l’atlas

    Carte relationnelle

    Repère le chapitre, les concepts proches et la prochaine décision utile.

    • Chapitre

      Changer de vue ou révéler du contenu

      Accordéon appartient à ce groupe de concepts comparés.

    • Ne pas confondre

      Onglets

      Choisis Accordéon si plusieurs sections peuvent rester ouvertes en même temps et se lisent de haut en bas, comme une FAQ. Choisis Onglets si les vues sont de même niveau et qu’une seule doit occuper l’espace à la fois.

      Comparer cette paire
    • Ne pas confondre

      Contrôle segmenté

      Choisis Accordéon si l’utilisateur ouvre des sections de détail facultatives, comme une FAQ, et peut en laisser plusieurs ouvertes. Choisis Contrôle segmenté si l’utilisateur bascule un réglage ou un mode d’affichage compact entre deux et cinq valeurs.

      Comparer cette paire
    • Prochaine étape

      Compare les concepts du chapitre avant de retenir une implémentation.

      Ouvrir le chapitre

    Avec tes mots

    Comprendre

    Ce que les gens décrivent

    Alias documentés : sections dépliables, panneaux repliables, liste de révélations

    • des questions qui ouvrent les réponses dessous
    • cliquer sur un titre pour développer sa section
    • une liste verticale de contenu repliable
    • afficher et masquer les détails ligne par ligne
    • une FAQ avec des réponses dépliables
    • ouvrir plusieurs sections sans changer de page

    Choisir

    À utiliser quand

    • Organiser des FAQ ou sections de détail facultatives
    • Permettre de parcourir les en-têtes avant d'ouvrir le contenu utile

    À éviter quand

    • Tout le contenu est assez court pour être affiché
    • Les sections sont des destinations principales qui nécessitent des URL

    Comparer

    Comparer les concepts proches

    Checklist de vérification

    Essaie ces gestes dans le lab, puis vérifie les mêmes comportements dans le résultat de ton agent. Adapte les noms d’exemple à ton interface.

    1. 1. À faire

      Place le focus sur le titre d’une rubrique et appuie sur Entrée ou Espace pour l’ouvrir et la fermer.

      Résultat attendu

      Seul son contenu associé change, l’état ouvert est indiqué et le focus reste sur le bouton du titre.

    2. 2. À faire

      Ouvre une deuxième rubrique alors que la première est déjà ouverte.

      Résultat attendu

      Le résultat respecte la règle annoncée : une ou plusieurs rubriques ouvertes ; une rubrique qui doit rester ouverte n’est pas présentée comme librement repliable.

    3. 3. À faire

      Ouvre une rubrique et lis son texte, puis ferme-la et continue avec Tab ; si elle contient des liens ou commandes, vérifie qu’ils sont ignorés une fois repliée.

      Résultat attendu

      Le contenu de la rubrique fermée est masqué et ne crée aucun arrêt invisible au clavier ; son titre reste accessible pour la rouvrir.

    Contrat complet
    1. 1Chaque en-tête contient un vrai bouton dans un titre pertinent
    2. 2L'état développé correspond au contenu visible
    3. 3L'ouverture simple ou multiple est volontaire
    4. 4Ouvrir et fermer ne déplace jamais le focus sans raison

    Comprendre → Reconnaître → Choisir → Comparer

    Pack pour ton agent

    Instructions pré-écrites à coller dans ton agent. Copier n’exécute rien.

    Implémenter correctement

    Construis Accordéon sans casser son comportement

    # Implémenter Accordéon dans ton agent
    
    ## Objectif
    Implémente Accordéon pour ce comportement vérifié : Un ensemble vertical d’en-têtes qui révèle ou masque chaque section de contenu associée.
    
    ## Prérequis
    - Inspecte d’abord le dépôt, le design system et les tests existants.
    - Préserve les changements sans rapport et borne les fichiers modifiés.
    - Confirme qu’Accordéon répond au besoin avant de coder.
    
    ## Comportement requis
    - Activer un en-tête révèle ou masque son contenu associé tout en exposant l’état développé.
    - Les flèches parcourent les éléments liés selon leur orientation visuelle.
    
    ## États à couvrir
    - Remboursements repliés
    - Remboursements développés
    
    ## Accessibilité
    - Rôle ARIA : heading > button[aria-expanded][aria-controls] + region
    - Le contrôle principal ou la région nommée pour Accordéon possède un nom accessible stable issu d’un texte visible ou d’un libellé programmatique explicite ; le placeholder et l’infobulle ne servent pas de nom.
    - Le focus reste sur le bouton d’en-tête lorsque son panneau s’ouvre ou se ferme.
    - Chaque panneau développé se ferme en activant son propre en-tête lorsque le produit permet le repli.
    - Le niveau d’en-tête, le nom du bouton, l’état développé et la relation contrôlée sont exposés.
    - Tab atteint chaque bouton d’en-tête
    - Entrée ou Espace bascule une section
    - Les flèches facultatives parcourent les en-têtes
    
    ## Quand ne pas utiliser
    - Tout le contenu est assez court pour être affiché
    - Les sections sont des destinations principales qui nécessitent des URL
    
    ## Critères d’acceptation
    - Chaque en-tête contient un vrai bouton dans un titre pertinent
    - L’état développé correspond au contenu visible
    - L’ouverture simple ou multiple est volontaire
    - Ouvrir et fermer ne déplace jamais le focus sans raison
    
    ## Garde-fous
    - Montre d’abord les changements envisagés avant toute action externe.
    - Ne publie, n’envoie, ne supprime, ne paie et ne modifie aucun état distant sans autorisation explicite.
    - Préserve les changements sans rapport et arrête-toi si le périmètre devient ambigu.
    
    ## Format de sortie
    - Résultat obtenu ou verdict.
    - Fichiers ou actions concernés.
    - Vérifications exécutées et preuves observables.
    - Blocages ou limites restantes.
    
    • @radix-ui/react-accordion
    • Prérequis · Accès au dépôt, au design system et aux tests
    Pourquoi ça marche
    • Le besoin est relié au comportement canonique avant toute décision technique.
    • Les états, l’accessibilité et les non-objectifs empêchent une implémentation seulement visuelle.
    • Les critères d’acceptation et le format de sortie rendent la vérification observable.

    À essayer ensuite

    Vérifie Accordéon sur un parcours réel

    # Vérifier Accordéon après l’implémentation
    
    ## Objectif
    Audite l’implémentation d’Accordéon au regard de son comportement, de ses états et de ses exigences d’accessibilité sans la modifier automatiquement.
    
    ## Contrôles
    - Rejoue le plus petit parcours représentatif.
    - Contrôle le clavier, le focus, le nom accessible et les annonces.
    - Relie chaque écart à un critère d’acceptation précis.
    
    ## Garde-fous
    - Montre d’abord les changements envisagés avant toute action externe.
    - Ne publie, n’envoie, ne supprime, ne paie et ne modifie aucun état distant sans autorisation explicite.
    - Préserve les changements sans rapport et arrête-toi si le périmètre devient ambigu.
    
    ## Format de sortie
    - Résultat obtenu ou verdict.
    - Fichiers ou actions concernés.
    - Vérifications exécutées et preuves observables.
    - Blocages ou limites restantes.
    

    sha256:ed5aa05ba83b14168b2281b8489ca45fd7d227e71ffa75bf982603fb271fdce0

    Diagnostiquer un problème

    Trouve et corrige le défaut d’Accordéon

    # Déboguer Accordéon dans ton agent
    
    ## Symptôme observé
    [DÉCRIS ICI LE SYMPTÔME]
    
    ## Contrôles observables
    - Reproduis le problème avec le plus petit parcours pertinent.
    - Compare le comportement aux états et transitions documentés d’Accordéon.
    - Vérifie le clavier, le focus, le nom accessible et les annonces.
    
    ## Causes possibles
    - La primitive employée ne correspond pas au comportement attendu.
    - Un état, une transition ou un retour de focus manque.
    - Le composant voisin capture un événement ou masque un signal accessible.
    
    ## Corrections bornées
    - Corrige la cause reproduite sans recréer les composants voisins.
    - Conserve le contrat public et ajoute un test ciblé de non-régression.
    - N’installe aucune dépendance et ne modifie aucun état distant sans autorisation.
    
    ## Vérification finale
    - Chaque en-tête contient un vrai bouton dans un titre pertinent
    - L’état développé correspond au contenu visible
    - L’ouverture simple ou multiple est volontaire
    - Ouvrir et fermer ne déplace jamais le focus sans raison
    
    ## Garde-fous
    - Montre d’abord les changements envisagés avant toute action externe.
    - Ne publie, n’envoie, ne supprime, ne paie et ne modifie aucun état distant sans autorisation explicite.
    - Préserve les changements sans rapport et arrête-toi si le périmètre devient ambigu.
    
    ## Format de sortie
    - Résultat obtenu ou verdict.
    - Fichiers ou actions concernés.
    - Vérifications exécutées et preuves observables.
    - Blocages ou limites restantes.
    
    • @radix-ui/react-accordion
    • Prérequis · Accès au dépôt, au design system et aux tests
    Pourquoi ça marche
    • Le symptôme explicite évite de partir d’une correction supposée.
    • Les contrôles séparent comportement, accessibilité et interférences voisines.
    • La correction reste bornée et doit produire une preuve de non-régression.

    À essayer ensuite

    Verrouille la correction d’Accordéon

    # Empêcher la régression d’Accordéon
    
    ## Objectif
    Transforme la cause reproduite en test de non-régression ciblé et compare Accordéon aux concepts voisins avant d’élargir la correction.
    
    ## Contrôles
    - Prouve que le test échoue avant la correction.
    - Prouve qu’il passe après la correction bornée.
    - Vérifie qu’aucun composant voisin n’a changé de comportement.
    
    ## Garde-fous
    - Montre d’abord les changements envisagés avant toute action externe.
    - Ne publie, n’envoie, ne supprime, ne paie et ne modifie aucun état distant sans autorisation explicite.
    - Préserve les changements sans rapport et arrête-toi si le périmètre devient ambigu.
    
    ## Format de sortie
    - Résultat obtenu ou verdict.
    - Fichiers ou actions concernés.
    - Vérifications exécutées et preuves observables.
    - Blocages ou limites restantes.
    

    sha256:0b32d96b1fbcbbac2f3740a9453910e0abb3ed1c2837cf2044054fff85c90681

    Fiche complète, enregistrement et provenance

    Instruction pré-écrite par SkillCodex — ta demande n’est ni envoyée ni utilisée pour adapter ce texte ; aucun contenu n’est généré et copier n’exécute rien.

    Digest du Pack: sha256:d147510ad6eb0c7909ad3a0c36d8a9d76349d837af1cafe466ea61fcea06ff8d

    Dans le code

    TechnologiePrimitiveVersionLimite
    @radix-ui/react-accordion

    Accordion.Root

    @radix-ui/react-accordion@1.2.16Radix fournit l’état de révélation et le clavier ; les niveaux de titre, le mode d’expansion et l’usage des régions restent des décisions de contenu.

    Détails techniques

    Comportements

    • Révéler et masquer une section

      Activer un en-tête révèle ou masque son contenu associé tout en exposant l'état développé.

    • Naviguer avec les flèches

      Les flèches parcourent les éléments liés selon leur orientation visuelle.

    États

    • Remboursements repliés

      Remboursements repliés

    • Remboursements développés

      Remboursements développés

    Transitions d’état

    • Remboursements repliés → Remboursements développés

      L’activation de l’en-tête Remboursements affiche sa réponse juste après l’en-tête.

    • Remboursements développés → Remboursements repliés

      L’activation de l’en-tête Remboursements développé masque uniquement sa réponse associée.

    Scénarios de test

    Contexte
    Une aide de facturation regroupe les réponses sur factures, remboursements et moyens de paiement.
    Mission
    Développer Remboursements, atteindre Moyens de paiement au clavier, l'ouvrir et replier Remboursements.
    État principal
    L'en-tête développé expose son état et la réponse apparaît juste après.
    Cas limite
    Une section obligatoirement ouverte ne peut pas être repliée et communique cette règle sans faux contrôle.

    Signaux visuels

    • En-têtes empilés avec indicateurs
    • Contenu directement sous son en-tête
    • Plusieurs sections peuvent rester visibles

    Signaux comportementaux

    • Activer l'en-tête bascule l'état développé
    • Tab atteint chaque bouton d'en-tête
    • Le mode simple ou multiple est déclaré

    Accessibilité

    Rôle
    heading > button[aria-expanded][aria-controls] + region
    Nom accessible
    Le contrôle principal ou la région nommée pour Accordéon possède un nom accessible stable issu d’un texte visible ou d’un libellé programmatique explicite ; le placeholder et l’infobulle ne servent pas de nom.
    Focus clavier
    Le focus reste sur le bouton d'en-tête lorsque son panneau s'ouvre ou se ferme.
    Fermeture
    Chaque panneau développé se ferme en activant son propre en-tête lorsque le produit permet le repli.
    Défilement
    Le développement ou la réduction du contenu garde l'en-tête de contrôle visible et évite tout saut inattendu dans la page.
    Annonce
    Le niveau d'en-tête, le nom du bouton, l'état développé et la relation contrôlée sont exposés.
    Clavier
    • Tab atteint chaque bouton d'en-tête
    • Entrée ou Espace bascule une section
    • Les flèches facultatives parcourent les en-têtes

    Implémentations

    Ouvrir la matrice HTML, ARIA, Radix et shadcn
    • Accordion.Root

      implementationKind
      radix
      nativeElement
      Non applicable
      ariaPattern
      disclosure buttons with aria-expanded
      radixPrimitive
      Accordion
      shadcnRecipe
      Accordion
      runtimeDependency
      @radix-ui/react-accordion@1.2.16
      packageName
      @radix-ui/react-accordion
      exportName
      Accordion.Root
      exactVersion
      1.2.16
      status
      verified
      sourceId
      source-ui-radix-accordion
      deprecationStatus
      active
      replacement
      Non applicable
      validFrom
      Non applicable
      validUntil
      Non applicable

      Limite d’équivalence : Radix fournit l’état de révélation et le clavier ; les niveaux de titre, le mode d’expansion et l’usage des régions restent des décisions de contenu.

      Vérifier la source du binding

    Sources

    • WAI-ARIA APG: Accordion Pattern
      sourceId
      source-ui-aria-accordion
      kind
      documentation
      canonicalUrl
      https://www.w3.org/WAI/ARIA/apg/patterns/accordion/
      publisher
      W3C WAI
      sourceRevision
      http-last-modified:2026-07-09T07:07:36Z
      consultedAt
      2026-07-19
      license
      Non indiquée
      contentDigest
      sha256:d66381c3684cfb78744d5648cb7f567387d6d0f5f07d842953e27f23541f5ae7
      status
      verified

      Affirmation couverte : Accordéon : guide APG informatif pour le modèle accordéon : rôles, états, relations et interactions au clavier.

    • Radix Primitives: Accordion
      sourceId
      source-ui-radix-accordion
      kind
      documentation
      canonicalUrl
      https://www.radix-ui.com/primitives/docs/components/accordion
      publisher
      Radix Primitives
      sourceRevision
      http-etag:W/"c0cd83d6d0705b1dad9c207456ffd978"
      consultedAt
      2026-07-19
      license
      Non indiquée
      contentDigest
      sha256:3baef4674c46481d3c573a6dcd76c5a892d81d1618000af491013aa4484bca48
      status
      verified

      Affirmation couverte : Accordéon : parties, API d'état, interactions et limites d'implémentation documentées pour Radix Accordion.

    • WAI-ARIA APG: Button Pattern
      sourceId
      source-ui-aria-button
      kind
      documentation
      canonicalUrl
      https://www.w3.org/WAI/ARIA/apg/patterns/button/
      publisher
      W3C WAI
      sourceRevision
      http-last-modified:2026-07-09T07:07:36Z
      consultedAt
      2026-07-19
      license
      Non indiquée
      contentDigest
      sha256:863329ea659a53439b0953eec0bd0af7c6219e372d0e878f75e57d263924704c
      status
      verified

      Affirmation couverte : Accordéon : guide APG informatif pour le modèle bouton : rôles, états, relations et interactions au clavier.

    • WAI-ARIA 1.2: Roles Model
      sourceId
      source-ui-wai-aria-roles
      kind
      standard
      canonicalUrl
      https://www.w3.org/TR/wai-aria-1.2/#roles
      publisher
      W3C WAI
      sourceRevision
      W3C-REC-wai-aria-1.2-20230606
      consultedAt
      2026-07-19
      license
      Non indiquée
      contentDigest
      sha256:c0fea16fc747779569ab754d2d25bca3e2b7e8a673b8ef5362aeb9ebc73a4849
      status
      verified

      Affirmation couverte : Accordéon : définitions normatives des rôles ARIA et contraintes du rôle accessible indiqué.

    • WCAG 2.2: Focus Appearance
      sourceId
      source-ui-wcag-understanding-focus-appearance
      kind
      documentation
      canonicalUrl
      https://www.w3.org/WAI/WCAG22/Understanding/focus-appearance.html
      publisher
      W3C WAI
      sourceRevision
      http-last-modified:2026-07-02T10:07:49Z
      consultedAt
      2026-07-19
      license
      Non indiquée
      contentDigest
      sha256:fdcf316a1f0e3cc758eda9618322d132862124ff0a3f3b1a3acbf20daf804ff0
      status
      verified

      Affirmation couverte : Accordéon : guide WCAG informatif pour évaluer l'apparence visible du focus clavier.