Resizable
Accessible resizable panel groups and layouts with keyboard support.
About
The Resizable component is built on top of react-resizable-panels by bvaughn.
Installation
bunx --bun shadcn@latest add @sui/resizableInstall with the shadcn CLI or use the shared @workspace/ui package. Follow the installation guide to configure the registry, load styles, and choose import aliases.
Usage
import {
ResizableHandle,
ResizablePanel,
ResizablePanelGroup,
} from "@workspace/ui/components/resizable"<ResizablePanelGroup orientation="horizontal">
<ResizablePanel>One</ResizablePanel>
<ResizableHandle />
<ResizablePanel>Two</ResizablePanel>
</ResizablePanelGroup>Composition
Use the following composition to build a ResizablePanelGroup:
ResizablePanelGroup
├── ResizablePanel
├── ResizableHandle
└── ResizablePanelVertical
Use orientation="vertical" for vertical resizing.
Handle
Use the withHandle prop on ResizableHandle to show a visible handle.
RTL
To enable RTL support in shadcn/ui, see the RTL configuration guide.
API Reference
See the react-resizable-panels documentation.
Changelog
2025-02-02 react-resizable-panels v4
Updated to react-resizable-panels v4. See the v4.0.0 release notes for full details.
If you're using react-resizable-panels primitives directly, note the following changes:
| v3 | v4 |
|---|---|
PanelGroup | Group |
PanelResizeHandle | Separator |
direction prop | orientation prop |
defaultSize={50} | defaultSize="50%" |
onLayout | onLayoutChange |
ImperativePanelHandle | PanelImperativeHandle |
ref prop on Panel | panelRef prop |
data-panel-group-direction | aria-orientation |
The shadcn/ui wrapper components (ResizablePanelGroup, ResizablePanel,
ResizableHandle) remain unchanged.