• Start

  • Blogg

  • Kom igång

  • Riktlinjer

  • Komponenter

  • Changelog

  • Tillgänglighet

  • Statistik

  • Inställningar

Komponenter

Komponenter

​
​

Inga resultat hittade, prova med andra sökvillkor.

Accordion

Accordion

4.1.4

Show and hide details by expanding and collapsing content vertically.

Demo
Props
Installation
Länkar
Best practices
Tillgänglighet
Tangentbordsinteraktioner
Change log
Statistik

Demo

Props

Se fullständing dokumentation(öppnas i ny flik)
NamnTypBeskrivning

children *

ReactNodeThe content to be displayed when the accordion is expanded.

className

stringOptional CSS class name.

customAttribute

{ attribute: string; value: string | number }Used for tests. Clickable and requested subcomponents will be suffixed with "-[ComponentName]".

defaultExpanded

booleanIf true, expands the accordion by default when the component mounts. Only controls the initial state - subsequent expand/collapse actions will be handled by user interaction. Use this for uncontrolled behavior where you just want to set the initial state.

disabled

booleanIf true, the component is disabled.

expanded

booleanControls the expanded state of the accordion. Use this prop along with onChange to create a controlled component where you need to manage the state yourself. If not provided, the accordion will be uncontrolled and manage its own state internally.

id *

stringA unique identifier for the <Accordion>. This is required to correctly associate <AccordionSummary> with <AccordionDetails> via WAI-ARIA attributes, ensuring proper accessibility for screen readers.

isLoading

booleanIf true, a loading skeleton will be rendered instead of the component's content and all interactions will be disabled.

lang

"sv" | "en"Language used for internal translations.

negativeMargins

booleanIf true, applies negative horizontal margins.

onChange

(expanded: undefined | boolean) => voidCallback when accordion is changed.

onClick

() => voidCallback when the item is clicked.

sx

SxPropsThe system prop that allows defining system overrides as well as additional CSS styles.

Installation

Kodexempel
npm install @sj-ab/component-library.ui.accordion

Länkar

  • Storybook

  • Figma

  • Bit.cloud

Best practices

Uppbyggnad

En Accordion består av två interna komponenter. Dessa hanteras automatiskt och behöver inte konfigureras av användaren, men det kan vara bra att känna till deras funktion:

AccordionSummary är en omslutande komponent för rubriken. När användaren klickar på denna expanderas eller kollapsas innehållet.

AccordionDetails är en omslutande komponent för det innehåll som visas när accordions är utfälld.

Tillgänglighet

Rubriknivåer

AccordionSummary presenteras för användaren som en knapp inuti en rubrik:

Kodexempel

Rubriken gör det möjligt för användare med skärmläsare att hoppa mellan alla accordions och andra rubriker på sidan med tangentbordskommandot "H".

Varje utvecklare ansvarar för att Accordion får rätt rubriknivå för att passa i den kontext där den ska visas. Rubriknivåer får aldrig skippas på en sida utan måste följa sin semantiska ordning. Som standard används en h2-rubrik men det kan ändras vid behov med propen headingLevel.

WAI-ARIA

ARIA-attributet aria-expanded berättar för användare med skärmläsare om komponenten är utfälld eller inte. Det hanteras automatiskt på komponentnivå i AccordionSummary och behöver inte sättas manuellt.

Tillgängligt namn

Namnet på AccordionSummary som läses upp av skärmläsare kommer automatiskt från dess innehåll.

Tangentbordsinteraktioner

  • Enter eller mellanslag
    Öppna eller stäng komponenten

Change log

  • Adds new focus-visible markings.

    4.1.0
  • Major refactor of Accordion

    4.0.0

    Breaking

  • Upgrade to React 19

    3.1.0

Statistik

  • Importer av Accordion

    56
  • Repos med Accordion

    45%
  • Senaste installerade version av Accordion

    4.1.0
  • Äldsta installerade version av Accordion

    3.1.0