گفتگوی هشدار
یک پنجرهٔ مدال که جریان را برای اقدامات مخرب — حذف، خروج، دور انداختن — متوقف میکند، با جلوهی نئوبروتالیستِ مرزها و سایهها.
import {
AlertDialog,
AlertDialogAction,دیالوگ هشدار کاربر را با یک مدال قطع میکند که نیازمند انتخاب صریح است — کلیک بیرون آن را نمیبندد. بر پایهٔ Base UI Alert Dialog ساخته شده و با دستور پخت نئوبروتالیستی استایل شده: حاشیههای ضخیم، سایههای سخت و تایپوگرافی پررنگ.
برای این موارد از آن استفاده کنید:
- تأیید اقدامات مخرب — حذف حساب، حذف عضو تیم، پاک کردن پروژه.
- عملیات برگشتناپذیر — انتشار، ارسال، ثبت؛ هر چیزی بدون undo.
- نگهبان تغییرات ذخیرهنشده — هشدار قبل از ترک فرمی که تغییر کرده است.
نصب#
pnpm dlx shadcn@latest add https://neobrutalism.com/r/base/alert-dialog.jsonnpx shadcn@latest add https://neobrutalism.com/r/base/alert-dialog.jsonyarn dlx shadcn@latest add https://neobrutalism.com/r/base/alert-dialog.jsonbunx --bun shadcn@latest add https://neobrutalism.com/r/base/alert-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 { AlertDialog as AlertDialogPrimitive } from "radix-ui"
import { cn } from "@/lib/utils"
import { Button } from "@/components/ui/button"
function AlertDialog({
...props
}: React.ComponentProps<typeof AlertDialogPrimitive.Root>) {
return <AlertDialogPrimitive.Root data-slot="alert-dialog" {...props} />
}
function AlertDialogTrigger({
...props
}: React.ComponentProps<typeof AlertDialogPrimitive.Trigger>) {
return (
<AlertDialogPrimitive.Trigger data-slot="alert-dialog-trigger" {...props} />
)
}
function AlertDialogPortal({
...props
}: React.ComponentProps<typeof AlertDialogPrimitive.Portal>) {
return (
<AlertDialogPrimitive.Portal data-slot="alert-dialog-portal" {...props} />
)
}
function AlertDialogOverlay({
className,
...props
}: React.ComponentProps<typeof AlertDialogPrimitive.Overlay>) {
return (
<AlertDialogPrimitive.Overlay
data-slot="alert-dialog-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 AlertDialogContent({
className,
size = "default",
...props
}: React.ComponentProps<typeof AlertDialogPrimitive.Content> & {
size?: "default" | "sm"
}) {
return (
<AlertDialogPortal>
<AlertDialogOverlay />
<AlertDialogPrimitive.Content
data-slot="alert-dialog-content"
data-size={size}
className={cn(
"group/alert-dialog-content fixed top-1/2 left-1/2 z-50 grid w-full -translate-x-1/2 -translate-y-1/2 gap-4 rounded border-2 bg-popover p-4 text-popover-foreground shadow-md duration-100 outline-none data-[size=default]:max-w-xs data-[size=sm]:max-w-xs data-[size=default]: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}
/>
</AlertDialogPortal>
)
}
function AlertDialogHeader({
className,
...props
}: React.ComponentProps<"div">) {
return (
<div
data-slot="alert-dialog-header"
className={cn(
"grid grid-rows-[auto_1fr] place-items-center gap-1.5 text-center has-data-[slot=alert-dialog-media]:grid-rows-[auto_auto_1fr] has-data-[slot=alert-dialog-media]:gap-x-4 sm:group-data-[size=default]/alert-dialog-content:place-items-start sm:group-data-[size=default]/alert-dialog-content:text-left sm:group-data-[size=default]/alert-dialog-content:has-data-[slot=alert-dialog-media]:grid-rows-[auto_1fr]",
className
)}
{...props}
/>
)
}
function AlertDialogFooter({
className,
...props
}: React.ComponentProps<"div">) {
return (
<div
data-slot="alert-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 group-data-[size=sm]/alert-dialog-content:grid group-data-[size=sm]/alert-dialog-content:grid-cols-2 sm:flex-row sm:justify-end",
className
)}
{...props}
/>
)
}
function AlertDialogMedia({
className,
...props
}: React.ComponentProps<"div">) {
return (
<div
data-slot="alert-dialog-media"
className={cn(
"mb-2 inline-flex size-10 items-center justify-center rounded-md bg-muted sm:group-data-[size=default]/alert-dialog-content:row-span-2 *:[svg:not([class*='size-'])]:size-6",
className
)}
{...props}
/>
)
}
function AlertDialogTitle({
className,
...props
}: React.ComponentProps<typeof AlertDialogPrimitive.Title>) {
return (
<AlertDialogPrimitive.Title
data-slot="alert-dialog-title"
className={cn(
"font-head text-base font-medium sm:group-data-[size=default]/alert-dialog-content:group-has-data-[slot=alert-dialog-media]/alert-dialog-content:col-start-2",
className
)}
{...props}
/>
)
}
function AlertDialogDescription({
className,
...props
}: React.ComponentProps<typeof AlertDialogPrimitive.Description>) {
return (
<AlertDialogPrimitive.Description
data-slot="alert-dialog-description"
className={cn(
"text-sm text-balance text-muted-foreground md:text-pretty *:[a]:underline *:[a]:underline-offset-3 *:[a]:hover:text-foreground",
className
)}
{...props}
/>
)
}
function AlertDialogAction({
className,
variant = "default",
size = "default",
...props
}: React.ComponentProps<typeof AlertDialogPrimitive.Action> &
Pick<React.ComponentProps<typeof Button>, "variant" | "size">) {
return (
<Button variant={variant} size={size} asChild>
<AlertDialogPrimitive.Action
data-slot="alert-dialog-action"
className={cn(className)}
{...props}
/>
</Button>
)
}
function AlertDialogCancel({
className,
variant = "outline",
size = "default",
...props
}: React.ComponentProps<typeof AlertDialogPrimitive.Cancel> &
Pick<React.ComponentProps<typeof Button>, "variant" | "size">) {
return (
<Button variant={variant} size={size} asChild>
<AlertDialogPrimitive.Cancel
data-slot="alert-dialog-cancel"
className={cn(className)}
{...props}
/>
</Button>
)
}
export {
AlertDialog,
AlertDialogAction,
AlertDialogCancel,
AlertDialogContent,
AlertDialogDescription,
AlertDialogFooter,
AlertDialogHeader,
AlertDialogMedia,
AlertDialogOverlay,
AlertDialogPortal,
AlertDialogTitle,
AlertDialogTrigger,
}
مسیرهای import را متناسب با ساختار پروژهٔ خود بهروزرسانی کنید.
استفاده#
import {
AlertDialog,
AlertDialogAction,
AlertDialogCancel,
AlertDialogContent,
AlertDialogDescription,
AlertDialogFooter,
AlertDialogHeader,
AlertDialogTitle,
AlertDialogTrigger,
} from "@/components/ui/alert-dialog"<AlertDialog>
<AlertDialogTrigger render={<Button variant="outline" />}>
Show Dialog
</AlertDialogTrigger>
<AlertDialogContent>
<AlertDialogHeader>
<AlertDialogTitle>Are you absolutely sure?</AlertDialogTitle>
<AlertDialogDescription>
This action cannot be undone. This will permanently delete your account
from our servers.
</AlertDialogDescription>
</AlertDialogHeader>
<AlertDialogFooter>
<AlertDialogCancel>Cancel</AlertDialogCancel>
<AlertDialogAction>Continue</AlertDialogAction>
</AlertDialogFooter>
</AlertDialogContent>
</AlertDialog>ترکیب#
برای ساخت AlertDialog از ترکیب زیر استفاده کنید:
AlertDialog
├── AlertDialogTrigger
└── AlertDialogContent
├── AlertDialogHeader
│ ├── AlertDialogMedia
│ ├── AlertDialogTitle
│ └── AlertDialogDescription
└── AlertDialogFooter
├── AlertDialogCancel
└── AlertDialogActionنمونهها#
پایه#
یک دیالوگ هشدار پایه با عنوان، توضیح و دکمههای لغو و ادامه.
import {
AlertDialog,
AlertDialogAction,کوچک#
از پراپ size="sm" برای کوچکتر کردن دیالوگ هشدار استفاده کنید.
import {
AlertDialog,
AlertDialogAction,رسانه#
از کامپوننت AlertDialogMedia برای افزودن یک عنصر رسانهای، مانند آیکون یا تصویر، به دیالوگ هشدار استفاده کنید.
import { CircleFadingPlusIcon } from "lucide-react"
import {کوچک با رسانه#
از پراپ size="sm" برای کوچکتر کردن دیالوگ هشدار و از کامپوننت AlertDialogMedia برای افزودن یک عنصر رسانهای مانند آیکون یا تصویر استفاده کنید.
import { BluetoothIcon } from "lucide-react"
import {مخرب#
از کامپوننت AlertDialogAction برای افزودن یک دکمهٔ کنش مخرب به دیالوگ هشدار استفاده کنید.
import { Trash2Icon } from "lucide-react"
import {RTL#
برای فعالسازی پشتیبانی RTL در Neobrutalism، راهنمای پیکربندی RTL را ببینید.
"use client"
import { BluetoothIcon } from "lucide-react"دسترسیپذیری#
دیالوگ هشدار از الگوی WAI-ARIA Alert Dialog پیروی میکند: پاپآپ با role="alertdialog" رندر میشود که از طریق aria-labelledby و aria-describedby به عنوان و توضیحات وصل است، و تا وقتی باز است فوکوس داخل آن گیر میافتد.
تعاملات صفحهکلید:
| کلید | عمل |
|---|---|
Space / Enter | باز کردن دیالوگ از تریگر فوکوسشده |
Tab / Shift + Tab | چرخاندن فوکوس بین عناصر قابلفوکوس دیالوگ |
Esc | بستن دیالوگ و بازگرداندن فوکوس به تریگر |
مرجع API#
size#
از پراپ size روی کامپوننت AlertDialogContent برای کنترل اندازهٔ دیالوگ هشدار استفاده کنید. مقادیر زیر را میپذیرد:
| Prop | Type | Default |
|---|---|---|
size | "default" | "sm" | "default" |
برای اطلاعات بیشتر دربارهٔ سایر کامپوننتها و پراپهای آنها، مستندات Base UI را ببینید.