TaavUI Lab
Overlay Primitive

TaavDialog

Modal accessible با focus trap — تأیید، هشدار danger و فرم کوتاه.

import { TaavDialog, TaavDialogTrigger, TaavDialogContent } from "@repo/ui/taav/overlays";

فقط از props رسمی TaavUI استفاده کنید. unsafeClassName و escape hatchهای مشابه فقط برای موارد نادر هستند و نباید در مثال‌های عادی دیده شوند.

استفاده پایه

RTL Preview

Danger confirmation

پیش‌نمایش

Form inside dialog

پیش‌نمایش
<TaavDialogContent size="md">
  <TaavFormField label="نام"><TaavInput /></TaavFormField>
</TaavDialogContent>

Props

Propنوعپیش‌فرضتوضیح
size'sm' | 'md' | 'lg' | 'xl' | 'fullscreen'mdعرض dialog
variant'default' | 'elevated' | 'soft'defaultسطح بصری
tone'neutral' | 'danger' | 'success' | 'warning' | 'info'neutralمرز معنادار
showCloseButtonbooleantrueدکمه بستن RTL
open / onOpenChangeboolean / fncontrolled state

Design Specs

Width mdvar(--taav-dialog-width-md)
Surfacevar(--taav-overlay-surface)
Backdropvar(--taav-overlay-backdrop)

دسترس‌پذیری

راهنمای استفاده در DastRanj / VahedYek

  • Title و Description الزامی برای screen reader
  • Escape و focus trap توسط Radix Dialog

Do / Don't

انجام دهید

  • برای confirmation و task کوتاه از TaavDialog استفاده کنید

انجام ندهید

  • modal محلی با div fixed و z-index دستی نسازید