skill

اسأل Sonner

دليل Sonner، مكتبة React toast — تثبيت وربط Toaster، اختيار استدعاء toast() المناسب، toasts للوعود والتحميل، تحديث وإغلاق واستمرارية ال toasts، التنسيق والمظهر والأيقونات، تحديد المواقع ووجود أكثر من Toaster. استخدمه عند العمل مع Sonner أو استكشاف مشاكله — ال toasts التي لا تظهر، أو تظهر مرتين، أو تفقد أنماطها، أو تتجاهل فئات Tailwind، أو تظهر خلف نافذة منبثقة (modal)، أو لا تتبع الوضع الداكن.

emilkowalski182,561+ تثبيتموثوق

نبذة

# العمل مع 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

يعمل مع

claude appclaude codeclaude apicursorcodexwindsurfclinezed

خطوات التثبيت

ثبت باستخدام `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 مجانية؟

نعم، يمكنك استخدامها مجانا.

أصول ذات صلة

مختارات أخرى في التطوير والبرمجة.

كل بدائل اسأل Sonner ←
skillclaude_appclaude_codeclaude_api
git clone https://github.com/anthropics/skills && cp -r skills/skills/claude-api ~/.claude/skills/
واجهة برمجة تطبيقات Claude
مرجع ل Claude API / Anthropic SDK — معرفات النماذج، التسعير، المعاملات (params)، البث (streaming)، استخدام الأدوات، MCP، الوكلاء (agents)، التخزين الم…★ 4.8 · 2,500+
skillclaude_appclaude_codeclaude_api
npx skills add mattpocock/skills
تطوير مدفوع بالاختبار
التطوير الموجه بالاختبار. يستخدم عندما يرغب المستخدم في بناء ميزات أو إصلاح أخطاء بأسلوب "الاختبار أولا"، أو يذكر "red-green-refactor"، أو يريد اختبار…1,046,962+
skillclaude_appclaude_codeclaude_api
npx skills add mattpocock/skills
الشواء
استجوب المستخدم بلا هوادة حول خطة أو قرار أو فكرة. استخدم هذا عندما يرغب المستخدم في اختبار مدى متانة تفكيره، أو يستخدم أي عبارات تحفيزية مثل "استجوبن…1,041,607+
skillclaude_appclaude_codeclaude_api
npx skills add mattpocock/skills
مراجعة الكود
راجع التغييرات منذ نقطة ثابتة (commit، فرع، وسم، أو merge-base) على محورين: المعايير (هل يتبع الكود معايير الترميز الموثقة لهذا المستودع؟) والمواصفات…840,484+
skillclaude_appclaude_codeclaude_api
npx skills add mattpocock/skills
تشخيص الأخطاء
حلقة تشخيص للأخطاء الصعبة وتراجعات الأداء. تستخدم عندما يقول المستخدم "شخص/صحح هذا"، أو يبلغ عن شيء معطل/يصدر أخطاء/فاشل/بطيء.746,030+
skillclaude_appclaude_codeclaude_api
npx skills add microsoft/azure-skills
تحضير Azure
تحضير مشاريع Azure القائمة على azd للنشر: ينشئ ملفات azure.yaml، والبنية التحتية (Bicep/Terraform)، وDockerfiles لسير عمل Azure Developer CLI (azd). ي…692,720+

افحص قبل التثبيت

شغل أي مصدر عبر فحوصاتنا - الظهور في الذكاء الاصطناعي والأمان والأداء واكتشاف التقنيات.

المزيد في التطوير والبرمجة