Dots

Collapsible

PreviousNext

An interactive component which expands/collapses a panel.

Order #4189

StatusShipped
"use client"

import * as React from "react"

Installation

pnpm dlx shadcn@latest add @dots/collapsible

Usage

import {
  Collapsible,
  CollapsibleContent,
  CollapsibleTrigger,
} from "@/components/ui/collapsible"
<Collapsible>
  <CollapsibleTrigger>Can I use this in my project?</CollapsibleTrigger>
  <CollapsibleContent>
    Yes. Free to use for personal and commercial projects. No attribution
    required.
  </CollapsibleContent>
</Collapsible>

Composition

Use the following composition to build a Collapsible:

Collapsible
├── CollapsibleTrigger
└── CollapsibleContent

Controlled State

Use the isExpanded and onExpandedChange props to control the state.

import * as React from "react"
 
export function Example() {
  const [open, setOpen] = React.useState(false)
 
  return (
    <Collapsible isExpanded={open} onExpandedChange={setOpen}>
      <CollapsibleTrigger>Toggle</CollapsibleTrigger>
      <CollapsibleContent>Content</CollapsibleContent>
    </Collapsible>
  )
}

Basic

import { ChevronDownIcon } from "lucide-react"

import { Button } from "@/components/ui/button"

Settings Panel

Use a trigger button to reveal additional settings.

Radius
Set the corner radius of the element.
"use client"

import * as React from "react"

File Tree

Use nested collapsibles to build a file tree. In a conversation, this is the File Tree pattern.

import { ChevronRightIcon, FileIcon, FolderIcon } from "lucide-react"

import { Button } from "@/components/ui/button"

API Reference

See the React Aria documentation for more information.