Package Exports

react-resizable-panels
react-resizable-panels/dist/react-resizable-panels.cjs
react-resizable-panels/dist/react-resizable-panels.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (react-resizable-panels) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

react-resizable-panels

React components for resizable panel groups/layouts.

Support

If you like this project there are several ways to support it:

Installation

Begin by installing the library from NPM:

npm install react-resizable-panels

TypeScript types

TypeScript definitions are included within the published dist folder

Documentation

Documentation for this project is available at react-resizable-panels.vercel.app.

Group

Required props

Optional props

Name	Description
children	Panel and Separator components that comprise this group.
className	CSS class name.
defaultLayout	Default layout for the Group. ℹ️ This value allows layouts to be remembered between page reloads. ⚠️ Refer to the documentation for how to avoid layout shift when using server components.
disableCursor	This library sets custom mouse cursor styles to indicate drag state. Use this prop to disable that behavior for Panels and Separators in this group.
disabled	Disable resize functionality.
elementRef	Ref attached to the root `HTMLDivElement`.
groupRef	Exposes the following imperative API: `getLayout(): Layout` `setLayout(layout: Layout): void` ℹ️ The `useGroupRef` and `useGroupCallbackRef` hooks are exported for convenience use in TypeScript projects.
id	Uniquely identifies this group within an application. Falls back to `useId` when not provided. ℹ️ This value will also be assigned to the `data-group` attribute.
onLayoutChange	Called when panel sizes change; receives a map of Panel id to size.
orientation	Specifies the resizable orientation ("horizontal" or "vertical"); defaults to "horizontal"
style	CSS properties. ⚠️ The following styles cannot be overridden: `display`, `flex-direction`, `flex-wrap`, and `overflow`.

Panel

Required props

Optional props

Name	Description
className	CSS class name. ⚠️ Class is applied to nested `HTMLDivElement` to avoid styles that interfere with Flex layout.
collapsedSize	Panel size when collapsed; defaults to 0.
collapsible	This panel can be collapsed. ℹ️ A collapsible panel will collapse when it's size is less than of the specified `minSize`
defaultSize	Default size of Panel within its parent group; default is auto-assigned based on the total number of Panels.
elementRef	Ref attached to the root `HTMLDivElement`.
id	Uniquely identifies this panel within the parent group. Falls back to `useId` when not provided. ℹ️ This prop is used to associate persisted group layouts with the original panel. ℹ️ This value will also be assigned to the `data-panel` attribute.
maxSize	Maximum size of Panel within its parent group; defaults to 100%.
minSize	Minimum size of Panel within its parent group; defaults to 0%.
onResize	Called when panel sizes change; receives a map of Panel id to size.
panelRef	Exposes the following imperative API: `collapse(): void` `expand(): void` `getSize(): number` `isCollapsed(): boolean` `isExpanded(): boolean` `resize(size: number): void` ℹ️ The `usePanelRef` and `usePanelCallbackRef` hooks are exported for convenience use in TypeScript projects.
style	CSS properties. ⚠️ Style is applied to nested `HTMLDivElement` to avoid styles that interfere with Flex layout.

Separator

Required props

Optional props

Name	Description
className	CSS class name. ℹ️ Use the `data-separator` attribute for custom hover and active styles ⚠️ The following properties cannot be overridden: `flex-grow`, `flex-shrink`
elementRef	Ref attached to the root `HTMLDivElement`.
id	Uniquely identifies the separator within the parent group. Falls back to `useId` when not provided. ℹ️ This value will also be assigned to the `data-separator` attribute.
style	CSS properties. ℹ️ Use the `data-separator` attribute for custom hover and active styles ⚠️ The following properties cannot be overridden: `flex-grow`, `flex-shrink`