Accordion

Accordion

An accordion stacks native <details> items. Give items the same name and only one stays open at a time.

Class names

Class nameTypeDescription
accordionComponentBordered wrapper around the items
accordion-itemPartA `<details>` element with a `<summary>` heading
accordion-contentPartPanel revealed when the item is open

Accordion

Items that share a name are exclusive; opening one closes the others.

What is PoppyUI?
A CSS-first design system with semantic class names.
Does it need JavaScript?
No. Behavior comes from the platform.
Can I use it with a framework?
Yes. It is plain HTML and CSS.
<div class="accordion">
  <details class="accordion-item" name="accordion-ex1" open>
    <summary>What is PoppyUI?</summary>
    <div class="accordion-content">A CSS-first design system with semantic class names.</div>
  </details>
  <details class="accordion-item" name="accordion-ex1">
    <summary>Does it need JavaScript?</summary>
    <div class="accordion-content">No. Behavior comes from the platform.</div>
  </details>
  <details class="accordion-item" name="accordion-ex1">
    <summary>Can I use it with a framework?</summary>
    <div class="accordion-content">Yes. It is plain HTML and CSS.</div>
  </details>
</div>

Independent items

Omit name and each item opens and closes on its own.

Shipping
Orders ship within two business days.
Returns
Return anything within 30 days.
<div class="accordion">
  <details class="accordion-item" open>
    <summary>Shipping</summary>
    <div class="accordion-content">Orders ship within two business days.</div>
  </details>
  <details class="accordion-item" open>
    <summary>Returns</summary>
    <div class="accordion-content">Return anything within 30 days.</div>
  </details>
</div>

All closed

Leave off open to start collapsed.

First
First panel.
Second
Second panel.
<div class="accordion">
  <details class="accordion-item" name="accordion-ex3">
    <summary>First</summary>
    <div class="accordion-content">First panel.</div>
  </details>
  <details class="accordion-item" name="accordion-ex3">
    <summary>Second</summary>
    <div class="accordion-content">Second panel.</div>
  </details>
</div>

FAQ

How do I install it?

Install the package, then import the stylesheet once.

pnpm add @poppyui/core

How do I change the theme?
Set data-theme on any ancestor element.
<div class="accordion">
  <details class="accordion-item" name="accordion-ex4" open>
    <summary>How do I install it?</summary>
    <div class="accordion-content">
      <p>Install the package, then import the stylesheet once.</p>
      <p><code>pnpm add @poppyui/core</code></p>
    </div>
  </details>
  <details class="accordion-item" name="accordion-ex4">
    <summary>How do I change the theme?</summary>
    <div class="accordion-content">Set <code>data-theme</code> on any ancestor element.</div>
  </details>
</div>