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

التنبيه

احصل على Ritla UI

رسالة داخل الصفحة بجانب ما تخصه، تبقى حتى يتغير الوضع أو يخفيها الشخص: دفعة فشلت، هوية توشك أن تنتهي، استيراد اكتمل.

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

افتح في Figma

المعاينة

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

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

التثبيت

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

    npx ritla add alert

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

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

    @phosphor-icons/react

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

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

الاستخدام

alert.tsx
import { Alert } from "@/components/ui/alert";<Alert type="warning" title="Your ID expires on 12 October" action={{ label: "Upload ID", href: "/id" }}>  Upload a new ID before then to keep sending money.</Alert>

أمثلة

الأنواع ودرجات الظهور

النوع يقول ما الرسالة، والدرجة تقول مدى ارتفاع صوتها: الفاتح لمعظم التنبيهات، والهادئ ليلاحظه الناس، والقوي للمشكلة الحرجة الوحيدة في الصفحة.

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

قابل للإخفاء

‏dismissible للتنبيهات التي تُعلم فقط. عند الإخفاء ينتقل التركيز إلى العنصر التالي. وتذكّر الإخفاء على التطبيق (onDismiss).

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

ملخص أخطاء النموذج

بعد إرسال فاشل يظهر تنبيه خطأ فوق النموذج (announce="alert") وينتقل التركيز إليه، وروابطه تؤدي إلى الحقول. أرسل النموذج فارغًا لتراه.

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

مرجع الخصائص

Alert

الخاصيةالنوعالافتراضيالوصف
type"information" | "success" | "warning" | "error""information"خاصية Type.
emphasis"light" | "subtle" | "intense""light"خاصية Emphasis.
titleReactNodeلا يوجدخاصية Title: ما حدث.
childrenReactNodeلا يوجدخاصية Message: ما يمكن فعله.
iconIconComponent | nullلا يوجدخاصية Show leading icon؛ أيقونة لكل نوع افتراضيًا.
action / link{ label; href?; render?; onClick? }لا يوجدخاصيتا Show Button وShow link.
announce"status" | "alert"لا يوجدللتنبيهات التي تظهر بعد حدث؛ alert للأخطاء العاجلة فقط.
dismissible / dismissLabel / onDismissboolean / string / () => voidلا يوجدخاصية Show dismiss، واسم الزر، وما يحدث عند الإخفاء.

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

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

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

المفتاحما يفعله
Tabإلى الإجراء والرابط وزر الإخفاء؛ بعد الإخفاء ينتقل التركيز إلى العنصر التالي.

ARIA

  • التنبيه الموجود عند تحميل الصفحة جزء منها؛ والذي يظهر بعد حدث يأخذ status، والخطأ العاجل alert.
  • اللون لا يعمل وحده: الأيقونة والعنوان يقولان النوع.
  • لزر الإخفاء اسم («إخفاء»).

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

ينعكس

  • الأيقونة والعنوان والرسالة على اليمين، وزر الإخفاء على اليسار، والإجراءات تبدأ من اليمين.

لا ينعكس

  • أيقونات المعلومات والنجاح والتحذير والخطأ لا تنعكس.
الأرقام
التواريخ والمبالغ والأرقام التعريفية تُقرأ من اليسار إلى اليمين داخل <bdi dir="ltr">.
الخط العربي
العنوان body-14 Semibold والرسالة body-14، والارتفاع حد أدنى.
النص ثنائي الاتجاه
اكتب العنوان والرسالة بالعربية مباشرة، لا ترجمة حرفية.

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

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

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