هشدار — Toast

تنها نوع هشدار سیستم است. هر هشدار با ، ، یا ارسال می‌شود و محل نمایشش همان است که کاربر در تنظیمات سریع داک ← هشدارها انتخاب کرده: داخل منوی شیشه‌ای داک، یا یکی از چهار گوشهٔ صفحه. دیگر ناحیهٔ جدا، صف جدا یا پیام درون‌صفحه‌ای جدا وجود ندارد؛ همهٔ دکمه‌های نمونه و پلی‌گراند همین یک مدل را استفاده می‌کنند.

وضعیت: beta · لایه: ۳ () · کد: و

TSX

import { toast } from '@tokapps/tuk/feedback';

نمونهٔ زنده

این دکمه‌ها با همان ارسال می‌شوند؛ محل نمایش همان تنظیم سراسری داک است.

پلی‌گراند

وضعیت، متن، آیکون و گزینه‌ها را تغییر دهید و با «ارسال» همان پیام را بفرستید. کد قابل کپی همان ارسال است.

پیکربندی آزمایشی:

وضعیت:

عنوانمتن پیامنوع آیکون

ماندگار (تا بستن دستی)کنش (actionLabel)صدا (sound)

محل نمایش را در تنظیمات سریع داک ← هشدارها تعیین کنید؛ همان محلی که همهٔ دکمه‌های نمونه استفاده می‌کنند.

کد قابل کپی

code

import { toast } from '@tokapps/tuk/feedback';toast.info("به‌روزرسانی", { description: "نسخهٔ جدید برنامه در دسترس است." });

کد قابل کپی

TSX

import { toast } from '@tokapps/tuk/feedback';toast.success('ذخیره شد');toast.error('ارسال ناموفق بود', { description: 'اتصال اینترنت را بررسی کنید.', actionLabel: 'تلاش دوباره', onAction: retry });toast.warning('سهمیهٔ امروز رو به پایان است', { iconKind: 'notification' });toast.info('جلسهٔ شما ۱۰ دقیقهٔ دیگر تمام می‌شود', { timeout: 0 });

TSX

// یک‌بار در ریشهٔ برنامه: محل نمایش را از تنظیم سراسری داک بخوانیدimport { DockAlertHost } from '@tokapps/tuk/dock';<DockAlertHost placement={dockAlertPlacement} />

محل نمایش

تنظیم داک ()	نمایش
	داخل منوی شیشه‌ای داک؛ خودش هشدار را نشان می‌دهد
· · ·	کارت شناور در گوشهٔ انتخابی؛ آن را رندر می‌کند

تغییر محل در تنظیمات سریع داک بلافاصله روی همهٔ هشدارها اعمال می‌شود.

API

گزینه	نوع	پیش‌فرض	توضیح
(آرگومان اول)		—	عنوان هشدار؛ بدون همان متن پیام است
		—	توضیح زیر عنوان
		موفق/اطلاعات/هشدار: زمان‌دار؛ خطا: ماندگار	میلی‌ثانیه؛ = ماندگار تا بستن دستی
/	/	—	کنش؛ پس از کلیک هشدار بسته می‌شود
		—	پس از بسته‌شدن (زمان‌دار، دستی یا با کنش)
	\| \| \| \| \| \| \| \|		نوع آیکون؛ بدون آیکون
/	\| /		صدا (Opt-in و زیر سوییچ صدای کاربر)

با شناسهٔ برگشتی یک هشدار را می‌بندد و همه را.

رفتار و دسترس‌پذیری

پشته: حداکثر ۴ هشدار هم‌زمان؛ جدیدترین در لبه است و قدیمی‌ترها کنار می‌روند.
بستن: زمان‌دار، دکمهٔ بستن، کشیدن کارت به کنار، یا کلید Escape (برای هشدار داک).
صفحه‌خوان: خطا و هشدار با و موفقیت/اطلاعات با اعلام می‌شوند؛ برچسب وضعیت متنی است، نه فقط رنگ.
کاهش حرکت: با یا سوییچ کاهش حرکت، انیمیشن ورود و خروج حذف می‌شود.
چاپ: هشدارها روی کاغذ پنهان می‌شوند.

توکن‌ها

سیال (مشترک): ، ، ، ، .
کامپوننتی: (از جمله ). فایل‌ها: و .
هویت حرکتی: هر تم منحنی ورود و خروج و صدای خودش را دارد ().

نکات

تأیید مسدودکننده: AlertDialog
نبودن محتوا: EmptyState

هشدار — Toast

وضعیت: beta · لایه: ۳ () · کد: و

TSX

import { toast } from '@tokapps/tuk/feedback';

نمونهٔ زنده

این دکمه‌ها با همان ارسال می‌شوند؛ محل نمایش همان تنظیم سراسری داک است.

پلی‌گراند

وضعیت، متن، آیکون و گزینه‌ها را تغییر دهید و با «ارسال» همان پیام را بفرستید. کد قابل کپی همان ارسال است.

پیکربندی آزمایشی:

وضعیت:

عنوانمتن پیامنوع آیکون

ماندگار (تا بستن دستی)کنش (actionLabel)صدا (sound)

محل نمایش را در تنظیمات سریع داک ← هشدارها تعیین کنید؛ همان محلی که همهٔ دکمه‌های نمونه استفاده می‌کنند.

کد قابل کپی

code

import { toast } from '@tokapps/tuk/feedback';toast.info("به‌روزرسانی", { description: "نسخهٔ جدید برنامه در دسترس است." });

کد قابل کپی

TSX

import { toast } from '@tokapps/tuk/feedback';toast.success('ذخیره شد');toast.error('ارسال ناموفق بود', { description: 'اتصال اینترنت را بررسی کنید.', actionLabel: 'تلاش دوباره', onAction: retry });toast.warning('سهمیهٔ امروز رو به پایان است', { iconKind: 'notification' });toast.info('جلسهٔ شما ۱۰ دقیقهٔ دیگر تمام می‌شود', { timeout: 0 });

TSX

// یک‌بار در ریشهٔ برنامه: محل نمایش را از تنظیم سراسری داک بخوانیدimport { DockAlertHost } from '@tokapps/tuk/dock';<DockAlertHost placement={dockAlertPlacement} />

محل نمایش

تنظیم داک ()	نمایش
	داخل منوی شیشه‌ای داک؛ خودش هشدار را نشان می‌دهد
· · ·	کارت شناور در گوشهٔ انتخابی؛ آن را رندر می‌کند

تغییر محل در تنظیمات سریع داک بلافاصله روی همهٔ هشدارها اعمال می‌شود.

API

گزینه	نوع	پیش‌فرض	توضیح
(آرگومان اول)		—	عنوان هشدار؛ بدون همان متن پیام است
		—	توضیح زیر عنوان
		موفق/اطلاعات/هشدار: زمان‌دار؛ خطا: ماندگار	میلی‌ثانیه؛ = ماندگار تا بستن دستی
/	/	—	کنش؛ پس از کلیک هشدار بسته می‌شود
		—	پس از بسته‌شدن (زمان‌دار، دستی یا با کنش)
	\| \| \| \| \| \| \| \|		نوع آیکون؛ بدون آیکون
/	\| /		صدا (Opt-in و زیر سوییچ صدای کاربر)

با شناسهٔ برگشتی یک هشدار را می‌بندد و همه را.

رفتار و دسترس‌پذیری

پشته: حداکثر ۴ هشدار هم‌زمان؛ جدیدترین در لبه است و قدیمی‌ترها کنار می‌روند.
بستن: زمان‌دار، دکمهٔ بستن، کشیدن کارت به کنار، یا کلید Escape (برای هشدار داک).
صفحه‌خوان: خطا و هشدار با و موفقیت/اطلاعات با اعلام می‌شوند؛ برچسب وضعیت متنی است، نه فقط رنگ.
کاهش حرکت: با یا سوییچ کاهش حرکت، انیمیشن ورود و خروج حذف می‌شود.
چاپ: هشدارها روی کاغذ پنهان می‌شوند.

توکن‌ها

سیال (مشترک): ، ، ، ، .
کامپوننتی: (از جمله ). فایل‌ها: و .
هویت حرکتی: هر تم منحنی ورود و خروج و صدای خودش را دارد ().

نکات

تأیید مسدودکننده: AlertDialog
نبودن محتوا: EmptyState