الإشعار المنبثق
يؤكد ما حدث للتو دون أن يوقف أحدًا. أضف إجراءً واحدًا مثل «تراجع» أو «إعادة المحاولة» فيصبح شريط إشعار (Snackbar).
فحص ريتلا لهذه المعاينة: الفحوص الناجحة: 41 من 41مقاسات العرض: 3تاريخ الفحص:
المعاينة
«معكوس» هو المحتوى الإنجليزي نفسه من اليمين إلى اليسار، ليفصل خطأ الاتجاه عن خطأ الترجمة.
التثبيت
أضف المكوّن
npx ritla add toastويعمل أيضًا مع shadcn:
npx shadcn@latest add @ritla/toastالاعتماديات التي يضيفها
@base-ui/react@phosphor-icons/reactأو انسخه يدويًا
التثبيت اليدوي ينسخ مصدر المكوّن إلى مشروعك. المصدر يأتي مع ترخيص Ritla UI، وأداة سطر الأوامر هي الطريق الأقصر إلى الملفات نفسها.
الاستخدام
import { Toaster, toast } from "@/components/ui/toast";// Once, in the root layout:<Toaster /> // Anywhere:toast({ message: "Card removed", action: { label: "Undo", onClick: restoreCard } });أمثلة
التراجع
تُزال البطاقة فورًا، و«تراجع» يعيدها. الإشعار الذي فيه إجراء يبقى حتى يُستخدم أو يُخفى، فلا تضيع الفرصة.
الأنواع
Toast يعرض الشكل وحده دون مؤقت. الافتراضي لمعظم التأكيدات، والنجاح والخطأ والتحذير حين تهم النتيجة، والعلامة نادرًا. والتحذير يبقى بألوانه الفاتحة في الوضع الداكن.
مرجع الخصائص
toast()
| الخاصية | النوع | الافتراضي | الوصف |
|---|---|---|---|
message | string | لا يوجد | خاصية Message: ما حدث في سطر، وهو ما يُعلن لقارئ الشاشة. |
type | "default" | "brand" | "success" | "error" | "warning" | "default" | خاصية Type. الخطأ يُعلن فورًا. |
action | { label: string; onClick: () => void } | لا يوجد | خاصية Show action: إجراء واحد يُبقي الإشعار ظاهرًا. |
icon | IconComponent | null | لا يوجد | خاصية Leading icon؛ null لإخفائها. |
dismiss | boolean | true | خاصية Show dismiss. |
timeout | number | 5000 / 0 | بالملّي ثانية؛ صفر (يبقى) حين يكون فيه إجراء. |
toast.dismiss(id?) | function | لا يوجد | يغلق إشعارًا أو كل الإشعارات. |
Toaster
| الخاصية | النوع | الافتراضي | الوصف |
|---|---|---|---|
offset | string | لا يوجد | مسافة إضافية أسفل الإشعارات على الجوال، فوق شريط التنقل. |
Toast
| الخاصية | النوع | الافتراضي | الوصف |
|---|---|---|---|
message / type / icon | ReactNode / ToastType / IconComponent | null | لا يوجد | الشكل وحده، للاستخدام الثابت. |
action / dismiss | ReactNode | لا يوجد | ToastActionButton وToastDismissButton. |
إمكانية الوصول
لوحة المفاتيح
المفاتيح مكتوبة للاتجاه من اليسار إلى اليمين. في الاتجاه من اليمين يتبادل السهمان دورهما: السهم المتجه مع اتجاه القراءة ينقلك إلى الأمام.
| المفتاح | ما يفعله |
|---|---|
| Tab | إلى الإجراء وزر الإخفاء؛ التركيز لا ينتقل إلى الإشعار وحده. |
ARIA
- الإشعار يُعلن بهدوء (
status)، والخطأ بإلحاح (alert)، ويبقى التركيز حيث هو. - يتوقف المؤقت عند المرور أو التركيز، والإشعار الذي فيه إجراء لا يختفي وحده.
- لزر الإخفاء اسم («إخفاء»)، والخطأ لا يُعرف باللون وحده: الرسالة تقوله.
ملاحظات العربية والاتجاه
ينعكس
- الأيقونة والرسالة على اليمين، والإجراء وزر الإخفاء على اليسار.
- على الشاشات الكبيرة تظهر في أسفل بداية الصفحة من جهة النهاية، أي أسفل اليسار.
- كل إشعار يأخذ اتجاه المكان الذي أُطلق منه ولغته.
لا ينعكس
- الإشعار يدخل ويُسحب للأسفل عموديًا في اللغتين.
- الأرقام
- المبالغ في الرسالة تتبع إعداد الأرقام وتُقرأ من اليسار إلى اليمين.
- الخط العربي
- الرسالة
body-14Medium في سطر واحد، وارتفاع الإشعار 48 بكسل على الأقل. - النص ثنائي الاتجاه
- اكتب الرسالة العربية قصيرة كالإنجليزية: «أُزيلت البطاقة».
الفحوص التي يجتازها
فحوص ريتلا التي يجتازها هذا المكوّن بطريقة بنائه. إن استُخدم كما هو موثّق، لا يحمل هذه الأخطاء إلى صفحتك.
- نصوص سمات غير مترجمة (placeholder وalt وtitle وaria-label وقيمة الزر)
- نص مقصوص: محتوى أعرض من صندوقه مع overflow مخفي وبلا علامة حذف
- حاوية بعرض ثابت بالبكسل يتجاوز نصها العربي المساحة
- نص عربي يسقط إلى خط غير الخط المعلن (مقيسًا، أو وفق الإعلان، أو لأن خط الويب فشل في التحميل)
- تباعد حروف مطبَّق على نص عربي (يكسر الخط المتصل)