Resizable

About

The Resizable component is built on top of react-resizable-panels by bvaughn.

Installation

<CodeTabs> <TabsList> <TabsTrigger value="cli">Command</TabsTrigger> <TabsTrigger value="manual">Manual</TabsTrigger> </TabsList> <TabsContent value="cli">

bash

npx shadcn@latest add resizable

</TabsContent> <TabsContent value="manual"> <Steps className="mb-0 pt-2">

<Step>Install the following dependencies:</Step>

bash

npm install react-resizable-panels

<Step>Copy and paste the following code into your project.</Step>

<Step>Update the import paths to match your project setup.</Step>

</Steps> </TabsContent> </CodeTabs>

Usage

tsx

import {
  ResizableHandle,
  ResizablePanel,
  ResizablePanelGroup,
} from "@/components/ui/resizable"

tsx

<ResizablePanelGroup orientation="horizontal">
  <ResizablePanel>One</ResizablePanel>
  <ResizableHandle />
  <ResizablePanel>Two</ResizablePanel>
</ResizablePanelGroup>

Examples

Vertical

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`

<Callout> The shadcn/ui wrapper components (`ResizablePanelGroup`, `ResizablePanel`, `ResizableHandle`) remain unchanged. </Callout>