דילוג לתוכן

ניתן לשינוי גודל

חלוניות מפוצלות הניתנות לגרירה עבור עורכי קוד, עצי קבצים ומערך לוחות מחוונים — עם עיצוב ניאו-ברוטליסטי הכולל מסגרות וצללים.

import {
  ResizableHandle,
  ResizablePanel,

רכיב ה-resizable מפצל אזור לפאנלים שהמשתמשים גוררים כדי לשנות יחס — אופקי או אנכי, ניתן לקינון, עם ידיות שניתנות להפעלה במקלדת. שני הווריאנטים עוטפים את react-resizable-panels של bvaughn, מעוצב לפי המתכון הנאו-ברוטליסטי: מסגרות עבות, צללים חדים וטיפוגרפיה מודגשת.

השתמשו בו כש:

  • עורכי קוד ופריסות בסגנון IDE — עץ קבצים, עורך ופאנלי תצוגה מקדימה שהמשתמשים מתאימים לגודל.
  • תצוגות master–detail — תיבת דואר ושרשור, טבלה ובודק רשומה, עם המפריד במקום שהמשתמשים רוצים.
  • לוחות מחוונים וקונסולות — מאפשרים לפאנל לוג או טרמינל לקחת גובה מהתצוגה הראשית בלי מודאל.

אודות

רכיב Resizable בנוי על גבי react-resizable-panels של bvaughn.

התקנה

pnpm dlx shadcn@latest add https://neobrutalism.com/r/base/resizable.json
npx shadcn@latest add https://neobrutalism.com/r/base/resizable.json
yarn dlx shadcn@latest add https://neobrutalism.com/r/base/resizable.json
bunx --bun shadcn@latest add https://neobrutalism.com/r/base/resizable.json

התקינו את התלויות הבאות:

pnpm add react-resizable-panels
npm install react-resizable-panels
yarn add react-resizable-panels
bun add react-resizable-panels

העתיקו והדביקו את הקוד הבא לתוך הפרויקט שלכם.

components/ui/resizable.tsx
"use client"

import * as ResizablePrimitive from "react-resizable-panels"

import { cn } from "@/lib/utils"

function ResizablePanelGroup({
  className,
  ...props
}: ResizablePrimitive.GroupProps) {
  return (
    <ResizablePrimitive.Group
      data-slot="resizable-panel-group"
      className={cn(
        "flex h-full w-full aria-[orientation=vertical]:flex-col",
        className
      )}
      {...props}
    />
  )
}

function ResizablePanel({ ...props }: ResizablePrimitive.PanelProps) {
  return <ResizablePrimitive.Panel data-slot="resizable-panel" {...props} />
}

function ResizableHandle({
  withHandle,
  className,
  ...props
}: ResizablePrimitive.SeparatorProps & {
  withHandle?: boolean
}) {
  return (
    <ResizablePrimitive.Separator
      data-slot="resizable-handle"
      className={cn(
        "relative flex w-px items-center justify-center bg-border after:absolute after:inset-y-0 after:left-1/2 after:w-1 after:-translate-x-1/2 focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-primary aria-[orientation=horizontal]:h-px aria-[orientation=horizontal]:w-full aria-[orientation=horizontal]:after:left-0 aria-[orientation=horizontal]:after:h-1 aria-[orientation=horizontal]:after:w-full aria-[orientation=horizontal]:after:translate-x-0 aria-[orientation=horizontal]:after:-translate-y-1/2 [&[aria-orientation=horizontal]>div]:rotate-90",
        className
      )}
      {...props}
    >
      {withHandle && (
        <div className="z-10 flex h-6 w-1 shrink-0 rounded-lg bg-border" />
      )}
    </ResizablePrimitive.Separator>
  )
}

export { ResizableHandle, ResizablePanel, ResizablePanelGroup }

עדכנו את נתיבי הייבוא כך שיתאימו למבנה הפרויקט שלכם.

שימוש

import {
  ResizableHandle,
  ResizablePanel,
  ResizablePanelGroup,
} from "@/components/ui/resizable"
<ResizablePanelGroup orientation="horizontal">
  <ResizablePanel>One</ResizablePanel>
  <ResizableHandle />
  <ResizablePanel>Two</ResizablePanel>
</ResizablePanelGroup>

קומפוזיציה

השתמשו בקומפוזיציה הבאה כדי לבנות ResizablePanelGroup:

ResizablePanelGroup
├── ResizablePanel
├── ResizableHandle
└── ResizablePanel

דוגמאות

אנכי

השתמשו ב-orientation="vertical" לשינוי גודל אנכי.

import {
  ResizableHandle,
  ResizablePanel,

ידית

השתמשו במאפיין withHandle על ResizableHandle כדי להציג ידית גלויה.

import {
  ResizableHandle,
  ResizablePanel,

RTL

כדי להפעיל RTL ב-Neobrutalism, עיינו במדריך ההגדרה של RTL.

"use client"

import * as React from "react"

נגישות

הידית עוקבת אחרי דפוס Window Splitter של WAI-ARIA: react-resizable-panels מרנדר כל ידית כ-role="separator" ניתן לפוקוס עם aria-valuenow / aria-valuemin / aria-valuemax ו-aria-controls שמצביע על הפאנל שהיא משנה גודל, כך שקוראי מסך מכריזים על מיקום הפיצול כשהוא משתנה.

אינטראקציות מקלדת:

מקשפעולה
Tab / Shift + Tabמעבירים מוקד אל / מידית שינוי גודל
ArrowLeft / ArrowRightמשנים גודל קבוצה אופקית בצעד אחד
ArrowUp / ArrowDownמשנים גודל קבוצה אנכית בצעד אחד
Homeמכווצים את הפאנל לפני הידית לגודל המינימום שלו
Endמגדילים את הפאנל לפני הידית לגודל המקסימום שלו
Enterמחליפים פאנל מתקפל בין מכווץ למורחב

תיעוד ה-API

עיינו בתיעוד של react-resizable-panels.

Changelog

2025-02-02 react-resizable-panels v4

עודכן ל-react-resizable-panels v4. לפרטים המלאים, עיינו בהערות השחרור של v4.0.0.

אם אתם משתמשים ישירות בפרימיטיבים של react-resizable-panels, שימו לב לשינויים הבאים:

v3v4
PanelGroupGroup
PanelResizeHandleSeparator
direction proporientation prop
defaultSize={50}defaultSize="50%"
onLayoutonLayoutChange
ImperativePanelHandlePanelImperativeHandle
ref prop on PanelpanelRef prop
data-panel-group-directionaria-orientation