النافذة الحوارية
توقف سير العمل لتأكيد إجراء أو التنبيه إلى خطر أو جمع مدخل قصير. تظهر فوق طبقة معتمة، ويبقى التركيز داخلها حتى تُغلق.
فحص ريتلا لهذه المعاينة: الفحوص الناجحة: 41 من 41مقاسات العرض: 3تاريخ الفحص:
المعاينة
«معكوس» هو المحتوى الإنجليزي نفسه من اليمين إلى اليسار، ليفصل خطأ الاتجاه عن خطأ الترجمة.
التثبيت
أضف المكوّن
npx ritla add dialogويعمل أيضًا مع shadcn:
npx shadcn@latest add @ritla/dialogالاعتماديات التي يضيفها
@base-ui/react@phosphor-icons/reactأو انسخه يدويًا
التثبيت اليدوي ينسخ مصدر المكوّن إلى مشروعك. المصدر يأتي مع ترخيص Ritla UI، وأداة سطر الأوامر هي الطريق الأقصر إلى الملفات نفسها.
الاستخدام
import { Dialog, DialogActions, DialogClose, DialogContent, DialogHeader, DialogTrigger } from "@/components/ui/dialog";<Dialog> <DialogTrigger render={<Button />}>Send money</DialogTrigger> <DialogContent> <DialogHeader icon={CheckCircleIcon} iconColor="success" title="Transfer sent" description="It usually arrives within a few minutes." /> <DialogActions> <DialogClose render={<Button variant="outline" />}>View receipt</DialogClose> <DialogClose render={<Button />}>Done</DialogClose> </DialogActions> </DialogContent></Dialog>أمثلة
تحذير بتخطيط أفقي
layout="horizontal" يضع الأيقونة بجانب النص بعرض 544 بكسل (size="lg")، وlayout="end" يجمع الأزرار في نهاية السطر. للشاشات العريضة والنصوص القصيرة.
تأكيد الحذف
AlertDialog لما يحذف أو يزيل: دوره alertdialog، ولا يُغلق بالنقر خارجه، ويبدأ التركيز على «إلغاء». العنوان سؤال محدد، والزر الأحمر يكرر الفعل، ورقم البطاقة يبقى من اليسار إلى اليمين.
مهمة قصيرة في نموذج
يبدأ التركيز في الحقل، وEnter يرسل. وdisablePointerDismissal يمنع إغلاقها بنقرة خارجها فلا يضيع ما كُتب.
محتوى طويل
لا تتجاوز النافذة الشاشة: DialogBody يمرّر محتواه ويبقى العنوان والأزرار في مكانهما. هنا فواصل فوق المحتوى وتحته، ومربع اختيار في بداية صف الأزرار.
قائمة داخل النافذة
القوائم المنسدلة التي تُفتح من داخل النافذة تظهر فوقها، في طبقة popover.
ملخص ما يتأثر
DialogSummary يعرض حقائق الإجراء صفوفًا من عنوان وقيمة، أربعة على الأكثر. القيمة في نهاية السطر (اليسار في العربية)، والمبالغ تُنسَّق بـ formatNumber فتتبع إعداد الأرقام، والعملة بعد الرقم في العربية. الرأس على افتراضات Figma: أيقونة بلون العلامة بلا زخرفة.
مرجع الخصائص
Dialog / AlertDialog
| الخاصية | النوع | الافتراضي | الوصف |
|---|---|---|---|
open / defaultOpen / onOpenChange | boolean | لا يوجد | للتحكم في الفتح. |
disablePointerDismissal | boolean | false | لا تُغلق بالنقر خارجها (للنماذج). في AlertDialog دائمًا. |
DialogContent
| الخاصية | النوع | الافتراضي | الوصف |
|---|---|---|---|
size | "sm" | "md" | "lg" | "xl" | "sm" | العرض: 400 للتأكيد، 480، 544 للأفقي، 640 للنماذج. |
breakpoint | "auto" | "desktop" | "mobile" | "auto" | خاصية Breakpoint: في الوسط على الحاسوب، وفي الأسفل على الجوال. |
initialFocus / finalFocus | RefObject<HTMLElement> | لا يوجد | أين يبدأ التركيز وأين يعود. |
DialogHeader
| الخاصية | النوع | الافتراضي | الوصف |
|---|---|---|---|
title | ReactNode | لا يوجد | خاصية Title، وهي اسم النافذة. |
description | ReactNode | لا يوجد | خاصية Description، وهي وصف النافذة. |
icon | IconComponent | لا يوجد | خاصية Featured icon. |
iconColor | "brand" | "gray" | "success" | "warning" | "error" | "brand" | لون حامل الأيقونة (Color). مرّر success لتأكيد نجاح، وerror لما يحذف. |
layout | "stacked" | "centered" | "horizontal" | "stacked" | خاصية Type للرأس. |
closeButton | boolean | true | خاصية X close button. |
closeLabel | string | "Close" | اسم زر الإغلاق، بلغة النافذة افتراضيًا. |
divider | boolean | false | خاصية Divider. |
pattern | boolean | false | خاصية Pattern: الحلقات الزخرفية خلف الأيقونة. |
DialogActions
| الخاصية | النوع | الافتراضي | الوصف |
|---|---|---|---|
children | ReactNode | لا يوجد | الأزرار بترتيب القراءة: الإلغاء ثم التأكيد. |
layout | "fill" | "stacked" | "end" | "fill" | خاصية Type للأزرار. على الجوال تتكدس كلها والتأكيد في الأعلى. |
start | ReactNode | لا يوجد | مربع اختيار أو رابط في بداية الصف (layout="end"). |
divider | boolean | false | خاصية Divider. |
DialogSummary / DialogSummaryRow
| الخاصية | النوع | الافتراضي | الوصف |
|---|---|---|---|
DialogSummary | dl | لا يوجد | بطاقة الملخص داخل DialogBody. أربعة صفوف على الأكثر. |
label | ReactNode | لا يوجد | عنوان الصف (Row label). |
children | ReactNode | لا يوجد | قيمة الصف (Row value). ضع النص اللاتيني داخل العربية في <bdi>. |
DialogBody / DialogTrigger / DialogClose
| الخاصية | النوع | الافتراضي | الوصف |
|---|---|---|---|
DialogBody | div | لا يوجد | المحتوى بين الرأس والأزرار، ويمرَّر عند الحاجة. |
render | ReactElement | لا يوجد | الزر المرئي لـ DialogTrigger وDialogClose. |
إمكانية الوصول
لوحة المفاتيح
المفاتيح مكتوبة للاتجاه من اليسار إلى اليمين. في الاتجاه من اليمين يتبادل السهمان دورهما: السهم المتجه مع اتجاه القراءة ينقلك إلى الأمام.
| المفتاح | ما يفعله |
|---|---|
| TabShift+Tab | بين عناصر النافذة فقط، والصفحة خلفها معطلة. |
| Esc | يغلق النافذة ويعيد التركيز إلى الزر الذي فتحها. |
| Enter | يرسل النموذج داخلها. |
ARIA
- دورها
dialog(أوalertdialogلتأكيد الحذف) معaria-modal، والعنوان اسمها والوصف وصفها. - يبدأ التركيز في أول حقل، أو على «إلغاء» في تأكيد الحذف، ويعود إلى الزر الذي فتحها.
- لزر الإغلاق اسم («إغلاق»). والخطر لا يُعرف باللون الأحمر وحده: العنوان والفعل يقولانه.
- تُفتح في 300 ملّي ثانية وتتلاشى فقط مع تقليل الحركة.
- الملخص قائمة تعريف (
<dl>)، فيقرأ قارئ الشاشة كل عنوان مع قيمته.
ملاحظات العربية والاتجاه
ينعكس
- الأيقونة والنص إلى اليمين، وزر الإغلاق في أعلى اليسار.
- الأزرار تنعكس: «إلغاء» على اليمين والتأكيد على اليسار، في نهاية السطر.
- صفوف الملخص تنعكس: العنوان على اليمين والقيمة على اليسار.
- النافذة تحمل اتجاه المكان الذي كُتبت فيه ولغته، حتى وهي خارج الشجرة.
لا ينعكس
- أيقونات النجاح والتحذير والحذف، والحلقات الزخرفية المتناظرة.
- الأرقام
- المبالغ تتبع إعداد الأرقام؛ أرقام البطاقات تبقى من اليسار إلى اليمين داخل
<bdi dir="ltr">. - الخط العربي
- العنوان
body-18Semibold والوصفbody-14، والأزرارlg. - النص ثنائي الاتجاه
- اكتب العنوان سؤالًا عربيًا محددًا: «إزالة هذه البطاقة؟» لا «هل أنت متأكد؟».
الفحوص التي يجتازها
فحوص ريتلا التي يجتازها هذا المكوّن بطريقة بنائه. إن استُخدم كما هو موثّق، لا يحمل هذه الأخطاء إلى صفحتك.
- text-align: left مضبوطة صراحة على نص عربي في معظمه
- نص مقصوص: محتوى أعرض من صندوقه مع overflow مخفي وبلا علامة حذف
- حاوية بعرض ثابت بالبكسل يتجاوز نصها العربي المساحة
- نص عربي يسقط إلى خط غير الخط المعلن (مقيسًا، أو وفق الإعلان، أو لأن خط الويب فشل في التحميل)
- تباعد حروف مطبَّق على نص عربي (يكسر الخط المتصل)