لوحة جانبية
لوحة تنزلق من حافة الشاشة لعرض أدراج التنقل، والمرشحات، ونماذج التحرير — مع تطبيق أسلوب «النيوبروتاليستي» في تصميم الحدود والظلال.
import { Button } from "@/components/ui/button"
import { Input } from "@/components/ui/input"
import { Label } from "@/components/ui/label"هذه النافذة هي مربع حوار مثبت على حافة الشاشة بدلاً من أن يكون في المنتصف — بنفس التراكب، وميزة «تركيز الانتباه»، وسلوك الإغلاق، مع اختلاف في الموضع. تم إنشاؤها باستخدام عنصر Base UI Dialog الأساسي وتصميمها وفقًا لنهج «النيوبروتالية»: حدود سميكة، وظلال حادة، وخط عريض.
استخدمه عندما:
- التنقل على الأجهزة المحمولة — شريط التنقل الذي ينزلق من الجانب.
- لوحات سلة التسوق والتفاصيل — سلة التسوق، أو ملخص الطلب، أو تفاصيل الصف دون مغادرة الصفحة.
- نماذج التحرير — تحديث سجل في لوحة جانبية بينما يظل الجدول معروضًا.
التثبيت#
pnpm dlx shadcn@latest add https://neobrutalism.com/r/base/sheet.jsonnpx shadcn@latest add https://neobrutalism.com/r/base/sheet.jsonyarn dlx shadcn@latest add https://neobrutalism.com/r/base/sheet.jsonbunx --bun shadcn@latest add https://neobrutalism.com/r/base/sheet.json
ثبّت التبعيات التالية:
pnpm add @base-ui/reactnpm install @base-ui/reactyarn add @base-ui/reactbun add @base-ui/react
انسخ الكود التالي والصقه في مشروعك.
"use client"
import * as React from "react"
import { XIcon } from "lucide-react"
import { Dialog as SheetPrimitive } from "radix-ui"
import { cn } from "@/lib/utils"
import { Button } from "@/components/ui/button"
function Sheet({ ...props }: React.ComponentProps<typeof SheetPrimitive.Root>) {
return <SheetPrimitive.Root data-slot="sheet" {...props} />
}
function SheetTrigger({
...props
}: React.ComponentProps<typeof SheetPrimitive.Trigger>) {
return <SheetPrimitive.Trigger data-slot="sheet-trigger" {...props} />
}
function SheetClose({
...props
}: React.ComponentProps<typeof SheetPrimitive.Close>) {
return <SheetPrimitive.Close data-slot="sheet-close" {...props} />
}
function SheetPortal({
...props
}: React.ComponentProps<typeof SheetPrimitive.Portal>) {
return <SheetPrimitive.Portal data-slot="sheet-portal" {...props} />
}
function SheetOverlay({
className,
...props
}: React.ComponentProps<typeof SheetPrimitive.Overlay>) {
return (
<SheetPrimitive.Overlay
data-slot="sheet-overlay"
className={cn(
"fixed inset-0 z-50 bg-foreground/20 duration-100 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 SheetContent({
className,
children,
side = "right",
showCloseButton = true,
...props
}: React.ComponentProps<typeof SheetPrimitive.Content> & {
side?: "top" | "right" | "bottom" | "left"
showCloseButton?: boolean
}) {
return (
<SheetPortal>
<SheetOverlay />
<SheetPrimitive.Content
data-slot="sheet-content"
data-side={side}
className={cn(
"fixed z-50 flex flex-col gap-4 bg-popover bg-clip-padding text-sm text-popover-foreground shadow-md transition duration-200 ease-in-out data-[side=bottom]:inset-x-0 data-[side=bottom]:bottom-0 data-[side=bottom]:h-auto data-[side=bottom]:border-t-2 data-[side=left]:inset-y-0 data-[side=left]:left-0 data-[side=left]:h-full data-[side=left]:w-3/4 data-[side=left]:border-r-2 data-[side=right]:inset-y-0 data-[side=right]:right-0 data-[side=right]:h-full data-[side=right]:w-3/4 data-[side=right]:border-l-2 data-[side=top]:inset-x-0 data-[side=top]:top-0 data-[side=top]:h-auto data-[side=top]:border-b-2 data-[side=left]:sm:max-w-sm data-[side=right]:sm:max-w-sm data-open:animate-in data-open:fade-in-0 data-[side=bottom]:data-open:slide-in-from-bottom-10 data-[side=left]:data-open:slide-in-from-left-10 data-[side=right]:data-open:slide-in-from-right-10 data-[side=top]:data-open:slide-in-from-top-10 data-closed:animate-out data-closed:fade-out-0 data-[side=bottom]:data-closed:slide-out-to-bottom-10 data-[side=left]:data-closed:slide-out-to-left-10 data-[side=right]:data-closed:slide-out-to-right-10 data-[side=top]:data-closed:slide-out-to-top-10",
className
)}
{...props}
>
{children}
{showCloseButton && (
<SheetPrimitive.Close data-slot="sheet-close" asChild>
<Button
variant="ghost"
className="absolute top-3 right-3"
size="icon-sm"
>
<XIcon />
<span className="sr-only">Close</span>
</Button>
</SheetPrimitive.Close>
)}
</SheetPrimitive.Content>
</SheetPortal>
)
}
function SheetHeader({ className, ...props }: React.ComponentProps<"div">) {
return (
<div
data-slot="sheet-header"
className={cn("flex flex-col gap-0.5 p-4", className)}
{...props}
/>
)
}
function SheetFooter({ className, ...props }: React.ComponentProps<"div">) {
return (
<div
data-slot="sheet-footer"
className={cn("mt-auto flex flex-col gap-2 p-4", className)}
{...props}
/>
)
}
function SheetTitle({
className,
...props
}: React.ComponentProps<typeof SheetPrimitive.Title>) {
return (
<SheetPrimitive.Title
data-slot="sheet-title"
className={cn(
"font-head text-base font-medium text-foreground",
className
)}
{...props}
/>
)
}
function SheetDescription({
className,
...props
}: React.ComponentProps<typeof SheetPrimitive.Description>) {
return (
<SheetPrimitive.Description
data-slot="sheet-description"
className={cn("text-sm text-muted-foreground", className)}
{...props}
/>
)
}
export {
Sheet,
SheetTrigger,
SheetClose,
SheetContent,
SheetHeader,
SheetFooter,
SheetTitle,
SheetDescription,
}
حدّث مسارات الاستيراد لتتوافق مع بنية مشروعك.
الاستخدام#
import {
Sheet,
SheetClose,
SheetContent,
SheetDescription,
SheetFooter,
SheetHeader,
SheetTitle,
SheetTrigger,
} from "@/components/ui/sheet"<Sheet>
<SheetTrigger>Open</SheetTrigger>
<SheetContent>
<SheetHeader>
<SheetTitle>Are you absolutely sure?</SheetTitle>
<SheetDescription>This action cannot be undone.</SheetDescription>
</SheetHeader>
</SheetContent>
</Sheet>التركيب#
استخدم التركيب التالي لبناء Sheet:
Sheet
├── SheetTrigger
└── SheetContent
├── SheetHeader
│ ├── SheetTitle
│ └── SheetDescription
└── SheetFooterأمثلة#
الجهة#
استخدم الخاصية side على SheetContent لتحديد حافة الشاشة التي تظهر عندها الورقة. القيم هي top أو right أو bottom أو left.
import { Button } from "@/components/ui/button"
import {
Sheet,بدون زر إغلاق#
استخدم showCloseButton={false} على SheetContent لإخفاء زر الإغلاق.
import { Button } from "@/components/ui/button"
import {
Sheet,RTL#
لتفعيل RTL في Neobrutalism، راجع دليل إعداد RTL.
"use client"
import {إمكانية الوصول#
تتبع هذه الورقة نموذج WAI-ARIA Dialog (Modal) pattern: تقوم اللوحة بعرض role="dialog" مع aria-modal، وينتقل التركيز إليها عند الفتح ويبقى محصوراً فيها، ويتم توصيل SheetTitle / SheetDescription بـ aria-labelledby / aria-describedby — مع عرض SheetTitle دائماً، وإخفائه بصرياً إذا لزم الأمر.
تفاعلات لوحة المفاتيح:
| المفتاح | الإجراء |
|---|---|
Space / Enter | فتح الورقة عند تركيز التركيز على المشغل |
Tab / Shift + Tab | نقل التركيز بين العناصر القابلة للتركيز داخل الورقة (مصيدة التركيز) |
Esc | إغلاق الورقة وإعادة التركيز إلى المشغل |
مرجع API#
لمزيد من المعلومات، راجع وثائق Base UI.