نافذة حوار
نافذةٌ تعلو الصفحة لتأكيد إجراءٍ أو إدخال بيانات.
يعرض v0 بنية المكوّن فقط، من دون ألوان قَطّ وخطوطه ونقوشه.
التثبيت
مدير الحزم
@qatt
pnpm dlx shadcn@latest add @qatt/dialogURL
pnpm dlx shadcn@latest add https://asiri-qatt.rifan.xyz/r/dialog.jsonتنبيه: المكوّنات المُعاد تصميمها تحلّ محلّ ملفاتها في components/ui/. احفظوا تعديلاتكم في git قبل التثبيت.
الاستخدام
import { Dialog } from "@/components/ui/dialog"
<Dialog>
<DialogTrigger render={<Button />}>…</DialogTrigger>
<DialogContent>
<DialogHeader>
<DialogTitle>…</DialogTitle>
</DialogHeader>
</DialogContent>
</Dialog>الخصائص
| الخاصية | النوع | الافتراضي | الوصف |
|---|---|---|---|
DialogContent variant | "default" | "qatt" | "default" | النمط qatt يضيف حدًّا بلون الحبر بسماكة 2px. |
showCloseButton | boolean | true | زرّ إغلاقٍ في جهة نهاية السطر، أي يسارًا في العربية. |
closeLabel | string | "إغلاق" | الاسم الذي تقرؤه التقنيات المساعدة لزرّ الإغلاق. |
DialogContent ornament | "mahareeb" | "rukun" | false | false | إفريزٌ زخرفي بارتفاع 20px على الحافة العليا للنافذة: mahareeb صفٌّ من «المحاريب» وهي أقواسٌ مدبّبة، وrukun صفٌّ من مثلثات «الركون». وينزل زرّ الإغلاق تحت الإفريز. والإفريز زخرفيٌّ لا تقرؤه التقنيات المساعدة. |
ملاحظات الاتجاه
زرّ الإغلاق في جهة نهاية السطر. ويحافظ التذييل على ترتيب shadcn، الإلغاء ثم التأكيد، مع محاذاةٍ إلى النهاية، فيقع زرّ التأكيد يسارًا في العربية عند منتهى مسار القراءة.
سهولة الوصول
العنوان DialogTitle مطلوب. ويذهب التركيز أولًا إلى أوّل حقل، أو إلى الإجراء الآمن حين يكون التأكيد لإجراءٍ يتعذّر التراجع عنه.