Accordion
A stack of headings that each show or hide a section of content.
Accordion follows the Accordion WAI-ARIA design pattern.
import { component$, useStyles$ } from '@builder.io/qwik';
import { Accordion } from '@leve-ui/accordion';
import { LuChevronDown } from '@qwikest/icons/lucide';
import styles from './default.css?inline';
export default component$(() => {
useStyles$(styles);
return (
<Accordion.Root class="accordion-default-root">
<Accordion.Item value="item-1" class="accordion-default-item">
<Accordion.Header class="accordion-default-header">
<Accordion.Trigger class="accordion-default-trigger">
<span>What is leve-ui?</span>
<LuChevronDown class="accordion-default-chevron" aria-hidden="true" />
</Accordion.Trigger>
</Accordion.Header>
<Accordion.Content class="accordion-default-content">
leve-ui is a headless UI component library built for Qwik with full WAI-ARIA compliance.
</Accordion.Content>
</Accordion.Item>
<Accordion.Item value="item-2" class="accordion-default-item">
<Accordion.Header class="accordion-default-header">
<Accordion.Trigger class="accordion-default-trigger">
<span>Is it accessible?</span>
<LuChevronDown class="accordion-default-chevron" aria-hidden="true" />
</Accordion.Trigger>
</Accordion.Header>
<Accordion.Content class="accordion-default-content">
Yes, all components follow WAI-ARIA Authoring Practices Guide (APG) patterns and keyboard
interactions.
</Accordion.Content>
</Accordion.Item>
<Accordion.Item value="item-3" class="accordion-default-item">
<Accordion.Header class="accordion-default-header">
<Accordion.Trigger class="accordion-default-trigger">
<span>Can I customize the styles?</span>
<LuChevronDown class="accordion-default-chevron" aria-hidden="true" />
</Accordion.Trigger>
</Accordion.Header>
<Accordion.Content class="accordion-default-content">
Yes, leve-ui components are headless and unstyled. You can style them using CSS, Tailwind,
or any CSS-in-JS library.
</Accordion.Content>
</Accordion.Item>
</Accordion.Root>
);
});.accordion-default-root {
width: 320px;
max-width: 100%;
font-family: inherit;
}
.accordion-default-item {
border-bottom: 1px solid light-dark(#e2e8f0, #ffffff1f);
}
.accordion-default-header {
margin: 0;
}
.accordion-default-trigger {
display: flex;
align-items: center;
justify-content: space-between;
width: 100%;
padding: 12px 2px;
background: none;
border: none;
font: inherit;
font-size: 14px;
font-weight: 500;
color: light-dark(#0f172a, #ffffff);
text-align: left;
cursor: pointer;
}
.accordion-default-trigger:hover:not([data-disabled]) {
color: light-dark(#006ce9, #4cb8ff);
}
.accordion-default-trigger:focus-visible {
outline: 2px solid #009dfd;
outline-offset: 2px;
border-radius: 4px;
}
.accordion-default-trigger[data-disabled] {
opacity: 0.5;
cursor: not-allowed;
}
/* Rotate the chevron while the item is open */
.accordion-default-chevron {
flex-shrink: 0;
width: 16px;
height: 16px;
color: light-dark(#475569, #c9ddf0);
transition: transform 200ms ease;
}
.accordion-default-trigger[data-state="open"] .accordion-default-chevron {
transform: rotate(180deg);
}
.accordion-default-content {
padding: 0 2px 12px;
font-size: 14px;
line-height: 1.6;
color: light-dark(#475569, #c9ddf0);
}Installation#
Install the individual package, or use @leve-ui/core to get every component at once:
pnpm add @leve-ui/accordionnpm install @leve-ui/accordionyarn add @leve-ui/accordionbun add @leve-ui/accordionpnpm add @leve-ui/corenpm install @leve-ui/coreyarn add @leve-ui/corebun add @leve-ui/coreAnatomy#
import { Accordion } from '@leve-ui/accordion'; // or '@leve-ui/core'
<Accordion.Root>
<Accordion.Item value="item-1">
<Accordion.Header>
<Accordion.Trigger />
</Accordion.Header>
<Accordion.Content />
</Accordion.Item>
</Accordion.Root>
| Part | Element | Description |
|---|---|---|
Accordion.Root | <div> | Wraps the items and holds which ones are open. |
Accordion.Item | <div> | One pair of a header and its content, identified by value. |
Accordion.Header | <h1>–<h6> | The heading that wraps the trigger. The level is set by level (default 3). |
Accordion.Trigger | <button> | Shows or hides the content. |
Accordion.Content | <div> | The section of content. Hidden while the item is closed. |
Examples#
Multiple#
With type="multiple", any number of items can be open at once.
import { component$, useStyles$ } from '@builder.io/qwik';
import { Accordion } from '@leve-ui/accordion';
import { LuChevronDown } from '@qwikest/icons/lucide';
import styles from './multiple.css?inline';
export default component$(() => {
useStyles$(styles);
return (
<Accordion.Root type="multiple" defaultValue={['item-1']} class="accordion-multiple-root">
<Accordion.Item value="item-1" class="accordion-multiple-item">
<Accordion.Header class="accordion-multiple-header">
<Accordion.Trigger class="accordion-multiple-trigger">
<span>What is leve-ui?</span>
<LuChevronDown class="accordion-multiple-chevron" aria-hidden="true" />
</Accordion.Trigger>
</Accordion.Header>
<Accordion.Content class="accordion-multiple-content">
leve-ui is a headless UI component library built for Qwik with full WAI-ARIA compliance.
</Accordion.Content>
</Accordion.Item>
<Accordion.Item value="item-2" class="accordion-multiple-item">
<Accordion.Header class="accordion-multiple-header">
<Accordion.Trigger class="accordion-multiple-trigger">
<span>Is it accessible?</span>
<LuChevronDown class="accordion-multiple-chevron" aria-hidden="true" />
</Accordion.Trigger>
</Accordion.Header>
<Accordion.Content class="accordion-multiple-content">
Yes, all components follow WAI-ARIA Authoring Practices Guide (APG) patterns and keyboard
interactions.
</Accordion.Content>
</Accordion.Item>
<Accordion.Item value="item-3" class="accordion-multiple-item">
<Accordion.Header class="accordion-multiple-header">
<Accordion.Trigger class="accordion-multiple-trigger">
<span>Can I customize the styles?</span>
<LuChevronDown class="accordion-multiple-chevron" aria-hidden="true" />
</Accordion.Trigger>
</Accordion.Header>
<Accordion.Content class="accordion-multiple-content">
Yes, leve-ui components are headless and unstyled. You can style them using CSS, Tailwind,
or any CSS-in-JS library.
</Accordion.Content>
</Accordion.Item>
</Accordion.Root>
);
});.accordion-multiple-root {
width: 320px;
max-width: 100%;
font-family: inherit;
}
.accordion-multiple-item {
border-bottom: 1px solid light-dark(#e2e8f0, #ffffff1f);
}
.accordion-multiple-header {
margin: 0;
}
.accordion-multiple-trigger {
display: flex;
align-items: center;
justify-content: space-between;
width: 100%;
padding: 12px 2px;
background: none;
border: none;
font: inherit;
font-size: 14px;
font-weight: 500;
color: light-dark(#0f172a, #ffffff);
text-align: left;
cursor: pointer;
}
.accordion-multiple-trigger:hover:not([data-disabled]) {
color: light-dark(#006ce9, #4cb8ff);
}
.accordion-multiple-trigger:focus-visible {
outline: 2px solid #009dfd;
outline-offset: 2px;
border-radius: 4px;
}
.accordion-multiple-trigger[data-disabled] {
opacity: 0.5;
cursor: not-allowed;
}
/* Rotate the chevron while the item is open */
.accordion-multiple-chevron {
flex-shrink: 0;
width: 16px;
height: 16px;
color: light-dark(#475569, #c9ddf0);
transition: transform 200ms ease;
}
.accordion-multiple-trigger[data-state="open"] .accordion-multiple-chevron {
transform: rotate(180deg);
}
.accordion-multiple-content {
padding: 0 2px 12px;
font-size: 14px;
line-height: 1.6;
color: light-dark(#475569, #c9ddf0);
}Collapsible#
With collapsible, the open item can be closed by activating its trigger again.
import { component$, useStyles$ } from '@builder.io/qwik';
import { Accordion } from '@leve-ui/accordion';
import { LuChevronDown } from '@qwikest/icons/lucide';
import styles from './collapsible.css?inline';
export default component$(() => {
useStyles$(styles);
return (
<Accordion.Root collapsible defaultValue={['item-1']} class="accordion-collapsible-root">
<Accordion.Item value="item-1" class="accordion-collapsible-item">
<Accordion.Header class="accordion-collapsible-header">
<Accordion.Trigger class="accordion-collapsible-trigger">
<span>What is leve-ui?</span>
<LuChevronDown class="accordion-collapsible-chevron" aria-hidden="true" />
</Accordion.Trigger>
</Accordion.Header>
<Accordion.Content class="accordion-collapsible-content">
leve-ui is a headless UI component library built for Qwik with full WAI-ARIA compliance.{' '}
<a href="#learn-more" class="accordion-collapsible-link">
Learn more about leve-ui
</a>
</Accordion.Content>
</Accordion.Item>
<Accordion.Item value="item-2" class="accordion-collapsible-item">
<Accordion.Header class="accordion-collapsible-header">
<Accordion.Trigger class="accordion-collapsible-trigger">
<span>Is it accessible?</span>
<LuChevronDown class="accordion-collapsible-chevron" aria-hidden="true" />
</Accordion.Trigger>
</Accordion.Header>
<Accordion.Content class="accordion-collapsible-content">
Yes, all components follow WAI-ARIA Authoring Practices Guide (APG) patterns and keyboard
interactions.
</Accordion.Content>
</Accordion.Item>
<Accordion.Item value="item-3" class="accordion-collapsible-item">
<Accordion.Header class="accordion-collapsible-header">
<Accordion.Trigger class="accordion-collapsible-trigger">
<span>Can I customize the styles?</span>
<LuChevronDown class="accordion-collapsible-chevron" aria-hidden="true" />
</Accordion.Trigger>
</Accordion.Header>
<Accordion.Content class="accordion-collapsible-content">
Yes, leve-ui components are headless and unstyled. You can style them using CSS, Tailwind,
or any CSS-in-JS library.
</Accordion.Content>
</Accordion.Item>
</Accordion.Root>
);
});.accordion-collapsible-root {
width: 320px;
max-width: 100%;
font-family: inherit;
}
.accordion-collapsible-item {
border-bottom: 1px solid light-dark(#e2e8f0, #ffffff1f);
}
.accordion-collapsible-header {
margin: 0;
}
.accordion-collapsible-trigger {
display: flex;
align-items: center;
justify-content: space-between;
width: 100%;
padding: 12px 2px;
background: none;
border: none;
font: inherit;
font-size: 14px;
font-weight: 500;
color: light-dark(#0f172a, #ffffff);
text-align: left;
cursor: pointer;
}
.accordion-collapsible-trigger:hover:not([data-disabled]) {
color: light-dark(#006ce9, #4cb8ff);
}
.accordion-collapsible-trigger:focus-visible {
outline: 2px solid #009dfd;
outline-offset: 2px;
border-radius: 4px;
}
.accordion-collapsible-trigger[data-disabled] {
opacity: 0.5;
cursor: not-allowed;
}
/* Rotate the chevron while the item is open */
.accordion-collapsible-chevron {
flex-shrink: 0;
width: 16px;
height: 16px;
color: light-dark(#475569, #c9ddf0);
transition: transform 200ms ease;
}
.accordion-collapsible-trigger[data-state="open"] .accordion-collapsible-chevron {
transform: rotate(180deg);
}
.accordion-collapsible-content {
padding: 0 2px 12px;
font-size: 14px;
line-height: 1.6;
color: light-dark(#475569, #c9ddf0);
}
.accordion-collapsible-link {
color: light-dark(#006ce9, #4cb8ff);
text-decoration: underline;
}
.accordion-collapsible-link:focus-visible {
outline: 2px solid #009dfd;
outline-offset: 2px;
}Disabled#
disabled on an Accordion.Item disables that item. disabled on the Root disables all items.
import { component$, useStyles$ } from '@builder.io/qwik';
import { Accordion } from '@leve-ui/accordion';
import { LuChevronDown } from '@qwikest/icons/lucide';
import styles from './disabled.css?inline';
export default component$(() => {
useStyles$(styles);
return (
<Accordion.Root class="accordion-disabled-root">
<Accordion.Item value="item-1" class="accordion-disabled-item">
<Accordion.Header class="accordion-disabled-header">
<Accordion.Trigger class="accordion-disabled-trigger">
<span>What is leve-ui?</span>
<LuChevronDown class="accordion-disabled-chevron" aria-hidden="true" />
</Accordion.Trigger>
</Accordion.Header>
<Accordion.Content class="accordion-disabled-content">
leve-ui is a headless UI component library built for Qwik with full WAI-ARIA compliance.
</Accordion.Content>
</Accordion.Item>
<Accordion.Item value="item-2" disabled class="accordion-disabled-item">
<Accordion.Header class="accordion-disabled-header">
<Accordion.Trigger class="accordion-disabled-trigger">
<span>Is it accessible? (Disabled)</span>
<LuChevronDown class="accordion-disabled-chevron" aria-hidden="true" />
</Accordion.Trigger>
</Accordion.Header>
<Accordion.Content class="accordion-disabled-content">
Yes, all components follow WAI-ARIA Authoring Practices Guide (APG) patterns and keyboard
interactions.
</Accordion.Content>
</Accordion.Item>
<Accordion.Item value="item-3" class="accordion-disabled-item">
<Accordion.Header class="accordion-disabled-header">
<Accordion.Trigger class="accordion-disabled-trigger">
<span>Can I customize the styles?</span>
<LuChevronDown class="accordion-disabled-chevron" aria-hidden="true" />
</Accordion.Trigger>
</Accordion.Header>
<Accordion.Content class="accordion-disabled-content">
Yes, leve-ui components are headless and unstyled. You can style them using CSS, Tailwind,
or any CSS-in-JS library.
</Accordion.Content>
</Accordion.Item>
</Accordion.Root>
);
});.accordion-disabled-root {
width: 320px;
max-width: 100%;
font-family: inherit;
}
.accordion-disabled-item {
border-bottom: 1px solid light-dark(#e2e8f0, #ffffff1f);
}
.accordion-disabled-header {
margin: 0;
}
.accordion-disabled-trigger {
display: flex;
align-items: center;
justify-content: space-between;
width: 100%;
padding: 12px 2px;
background: none;
border: none;
font: inherit;
font-size: 14px;
font-weight: 500;
color: light-dark(#0f172a, #ffffff);
text-align: left;
cursor: pointer;
}
.accordion-disabled-trigger:hover:not([data-disabled]) {
color: light-dark(#006ce9, #4cb8ff);
}
.accordion-disabled-trigger:focus-visible {
outline: 2px solid #009dfd;
outline-offset: 2px;
border-radius: 4px;
}
.accordion-disabled-trigger[data-disabled] {
opacity: 0.5;
cursor: not-allowed;
}
/* Rotate the chevron while the item is open */
.accordion-disabled-chevron {
flex-shrink: 0;
width: 16px;
height: 16px;
color: light-dark(#475569, #c9ddf0);
transition: transform 200ms ease;
}
.accordion-disabled-trigger[data-state="open"] .accordion-disabled-chevron {
transform: rotate(180deg);
}
.accordion-disabled-content {
padding: 0 2px 12px;
font-size: 14px;
line-height: 1.6;
color: light-dark(#475569, #c9ddf0);
}Controlled#
Pass a signal to bind:value to read and change the open items from outside.
Open items: item-1
import { component$, useSignal, useStyles$ } from '@builder.io/qwik';
import { Accordion } from '@leve-ui/accordion';
import { LuChevronDown } from '@qwikest/icons/lucide';
import styles from './controlled.css?inline';
export default component$(() => {
useStyles$(styles);
const openValues = useSignal<string[]>(['item-1']);
return (
<div class="accordion-controlled-wrapper">
<Accordion.Root collapsible bind:value={openValues} class="accordion-controlled-root">
<Accordion.Item value="item-1" class="accordion-controlled-item">
<Accordion.Header class="accordion-controlled-header">
<Accordion.Trigger class="accordion-controlled-trigger">
<span>What is leve-ui?</span>
<LuChevronDown class="accordion-controlled-chevron" aria-hidden="true" />
</Accordion.Trigger>
</Accordion.Header>
<Accordion.Content class="accordion-controlled-content">
leve-ui is a headless UI component library built for Qwik with full WAI-ARIA compliance.
</Accordion.Content>
</Accordion.Item>
<Accordion.Item value="item-2" class="accordion-controlled-item">
<Accordion.Header class="accordion-controlled-header">
<Accordion.Trigger class="accordion-controlled-trigger">
<span>Is it accessible?</span>
<LuChevronDown class="accordion-controlled-chevron" aria-hidden="true" />
</Accordion.Trigger>
</Accordion.Header>
<Accordion.Content class="accordion-controlled-content">
Yes, all components follow WAI-ARIA Authoring Practices Guide (APG) patterns and
keyboard interactions.
</Accordion.Content>
</Accordion.Item>
<Accordion.Item value="item-3" class="accordion-controlled-item">
<Accordion.Header class="accordion-controlled-header">
<Accordion.Trigger class="accordion-controlled-trigger">
<span>Can I customize the styles?</span>
<LuChevronDown class="accordion-controlled-chevron" aria-hidden="true" />
</Accordion.Trigger>
</Accordion.Header>
<Accordion.Content class="accordion-controlled-content">
Yes, leve-ui components are headless and unstyled. You can style them using CSS,
Tailwind, or any CSS-in-JS library.
</Accordion.Content>
</Accordion.Item>
</Accordion.Root>
<p class="accordion-controlled-status">
Open items: {openValues.value.length > 0 ? openValues.value.join(', ') : 'none'}
</p>
</div>
);
});.accordion-controlled-wrapper {
display: flex;
flex-direction: column;
gap: 12px;
font-family: inherit;
}
.accordion-controlled-root {
width: 320px;
max-width: 100%;
}
.accordion-controlled-item {
border-bottom: 1px solid light-dark(#e2e8f0, #ffffff1f);
}
.accordion-controlled-header {
margin: 0;
}
.accordion-controlled-trigger {
display: flex;
align-items: center;
justify-content: space-between;
width: 100%;
padding: 12px 2px;
background: none;
border: none;
font: inherit;
font-size: 14px;
font-weight: 500;
color: light-dark(#0f172a, #ffffff);
text-align: left;
cursor: pointer;
}
.accordion-controlled-trigger:hover:not([data-disabled]) {
color: light-dark(#006ce9, #4cb8ff);
}
.accordion-controlled-trigger:focus-visible {
outline: 2px solid #009dfd;
outline-offset: 2px;
border-radius: 4px;
}
.accordion-controlled-trigger[data-disabled] {
opacity: 0.5;
cursor: not-allowed;
}
/* Rotate the chevron while the item is open */
.accordion-controlled-chevron {
flex-shrink: 0;
width: 16px;
height: 16px;
color: light-dark(#475569, #c9ddf0);
transition: transform 200ms ease;
}
.accordion-controlled-trigger[data-state="open"] .accordion-controlled-chevron {
transform: rotate(180deg);
}
.accordion-controlled-content {
padding: 0 2px 12px;
font-size: 14px;
line-height: 1.6;
color: light-dark(#475569, #c9ddf0);
}
.accordion-controlled-status {
margin: 0;
font-size: 13px;
color: light-dark(#475569, #c9ddf0);
}API Reference#
Root#
| Prop | Default | Type |
|---|---|---|
| type | 'single' | 'single' | 'multiple' How many items can be open at once.
- |
| defaultValue | [] | string[] The values of the items that are open initially (uncontrolled). |
| bind:value | – | Signal<string[]> A signal with the values of the open items (controlled). |
| onValueChange$ | – | QRL<(value: string[]) => void> Called when the user opens or closes an item. |
| collapsible | false | boolean When |
| disabled | false | boolean Disables all items. |
| orientation | 'vertical' | 'vertical' | 'horizontal' The orientation of the accordion, which decides the arrow keys that move focus. |
| loop | true | boolean Whether arrow keys wrap from the last trigger to the first and vice versa. |
Also accepts all <div> attributes.
| Data attribute | Value |
|---|---|
data-leve-accordion | Always present |
data-orientation | "vertical" | "horizontal" |
data-disabled | Present when the Root is disabled |
The open items are uncontrolled with defaultValue, or controlled with bind:value. onValueChange$ is called when the user opens or closes an item.
Item#
| Prop | Default | Type |
|---|---|---|
| value (required) | – | string A unique value that identifies this item. |
| disabled | false | boolean Disables this item. |
Also accepts all <div> attributes.
| Data attribute | Value |
|---|---|
data-leve-accordion-item | Always present |
data-state | "open" | "closed" |
data-disabled | Present when the item or the Root is disabled |
data-orientation | "vertical" | "horizontal" |
Header#
| Prop | Default | Type |
|---|---|---|
| level | 3 | 1 | 2 | 3 | 4 | 5 | 6 The heading level (1–6) of the element that wraps the trigger. |
Also accepts all <h1>–<h6> attributes.
| Data attribute | Value |
|---|---|
data-leve-accordion-header | Always present |
data-state | "open" | "closed" |
data-disabled | Present when the item is disabled |
data-orientation | "vertical" | "horizontal" |
Trigger#
No props of its own. Accepts all <button> attributes.
| Data attribute | Value |
|---|---|
data-leve-accordion-trigger | Always present |
data-state | "open" | "closed" |
data-disabled | Present when the item is disabled |
data-orientation | "vertical" | "horizontal" |
A disabled item's trigger gets the native disabled attribute.
Content#
No props of its own. Accepts all <div> attributes.
| Data attribute | Value |
|---|---|
data-leve-accordion-content | Always present |
data-state | "open" | "closed" |
data-disabled | Present when the item is disabled |
data-orientation | "vertical" | "horizontal" |
The content has the hidden attribute while the item is closed. It stays in the DOM so that the trigger's aria-controls keeps pointing to it.
Accessibility#
Complies with the Accordion WAI-ARIA design pattern.
Accordion.Triggeris a<button type="button">witharia-expandedandaria-controlspointing to its content.Accordion.Contenthasrole="region"andaria-labelledbypointing to its trigger. IDs are generated withuseId().- Choose a
levelonAccordion.Headerthat fits the heading structure of the page. - When
typeis"single"andcollapsibleisfalse, the trigger of the open item hasaria-disabled="true", because it cannot be closed. - Disabled triggers are skipped by Tab and the arrow keys.
Keyboard Interactions#
| Key | Description |
|---|---|
Enter / Space | Opens or closes the item of the focused trigger. |
Tab / Shift+Tab | Moves focus to the next or previous focusable element. |
ArrowDown / ArrowUp | When orientation is "vertical", moves focus to the next or previous trigger. |
ArrowRight / ArrowLeft | When orientation is "horizontal", moves focus to the next or previous trigger (reversed in right-to-left text). |
Home / End | Moves focus to the first or last trigger. |
The arrow keys wrap from the last trigger to the first and back while loop is true (the default).