مربع حوار
نافذة منبثقة مخصصة لعمليات التأكيد، والنماذج السريعة، ومطالبات الإجراءات التي تؤدي إلى فقدان البيانات — تظهر فوق الصفحة بحدود سميكة وظل بارز.
import { Button } from "@/components/ui/button"
import {
Dialog,يفتح الـ dialog نافذة منبثقة فوق الصفحة — ينتقل التركيز إلى داخلها، ويصبح المحتوى خلفها خاملاً، والإغلاق يعيدك حيث كنت. مبني على عنصر Base UI Dialog الأساسي ومصمَّم وفق وصفة النيوبروتالية: حدود سميكة، وظلال حادة، وخط عريض.
استخدمه عندما:
- التأكيدات — حذف، تسجيل خروج، تخفيض خطة؛ أي شيء مدمّر يستحق وقفة حازمة.
- نماذج سريعة — تعديل ملف شخصي، إعادة تسمية مشروع، دعوة زميل دون مغادرة الصفحة.
- عروض تفاصيل مركَّزة — معاينات صور، نص ترخيص، ملاحظات إصدار لا تحتاج مسارًا خاصًا.
التثبيت#
pnpm dlx shadcn@latest add https://neobrutalism.com/r/base/dialog.jsonnpx shadcn@latest add https://neobrutalism.com/r/base/dialog.jsonyarn dlx shadcn@latest add https://neobrutalism.com/r/base/dialog.jsonbunx --bun shadcn@latest add https://neobrutalism.com/r/base/dialog.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 DialogPrimitive } from "radix-ui"
import { cn } from "@/lib/utils"
import { Button } from "@/components/ui/button"
function Dialog({
...props
}: React.ComponentProps<typeof DialogPrimitive.Root>) {
return <DialogPrimitive.Root data-slot="dialog" {...props} />
}
function DialogTrigger({
...props
}: React.ComponentProps<typeof DialogPrimitive.Trigger>) {
return <DialogPrimitive.Trigger data-slot="dialog-trigger" {...props} />
}
function DialogPortal({
...props
}: React.ComponentProps<typeof DialogPrimitive.Portal>) {
return <DialogPrimitive.Portal data-slot="dialog-portal" {...props} />
}
function DialogClose({
...props
}: React.ComponentProps<typeof DialogPrimitive.Close>) {
return <DialogPrimitive.Close data-slot="dialog-close" {...props} />
}
function DialogOverlay({
className,
...props
}: React.ComponentProps<typeof DialogPrimitive.Overlay>) {
return (
<DialogPrimitive.Overlay
data-slot="dialog-overlay"
className={cn(
"fixed inset-0 isolate 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 DialogContent({
className,
children,
showCloseButton = true,
...props
}: React.ComponentProps<typeof DialogPrimitive.Content> & {
showCloseButton?: boolean
}) {
return (
<DialogPortal>
<DialogOverlay />
<DialogPrimitive.Content
data-slot="dialog-content"
className={cn(
"fixed top-1/2 left-1/2 z-50 grid w-full max-w-[calc(100%-2rem)] -translate-x-1/2 -translate-y-1/2 gap-4 rounded border-2 bg-popover p-4 text-sm text-popover-foreground shadow-md duration-100 outline-none sm:max-w-sm data-open:animate-in data-open:fade-in-0 data-open:zoom-in-95 data-closed:animate-out data-closed:fade-out-0 data-closed:zoom-out-95",
className
)}
{...props}
>
{children}
{showCloseButton && (
<DialogPrimitive.Close data-slot="dialog-close" asChild>
<Button
variant="ghost"
className="absolute top-2 right-2"
size="icon-sm"
>
<XIcon />
<span className="sr-only">Close</span>
</Button>
</DialogPrimitive.Close>
)}
</DialogPrimitive.Content>
</DialogPortal>
)
}
function DialogHeader({ className, ...props }: React.ComponentProps<"div">) {
return (
<div
data-slot="dialog-header"
className={cn("flex flex-col gap-2", className)}
{...props}
/>
)
}
function DialogFooter({
className,
showCloseButton = false,
children,
...props
}: React.ComponentProps<"div"> & {
showCloseButton?: boolean
}) {
return (
<div
data-slot="dialog-footer"
className={cn(
"-mx-4 -mb-4 flex flex-col-reverse gap-2 rounded-b-xl border-t-2 bg-muted/50 p-4 sm:flex-row sm:justify-end",
className
)}
{...props}
>
{children}
{showCloseButton && (
<DialogPrimitive.Close asChild>
<Button variant="outline">Close</Button>
</DialogPrimitive.Close>
)}
</div>
)
}
function DialogTitle({
className,
...props
}: React.ComponentProps<typeof DialogPrimitive.Title>) {
return (
<DialogPrimitive.Title
data-slot="dialog-title"
className={cn(
"font-head text-base leading-none font-medium",
className
)}
{...props}
/>
)
}
function DialogDescription({
className,
...props
}: React.ComponentProps<typeof DialogPrimitive.Description>) {
return (
<DialogPrimitive.Description
data-slot="dialog-description"
className={cn(
"text-sm text-muted-foreground *:[a]:underline *:[a]:underline-offset-3 *:[a]:hover:text-foreground",
className
)}
{...props}
/>
)
}
export {
Dialog,
DialogClose,
DialogContent,
DialogDescription,
DialogFooter,
DialogHeader,
DialogOverlay,
DialogPortal,
DialogTitle,
DialogTrigger,
}
حدّث مسارات الاستيراد لتطابق إعداد مشروعك.
الاستخدام#
import {
Dialog,
DialogContent,
DialogDescription,
DialogHeader,
DialogTitle,
DialogTrigger,
} from "@/components/ui/dialog"<Dialog>
<DialogTrigger>Open</DialogTrigger>
<DialogContent>
<DialogHeader>
<DialogTitle>Are you absolutely sure?</DialogTitle>
<DialogDescription>
This action cannot be undone. This will permanently delete your account
and remove your data from our servers.
</DialogDescription>
</DialogHeader>
</DialogContent>
</Dialog>التركيب#
استخدم التركيب التالي لبناء Dialog:
Dialog
├── DialogTrigger
└── DialogContent
├── DialogHeader
│ ├── DialogTitle
│ └── DialogDescription
└── DialogFooterأمثلة#
زر إغلاق مخصص#
استبدل عنصر الإغلاق الافتراضي بزرّك الخاص.
import { Button } from "@/components/ui/button"
import {
Dialog,بدون زر إغلاق#
استخدم showCloseButton={false} لإخفاء زر الإغلاق.
import { Button } from "@/components/ui/button"
import {
Dialog,تذييل ثابت#
أبقِ الإجراءات مرئية أثناء تمرير المحتوى.
import { Button } from "@/components/ui/button"
import {
Dialog,محتوى قابل للتمرير#
يمكن تمرير المحتوى الطويل مع بقاء الرأس ظاهرًا.
import { Button } from "@/components/ui/button"
import {
Dialog,RTL#
لتفعيل RTL في Neobrutalism، راجع دليل إعداد RTL.
"use client"
import {إمكانية الوصول#
يتبع الـ dialog نمط WAI-ARIA Dialog (Modal): يُعرض المحتوى بـ role="dialog" وaria-modal، ويُوسم بـ DialogTitle ويُوصف بـ DialogDescription، ويُحبس التركيز داخله أثناء الفتح، والإغلاق يعيد التركيز إلى المشغّل.
تفاعلات لوحة المفاتيح:
| المفتاح | الإجراء |
|---|---|
Space / Enter | فتح الحوار من المشغّل المركَّز |
Tab / Shift + Tab | نقل التركيز إلى العنصر التالي / السابق داخل الحوار (التركيز محبوس) |
Esc | إغلاق الحوار وإعادة التركيز إلى المشغّل |
مرجع API#
لمزيد من المعلومات، راجع وثائق Base UI.