إشعار منبثق
تنبيهٌ قصير يظهر برفق ثم يمضي، ليُخبرك بما تمّ.
يعرض v0 بنية المكوّن فقط، من دون ألوان قَطّ وخطوطه ونقوشه.
التثبيت
مدير الحزم
@qatt
pnpm dlx shadcn@latest add @qatt/sonnerURL
pnpm dlx shadcn@latest add https://asiri-qatt.rifan.xyz/r/sonner.jsonتنبيه: المكوّنات المُعاد تصميمها تحلّ محلّ ملفاتها في components/ui/. احفظوا تعديلاتكم في git قبل التثبيت.
الاستخدام
import { Toaster } from "@/components/ui/sonner"
<Toaster />
toast.success("…")الخصائص
| الخاصية | النوع | الافتراضي | الوصف |
|---|---|---|---|
position | ToasterProps["position"] | bottom-left (RTL) / bottom-right (LTR) | يظهر افتراضيًا في الركن السفلي من جهة نهاية السطر. |
dir | "ltr" | "rtl" | "auto" | from useDirection() | يُمرَّر إلى sonner كما هو. |
ornament | "hanash" | false | false | القيمة hanash تضيف خطًّا متعرّجًا من «الحنش» بعرض 4px على حافة بداية السطر في الإشعار، أي يمينه في العربية. ويتلوّن بنوع الإشعار: الأحمر للخطأ، والأزرق للمعلومة، والأخضر للنجاح، والبرتقالي للتحذير، ولون الحبر لغيرها. ويبقى النوع مفهومًا من الأيقونة والنص، فلا يكون اللون الدليل الوحيد. |
ملاحظات الاتجاه
يظهر الإشعار في الركن السفلي الأيسر في العربية، والأيمن في الإنجليزية، ويُمرَّر dir إلى Toaster. والسحب للإغلاق يكون نحو جهة نهاية السطر.
سهولة الوصول
يُعلَن الإشعار عبر منطقةٍ حيّة (live region)، ويُعرف نوعه بالأيقونة والنص معًا، لا بلون الشريط وحده.