skill
اسأل Sonner
دليل Sonner، مكتبة React toast — تثبيت وربط Toaster، اختيار استدعاء toast() المناسب، toasts للوعود والتحميل، تحديث وإغلاق واستمرارية ال toasts، التنسيق والمظهر والأيقونات، تحديد المواقع ووجود أكثر من Toaster. استخدمه عند العمل مع Sonner أو استكشاف مشاكله — ال toasts التي لا تظهر، أو تظهر مرتين، أو تفقد أنماطها، أو تتجاهل فئات Tailwind، أو تظهر خلف نافذة منبثقة (modal)، أو لا تتبع الوضع الداكن.
نبذة
# العمل مع Sonner
## الاستجابة الأولية
عند استدعاء هذه المهارة لأول مرة بدون سؤال محدد، استجب فقط بما يلي:
> أنا جاهز لمساعدتك في إعداد Sonner وتصميمه واستكشاف مشكلاته، معرفتي مستمدة من مؤلفه، Emil Kowalski.
لا تقدم أي معلومات أخرى حتى يطرح المستخدم سؤالا.
مهارة إرشادية ل [Sonner](https://sonner.emilkowal.ski)، مكتبة التنبيهات (toast library). عندما تتضمن مهمة Sonner — ربطها، عرض التنبيهات، تصميمها، أو إصلاحها — أجب من هذا الملف أولا. جداول الخصائص الكاملة ل `<Toaster />` و `toast()` موجودة في [API.md](API.md)؛ اقرأها عندما تحتاج إلى اسم خاصية أو نوع أو قيمة افتراضية دقيقة.
## الإعداد
قطعتان، وقطعتان فقط:
1. **مكون `<Toaster />` واحد، يتم تحميله مرة واحدة**، أقرب ما يمكن إلى الجذر (في Next.js: `layout.tsx` — يعمل داخل مكونات الخادم). لا تقم أبدا بعرضه لكل صفحة أو بشكل شرطي؛ وجود Toaster ثان بدون `id` خاص به يكرر كل تنبيه. 2. **`toast()` يتم استدعاؤه من كود العميل** — معالجات الأحداث، التأثيرات، ردود الاتصال. إنها دالة عادية، لا تحتاج إلى hook أو provider، لكنها لا تفعل شيئا على الخادم: في إجراء خادم، أعد النتيجة واستدع `toast()` في كود العميل الذي يستقبلها.
```jsx import { Toaster } from 'sonner'; // مرة واحدة، في layout import { toast } from 'sonner'; // في أي مكان من جانب العميل ```
## اختيار الاستدعاء الصحيح
| ما تريده | الاستدعاء | | --- | --- | | رسالة عادية | `toast('Title')` — أضف `{ description }` لسطر ثان | | أيقونة نجاح / خطأ / معلومات / تحذير | `toast.success('…')`, `toast.error('…')`, إلخ. | | مؤشر تحميل (Spinner) بينما تدير الحالة بنفسك | `toast.loading('…')`، ثم قم بتحديثه بواسطة id | | تحميل ← نجاح/خطأ مرتبط بوعد (promise) | `toast.promise(promise, { loading, success, error })` — النجاح/الخطأ يقبلان دوال تستقبل القيمة المحلولة/الخطأ | | زر يقوم بشيء | `{ action: { label, onClick } }` — يغلق التنبيه ما لم تستدع `onClick` الدالة `event.preventDefault()`؛ `cancel` هو البديل الثانوي | | JSX مخصص، غلاف التنبيه الافتراضي | `toast(<jsx />)` | | JSX مخصص، بدون أي أنماط على الإطلاق | `toast.custom((t) => <jsx />)` — بدون رأس (headless)، `t` يمنحك ال id لإغلاق التنبيه |
## وصفات
**تحديث تنبيه** — استدع `toast()` مرة أخرى بنفس `id`؛ تتغير الخصائص التي تمررها فقط. التبديل إلى `toast.success(…, { id })` يغير النوع. هذه هي كيفية عمل تدفقات التحميل ← النجاح بدون `toast.promise`:
```jsx const id = toast.loading('Uploading…'); toast.success('Uploaded', { id }); ```
**استمرارية** — `{ duration: Infinity }`. **إغلاق** — `toast.dismiss(id)`، أو `toast.dismiss()` للجميع. **قراءة التنبيهات النشطة** — `useSonner()` في React، `toast.getToasts()` خارجها.
**روابط أو مكونات في النص** — مرر دالة للعنوان أو الوصف: `toast(() => <a href="…">View</a>)`.
**أكثر من Toaster واحد** — أعط كل واحد `id` واستهدف باستخدام `toast('…', { toasterId: 'canvas' })`. Toaster ذو `id` يعرض فقط التنبيهات المستهدفة له؛ Toaster بدون `id` يعرض فقط التنبيهات غير المستهدفة.
**ردود اتصال الإغلاق** — `onDismiss` يتم تشغيله عند زر الإغلاق، السحب، أو `toast.dismiss()`؛ `onAutoClose` يتم تشغيله عند انتهاء المهلة. إنهما منفصلان؛ لا يوجد رد اتصال واحد "مغلق".
## التصميم — سلم التصعيد
اصعد فقط بقدر ما يتطلبه التغيير. استثناء: إذا كنت ستضع علامة `!important` على أكثر من بضعة فئات، انتقل مباشرة إلى الوضع "بدون رأس" (headless) — إنه الحالة النهائية الموصى بها.
1. **القيم الافتراضية** — بالإضافة إلى `richColors` على Toaster لألوان النجاح/الخطأ الملونة، `invert` للقلب مقابل السمة. 2. **تعديلات مضمنة** — `toastOptions={{ style: {…} }}` على Toaster لجميع التنبيهات، أو `style` لكل استدعاء `toast()`. 3. **فئات على الأجزاء** — `toastOptions={{ classNames: { toast, title, description, actionButton, cancelButton, closeButton } }}`. الأنماط المحقونة من Sonner تفوز في التتالي، لذا تحتاج كل فئة إلى `!important` (Tailwind: `!text-red-900`). إذا كنت تضع علامة مهمة على أكثر من بضعة أشياء، توقف — انتقل إلى الوضع "بدون رأس". 4. **بدون رأس (Headless)** — `toast.custom()` مع JSX الخاص بك، مع الحفاظ على تحديد المواقع والتكديس والسحب من Sonner. النهج الموصى به لتنبيه نظام التصميم: لفه في تجريد `toast()` الخاص بك. (`unstyled: true` موجود كحل وسط، لكن الوضع "بدون رأس" يمنح تحكما أكبر بنفس الجهد.)
**الأيقونات** — استبدل القيم الافتراضية لكل نوع باستخدام خاصية `icons` في Toaster، لكل تنبيه باستخدام `icon`، أزلها باستخدام `null`.
**السمة (Theme)** — `theme` الافتراضي هو `'light'` ولا يتتبع نظام التشغيل. مرر `theme="system"`، أو اربط مزود السمة الخاص بك: `<Toaster theme={resolvedTheme} />` من `next-themes`.
## استكشاف الأخطاء وإصلاحها
| العرض | السبب ← الإصلاح | | --- | --- | | التنبيه لا يظهر أبدا | لم يتم تحميل `<Toaster />`، أو تم إلغاء تحميله (عرض شرطي، وضع لكل صفحة). قم بتحميل واحد في الجذر. إذا تم الاستدعاء من إجراء خادم: `toast()` خاص بالعميل فقط — استدعه مع نتيجة الإجراء على العميل. | | نفس التنبيه يظهر مرتين | تم تحميل Toasterين (layout **و** page) — احتفظ بواحد. أو تم تشغيل `toast()` في تأثير تحت استدعاء React StrictMode المزدوج في وضع التطوير — قم بالتشغيل من معالج الحدث بدلا من ذلك، أو مرر `id` ثابتا. |
التثبيت
شغل هذا الأمر
npx skills add emilkowalski/skillsيعمل مع
خطوات التثبيت
ثبت باستخدام `npx skills add emilkowalski/skills`، أو استنسخ المستودع وانسخ مجلد `skills/ask-sonner` إلى دليل مهارات Claude الخاص بك.
أسئلة شائعة
ما هي مهارة اسأل Sonner؟
دليل Sonner، مكتبة React toast — تثبيت وربط Toaster، اختيار استدعاء toast() المناسب، toasts للوعود والتحميل، تحديث وإغلاق واستمرارية ال toasts، التنسيق والمظهر والأيقونات، تحديد المواقع ووجود أكثر من Toaster. استخدمه عند العمل مع Sonner أو استكشاف مشاكله — ال toasts التي لا تظهر، أو تظهر مرتين، أو تفقد أنماطها، أو تتجاهل فئات Tailwind، أو تظهر خلف نافذة منبثقة (modal)، أو لا تتبع الوضع الداكن.
كيف أثبت اسأل Sonner؟
شغل هذا الأمر في الطرفية:
npx skills add emilkowalski/skillsمع أي أدوات ذكاء اصطناعي تعمل اسأل Sonner؟
تعمل مع claude_app، claude_code، claude_api، cursor، codex، windsurf، cline، zed.
من طور اسأل Sonner؟
طورها emilkowalski.
هل اسأل Sonner مجانية؟
نعم، يمكنك استخدامها مجانا.
git clone https://github.com/anthropics/skills && cp -r skills/skills/claude-api ~/.claude/skills/
npx skills add mattpocock/skills
npx skills add mattpocock/skills
npx skills add mattpocock/skills
npx skills add mattpocock/skills
npx skills add microsoft/azure-skills
افحص قبل التثبيت
شغل أي مصدر عبر فحوصاتنا - الظهور في الذكاء الاصطناعي والأمان والأداء واكتشاف التقنيات.
مختبر وكلاء الذكاء الاصطناعي
اختبار الذكاء الاصطناعي
فحص أمني تلقائي للموقع
الأمان
اختبار جودة المحتوى العربي بالذكاء الاصطناعي
جودة المحتوى
كاشف منصة الموقع
الترحيل
محلل سرعة الصفحة
الأداء
تدقيق الظهور في محركات الذكاء الاصطناعي
الظهور في الذكاء الاصطناعي
مولد ملف llms.txt
الظهور في الذكاء الاصطناعي
منشئ البيانات المنظمة
الظهور في الذكاء الاصطناعي
مقياس سهولة القراءة بالعربية
جودة المحتوى
حاسبة تكاليف الذكاء الاصطناعي
اختبار الذكاء الاصطناعي
محلل العناوين العربية
جودة المحتوى