מגירה
גיליון המופעל באמצעות מחוות, הנפתח מכל קצה עבור תפריטים, מסננים וטפסים מהירים במכשירים ניידים — עם מסגרות וצללים בסגנון ניאו-ברוטליסטי.
"use client"
import * as React from "react"ה-drawer הוא פאנל שנכנס בהחלקה מקצה המסך ואפשר לגרור לסגירה. נבנה על Vaul של Emil Kowalski ומעוצב לפי המתכון הנאו-ברוטליסטי: מסגרות עבות, צללים חדים וטיפוגרפיה מודגשת.
השתמשו בו כש:
- גיליונות פעולה למובייל — תפריטי שיתוף, אפשרויות מיון, אישורים מהירים. מחוות גרירה-לסגירה עדיפה על חיפוש כפתור סגירה קטן במגע.
- פאנלי מסננים והגדרות — מסנני מסחר או העדפות שצריכים יותר מקום מ-popover אבל לא מצדיקים עמוד.
- dialogs רספונסיביים — חברו אותו ל-
Dialogכדי לרנדר מודאל בדסקטופ ו-drawer במובייל (ראו את הדוגמה למטה).
אודות#
Drawer בנוי על גבי Vaul מאת emilkowalski.
התקנה#
pnpm dlx shadcn@latest add https://neobrutalism.com/r/base/drawer.jsonnpx shadcn@latest add https://neobrutalism.com/r/base/drawer.jsonyarn dlx shadcn@latest add https://neobrutalism.com/r/base/drawer.jsonbunx --bun shadcn@latest add https://neobrutalism.com/r/base/drawer.json
התקינו את התלויות הבאות:
pnpm add vaulnpm install vaulyarn add vaulbun add vaul
העתיקו והדביקו את הקוד הבא לתוך הפרויקט שלכם.
"use client"
import * as React from "react"
import { Drawer as DrawerPrimitive } from "vaul"
import { cn } from "@/lib/utils"
function Drawer({
...props
}: React.ComponentProps<typeof DrawerPrimitive.Root>) {
return <DrawerPrimitive.Root data-slot="drawer" {...props} />
}
function DrawerTrigger({
...props
}: React.ComponentProps<typeof DrawerPrimitive.Trigger>) {
return <DrawerPrimitive.Trigger data-slot="drawer-trigger" {...props} />
}
function DrawerPortal({
...props
}: React.ComponentProps<typeof DrawerPrimitive.Portal>) {
return <DrawerPrimitive.Portal data-slot="drawer-portal" {...props} />
}
function DrawerClose({
...props
}: React.ComponentProps<typeof DrawerPrimitive.Close>) {
return <DrawerPrimitive.Close data-slot="drawer-close" {...props} />
}
function DrawerOverlay({
className,
...props
}: React.ComponentProps<typeof DrawerPrimitive.Overlay>) {
return (
<DrawerPrimitive.Overlay
data-slot="drawer-overlay"
className={cn(
"fixed inset-0 z-50 bg-foreground/20 supports-backdrop-filter:backdrop-blur-xs data-open:animate-in data-open:fade-in-0 data-closed:animate-out data-closed:fade-out-0",
className
)}
{...props}
/>
)
}
function DrawerContent({
className,
children,
...props
}: React.ComponentProps<typeof DrawerPrimitive.Content>) {
return (
<DrawerPortal data-slot="drawer-portal">
<DrawerOverlay />
<DrawerPrimitive.Content
data-slot="drawer-content"
className={cn(
"group/drawer-content fixed z-50 flex h-auto flex-col bg-popover text-sm text-popover-foreground shadow-md data-[vaul-drawer-direction=bottom]:inset-x-0 data-[vaul-drawer-direction=bottom]:bottom-0 data-[vaul-drawer-direction=bottom]:mt-24 data-[vaul-drawer-direction=bottom]:max-h-[80vh] data-[vaul-drawer-direction=bottom]:rounded-t-xl data-[vaul-drawer-direction=bottom]:border-t-2 data-[vaul-drawer-direction=left]:inset-y-0 data-[vaul-drawer-direction=left]:left-0 data-[vaul-drawer-direction=left]:w-3/4 data-[vaul-drawer-direction=left]:rounded-r-xl data-[vaul-drawer-direction=left]:border-r-2 data-[vaul-drawer-direction=right]:inset-y-0 data-[vaul-drawer-direction=right]:right-0 data-[vaul-drawer-direction=right]:w-3/4 data-[vaul-drawer-direction=right]:rounded-l-xl data-[vaul-drawer-direction=right]:border-l-2 data-[vaul-drawer-direction=top]:inset-x-0 data-[vaul-drawer-direction=top]:top-0 data-[vaul-drawer-direction=top]:mb-24 data-[vaul-drawer-direction=top]:max-h-[80vh] data-[vaul-drawer-direction=top]:rounded-b-xl data-[vaul-drawer-direction=top]:border-b-2 data-[vaul-drawer-direction=left]:sm:max-w-sm data-[vaul-drawer-direction=right]:sm:max-w-sm",
className
)}
{...props}
>
<div className="mx-auto mt-4 hidden h-1 w-[100px] shrink-0 rounded-full bg-muted group-data-[vaul-drawer-direction=bottom]/drawer-content:block" />
{children}
</DrawerPrimitive.Content>
</DrawerPortal>
)
}
function DrawerHeader({ className, ...props }: React.ComponentProps<"div">) {
return (
<div
data-slot="drawer-header"
className={cn(
"flex flex-col gap-0.5 p-4 group-data-[vaul-drawer-direction=bottom]/drawer-content:text-center group-data-[vaul-drawer-direction=top]/drawer-content:text-center md:gap-0.5 md:text-left",
className
)}
{...props}
/>
)
}
function DrawerFooter({ className, ...props }: React.ComponentProps<"div">) {
return (
<div
data-slot="drawer-footer"
className={cn("mt-auto flex flex-col gap-2 p-4", className)}
{...props}
/>
)
}
function DrawerTitle({
className,
...props
}: React.ComponentProps<typeof DrawerPrimitive.Title>) {
return (
<DrawerPrimitive.Title
data-slot="drawer-title"
className={cn(
"font-head text-base font-medium text-foreground",
className
)}
{...props}
/>
)
}
function DrawerDescription({
className,
...props
}: React.ComponentProps<typeof DrawerPrimitive.Description>) {
return (
<DrawerPrimitive.Description
data-slot="drawer-description"
className={cn("text-sm text-muted-foreground", className)}
{...props}
/>
)
}
export {
Drawer,
DrawerPortal,
DrawerOverlay,
DrawerTrigger,
DrawerClose,
DrawerContent,
DrawerHeader,
DrawerFooter,
DrawerTitle,
DrawerDescription,
}
עדכנו את נתיבי הייבוא כך שיתאימו למבנה הפרויקט שלכם.
שימוש#
import {
Drawer,
DrawerClose,
DrawerContent,
DrawerDescription,
DrawerFooter,
DrawerHeader,
DrawerTitle,
DrawerTrigger,
} from "@/components/ui/drawer"<Drawer>
<DrawerTrigger>Open</DrawerTrigger>
<DrawerContent>
<DrawerHeader>
<DrawerTitle>Are you absolutely sure?</DrawerTitle>
<DrawerDescription>This action cannot be undone.</DrawerDescription>
</DrawerHeader>
<DrawerFooter>
<Button>Submit</Button>
<DrawerClose>
<Button variant="outline">Cancel</Button>
</DrawerClose>
</DrawerFooter>
</DrawerContent>
</Drawer>קומפוזיציה#
השתמשו בקומפוזיציה הבאה כדי לבנות Drawer:
Drawer
├── DrawerTrigger
└── DrawerContent
├── DrawerHeader
│ ├── DrawerTitle
│ └── DrawerDescription
└── DrawerFooterדוגמאות#
תוכן נגלל#
שמרו על הפעולות גלויות בזמן שהתוכן נגלל.
import { Button } from "@/components/ui/button"
import {
Drawer,צדדים#
השתמשו ב-prop בשם direction כדי להגדיר את צד המגירה. האפשרויות הזמינות הן top, right, bottom ו-left.
import { Button } from "@/components/ui/button"
import {
Drawer,דיאלוג רספונסיבי#
אפשר לשלב את הרכיבים Dialog ו-Drawer כדי ליצור דיאלוג רספונסיבי. הוא מרנדר רכיב Dialog במחשב שולחני ורכיב Drawer במובייל.
"use client"
import * as React from "react"RTL#
כדי להפעיל RTL ב-Neobrutalism, עיינו במדריך ההגדרה של RTL.
"use client"
import * as React from "react"נגישות#
ה-drawer עוקב אחרי דפוס Dialog (Modal) של WAI-ARIA: Vaul בנוי על פרימיטיב Dialog של Radix, כך שהפאנל מרנדר עם role="dialog" ו-aria-modal, לוכד מוקד כשהוא פתוח, ומתויג על ידי DrawerTitle ומתואר על ידי DrawerDescription. גרירה לסגירה היא מצביע בלבד — משתמשי מקלדת סוגרים עם Escape או כפתור DrawerClose, אז תמיד כללו אחד.
אינטראקציות מקלדת:
| מקש | פעולה |
|---|---|
Space / Enter | פותחים את ה-drawer מהטריגר שבפוקוס |
Tab / Shift + Tab | מעבירים מוקד בתוכן ה-drawer (המוקד נלכד) |
Escape | סוגרים את ה-drawer ומחזירים מוקד לטריגר |
תיעוד ה-API#
עיינו בתיעוד של Vaul לקבלת תיעוד ה-API המלא.