Collapsible

Usage

import { Collapsible } from "@devvy-ui/react";

<Collapsible summary="Advanced settings"><p>Adjust these options for your workspace.</p></Collapsible>

API reference

Native HTML attributes, className, style and a forwarded ref are supported. Component-specific props:

Prop	Type	Default	Description
summary	ReactNode	required	Visible disclosure trigger text.
open / defaultOpen / onOpenChange	boolean / boolean / callback	— / false / —	Controlled or initial expansion.
disabled	boolean	false	Keep the summary discoverable without activation.

Source ownership

Run npx @devvy-ui/cli init once in your React project, then add the source:

npx @devvy-ui/cli add collapsible

Make the source yours.

Start from the canonical implementation used by the package and registry. Change the code, keep the MIT notice, and build the behavior your project needs.

Collapsible.tsxREACT / TSX

import { forwardRef, useState, type DetailsHTMLAttributes, type ReactNode } from 'react';
import { cx } from '../lib/cx';
export interface CollapsibleProps extends DetailsHTMLAttributes<HTMLDetailsElement> {
  summary: ReactNode;
  defaultOpen?: boolean;
  onOpenChange?: (open: boolean) => void;
  disabled?: boolean;
}
export const Collapsible = forwardRef<HTMLDetailsElement, CollapsibleProps>(function Collapsible(
  {
    summary,
    open,
    defaultOpen = false,
    onOpenChange,
    disabled = false,
    children,
    className,
    ...props
  },
  ref,
) {
  const [local, setLocal] = useState(defaultOpen);
  const expanded = open ?? local;
  return (
    <details {...props} ref={ref} open={expanded} className={cx('dvy-collapsible', className)}>
      <summary
        aria-disabled={disabled || undefined}
        onClick={(event) => {
          event.preventDefault();
          if (disabled) return;
          if (open === undefined) setLocal(!expanded);
          onOpenChange?.(!expanded);
        }}
      >
        {summary}
      </summary>
      <div className="dvy-collapsible-content">{children}</div>
    </details>
  );
});

Edit your own copy. Downloaded source uses your changes; the component preview above uses the shipped version. Run the source installer first to include shared helpers.

Interactive preview

Usage

API reference

Accessibility & behavior

Platform Behavior & Guidelines

Source ownership

Make the source yours.