Skip to content

shadcn.io is an independent project built on shadcn/ui

Tab-Style Accordion with Plus Trigger for Ark UI

Team questions as separate rounded cards, with a plus on the right that turns into a minus.

Four team questions, each a rounded card with a gap. A plus on the right turns into a minus, and How do I invite teammates? starts open.

Use it when each answer should stand alone. If inviting is the task, put it on a Button instead of inside an answer. In React, Ark UI does not send the invite.

Preview

Preview width

Installation

Sign in to get your install command
Free with an account. It carries your token, so the CLI installs everything in one go.
Use email insteadNo credit card

Anatomy

Accordion anatomy: root, item, item trigger, item content, item indicator

Usage

<Accordion
  className="flex w-full max-w-md flex-col gap-2"
  defaultValue={["invite"]}
>
  {items.map((item) => (
    <AccordionItem
      className="overflow-hidden rounded-lg border bg-background px-4"
      key={item.value}
      value={item.value}
    >
      <AccordionTrigger className="hover:no-underline **:data-[slot=accordion-trigger-icon]:hidden">
        <span className="flex w-full items-center justify-between gap-3">
          <span className="text-start">{item.title}</span>
          <span className="relative size-4 shrink-0">
            <PlusIcon
              aria-hidden="true"
              className="absolute inset-0 size-4 text-muted-foreground transition-opacity duration-200 group-aria-expanded/accordion-trigger:opacity-0"
            />
            <MinusIcon
              aria-hidden="true"
              className="absolute inset-0 size-4 text-muted-foreground opacity-0 transition-opacity duration-200 group-aria-expanded/accordion-trigger:opacity-100"
            />
          </span>
        </span>
      </AccordionTrigger>
      <AccordionContent>
        <p className="text-muted-foreground">{item.content}</p>
      </AccordionContent>
    </AccordionItem>
  ))}
</Accordion>

FAQ

How are the sections separated?

Accordion is flex flex-col gap-2. Each AccordionItem has its own rounded-lg border and px-4.

How does the plus turn into a minus?

**:data-[slot=accordion-trigger-icon]:hidden on AccordionTrigger hides the built-in chevron. PlusIcon and MinusIcon share one relative size-4 box, and group-aria-expanded/accordion-trigger fades the plus out and the minus in over duration-200. Both icons are aria-hidden and text-muted-foreground.

Where does the answer sit?

AccordionContent adds no padding class of its own. The item px-4 insets the paragraph with the title, and justify-between keeps the plus and minus at the end of the trigger.

Why does the invite question start open?

defaultValue={["invite"]} opens the invite question on first render. The string matches that item's value.

How do I let several items stay open at once?

One open item is the default. Add multiple to Accordion to let several stay open, and list every item that should start open in the defaultValue array.

Is keyboard navigation built in?

Yes. Each trigger is a button with aria-expanded and aria-controls, and Enter or Space toggles it. The arrow keys move between triggers, and Home and End jump to the first and last.

API Reference

Accordion

Sets defaultValue={["invite"]} and value={item.value}. The rest is on the Accordion page.