انتقل إلى المحتوى

النافذة الحوارية

احصل على Ritla UI

توقف سير العمل لتأكيد إجراء أو التنبيه إلى خطر أو جمع مدخل قصير. تظهر فوق طبقة معتمة، ويبقى التركيز داخلها حتى تُغلق.

فحص ريتلا لهذه المعاينة: الفحوص الناجحة: 41 من 41مقاسات العرض: 3تاريخ الفحص:

افتح في Figma

المعاينة

«معكوس» هو المحتوى الإنجليزي نفسه من اليمين إلى اليسار، ليفصل خطأ الاتجاه عن خطأ الترجمة.

المعاينةالكود
إنجليزيمعكوسعربي
← RTL

التثبيت

  1. أضف المكوّن

    npx ritla add dialog

    ويعمل أيضًا مع shadcn: npx shadcn@latest add @ritla/dialog

  2. الاعتماديات التي يضيفها

    @base-ui/react@phosphor-icons/react

  3. أو انسخه يدويًا

    التثبيت اليدوي ينسخ مصدر المكوّن إلى مشروعك. المصدر يأتي مع ترخيص Ritla UI، وأداة سطر الأوامر هي الطريق الأقصر إلى الملفات نفسها.

الاستخدام

dialog.tsx
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" يجمع الأزرار في نهاية السطر. للشاشات العريضة والنصوص القصيرة.

إنجليزيمعكوسعربي
← RTL

تأكيد الحذف

‏AlertDialog لما يحذف أو يزيل: دوره alertdialog، ولا يُغلق بالنقر خارجه، ويبدأ التركيز على «إلغاء». العنوان سؤال محدد، والزر الأحمر يكرر الفعل، ورقم البطاقة يبقى من اليسار إلى اليمين.

إنجليزيمعكوسعربي
← RTL

مهمة قصيرة في نموذج

يبدأ التركيز في الحقل، وEnter يرسل. وdisablePointerDismissal يمنع إغلاقها بنقرة خارجها فلا يضيع ما كُتب.

إنجليزيمعكوسعربي
← RTL

محتوى طويل

لا تتجاوز النافذة الشاشة: DialogBody يمرّر محتواه ويبقى العنوان والأزرار في مكانهما. هنا فواصل فوق المحتوى وتحته، ومربع اختيار في بداية صف الأزرار.

إنجليزيمعكوسعربي
← RTL

قائمة داخل النافذة

القوائم المنسدلة التي تُفتح من داخل النافذة تظهر فوقها، في طبقة popover.

إنجليزيمعكوسعربي
← RTL

ملخص ما يتأثر

‏DialogSummary يعرض حقائق الإجراء صفوفًا من عنوان وقيمة، أربعة على الأكثر. القيمة في نهاية السطر (اليسار في العربية)، والمبالغ تُنسَّق بـ formatNumber فتتبع إعداد الأرقام، والعملة بعد الرقم في العربية. الرأس على افتراضات Figma: أيقونة بلون العلامة بلا زخرفة.

إنجليزيمعكوسعربي
← RTL

مرجع الخصائص

Dialog / AlertDialog

الخاصيةالنوعالافتراضيالوصف
open / defaultOpen / onOpenChangebooleanلا يوجدللتحكم في الفتح.
disablePointerDismissalbooleanfalseلا تُغلق بالنقر خارجها (للنماذج). في AlertDialog دائمًا.

DialogContent

الخاصيةالنوعالافتراضيالوصف
size"sm" | "md" | "lg" | "xl""sm"العرض: 400 للتأكيد، 480، 544 للأفقي، 640 للنماذج.
breakpoint"auto" | "desktop" | "mobile""auto"خاصية Breakpoint: في الوسط على الحاسوب، وفي الأسفل على الجوال.
initialFocus / finalFocusRefObject<HTMLElement>لا يوجدأين يبدأ التركيز وأين يعود.

DialogHeader

الخاصيةالنوعالافتراضيالوصف
titleReactNodeلا يوجدخاصية Title، وهي اسم النافذة.
descriptionReactNodeلا يوجدخاصية Description، وهي وصف النافذة.
iconIconComponentلا يوجدخاصية Featured icon.
iconColor"brand" | "gray" | "success" | "warning" | "error""brand"لون حامل الأيقونة (Color). مرّر success لتأكيد نجاح، وerror لما يحذف.
layout"stacked" | "centered" | "horizontal""stacked"خاصية Type للرأس.
closeButtonbooleantrueخاصية X close button.
closeLabelstring"Close"اسم زر الإغلاق، بلغة النافذة افتراضيًا.
dividerbooleanfalseخاصية Divider.
patternbooleanfalseخاصية Pattern: الحلقات الزخرفية خلف الأيقونة.

DialogActions

الخاصيةالنوعالافتراضيالوصف
childrenReactNodeلا يوجدالأزرار بترتيب القراءة: الإلغاء ثم التأكيد.
layout"fill" | "stacked" | "end""fill"خاصية Type للأزرار. على الجوال تتكدس كلها والتأكيد في الأعلى.
startReactNodeلا يوجدمربع اختيار أو رابط في بداية الصف (layout="end").
dividerbooleanfalseخاصية Divider.

DialogSummary / DialogSummaryRow

الخاصيةالنوعالافتراضيالوصف
DialogSummarydlلا يوجدبطاقة الملخص داخل DialogBody. أربعة صفوف على الأكثر.
labelReactNodeلا يوجدعنوان الصف (Row label).
childrenReactNodeلا يوجدقيمة الصف (Row value). ضع النص اللاتيني داخل العربية في <bdi>.

DialogBody / DialogTrigger / DialogClose

الخاصيةالنوعالافتراضيالوصف
DialogBodydivلا يوجدالمحتوى بين الرأس والأزرار، ويمرَّر عند الحاجة.
renderReactElementلا يوجدالزر المرئي لـ DialogTrigger وDialogClose.

إمكانية الوصول

لوحة المفاتيح

المفاتيح مكتوبة للاتجاه من اليسار إلى اليمين. في الاتجاه من اليمين يتبادل السهمان دورهما: السهم المتجه مع اتجاه القراءة ينقلك إلى الأمام.

المفتاحما يفعله
TabShift+Tabبين عناصر النافذة فقط، والصفحة خلفها معطلة.
Escيغلق النافذة ويعيد التركيز إلى الزر الذي فتحها.
Enterيرسل النموذج داخلها.

ARIA

  • دورها dialog (أو alertdialog لتأكيد الحذف) مع aria-modal، والعنوان اسمها والوصف وصفها.
  • يبدأ التركيز في أول حقل، أو على «إلغاء» في تأكيد الحذف، ويعود إلى الزر الذي فتحها.
  • لزر الإغلاق اسم («إغلاق»). والخطر لا يُعرف باللون الأحمر وحده: العنوان والفعل يقولانه.
  • تُفتح في 300 ملّي ثانية وتتلاشى فقط مع تقليل الحركة.
  • الملخص قائمة تعريف (<dl>)، فيقرأ قارئ الشاشة كل عنوان مع قيمته.

ملاحظات العربية والاتجاه

ينعكس

  • الأيقونة والنص إلى اليمين، وزر الإغلاق في أعلى اليسار.
  • الأزرار تنعكس: «إلغاء» على اليمين والتأكيد على اليسار، في نهاية السطر.
  • صفوف الملخص تنعكس: العنوان على اليمين والقيمة على اليسار.
  • النافذة تحمل اتجاه المكان الذي كُتبت فيه ولغته، حتى وهي خارج الشجرة.

لا ينعكس

  • أيقونات النجاح والتحذير والحذف، والحلقات الزخرفية المتناظرة.
الأرقام
المبالغ تتبع إعداد الأرقام؛ أرقام البطاقات تبقى من اليسار إلى اليمين داخل <bdi dir="ltr">.
الخط العربي
العنوان body-18 Semibold والوصف body-14، والأزرار lg.
النص ثنائي الاتجاه
اكتب العنوان سؤالًا عربيًا محددًا: «إزالة هذه البطاقة؟» لا «هل أنت متأكد؟».

الفحوص التي يجتازها

فحوص ريتلا التي يجتازها هذا المكوّن بطريقة بنائه. إن استُخدم كما هو موثّق، لا يحمل هذه الأخطاء إلى صفحتك.

  • R022text-align: left مضبوطة صراحة على نص عربي في معظمه
  • R042نص مقصوص: محتوى أعرض من صندوقه مع overflow مخفي وبلا علامة حذف
  • R043حاوية بعرض ثابت بالبكسل يتجاوز نصها العربي المساحة
  • R050نص عربي يسقط إلى خط غير الخط المعلن (مقيسًا، أو وفق الإعلان، أو لأن خط الويب فشل في التحميل)
  • R051تباعد حروف مطبَّق على نص عربي (يكسر الخط المتصل)