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

Toast

طابور إشعارات قصيرة الظهور.

المتصفحات
Chrome 114+Firefox 125+Safari 17+
الفئة
1
الحجم المضغوط
2.41 kB
ميزانية التخطيط القسري
0 ms
ميزانية axe
0
متوافق مع SSR
نعم
العقد المنشور
بيئة الاختبار

المختبر

Toast

إطار العرض

API

Toast.Provider

الخاصيةالنوعافتراضيالوصف
limitnumber3أقصى عدد إشعارات عابرة في الطابور؛ وتُحذف الأقدم.
childrenReactNode—الشجرة التي يمكنها استدعاء useToast وعرض إطار عرض.

Toast.Viewport

الخاصيةالنوعافتراضيالوصف
aria-labelstring—اسم المنطقة التي تضم طابور الإشعارات العابرة للتقنيات المساعدة.
classNamestring—الفئة المطبّقة على عنصر إطار العرض.
popover"manual"—يعيّنه إطار العرض الحي على العميل لوضع الطابور المعروض في الطبقة العليا؛ ويتركه هيكل الخادم دون تعيين.
refRef<HTMLElement>—مرجع إلى عنصر إطار العرض.
childrenReactNode—محتوى إضافي يُعرض داخل إطار العرض مع الإشعارات العابرة في الطابور.

Toast.Root

الخاصيةالنوعافتراضيالوصف
toast*ToastRecord—السجل المطلوب عرضه من الطابور، مع معرّفه المحلول وعنوانه ووصفه وإجرائه ومدته وأولويته.

Toast.Title

الخاصيةالنوعافتراضيالوصف
classNamestring—الفئة المطبّقة على عنصر العنوان.
childrenReactNode—محتوى العنوان.

Toast.Description

الخاصيةالنوعافتراضيالوصف
classNamestring—الفئة المطبّقة على عنصر الوصف.
childrenReactNode—محتوى الوصف.

Toast.Action

الخاصيةالنوعافتراضيالوصف
classNamestring—الفئة المطبّقة على زر الإجراء.
onClick(event: MouseEvent<HTMLButtonElement>) => void—تُستدعى عند النقر على زر الإجراء.
childrenReactNode—محتوى زر الإجراء.

Toast.Close

الخاصيةالنوعافتراضيالوصف
classNamestring—الفئة المطبّقة على زر الإغلاق.
onClick(event: MouseEvent<HTMLButtonElement>) => void—تُستدعى عند النقر على زر الإغلاق.
childrenReactNode—محتوى زر الإغلاق.

useToast().toast(input)

الخاصيةالنوعافتراضيالوصف
titleReactNode—سطر عنوان الإشعار العابر.
descriptionReactNode—سطر مساعد تحت العنوان.
action{ label: ReactNode; onClick: () => void }—تسمية ومعالج لزر إجراء واحد على الإشعار العابر.
durationnumber4000المدة بالمللي ثانية قبل إغلاق الإشعار العابر تلقائيًا؛ وتبقيه قيمة صفر أو أقل حتى يُغلق.
priority"polite" | "assertive""polite"المنطقة الحية التي تعلن الإشعار العابر.
idstring—معرّف الإشعار العابر؛ يُولّد عند حذفه.

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

المفتاحالإجراء
Tabتركيز أزرار الإجراءات داخل الإشعار العابر
Escapeالإغلاق حين يكون متاحًا

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

إعلانات المنطقة الحية بنمط polite أو assertive؛ لا تنقل الإضافة إلى الطابور التركيز، ويوقف التحويم أو التركيز الإغلاق التلقائي مؤقتًا.

نقاط التنسيق

data-statedata-part="item"data-part="title"data-part="description"data-part="action"data-part="close"
تُرجمت هذه الصفحة آليًا ولم تُراجع بعد.