リサイズ可能なパネル(Resizable Panels)
ドラッグで幅・高さを自在に変更できる分割パネル UI を、Next.js のレイアウト向けライブラリ 3 種で比較します。 CSS の衝突を避けるため、各実装は独立したタブで切り替え表示しています。
react-resizable-panels
Brian Vaughn(React DevTools 作者)が開発した軽量パネルライブラリ。Group /Panel /Separatorの3コンポーネントで構成され、水平・垂直の分割に対応します。collapsible props で折りたたみも可能です。v4 ではサイズの数値は px、"25%"のような文字列は割合として扱われます。
'use client';
import { Group, Panel, Separator } from 'react-resizable-panels';
export function ReactResizablePanelsDemo() {
// v4 では、数値のサイズは px、"30%" のような文字列は割合として扱われる
return (
<Group orientation="horizontal" style={{ height: 400 }}>
<Panel defaultSize="30%" minSize="20%">
<div className="h-full p-4 bg-slate-50 border-r border-slate-200">左パネル</div>
</Panel>
<Separator className="w-1 bg-slate-200 hover:bg-blue-400 cursor-col-resize transition-colors" />
<Panel defaultSize="70%">
<div className="h-full p-4">右パネル</div>
</Panel>
</Group>
);
}AIプロンプトテンプレート
React + Tailwind CSSで、react-resizable-panelsを使ったリサイズ可能な分割パネルUIを実装してください。 - 使用ライブラリ: react-resizable-panels(v4)の Group / Panel / Separator - Group の orientation(horizontal / vertical)で分割方向を指定する - Panel の defaultSize / minSize / maxSize でサイズを指定する(v4 では数値は px、"25%" のような文字列は割合) - collapsible / collapsedSize props でパネルの折りたたみ機能を実装する - useDefaultLayout フックでパネルサイズを localStorage に保存・復元する - Separator の children に任意のJSXを渡してハンドルを完全カスタマイズする - 左パネルにナビゲーション、右パネルにコンテンツを配置したサンプルレイアウトを作成する
このプロンプトはあくまでたたき台です。AIの回答はモデルやバージョン、会話の文脈によって毎回異なります。意図通りに動かない場合は、条件を追記・修正してお使いください。
ライブラリ比較
| 項目 | react-resizable-panels | Allotment | CSS / React |
|---|---|---|---|
| コンポーネント構成 | Group / Panel / Separator | Allotment / Allotment.Pane | 自前実装 |
| 分割方向 | horizontal / vertical | horizontal / vertical | 自前で両対応可 |
| 折りたたみ(Collapse) | ✅ collapsible props | ✅ minSize=0 で対応 | ⚠️ 自前実装 |
| スナップ動作 | ⚠️ 自前実装 | ✅ snap props | ⚠️ 自前実装 |
| サイズ永続化 | ✅ useDefaultLayout(localStorage) | ❌ なし(手動実装) | ⚠️ 手動実装 |
| ネスト分割 | ✅ Group ネスト | ✅ Allotment ネスト | ✅ コンポーネント再利用 |
| キーボード操作 | ✅ 矢印キー対応 | ✅ 矢印キー対応 | ⚠️ 手動実装が必要 |
| CSSインポート | ❌ 不要 | ⚠️ style.css 必須 | ❌ 不要 |
| ハンドルカスタマイズ | ✅ 完全自由(children渡し) | ⚠️ 限定的 | ✅ 完全自由 |
| バンドルサイズ | 小(〜7kB gzip) | 中(〜20kB gzip) | 0(追加なし) |
選択のポイント
- react-resizable-panels — 軽量かつ柔軟性が高く、ハンドルを完全にカスタムできる点が強み。
useDefaultLayoutでサイズをlocalStorageに保存・復元でき、 管理画面・IDE風レイアウト・ダッシュボードなど幅広い用途に最適。 React DevTools 作者が開発しており信頼性も高い。 - Allotment — VS Code スタイルのコードエディターや、ネストが深い複雑な分割レイアウトを手軽に実現できる。
snapprops によるスナップ動作が組み込まれており、 エディター風 UI や開発者ツール系アプリに特に向いている。 CSSのインポートが必要な点に注意。 - CSS / 純粋な React — 追加依存ゼロで既存デザインシステムに完全合わせられる。 シンプルな2カラムレイアウトや、ライブラリのCSSが競合しやすい環境での軽量実装に最適。 キーボード対応・スナップ・折りたたみなどの機能は自前実装コストがかかるため、 要件が複雑な場合は上記ライブラリの採用を推奨。
リサイズパネルは、ドラッグ操作でパネル間の分割比率を変更できるレイアウトUI。スプリットビューとも呼ばれる。
コードエディタ・ファイルエクスプローラー・プレビュー付き編集画面など、2つ以上のコンテンツを並べて操作するツール系UIで使われる。
- 水平分割型(左右)
- 垂直分割型(上下)
- 多分割型(3ペイン以上)
- 最小・最大幅制限付き
- 折りたたみ可能型
同じカテゴリの他のページ
ヒーローセクション(Hero Section)の実装比較
Mantine・shadcn/ui・Tailwind CSSのヒーローセクション実装を比較。キャッチコピー・CTAボタン・グラデーション背景のデモ・コード付き。
アコーディオンUI(Accordion)のデザイン・実装比較
アコーディオンUIのデザインと実装を、Mantine・MUI・Ant Design・shadcn/ui・Chakra UI・CSSで比較。折りたたみ展開・複数同時開閉のデモ・コード付き。
アプリシェル(App Shell)の実装比較
Mantine・Ant Design・MUI・shadcn/ui・Tailwind CSSのアプリシェル実装を比較。ヘッダー・サイドバー・メインコンテンツの構成パターンをデモ・コード付き。