A vertically stacked set of interactive headings that each reveal a section of content.
What are your shipping options?
What is your return policy?
How can I contact customer support?
import { html } from '@webjsdev/core';
import { cn } from '#lib/utils/cn.ts';
import {
accordionClass, accordionItemClass, accordionTriggerClass, accordionContentClass, accordionContentInnerClass,
} from '#components/ui/accordion.ts';
import { ChevronDownIcon, ChevronUpIcon } from '#lib/ui/lucide.ts';
const ITEMS = [
{
value: 'shipping',
trigger: 'What are your shipping options?',
content: 'We offer standard (5-7 days), express (2-3 days), and overnight shipping. Free shipping on international orders.',
},
{
value: 'returns',
trigger: 'What is your return policy?',
content: 'Returns accepted within 30 days. Items must be unused and in original packaging. Refunds processed within 5-7 business days.',
},
{
value: 'support',
trigger: 'How can I contact customer support?',
content: 'Reach us via email, live chat, or phone. We respond within 24 hours during business days.',
},
];
export default function AccordionDemo() {
return html`
<div data-slot="accordion" class=${cn(accordionClass(), 'max-w-lg')}>
${ITEMS.map((item) => html`
<details name="accordion-demo" data-slot="accordion-item" class=${accordionItemClass()} ?open=${item.value === 'shipping'}>
<summary data-slot="accordion-trigger" class=${accordionTriggerClass()}>
${item.trigger}
${ChevronDownIcon('pointer-events-none ml-auto size-4 shrink-0 text-muted-foreground group-open:hidden')}
${ChevronUpIcon('pointer-events-none ml-auto hidden size-4 shrink-0 text-muted-foreground group-open:inline')}
</summary>
<div data-slot="accordion-content" class=${accordionContentClass()}>
<div class=${accordionContentInnerClass()}>${item.content}</div>
</div>
</details>
`)}
</div>
`;
}
View Code
Installation
Copy and paste the following code into your project.
/**
* Accordion: vertical collapsible list built on native <details>/<summary>.
*
* Tier-1 (no custom element). Exclusive open behaviour (Radix's
* `type="single"`) comes from giving every <details> the same
* `name="..."` attribute. Independent open (`type="multiple"`) is the
* default when `name` is omitted. Both modes give `collapsible` for
* free: clicking the open <summary> closes it.
*
* shadcn parity:
* <Accordion type="single" collapsible> → <div class=${accordionClass()}> wrapping
* <details name="..."> items
* <Accordion type="multiple"> → same, omit `name`
* <AccordionItem> → <details class=${accordionItemClass()}>
* <AccordionTrigger> → <summary class=${accordionTriggerClass()}>
* <AccordionContent> → <div class=${accordionContentClass()}> around
* <div class=${accordionContentInnerClass()}>
*
* Initial state: add `open` on the <details> that should render expanded
* on first paint. Programmatic toggling: `el.open = true | false`.
*
* `<details name="X">` is the platform's exclusive-accordion primitive:
* Chrome 120+, Safari 17.2+, Firefox 130+. Migrated from the prior
* <ui-accordion> custom element set.
*
* Design tokens used: --border, --ring, --foreground.
*
* A11y (mostly handled by the native primitives):
* Build it on `<details>` + `<summary>`, which is where nearly all of this
* comes from: the browser supplies the button semantics, the expanded state,
* Enter / Space activation, and focus, with no ARIA to hand-write. Do not
* reimplement it with a `<div>` and `aria-expanded`.
* Put the trigger classes on the `<summary>` ITSELF, not on a `<button>` or
* `<div>` nested inside it. A nested interactive element inside a `<summary>`
* is the #1078-class bug: the focusable thing and the labelled thing come
* apart, and the summary's own name goes empty.
* The chevron is decorative, so keep it `aria-hidden="true"`.
* `name` on `<details>` is what gives exclusive-open behaviour natively, so
* prefer it over JS that closes siblings.
* Use a real heading inside the `<summary>` when the section title belongs in
* the document outline, and pick its level from the surrounding page.
* Never rely on the collapsed state to HIDE something that must stay
* available: collapsed content is not reachable by find-in-page on every
* engine, so nothing essential should live only there.
*
* @example
* ```html
* <div class=${accordionClass()}>
* <details name="faq" class=${accordionItemClass()} open>
* <summary class=${accordionTriggerClass()}>
* <span>Is it accessible?</span>
* <svg class="size-4 shrink-0 transition-transform group-open:rotate-180" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" aria-hidden="true"><path d="m6 9 6 6 6-6" /></svg>
* </summary>
* <div class=${accordionContentClass()}>
* <div class=${accordionContentInnerClass()}>Yes, it uses a native disclosure widget.</div>
* </div>
* </details>
* <details name="faq" class=${accordionItemClass()}>
* <summary class=${accordionTriggerClass()}>
* <span>Is it styled?</span>
* <svg class="size-4 shrink-0 transition-transform group-open:rotate-180" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" aria-hidden="true"><path d="m6 9 6 6 6-6" /></svg>
* </summary>
* <div class=${accordionContentClass()}>
* <div class=${accordionContentInnerClass()}>Yes, with the kit's design tokens.</div>
* </div>
* </details>
* </div>
* ```
*/
/** Root wrapper. Holds the column-of-items rhythm; no display: rules. */
export const accordionClass = (): string => 'flex w-full flex-col';
/**
* Item: each <details>. The `group` utility lets the trigger's chevron
* rotate on open via `group-open:rotate-180`. `last:border-b-0` cleans
* the trailing edge.
*/
export const accordionItemClass = (): string => 'border-b last:border-b-0 group';
/**
* Trigger: applied to <summary>. Hides the native disclosure triangle so
* authors can compose their own chevron icon (typical pattern: trailing
* lucide chevron with `group-open:rotate-180`).
*
* `disabled: true` returns the visual disabled state (greyed out,
* not-allowed cursor, no pointer events). For true keyboard prevention
*, the native disabled-disclosure-widget gap, add the standard
* `inert` attribute to the <details> element. shadcn's React `disabled`
* prop combines both; native HTML has no `disabled` on <details>.
*/
export const accordionTriggerClass = (opts: { disabled?: boolean } = {}): string => {
const base = 'w-full cursor-pointer list-none items-center gap-4 py-4 text-start text-sm font-medium hover:underline focus-visible:ring-2 focus-visible:ring-ring/50 marker:hidden [&::-webkit-details-marker]:hidden group/accordion-trigger relative flex justify-between outline-none transition-all disabled:pointer-events-none disabled:opacity-50';
if (opts.disabled) return `${base} pointer-events-none cursor-not-allowed opacity-50`;
return base;
};
/**
* Content: <details> hides this entirely when not [open], so all we add
* is the typography rhythm matching shadcn (bottom padding, small text).
*/
export const accordionContentClass = (): string => 'pb-4 text-sm overflow-hidden';
/**
* Content inner: the wrapper shadcn's AccordionContent renders inside the
* content, around what you write. The styles put the content's padding here,
* and it underlines links and spaces paragraphs.
*/
export const accordionContentInnerClass = (): string =>
'h-(--radix-accordion-content-height) [&_a]:underline [&_a]:underline-offset-3 [&_a]:hover:text-foreground [&_p:not(:last-child)]:mb-4';
Update the import paths to match your project setup.
Usage
import {
accordionClass,
accordionItemClass,
accordionTriggerClass,
accordionContentClass,
} from '#components/ui/accordion.ts';
<div data-slot="accordion" class=${accordionClass()}>
<details name="faq" data-slot="accordion-item" class=${accordionItemClass()} open>
<summary data-slot="accordion-trigger" class=${accordionTriggerClass()}>Is it accessible?</summary>
<div data-slot="accordion-content" class=${accordionContentClass()}>
Yes. It adheres to the WAI-ARIA design pattern.
</div>
</details>
</div>
The accordion is built on the native <details> and <summary> elements, so it opens and closes with no JavaScript. Giving every item the same name makes them exclusive, so only one is open at a time, and clicking the open item closes it. Add open to the item that should render expanded.
Composition
Use the following composition to build an accordion:
accordionClass()
├── accordionItemClass()
│ ├── accordionTriggerClass()
│ └── accordionContentClass()
└── accordionItemClass()
├── accordionTriggerClass()
└── accordionContentClass()
Basic
A basic accordion that shows one item at a time. The first item is open by default.
How do I reset my password?
Can I change my subscription plan?
What payment methods do you accept?
import { html } from '@webjsdev/core';
import { cn } from '#lib/utils/cn.ts';
import {
accordionClass, accordionItemClass, accordionTriggerClass, accordionContentClass,
} from '#components/ui/accordion.ts';
import { ChevronDownIcon, ChevronUpIcon } from '#lib/ui/lucide.ts';
const items = [
{
value: 'item-1',
trigger: 'How do I reset my password?',
content:
"Click on 'Forgot Password' on the login page, enter your email address, and we'll send you a link to reset your password. The link will expire in 24 hours.",
},
{
value: 'item-2',
trigger: 'Can I change my subscription plan?',
content:
'Yes, you can upgrade or downgrade your plan at any time from your account settings. Changes will be reflected in your next billing cycle.',
},
{
value: 'item-3',
trigger: 'What payment methods do you accept?',
content:
'We accept all major credit cards, PayPal, and bank transfers. All payments are processed securely through our payment partners.',
},
];
// One shared name makes the items exclusive: opening one closes the others.
export default function AccordionBasic() {
return html`
<div data-slot="accordion" class=${cn(accordionClass(), 'max-w-lg')}>
${items.map((item) => html`
<details name="accordion-basic" data-slot="accordion-item" class=${accordionItemClass()} ?open=${item.value === 'item-1'}>
<summary data-slot="accordion-trigger" class=${accordionTriggerClass()}>
${item.trigger}
${ChevronDownIcon('pointer-events-none ml-auto size-4 shrink-0 text-muted-foreground group-open:hidden')}
${ChevronUpIcon('pointer-events-none ml-auto hidden size-4 shrink-0 text-muted-foreground group-open:inline')}
</summary>
<div data-slot="accordion-content" class=${accordionContentClass()}>${item.content}</div>
</details>
`)}
</div>
`;
}
View Code
Multiple
Leave out the name attribute to allow multiple items to be open at the same time.
Notification Settings
Privacy & Security
Billing & Subscription
import { html } from '@webjsdev/core';
import { cn } from '#lib/utils/cn.ts';
import {
accordionClass, accordionItemClass, accordionTriggerClass, accordionContentClass,
} from '#components/ui/accordion.ts';
import { ChevronDownIcon, ChevronUpIcon } from '#lib/ui/lucide.ts';
const items = [
{
value: 'notifications',
trigger: 'Notification Settings',
content:
'Manage how you receive notifications. You can enable email alerts for updates or push notifications for mobile devices.',
},
{
value: 'privacy',
trigger: 'Privacy & Security',
content:
'Control your privacy settings and security preferences. Enable two-factor authentication, manage connected devices, review active sessions, and configure data sharing preferences. You can also download your data or delete your account.',
},
{
value: 'billing',
trigger: 'Billing & Subscription',
content:
'View your current plan, payment history, and upcoming invoices. Update your payment method, change your subscription tier, or cancel your subscription.',
},
];
// No name on the items, so each one opens and closes on its own.
export default function AccordionMultiple() {
return html`
<div data-slot="accordion" class=${cn(accordionClass(), 'max-w-lg')}>
${items.map((item) => html`
<details data-slot="accordion-item" class=${accordionItemClass()} ?open=${item.value === 'notifications'}>
<summary data-slot="accordion-trigger" class=${accordionTriggerClass()}>
${item.trigger}
${ChevronDownIcon('pointer-events-none ml-auto size-4 shrink-0 text-muted-foreground group-open:hidden')}
${ChevronUpIcon('pointer-events-none ml-auto hidden size-4 shrink-0 text-muted-foreground group-open:inline')}
</summary>
<div data-slot="accordion-content" class=${accordionContentClass()}>${item.content}</div>
</details>
`)}
</div>
`;
}
View Code
Disabled
To disable an item, use accordionTriggerClass({ disabled: true }) for the disabled look and add inert to the item so it cannot be focused or opened.
Can I access my account history?
Premium feature information
How do I update my email address?
import { html } from '@webjsdev/core';
import { cn } from '#lib/utils/cn.ts';
import {
accordionClass, accordionItemClass, accordionTriggerClass, accordionContentClass,
} from '#components/ui/accordion.ts';
import { ChevronDownIcon, ChevronUpIcon } from '#lib/ui/lucide.ts';
const chevrons = () => html`
${ChevronDownIcon('pointer-events-none ml-auto size-4 shrink-0 text-muted-foreground group-open:hidden')}
${ChevronUpIcon('pointer-events-none ml-auto hidden size-4 shrink-0 text-muted-foreground group-open:inline')}
`;
// A <details> has no disabled attribute: the disabled trigger classes grey
// the item out, and inert takes it out of the tab order and the click path.
export default function AccordionDisabled() {
return html`
<div data-slot="accordion" class=${cn(accordionClass(), 'w-full')}>
<details name="accordion-disabled" data-slot="accordion-item" class=${accordionItemClass()}>
<summary data-slot="accordion-trigger" class=${accordionTriggerClass()}>
Can I access my account history?
${chevrons()}
</summary>
<div data-slot="accordion-content" class=${accordionContentClass()}>
Yes, you can view your complete account history including all
transactions, plan changes, and support tickets in the Account History
section of your dashboard.
</div>
</details>
<details name="accordion-disabled" data-slot="accordion-item" data-disabled inert class=${accordionItemClass()}>
<summary data-slot="accordion-trigger" class=${accordionTriggerClass({ disabled: true })}>
Premium feature information
${chevrons()}
</summary>
<div data-slot="accordion-content" class=${accordionContentClass()}>
This section contains information about premium features. Upgrade your
plan to access this content.
</div>
</details>
<details name="accordion-disabled" data-slot="accordion-item" class=${accordionItemClass()}>
<summary data-slot="accordion-trigger" class=${accordionTriggerClass()}>
How do I update my email address?
${chevrons()}
</summary>
<div data-slot="accordion-content" class=${accordionContentClass()}>
You can update your email address in your account settings.
You'll receive a verification email at your new address to
confirm the change.
</div>
</details>
</div>
`;
}
View Code
Borders
Add border to the accordion and border-b last:border-b-0 to each item to add borders to the items.
How does billing work?
Is my data secure?
What integrations do you support?
import { html } from '@webjsdev/core';
import { cn } from '#lib/utils/cn.ts';
import {
accordionClass, accordionItemClass, accordionTriggerClass, accordionContentClass,
} from '#components/ui/accordion.ts';
import { ChevronDownIcon, ChevronUpIcon } from '#lib/ui/lucide.ts';
const items = [
{
value: 'billing',
trigger: 'How does billing work?',
content:
'We offer monthly and annual subscription plans. Billing is charged at the beginning of each cycle, and you can cancel anytime. All plans include automatic backups, 24/7 support, and unlimited team members.',
},
{
value: 'security',
trigger: 'Is my data secure?',
content:
'Yes. We use end-to-end encryption, SOC 2 Type II compliance, and regular third-party security audits. All data is encrypted at rest and in transit using industry-standard protocols.',
},
{
value: 'integration',
trigger: 'What integrations do you support?',
content:
'We integrate with 500+ popular tools including Slack, Zapier, Salesforce, HubSpot, and more. You can also build custom integrations using our REST API and webhooks.',
},
];
export default function AccordionBorders() {
return html`
<div data-slot="accordion" class=${cn(accordionClass(), 'max-w-lg rounded-lg border')}>
${items.map((item) => html`
<details name="accordion-borders" data-slot="accordion-item" class=${cn(accordionItemClass(), 'border-b px-4 last:border-b-0')} ?open=${item.value === 'billing'}>
<summary data-slot="accordion-trigger" class=${accordionTriggerClass()}>
${item.trigger}
${ChevronDownIcon('pointer-events-none ml-auto size-4 shrink-0 text-muted-foreground group-open:hidden')}
${ChevronUpIcon('pointer-events-none ml-auto hidden size-4 shrink-0 text-muted-foreground group-open:inline')}
</summary>
<div data-slot="accordion-content" class=${accordionContentClass()}>${item.content}</div>
</details>
`)}
</div>
`;
}
View Code
Card
Put the accordion inside a Card.
What subscription plans do you offer?
How does billing work?
How do I cancel my subscription?
import { html } from '@webjsdev/core';
import { cn } from '#lib/utils/cn.ts';
import {
cardClass, cardHeaderClass, cardTitleClass, cardDescriptionClass, cardContentClass,
} from '#components/ui/card.ts';
import {
accordionClass, accordionItemClass, accordionTriggerClass, accordionContentClass,
} from '#components/ui/accordion.ts';
import { ChevronDownIcon, ChevronUpIcon } from '#lib/ui/lucide.ts';
const items = [
{
value: 'plans',
trigger: 'What subscription plans do you offer?',
content:
'We offer three subscription tiers: Starter ($9/month), Professional ($29/month), and Enterprise ($99/month). Each plan includes increasing storage limits, API access, priority support, and team collaboration features.',
},
{
value: 'billing',
trigger: 'How does billing work?',
content:
"Billing occurs automatically at the start of each billing cycle. We accept all major credit cards, PayPal, and ACH transfers for enterprise customers. You'll receive an invoice via email after each payment.",
},
{
value: 'cancel',
trigger: 'How do I cancel my subscription?',
content:
'You can cancel your subscription anytime from your account settings. There are no cancellation fees or penalties. Your access will continue until the end of your current billing period.',
},
];
export default function AccordionCard() {
return html`
<div data-slot="card" data-size="default" class=${cn(cardClass(), 'w-full max-w-sm')}>
<div data-slot="card-header" class=${cardHeaderClass()}>
<div data-slot="card-title" class=${cardTitleClass()}>Subscription & Billing</div>
<div data-slot="card-description" class=${cardDescriptionClass()}>
Common questions about your account, plans, payments and
cancellations.
</div>
</div>
<div data-slot="card-content" class=${cardContentClass()}>
<div data-slot="accordion" class=${accordionClass()}>
${items.map((item) => html`
<details name="accordion-card" data-slot="accordion-item" class=${accordionItemClass()} ?open=${item.value === 'plans'}>
<summary data-slot="accordion-trigger" class=${accordionTriggerClass()}>
${item.trigger}
${ChevronDownIcon('pointer-events-none ml-auto size-4 shrink-0 text-muted-foreground group-open:hidden')}
${ChevronUpIcon('pointer-events-none ml-auto hidden size-4 shrink-0 text-muted-foreground group-open:inline')}
</summary>
<div data-slot="accordion-content" class=${accordionContentClass()}>${item.content}</div>
</details>
`)}
</div>
</div>
</div>
`;
}
View Code
RTL
To enable RTL support, see the RTL configuration guide.
كيف يمكنني إعادة تعيين كلمة المرور؟
هل يمكنني تغيير خطة الاشتراك الخاصة بي؟
ما هي طرق الدفع التي تقبلونها؟
import { html } from '@webjsdev/core';
import { cn } from '#lib/utils/cn.ts';
import {
accordionClass, accordionItemClass, accordionTriggerClass, accordionContentClass,
} from '#components/ui/accordion.ts';
import { ChevronDownIcon, ChevronUpIcon } from '#lib/ui/lucide.ts';
const translations = {
en: {
dir: 'ltr',
values: {
question1: 'How do I reset my password?',
answer1:
"Click on 'Forgot Password' on the login page, enter your email address, and we'll send you a link to reset your password. ",
question2: 'Can I change my subscription plan?',
answer2:
'Yes, you can upgrade or downgrade your plan at any time from your account settings. Changes will be reflected in your next billing cycle.',
question3: 'What payment methods do you accept?',
answer3:
'We accept all major credit cards, PayPal, and bank transfers. All payments are processed securely through our payment partners.',
},
},
ar: {
dir: 'rtl',
values: {
question1: 'كيف يمكنني إعادة تعيين كلمة المرور؟',
answer1:
"انقر على 'نسيت كلمة المرور' في صفحة تسجيل الدخول، أدخل عنوان بريدك الإلكتروني، وسنرسل لك رابطًا لإعادة تعيين كلمة المرور. سينتهي صلاحية الرابط خلال 24 ساعة.",
question2: 'هل يمكنني تغيير خطة الاشتراك الخاصة بي؟',
answer2:
'نعم، يمكنك ترقية أو تخفيض خطتك في أي وقت من إعدادات حسابك. ستظهر التغييرات في دورة الفوترة التالية.',
question3: 'ما هي طرق الدفع التي تقبلونها؟',
answer3:
'نقبل جميع بطاقات الائتمان الرئيسية و PayPal والتحويلات المصرفية. تتم معالجة جميع المدفوعات بأمان من خلال شركاء الدفع لدينا.',
},
},
he: {
dir: 'rtl',
values: {
question1: 'איך אני מאפס את הסיסמה שלי?',
answer1:
"לחץ על 'שכחתי סיסמה' בעמוד ההתחברות, הזן את כתובת האימייל שלך, ונשלח לך קישור לאיפוס הסיסמה. הקישור יפוג תוך 24 שעות.",
question2: 'האם אני יכול לשנות את תוכנית המנוי שלי?',
answer2:
'כן, אתה יכול לשדרג או להוריד את התוכנית שלך בכל עת מההגדרות של החשבון שלך. השינויים יבואו לידי ביטוי במחזור החיוב הבא.',
question3: 'אילו אמצעי תשלום אתם מקבלים?',
answer3: 'אנו מקבלים כרטיסי אשראי, PayPal והעברות בנקאיות.',
},
},
};
const items = [
{ value: 'item-1', questionKey: 'question1', answerKey: 'answer1' },
{ value: 'item-2', questionKey: 'question2', answerKey: 'answer2' },
{ value: 'item-3', questionKey: 'question3', answerKey: 'answer3' },
] as const;
export default function AccordionRtl() {
const lang = 'ar';
const { dir, values: t } = translations[lang];
return html`
<div data-slot="accordion" dir=${dir} lang=${lang} class=${cn(accordionClass(), 'max-w-md')}>
${items.map((item) => html`
<details name="accordion-rtl" data-slot="accordion-item" class=${accordionItemClass()} ?open=${item.value === 'item-1'}>
<summary data-slot="accordion-trigger" class=${accordionTriggerClass()}>
${t[item.questionKey]}
${ChevronDownIcon('pointer-events-none ms-auto size-4 shrink-0 text-muted-foreground group-open:hidden')}
${ChevronUpIcon('pointer-events-none ms-auto hidden size-4 shrink-0 text-muted-foreground group-open:inline')}
</summary>
<div data-slot="accordion-content" class=${accordionContentClass()}>${t[item.answerKey]}</div>
</details>
`)}
</div>
`;
}
View Code
API Reference
Every part is a class helper you put on a native element. The browser supplies the button semantics, the expanded state and the keyboard handling.
accordionTriggerClass
To open or close an item from script, set its open property. See the details element on MDN for more information.