Collapsible

1.0.0

An interactive panel that expands and collapses additional content on demand.

Component data

ID
collapsible
Category
atoms
Version
1.0.0
Added
2026-09-17
Type
component
Keyboard nav
Yes
Reduced motion
Yes
collapsibledisclosureexpandcollapseatom

Dependencies

  • @base-ui/react

Registry

  • button
  • card
  • input

Examples

Default

<Collapsible className="flex w-[350px] flex-col gap-2">
      <div className="flex items-center justify-between gap-4 px-4">
        <h4 className="text-sm font-semibold">
          {collapsibleMocks.default.title}
        </h4>
        <CollapsibleTrigger
          render={
            <Button className="size-8 p-0" size="sm" variant="ghost">
              <ChevronsUpDownIcon />
              <span className="sr-only">
                {collapsibleMocks.default.toggleLabel}
              </span>
            </Button>
          }
        />
      </div>
      <div className="flex items-center justify-between rounded-md border border-border px-4 py-2 text-sm">
        <span className="text-muted-foreground">
          {collapsibleMocks.default.statusLabel}
        </span>
        <span className="font-medium">{collapsibleMocks.default.status}</span>
      </div>
      <CollapsibleContent className="flex flex-col gap-2">
        <div className="rounded-md border border-border px-4 py-2 text-sm">
          <p className="font-medium">
            {collapsibleMocks.default.shippingTitle}
          </p>
          <p className="text-muted-foreground">
            {collapsibleMocks.default.shippingAddress}
          </p>
        </div>
        <div className="rounded-md border border-border px-4 py-2 text-sm">
          <p className="font-medium">{collapsibleMocks.default.itemsTitle}</p>
          <p className="text-muted-foreground">
            {collapsibleMocks.default.items}
          </p>
        </div>
      </CollapsibleContent>
    </Collapsible>

Variants

<div className="flex w-full max-w-sm flex-col gap-8">
      <Card className="mx-auto w-full max-w-sm">
        <CardContent>
          <Collapsible className="rounded-md data-open:bg-muted">
            <CollapsibleTrigger
              render={
                <Button className="group/button w-full" variant="ghost">
                  {collapsibleMocks.basic.trigger}
                  <ChevronDownIcon className="ml-auto group-data-panel-open/button:rotate-180" />
                </Button>
              }
            />
            <CollapsibleContent className="flex flex-col items-start gap-2 p-2.5 pt-0 text-sm">
              <div>{collapsibleMocks.basic.content}</div>
              <Button size="sm">{collapsibleMocks.basic.action}</Button>
            </CollapsibleContent>
          </Collapsible>
        </CardContent>
      </Card>
      <SettingsPanel />
    </div>

Related