Skip to content

Conversation

@renovate
Copy link
Contributor

@renovate renovate bot commented Dec 17, 2025

This PR contains the following updates:

Package Change Age Confidence
react-resizable-panels (source) 3.0.64.1.0 age confidence

Release Notes

bvaughn/react-resizable-panels (react-resizable-panels)

v4.1.0

Compare Source

  • 567: useDefaultLayout hook supports saving and restoring multiple Panel layouts
  • 568: Fix race in useGroupRef and usePanelRef hooks

v4.0.16

Compare Source

  • 563: Panel expand() API should restore pre-collapse size
  • 564: Add guard for unexpected defaultView value seemingly returned by some dev environments

v4.0.15

Compare Source

  • 556: Ignore defaultLayout when keys don't match Panel ids

v4.0.14

Compare Source

  • 555: Allow resizable panels to be rendered into a different Window (e.g. popup or frame) by accessing globals through element.ownerDocument.defaultView

v4.0.13

Compare Source

  • useDefaultLayout: Deprecated groupId param in favor of id to avoid confusion; (there is no actual requirement for the Group to have a matching id)

v4.0.12

Compare Source

  • 552: useDefaultLayout now debounces calls to storage.setItem by 150ms
// To opt out of this change
useDefaultLayout({
  debounceSaveMs: 0,
  groupId: "test-group-id",
  storage: localStorage,
})

[!NOTE]
Some may consider this a breaking change, considering the default value is 150ms rather than 0ms. I think in practice this should only impact unit tests which can be easily fixed by overriding the default (as shown above) or by using fake timers.

Changes like this are often judgement calls, but I think on balance it's better to correct my initial oversight of not debouncing this by default.

v4.0.11

Compare Source

  • 8604491: Fix edge case bug with panel constraints not being properly invalidated after resize

v4.0.10

Compare Source

  • #​551: Expand fixed-size element support

v4.0.9

Compare Source

  • #​542: Clicks on higher z-index elements (e.g. modals) should not trigger separators behind them
  • #​547: Don't re-mount Group when defaultLayout or disableCursor props change
  • #​548: Bugfix: Gracefully handle Panel id changes
  • #​549: Improve DevX when Group within hidden DOM subtree; defer layout-change events

v4.0.8

Compare Source

  • #​541: Don't set invalid layouts when Group is hidden or has a width/height of 0
  • 40d4356: Gracefully handle invalid defaultLayout value

v4.0.7

Compare Source

  • f07bf00: Reset pointer-event styles after "pointerup" event

v4.0.6

Compare Source

  • 0796644: Account for Flex gap when calculating pointer-move delta %

v4.0.5

Compare Source

  • #​535: Updated docs to make size and layout formats clearer

v4.0.4

Compare Source

  • #​534: Set focus on Separator on "pointerdown"
  • e08fe42: Improve iOS/Safari resize UX

v4.0.3

Compare Source

  • Fixed TS type for defaultLayout value returned from useDefaultLayout

v4.0.2

Compare Source

  • Export GroupImperativeHandle and PanelImperativeHandle types.

v4.0.1

Compare Source

  • useDefaultLayout: Deprecated groupId param in favor of id to avoid confusion; (there is no actual requirement for the Group to have a matching id)

v4.0.0

Compare Source

Version 4 of react-resizable-panels offers more flexible size constraints– supporting units as pixels, percentages, REMs/EMs, and more. Support for server-rendering (including Server Components) has also been expanded.

Migrating from version 3 to 4

Refer to the docs for a complete list of props and API methods. Below are some examples of migrating from version 3 to 4, but first a couple of potential questions:

Q: Why'd you rename <component> or <prop>?
A: The most likely reason is that I think the new name more closely aligns with web standards like WAI-ARIA and CSS. For example, the PanelResizeHandle component was renamed to Separator to better align with the ARIA "separator" role and the direction prop was renamed to orientation to better align with the ARIA orientation attribute .
Q: Why'd you remove support for <feature>?
A: Probably because it wasn't used widely enough to justify the complexity required to maintain it. If it turns out that I'm mistaken, features can always be (re)added but it's more difficult to remove them.
Q: Were the onCollapse and onExpand event handlers removed?
A: Yes. Use the onResize event handler instead:
onResize={(size) => {
  // Either this
  const isCollapsed = size === collapsedSize;

  // Or this:
  panelRef.isCollapsed();
}}
Basic usage example
// Version 3

import { PanelGroup, Panel, PanelResizeHandle } from "react-resizable-panels";

<PanelGroup direction="horizontal">
  <Panel defaultSize={30} minSize={20}>left</Panel>
  <PanelResizeHandle />
  <Panel defaultSize={30} minSize={20}>right</Panel>
</PanelGroup>

// Version 4

import { Group, Panel, Separator } from "react-resizable-panels";

<Group orientation="horizontal">
  <Panel defaultSize="30%" minSize="20%">left</Panel>
  <Separator />
  <Panel defaultSize="30%" minSize="20%">right</Panel>
</Group>
Persistent layouts using localStorage
// Version 3

import { PanelGroup, Panel, PanelResizeHandle } from "react-resizable-panels";

<PanelGroup autoSaveId="unique-group-id" direction="horizontal">
  <Panel>left</Panel>
  <PanelResizeHandle />
  <Panel>right</Panel>
</PanelGroup>

// Version 4

import { Group, Panel, Separator, useDefaultLayout } from "react-resizable-panels";

const { defaultLayout, onLayoutChange } = useDefaultLayout({
  groupId: "unique-group-id",
  storage: localStorage
});

<Group defaultLayout={defaultLayout} onLayoutChange={onLayoutChange}>
  <Panel>left</Panel>
  <Separator />
  <Panel>right</Panel>
</Group>

[!NOTE]
Refer to the docs for examples of persistent layouts with server rendering and server components.

Conditional panels
// Version 3

import { PanelGroup, Panel, PanelResizeHandle } from "react-resizable-panels";

<PanelGroup autoSaveId="unique-group-id" direction="horizontal">
   {showLeftPanel && (
     <>
       <Panel id="left" order={1}>left</Panel>
       <PanelResizeHandle />
     </>
   )}
   <Panel id="center" order={2}>center</Panel>
   {showRightPanel && (
     <>
       <PanelResizeHandle />
       <Panel id="right" order={3}>right</Panel>
     </>
   )}
</PanelGroup>

// Version 4

import { Group, Panel, Separator } from "react-resizable-panels";

<Group>
  {showLeftPanel && (
    <>
      <Panel id="left">left</Panel>
      <Separator />
    </>
  )}
  <Panel id="center">center</Panel>
  {showRightPanel && (
    <>
      <Separator />
      <Panel id="right">right</Panel>
    </>
  )}
</Group>
Imperative APIs
// Version 3

import { PanelGroup, Panel, PanelResizeHandle } from "react-resizable-panels";
import type { ImperativePanelGroupHandle, ImperativePanelHandle }from "react-resizable-panels";

 const panelRef = useRef<ImperativePanelHandle>(null);
 const panelGroupRef = useRef<ImperativePanelGroupHandle>(null);

<PanelGroup direction="horizontal" ref={panelGroupRef}>
  <Panel ref={panelRef}>left</Panel>
  <PanelResizeHandle />
  <Panel>right</Panel>
</PanelGroup>

// Version 4

import { Group, Panel, Separator, useGroupRef, usePanelRef } from "react-resizable-panels";

const groupRef = useGroupRef();
const panelRef = usePanelRef();

<Group groupRef={groupRef} orientation="horizontal">
  <Panel panelRef={panelRef}>left</Panel>
  <Separator />
  <Panel>right</Panel>
</Group>
Disabling custom cursors
// Version 3

import { disableGlobalCursorStyles } from "react-resizable-panels";

disableGlobalCursorStyles();

// Version 4

import { Group, Panel, Separator } from "react-resizable-panels";

<Group disableCursor />

Configuration

📅 Schedule: Branch creation - "after 9am and before 7pm every weekday" in timezone Europe/Tallinn, Automerge - At any time (no schedule defined).

🚦 Automerge: Disabled by config. Please merge this manually once you are satisfied.

Rebasing: Whenever PR becomes conflicted, or you tick the rebase/retry checkbox.

🔕 Ignore: Close this PR and you won't be reminded about this update again.


  • If you want to rebase/retry this PR, check this box

This PR was generated by Mend Renovate. View the repository job log.

@renovate renovate bot requested a review from a team as a code owner December 17, 2025 10:49
@renovate renovate bot had a problem deploying to unittest-environment December 17, 2025 10:49 Failure
@renovate renovate bot had a problem deploying to test-environment December 17, 2025 10:49 Failure
@renovate renovate bot force-pushed the renovate/react-resizable-panels-4.x branch from 53965f8 to 9b79648 Compare December 17, 2025 15:01
@renovate renovate bot had a problem deploying to test-environment December 17, 2025 15:01 Failure
@renovate renovate bot had a problem deploying to unittest-environment December 17, 2025 15:01 Failure
@renovate renovate bot force-pushed the renovate/react-resizable-panels-4.x branch from 9b79648 to 969c9aa Compare December 17, 2025 20:01
@renovate renovate bot had a problem deploying to test-environment December 17, 2025 20:01 Failure
@renovate renovate bot had a problem deploying to unittest-environment December 17, 2025 20:01 Failure
@renovate renovate bot force-pushed the renovate/react-resizable-panels-4.x branch from 969c9aa to 7162398 Compare December 18, 2025 22:29
@renovate renovate bot had a problem deploying to test-environment December 18, 2025 22:29 Failure
@renovate renovate bot had a problem deploying to unittest-environment December 18, 2025 22:29 Failure
@renovate renovate bot force-pushed the renovate/react-resizable-panels-4.x branch from 7162398 to eeaf640 Compare December 19, 2025 17:52
@renovate renovate bot had a problem deploying to test-environment December 19, 2025 17:52 Failure
@renovate renovate bot had a problem deploying to unittest-environment December 19, 2025 17:52 Failure
@renovate renovate bot force-pushed the renovate/react-resizable-panels-4.x branch from eeaf640 to eccaf2a Compare December 19, 2025 21:44
@renovate renovate bot had a problem deploying to unittest-environment December 19, 2025 21:44 Failure
@renovate renovate bot had a problem deploying to test-environment December 19, 2025 21:44 Failure
@renovate renovate bot force-pushed the renovate/react-resizable-panels-4.x branch from eccaf2a to 6646714 Compare December 20, 2025 01:58
@renovate renovate bot had a problem deploying to test-environment December 20, 2025 01:58 Failure
@renovate renovate bot had a problem deploying to unittest-environment December 20, 2025 01:58 Failure
@renovate renovate bot force-pushed the renovate/react-resizable-panels-4.x branch from 6646714 to 27e2e34 Compare December 20, 2025 13:31
@renovate renovate bot had a problem deploying to test-environment December 20, 2025 13:31 Failure
@renovate renovate bot had a problem deploying to unittest-environment December 20, 2025 13:31 Failure
@renovate renovate bot force-pushed the renovate/react-resizable-panels-4.x branch from 27e2e34 to ba4bbc5 Compare December 20, 2025 17:48
@renovate renovate bot had a problem deploying to unittest-environment December 20, 2025 17:48 Failure
@renovate renovate bot had a problem deploying to test-environment December 20, 2025 17:48 Failure
@renovate renovate bot force-pushed the renovate/react-resizable-panels-4.x branch from ba4bbc5 to 2050c6a Compare December 21, 2025 22:39
@renovate renovate bot had a problem deploying to unittest-environment December 21, 2025 22:39 Failure
@renovate renovate bot had a problem deploying to test-environment December 21, 2025 22:39 Failure
@renovate renovate bot force-pushed the renovate/react-resizable-panels-4.x branch from 2050c6a to c9cc4f1 Compare December 22, 2025 14:49
@renovate renovate bot had a problem deploying to test-environment December 22, 2025 14:49 Failure
@renovate renovate bot had a problem deploying to unittest-environment December 22, 2025 14:49 Failure
@renovate renovate bot force-pushed the renovate/react-resizable-panels-4.x branch from c9cc4f1 to 4de391f Compare December 28, 2025 14:08
@renovate renovate bot had a problem deploying to unittest-environment December 28, 2025 14:08 Failure
@renovate renovate bot had a problem deploying to test-environment December 28, 2025 14:08 Failure
@renovate renovate bot force-pushed the renovate/react-resizable-panels-4.x branch from 4de391f to 4f84e97 Compare December 29, 2025 17:53
@renovate renovate bot had a problem deploying to test-environment December 29, 2025 17:53 Failure
@renovate renovate bot had a problem deploying to unittest-environment December 29, 2025 17:53 Failure
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant