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

الإشعار المنبثق

احصل على Ritla UI

يؤكد ما حدث للتو دون أن يوقف أحدًا. أضف إجراءً واحدًا مثل «تراجع» أو «إعادة المحاولة» فيصبح شريط إشعار (Snackbar).

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

افتح في Figma

المعاينة

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

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

التثبيت

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

    npx ritla add toast

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

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

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

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

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

الاستخدام

toast.tsx
import { Toaster, toast } from "@/components/ui/toast";// Once, in the root layout:<Toaster /> // Anywhere:toast({ message: "Card removed", action: { label: "Undo", onClick: restoreCard } });

أمثلة

التراجع

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

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

الأنواع

‏Toast يعرض الشكل وحده دون مؤقت. الافتراضي لمعظم التأكيدات، والنجاح والخطأ والتحذير حين تهم النتيجة، والعلامة نادرًا. والتحذير يبقى بألوانه الفاتحة في الوضع الداكن.

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

مرجع الخصائص

toast()

الخاصيةالنوعالافتراضيالوصف
messagestringلا يوجدخاصية Message: ما حدث في سطر، وهو ما يُعلن لقارئ الشاشة.
type"default" | "brand" | "success" | "error" | "warning""default"خاصية Type. الخطأ يُعلن فورًا.
action{ label: string; onClick: () => void }لا يوجدخاصية Show action: إجراء واحد يُبقي الإشعار ظاهرًا.
iconIconComponent | nullلا يوجدخاصية Leading icon؛ null لإخفائها.
dismissbooleantrueخاصية Show dismiss.
timeoutnumber5000 / 0بالملّي ثانية؛ صفر (يبقى) حين يكون فيه إجراء.
toast.dismiss(id?)functionلا يوجديغلق إشعارًا أو كل الإشعارات.

Toaster

الخاصيةالنوعالافتراضيالوصف
offsetstringلا يوجدمسافة إضافية أسفل الإشعارات على الجوال، فوق شريط التنقل.

Toast

الخاصيةالنوعالافتراضيالوصف
message / type / iconReactNode / ToastType / IconComponent | nullلا يوجدالشكل وحده، للاستخدام الثابت.
action / dismissReactNodeلا يوجد‏ToastActionButton وToastDismissButton.

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

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

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

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

ARIA

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

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

ينعكس

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

لا ينعكس

  • الإشعار يدخل ويُسحب للأسفل عموديًا في اللغتين.
الأرقام
المبالغ في الرسالة تتبع إعداد الأرقام وتُقرأ من اليسار إلى اليمين.
الخط العربي
الرسالة body-14 Medium في سطر واحد، وارتفاع الإشعار 48 بكسل على الأقل.
النص ثنائي الاتجاه
اكتب الرسالة العربية قصيرة كالإنجليزية: «أُزيلت البطاقة».

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

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

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