NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
npm, #1327 most downloaded on npm
<img src="https://react-resizable-panels.vercel.app/og.png" alt="react-resizable-panels logo" width="400" height="210" />
Latest stable
4.24.1
Last release 4 days ago
18 Nov 2026
Ships fairly regularly
a new release about every 2 weeks
Nearly every release is documented
notes for 60 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
4 years old
237 releases · first in 2022
Drag across the ruler to compare, or tap a release to open it.
Fix a Separator behind an open popover (e.g. <div popover> ) being draggable, including popovers rendered inside of the Group . - #845
Separator behind an open popover (e.g. <div popover>) being draggable, including popovers rendered inside of the Group. - #845Separator behind an open popover (e.g. <div popover>) being draggable, including popovers rendered inside of the Group. - #845Moving a tab no longer reloads its iframes, pauses its media, or blurs its focused elements, in browsers that support moveBefore (see caniuse ). - #81
Workspace:
moveBefore (see caniuse). - #818"collapse"), like the tool windows of an IDE, unless the workspace is disabled; previously it did nothing. Clicking the selected tab of a floating tabset that's partly covered by another only brings it to the front. - #814disabled workspace, clicking a tab (or the empty space in the header) of a collapsed tabset no longer expands it (clicking a tab only selects it). - #814index, so disableDrop={({ target }) => "edge" in target} doesn't reject them. - #814Your coding agent can read these notes before it upgrades. Set up the MCP server →
Add the onBeforeModelChange prop, which can block changes the user makes (e.g. closing a tab with unsaved changes). - #819 , #836
Workspace:
onBeforeModelChange prop, which can block changes the user makes (e.g. closing a tab with unsaved changes). - #819, #836resizeSplit method, which sets the sizes of a split's children by id (e.g. to apply a saved preset). - #810, #836dragSourceInfo prop, which tells the workspace a tab is dragged into where it came from (passed to its disableDrop and onModelChanged). - #815, #836target and size options to the addTab method (and region and size to ParentTabset.addTab), e.g. to add a tab in a new tabset below another one. - #811classNames and styles props can have functions of the tabset, tab, or split being styled (and its state), e.g. to style tabsets by their data. - #812lazyTabContent prop, which doesn't mount a tab's content until the tab is first shown. - #817hiddenTabBehavior now applies to tabs that aren't visible, not just to tabs that aren't selected: the selected tabs of collapsed tabsets (and of tabsets covered by a maximized tabset) are unmounted ("unmount") or hidden ("activity") too. - #817Form controls ( input , select , and textarea elements, the labels of form controls, editable content, and elements with a form control role such as r
input, select, and textarea elements, the labels of form controls, editable content, and elements with a form control role such as role="checkbox") within a Workspace tab no longer select the tab or start dragging it when pressed, like buttons within a tab (e.g. so a tab can show an input to rename it). Use the data-tab-ignore attribute to opt other elements out. - #822groupResizeBehavior: "preserve-pixel-size" panels and Grid tracks resizing (e.g. a collapsed panel expanding) when their constraints or groupResizeBehavior change after the group has been resized. - #832groupResizeBehavior: "preserve-pixel-size" panels and Grid tracks collapsed (with the keyboard or the imperative collapse() method) expanding to the wrong size (rather than their pre-collapse pixel size) if the group was resized while they were collapsed. - #832Workspace tab (e.g. an input to rename it) no longer select or drag the tab when pressed, like buttons. Opt other elements out with data-tab-ignore. - #822groupResizeBehavior: "preserve-pixel-size" panels and Grid tracks resizing when their constraints (or groupResizeBehavior) change after the group was resized. - #832groupResizeBehavior: "preserve-pixel-size" panels and Grid tracks expanding to the wrong size if the group was resized while they were collapsed. - #832Deprecate the Workspace onTearOff prop (and TearOffArgs and the drag preview's isTearOff ): browsers don't reliably report where a drag outside of the…
Workspace startExternalDrag method, which drags a new tab in from outside of the workspace (e.g. from a palette of widgets). - #808Workspace acceptExternalDrop prop, which creates tabs from the browser's drag and drop (e.g. draggable elements or files). - #808useTabListOverflow hook, which returns the ids of a tabset's tabs that are scrolled out of view (e.g. for an overflow menu), and the getTabListOverflow and subscribeToTabListOverflow methods. - #816Workspace tab is scrolled into view if its tab list overflows, and useParentTabset has a new selectTab method. - #816usePopoutWindows hook, which opens Workspace tabs in popup windows (e.g. from a "pop out" button), copying the page's styles, and docks them back when the windows are closed. - #821Workspace onTearOff prop (and TearOffArgs and the drag preview's isTearOff): browsers don't reliably report where a drag outside of the window ends, and some block popups opened then. Open popout windows from a button instead; it will be removed in the next major version. - #826Workspace copyTab and copyTabset props: tabs (and tabsets) dropped while Option (macOS) or Ctrl is held are copied rather than moved, and reported with the new "copy" reason. - #809Workspace:
startExternalDrag method, which drags a new tab in from outside of the workspace (e.g. from a palette of widgets). - #808acceptExternalDrop prop, which creates tabs from the browser's drag and drop (e.g. draggable elements or files). - #808useTabListOverflow hook, which returns the ids of a tabset's tabs that are scrolled out of view (e.g. for an overflow menu), and the getTabListOverflow and subscribeToTabListOverflow methods. - #816useParentTabset has a new selectTab method. - #816usePopoutWindows hook, which opens tabs in popup windows (e.g. from a "pop out" button), copying the page's styles, and docks them back when the windows are closed. - #821onTearOff prop (and TearOffArgs and the drag preview's isTearOff), since browsers don't reliably report where a drag outside of the window ends. Open popout windows from a button instead. - #826copyTab and copyTabset props: tabs (and tabsets) dropped while Option (macOS) or Ctrl is held are copied rather than moved, and reported with the new "copy" reason. - #809Add TabsetCollapseButton and TabsetMaximizeButton components, which collapse (or expand) and maximize (or restore) the tabset they're rendered within,
TabsetCollapseButton and TabsetMaximizeButton components, which collapse (or expand) and maximize (or restore) the tabset they're rendered within, with aria-expanded/aria-controls and aria-pressed. They render nothing when the action isn't available (e.g. maximizing the only tabset). - #805children, className, style, and title props of TabCloseButton, TabsetDragHandle, and the new buttons can be functions of the component's state, e.g. {({ isCollapsed }) => (isCollapsed ? "▸" : "▾")}. - #805groupResizeBehavior: "preserve-pixel-size" panels drifting by a fraction of a pixel when panels have fractional sizes (e.g. at 150% display scaling): a Group's size was measured as the sum of its panels' rounded sizes, which could be off by a pixel and looked like the Group being resized. - #804TabsetCollapseButton and TabsetMaximizeButton components, which collapse and maximize the tabset they're rendered within. - #805children, className, style, and title props of TabCloseButton, TabsetDragHandle, and the new buttons can be functions of the component's state. - #805groupResizeBehavior: "preserve-pixel-size" panels drifting by a fraction of a pixel at fractional display scaling (e.g. 150%). - #804Add floating tabsets to Workspace : tabsets that float above the layout, listed in the model's new floating field. Users move them by their headers, r
Workspace: tabsets that float above the layout, listed in the model's new floating field. Users move them by their headers, resize them by their edges, and drag tabs into and out of them. The new floatTab and floatTabset methods create them, collapseTabset collapses them to their headers, and moveTabset docks them. - #799Workspace tabs (and tabsets) can be dropped at the edges of the workspace, beside all of the other tabsets (e.g. as a sidebar or bottom panel). These targets are on by default; turn them off with disableDrop={({ target }) => "edge" in target}. - #800Warning
TabDropTarget has a new { edge } variant without a tabsetId, so check for it (e.g. with "tabsetId" in target) before reading target.tabsetId.
Workspace tabsets (the model's new floating field), which users can move, resize, and drag tabs into and out of. The new floatTab and floatTabset methods create them, and moveTabset docks them. - #799Workspace tabs (and tabsets) can be dropped at the edges of the workspace, beside all of the other tabsets (e.g. as a sidebar or bottom panel). These targets are on by default; turn them off with disableDrop={({ target }) => "edge" in target}. - #800[!WARNING]
TabDropTargethas a new{ edge }variant without atabsetId, so check for it (e.g. with"tabsetId" in target) before readingtarget.tabsetId.
Improve resizing and dragging performance, e.g. Panel s without an onResize prop are no longer observed, and dragging a Workspace tab only re-renders
Panels without an onResize prop are no longer observed, and dragging a Workspace tab only re-renders what changes.dragGroup, disableDrop is now called when the drop target changes, rather than on every dragover event.Panels without an onResize prop are no longer observed, and dragging a Workspace tab only re-renders what changes. - #798dragGroup, disableDrop is now called when the drop target changes, rather than on every dragover event. - #798[!WARNING] The library now reads
process.env.NODE_ENV(like React does), so it must be loaded with a bundler (or a CDN like esm.sh) that defines it.
Add the onTearOff prop to Workspace , which is called when a tab (or a whole tabset) is dropped outside of the window, e.g. to open it in a popup wind
onTearOff prop to Workspace, which is called when a tab (or a whole tabset) is dropped outside of the window, e.g. to open it in a popup window. It's passed the tab (or tabset), a model containing just that tab (in a new tabset) or tabset, where the pointer was released (in screen coordinates), and the size of the tabset it was dragged from. Returning true removes the tab (or tabset) from the workspace, reported to onModelChanged with the new "tear-off" reason. Tabsets with the keepWhenEmpty flag can't be torn off. The renderDragPreview and renderTabsetDragPreview props are passed an isTearOff flag (and the preview has a data-tear-off attribute) while releasing the pointer would tear off the tab. See the new "Multiple windows" guides. - #794dragGroup prop to Workspace, which lets tabs (and tabsets) be dragged between workspaces with the same group, including workspaces in other windows (e.g. popup windows opened by the application and rendered into with a portal). A tab dropped into another workspace keeps its id and data, and both workspaces report the change to onModelChanged with the new "transfer" reason. Tab ids must be unique within the group (a tab can't be dropped into a workspace that has a tab with its id), and tabsets with the keepWhenEmpty flag stay in their own workspaces. A workspace's only tabset can be dragged when this prop is set (e.g. from a popout window back into the main window). Mouse drags use the browser's drag and drop when this prop is set (touch drags still use pointer events). Tabs can still be torn off, though some browsers (e.g. Safari) block popup windows opened at the end of these drags. - #794
dragGroup in other copies of the application from the same origin (e.g. the application loaded in another browser window or tab) are part of the group too, so tabs can be dragged between them. A tab dropped into another copy of the application is sent there with the structured clone algorithm, so its data must be cloneable; tabs whose data can't be cloned can only be dragged within their copy. The new disableDragBetweenApps prop keeps a workspace's drags within its copy of the application.disableDrop is passed a new source argument: "local" for tabs dragged within the workspace, and "external" for tabs dragged from another workspace in the group (including workspaces in other copies of the application).Workspace drop indicator for an empty workspace (e.g. a popout window whose tabs were all dragged out). A tab or tabset dropped onto it now fills its tabset, keeping that tabset's id and data, instead of showing a half-size edge indicator. - #796Workspace drop indicator can now be animated between tabsets, not just between the regions of one tabset. It's the same element for the whole drag (positioned within the workspace's root element, rather than rendered within each tabset's panels), so a transition like transition: inset 250ms slides it from one tabset to the next. While a dragged tab isn't over any tabset's panels (e.g. between tabsets, or over a tab list), it stays where it was with no data-region attribute and opacity: 0, so it can also be faded (e.g. transition: inset 250ms, opacity 150ms). - #793Warning
The drop indicator (data-drop-indicator) is no longer a child of a tabset's panels (data-tab-panels); selectors like [data-tab-panels] > [data-drop-indicator] should be changed to [data-drop-indicator].
Workspace onTearOff prop, called when a tab (or tabset) is dropped outside of the window (e.g. to open it in a popup). Returning true removes it, reported with the new "tear-off" reason. - #794Workspace dragGroup prop, which lets tabs be dragged between workspaces (including in popup windows and other copies of the app), reported with the new "transfer" reason. disableDrop is passed a new source argument. - #794Workspace. - #796Workspace drop indicator is now a single element for the whole drag, so it can be animated between tabsets (e.g. transition: inset 250ms). - #793[!WARNING] The drop indicator (
data-drop-indicator) is no longer a child of a tabset's panels, so selectors like[data-tab-panels] > [data-drop-indicator]should be changed to[data-drop-indicator].
Fix the free space in a Workspace tabset's tab list (returned by useTabListFreeSpace and getTabListFreeSpace , reported to subscribeToTabListFreeSpace
Workspace tabset's tab list (returned by useTabListFreeSpace and getTabListFreeSpace, reported to subscribeToTabListFreeSpace listeners, and set as the --tab-list-free-space custom property) not changing once the tab list is squeezed to 0px, e.g. beside a toolbar that doesn't shrink. It now keeps going down as the header's content overflows the header, and is updated when the header or its toolbar changes size.Workspace interactions in right-to-left layouts (e.g. within dir="rtl"): dragging a tab within its tab list inserts it where it's dropped, arrow keys move focus to the tab on that side (ArrowLeft moves to the next tab), and dropping a tab or tabset onto the left or right edge of a tabset puts it on that side of the screen. The left and right regions passed to moveTab and moveTabset are sides of the screen too. A tab list's data-overflow-start and data-overflow-end attributes are also set correctly while it's scrolled. - #791Add the normalizeWorkspaceModel function, which checks and tidies a model the same way the defaultModel prop does (e.g. removing empty tabsets and fix
normalizeWorkspaceModel function, which checks and tidies a model the same way the defaultModel prop does (e.g. removing empty tabsets and fixing selections), and returns null if the value isn't a model (e.g. corrupt saved data). Its mapTab option replaces each saved tab with the app's current version (or removes it, by returning null), so layouts saved by older versions of an app can be restored.useTabListFreeSpace hook and getTabListFreeSpace imperative method, reported to listeners added with the new subscribeToTabListFreeSpace method (e.g. from a toolbar rendered outside of the Workspace), and set as the tab list's --tab-list-free-space custom property. All of them are updated before the browser paints.Workspace tabsets being shown at their collapsed sizes with their content still rendered (and reported as expanded by useParentTabsetState) when the model's sizes don't fit the tabsets' minimum sizes, e.g. a model saved in a wider window, a workspace that's made narrower, or expandTabset shrinking a sibling below its minimum. Tabsets are now shown within their minimum and maximum sizes (rather than collapsed, when there's room), and tabsets that still have to be collapsed to fit are shown (and reported) as collapsed; the new isCollapsedToFit value (returned by useParentTabsetState) tells them apart from tabsets collapsed in the model (e.g. to hide an "expand" button, since they can't be expanded until they fit). The model isn't changed, so the tabsets are shown as the model has them again once they fit.maxWidth and maxHeight to Workspace tabsets (and updateTabset), which limit how large a tabset's content area can be resized (e.g. a sidebar that can only grow so wide). Like minimum sizes, they must use absolute units. A maximum only applies if something else can take up the rest of its split (e.g. another tabset without a maximum); otherwise it's ignored, with a warning in development.Workspace tabset drag preview now shows the number of other tabs being dragged after the selected tab's title (e.g. "One (+2)"). Tabsets with one tab, and workspaces with a renderDragPreview or renderTabsetDragPreview prop, show the same preview as before. - #789normalizeWorkspaceModel, which checks and tidies a saved model (returning null if it isn't valid); its mapTab option updates saved tabs. - #790Workspace tab list (e.g. for an overflow menu): the useTabListFreeSpace hook, the getTabListFreeSpace and subscribeToTabListFreeSpace methods, and the --tab-list-free-space custom property. - #790maxWidth and maxHeight to Workspace tabsets. - #790Workspace tabsets that don't fit their minimum sizes being shown collapsed with their content rendered; they're now collapsed to fit (see useParentTabsetState().isCollapsedToFit) without changing the model. - #790Add dragging whole tabsets within a Workspace. A tabset is dragged by the empty space in its header, or by a TabsetDragHandle (or any element with a d
Workspace. A tabset is dragged by the empty space in its header, or by a TabsetDragHandle (or any element with a data-tabset-drag-handle attribute) when it has one. Dropping a tabset onto the edge of another tabset moves it there; dropping it onto another tabset's center or tab list moves its tabs into that tabset. Tabsets with the keepWhenEmpty flag can only be moved, not merged. Tabsets can't be dragged when they have the new disableDrag flag or contain a tab that does. - #785
moveTabset imperative method, renderTabsetDragPreview prop, and isDragDisabled value (returned by useParentTabsetState) support tabset dragging. A tabset being dragged has a data-tabset-dragging attribute, and the drag preview has a data-drag-type attribute ("tab" or "tabset").disableDrop is called for each tab in a dragged tabset, with the target each tab would be dropped at, so existing restrictions apply to tabset drags too. The new tabset argument is set while a whole tabset is dragged.Workspace. A tabset with the new collapsible flag can be collapsed to just its header (e.g. a bottom panel, or a sidebar that collapses to a vertical strip of tabs), by dragging a separator past its minimum size (like a collapsible Panel) or with the new collapseTabset and expandTabset methods; clicking a tab in a collapsed tabset expands it. Whether a tabset is collapsed is saved in the model (collapsed), and its size is the size it expands to. - #787
useParentTabset returns collapse, expand, and isCollapsed functions, and useParentTabsetState returns isCollapsed and isCollapsible values (e.g. for a collapse button in a tabset's toolbar). Elements within a collapsed tabset have a data-tabset-collapsed attribute.onModelChanged reports the new "collapse" and "expand" reasons.Workspace tabRemovalSelectionBehavior prop, which chooses the tab that's selected when the selected tab is closed (or dragged to another tabset): the tab after it ("adjacent", the default), or the tabset's most recently selected tab ("recent", like an IDE's editor groups). In "recent" mode, each tabset's recently selected tabs are saved in the model (TabsetNode.recentTabIds). - #786[!WARNING] The
tabargument passed todisableDropmay now beundefined, when a tabset without tabs (one with thekeepWhenEmptyflag) is dragged. Functions that readtab(e.g.tab.data) should check for this first.
Workspace, by the empty space in their headers or by a TabsetDragHandle. Also adds the moveTabset method, the renderTabsetDragPreview prop, and a disableDrag flag for tabsets. - #785Workspace tabsets (the collapsible flag), collapsed by dragging a separator or with the collapseTabset and expandTabset methods. - #787Workspace tabRemovalSelectionBehavior prop, which selects the adjacent tab (default) or the most recently selected one ("recent") when the selected tab is removed. - #786[!WARNING] The
tabargument passed todisableDropmay now beundefined(when an empty tabset with thekeepWhenEmptyflag is dragged).
Add a split entry to the Workspace classNames and styles props, for each split's Group (which now also has data-split and data-split-id attributes). I
split entry to the Workspace classNames and styles props, for each split's Group (which now also has data-split and data-split-id attributes). Its CSS gap adds space between tabsets, and counts toward their minimum sizes like separators do. - #783Workspace separator ending after moving a few pixels (most often when resizing tabsets stacked vertically, or tabsets with tabs on the left or right). The size of each tabset's header, which counts toward its minimum size, could change by a pixel as the tabset was resized, because it was measured as the difference of two rounded sizes; that re-registered the tabset's panel, which interrupted the drag. It is now measured from exact sizes. - #782Workspace tabsets and splits rendering their model node ids as element ids, which could match other elements on the page (e.g. a tabset with the id "root" matched an application's <div id="root">, and its styles) or the elements of another workspace with the same model. Their elements' ids are now unique within the page. - #784Workspace without separators, both resizing the tabset and dragging the tab. Resizing takes priority, as it does for other elements at the edges of panels. - #784split entry to the Workspace classNames and styles props; its CSS gap adds space between tabsets. - #783Workspace separator ending after a few pixels. - #782Workspace tabset and split element ids colliding with other elements on the page. - #784Workspace without separators) both resizing the tabset and dragging the tab. - #784Add Workspace component, for layouts of tabsets that users can rearrange by dragging tabs: between tabsets, within a tabset's list of tabs, or onto th
Workspace component, for layouts of tabsets that users can rearrange by dragging tabs: between tabsets, within a tabset's list of tabs, or onto the edge of a tabset to split it. Tabsets can also be resized and maximized. The layout is described by a serializable model, and tab content is not remounted when a tab is moved. - #780
renderTab, renderTabsetToolbar, and renderEmptyTabset props (and the TabCloseButton component), and styled with the classNames and styles props.Group); the useWorkspaceRef and useWorkspaceCallbackRef hooks return its imperative API.useParentWorkspace, useParentTabset, useParentTabsetState, useParentTab, and useParentTabState hooks.<Activity> (hiddenTabBehavior), and selected tabs' content can opt into server rendering (serverRenderTabContent).zoom or a scale transform (e.g. twice as far within zoom: 2). Pointer movements are now converted from screen pixels to layout pixels before resizing. - #780Group rendered into another window (e.g. a popup). The iframe check no longer uses instanceof HTMLIFrameElement, which is false for iframes from another window. - #778resizePreviewMode="separator") missing the separator's styles when its element was created by another window's document (e.g. by a popup's opener). - #781Workspace component, for layouts of tabsets that users can rearrange by dragging tabs. The layout is described by a serializable model, and tab content isn't remounted when a tab is moved. - #780zoom or scale transforms. - #780resizePreviewMode="separator" preview missing the separator's styles in popup windows. - #781Fix unused components not being removed by some bundlers (e.g. esbuild), so an application that only imports Group no longer includes Grid. Components
Group no longer includes Grid. Components now set their displayName within a pure-annotated expression, and package.json declares "sideEffects": false. - #779Grid) not being removed by some bundlers (e.g. esbuild). - #779Fix vh, vw, and em panel sizes (e.g. defaultSize="25vw") being resolved against the global window instead of the panel's own window, so a Group render
vh, vw, and em panel sizes (e.g. defaultSize="25vw") being resolved against the global window instead of the panel's own window, so a Group rendered into another window (e.g. a window.open popout via a portal, or an iframe) was sized against the opener's viewport. - #777vh, vw, and em panel sizes being resolved against the global window rather than the panel's own window (e.g. a popup or iframe). - #777Declare @types/react as an optional peer dependency. Under strict package linkers (e.g. pnpm with a global virtual store, Yarn PnP, or Bun isolated in
@types/react as an optional peer dependency. Under strict package linkers (e.g. pnpm with a global virtual store, Yarn PnP, or Bun isolated installs), TypeScript could fail to resolve it from this package, silently typing props built on React types as any. - #776@types/react as an optional peer dependency, so that strict package linkers (e.g. pnpm, Yarn PnP) can resolve it. - #776Add useParentGroup, useParentPanel, and useParentGrid hooks. Components rendered within a Group, Panel, or Grid can use them to access the nearest one
useParentGroup, useParentPanel, and useParentGrid hooks. Components rendered within a Group, Panel, or Grid can use them to access the nearest one (including its imperative API) without passing refs down; they return null outside of a matching component. Within a Cell, useParentGroup returns the nearest Group outside of the Grid. - #775Panel and GridTrack resize(), collapse(), and expand() calls (and double-clicking a separator to reset a panel's size) now take space from, or give it to, the nearest panels that can absorb it, on either side of the panel being resized. Previously only the panels on one side were used, starting with the adjacent panel, so these calls could silently do nothing (e.g. when the next panel was collapsed) or unexpectedly collapse or expand other panels. Changes that don't collapse or expand other panels are now preferred. - #774expand() still restores a panel's most recent size, but if that would require collapsing another panel, it now expands to the largest size that fits instead (as long as that's at least its minSize). - #774Separator "clicking" the element under the pointer (e.g. a button in a panel header). - #774useParentGroup, useParentPanel, and useParentGrid hooks, which return the nearest Group, Panel, or Grid (including its imperative API). - #775Panel and GridTrack resize(), collapse(), and expand() calls (and double-clicking a separator) now take space from the nearest panels that can absorb it on either side, rather than only the adjacent panel, so they no longer silently do nothing or collapse other panels. - #774expand() expands to the largest size that fits (if at least minSize) when restoring the panel's most recent size would collapse another panel. - #774Separator clicking the element under it. - #774Fix "Stacking order can only be calculated for elements with a common ancestor" error thrown by the document pointermove handler when the event target
pointermove handler when the event target is removed from the DOM during dispatch. Detached targets are now treated as viable hit targets. - #771Group and Grid setLayout() and Panel resize(), collapse(), and expand() validating against pixel-based constraints for the previous group size when called before the group's ResizeObserver ran (e.g. from an application's own ResizeObserver). - #770pointermove event's target is removed from the DOM. - #771setLayout(), resize(), collapse(), and expand() using the previous group size's pixel constraints when called before the group's ResizeObserver ran. - #770Improve mount performance for groups with many panels by skipping redundant constraint recalculations and subscriber notifications when a Panel's disa
Panel's disabled prop has not changed. - #768Fix F6 and Shift+F6 keyboard navigation trying to focus disabled separators. Disabled separators are now skipped. - #767
F6 and Shift+F6 keyboard navigation trying to focus disabled separators. Disabled separators are now skipped. - #767Group, Panel, Separator, Grid, and Cell only render an explicit id (or data-testid) as data-testid - #766
Fix pointer events in one document affecting groups mounted in another (e.g. a popup window). The resize cursor is now only shown in the document that
onLayoutChange, onLayoutChanged, or onResize callback leaving a drag stuck in the active state or preventing other groups from being updated. The error is now re-thrown once all groups have been updated. - #763761 Bugfix: A drag interrupted by pointercancel, lostpointercapture, or the window losing focus (e.g. Alt/Cmd+Tab) now ends and commits the current la
pointercancel, lostpointercapture, or the window losing focus (e.g. Alt/Cmd+Tab) now ends and commits the current layout, rather than staying active until the next pointer event"pointercancel", "lostpointercapture", or the window losing focus (e.g. Alt/Cmd+Tab) staying active until the next pointer event. The drag now ends and commits the current layout. - #761759: Bugfix: Resort panels and separators before (re)deriving constraints
720: Bugfix: Constraints applied because of a Group size change (e.g. a pixel-based minSize when the window is small) no longer permanently alter the
Group size change (e.g. a pixel-based minSize when the window is small) no longer permanently alter the layout; the requested layout is restored once the constraint no longer applies
onLayoutChanged meta includes a new requestedLayout attribute; useDefaultLayout and useDefaultGridLayout persist this value instead of the constrained layoutGroup size change (e.g. a pixel-based minSize when the window is small) permanently altering the layout. The requested layout is now restored once the constraint no longer applies. - #720
requestedLayout attribute to the onLayoutChanged meta. useDefaultLayout and useDefaultGridLayout persist this value instead of the constrained layout.New Grid, Cell, and Gridline components for resizable two-dimensional layouts:
Grid, Cell, and Gridline components for resizable two-dimensional layouts:
Panels (e.g. min/max size, collapsible)Gridlines (optional, like Separators) can span a subset of tracks to avoid spanning cellsuseDefaultGridLayout, useGridRef, and useGridCallbackRef hooksGrid, Cell, and Gridline components for resizable two-dimensional layouts: - #756
Panels (e.g. min/max size, collapsible).Gridlines (optional, like Separators) can span a subset of tracks to avoid spanning cells.useDefaultGridLayout, useGridRef, and useGridCallbackRef hooks. - #756755: Bugfix: Separator behind a modal can no longer be dragged
Separator behind a modal <dialog> can no longer be dragged751: Separator no longer retains focus after a drag
Match layout values to panel IDs so reordered keys map to the correct constraints
"Matching panels not found" error by preserving keyboard mappings for disabled separators.onLayoutChanged not firing when pressing elsewhere on the page or resizing another group.746: Customizable resize preview mode
743: Don't capture pointer for a detached Separator
730: Guard CSSStyleSheet construction to avoid throwing in unsupported environments (@leo-yang-qiong)
CSSStyleSheet construction to avoid throwing in unsupported environments. - (leo-yang-qiong - #730)Panel constraints. - #736"pointerup" edge case. - (waterWang - #732)Update inline documentation to clarify size units. - #726
723: Bug fix for context menu event (right click) occurring while pointer-resize is active
716): Meta info available to onLayoutChanged callback signalling whether resize event was triggered by direct user input (keyboard or mouse)
onLayoutChanged callback signalling whether resize event was triggered by direct user input (keyboard or mouse)useDefaultLayout hook supports onlySaveAfterUserInteractions option to only save layouts when directly triggered by user interactions.Fix rem-based sizes to be calculated relative to the owner document (not body). - #719
Fix an edge case SSR bug for panels with defaultSize={0}. - #715
defaultSize={0}. - #715Support the :focus-visible pseudo-class for Separator. - #712
Add data-separator="focus" state for Separator elements for more consistent custom CSS styles. - #705
data-separator="focus" state for Separator elements for more consistent custom CSS styles. - #705702: Add disableDoubleClick prop to Separator to enable turning _off_ the double-click size reset behavior.
disableDoubleClick prop to Separator to enable turning off the double-click size reset behavior.699: useDefaultLayout hook automatically migrates legacy layouts to version 4 format; see issue 605 or PR 699 for details on how this works.
698: Replace Panel aria-disabled attribute with data-disabled
Panel aria-disabled attribute with data-disabled696: Improved server rendering support for defaultSize prop
defaultSize prop689: Fix edge case bug with pointer event capture
690: Imperative Panel API supports non-percentage sizes
683: Don't scroll separator when setting focus
678: Change default overflow styles to support shadows
Nothing published for this version
Nothing published for this version
677: Add groupResizeBehavior prop to Panel, enabling panels to retain their current size (pixels) size when the parent Group is resized.
groupResizeBehavior prop to Panel, enabling panels to retain their current size (pixels) size when the parent Group is resized.groupResizeBehavior prop to Panel, enabling panels to retain their current size (in pixels) when the parent Group is resized. - #677670: Check for undefined adoptedStyleSheets (to better support environments like jsdom)
664, 665: Resize actions sometimes "jump" on touch devices
Fixed a problem with project logo not displaying correctly in the README for the Firefox browser.
660: Group guards against layouts with mis-ordered Panel id keys
Group guards against layouts with mis-ordered Panel id keys658: Imperative Panel and Group APIs ignored disabled status when resizing panels; this is an explicit override of the _disabled_ state and is require
Nothing published for this version
Nothing published for this version
657: Allow Panel and Separator components to be disabled
Panel and Separator components to be disabled649: Optimization: Replace useForceUpdate with useSyncExternalStore to avoid side effect of swallowing "click" events in certain cases
One column per quarter.