نمایش پیغام کوتاه
این عملکرد یک پیام کوتاه (Toast) نمایش می‌دهد که بعد از چند ثانیه محو می‌شود. متن پیام می‌تواند با قالب {{نام‌متغیر}} پویا شود.
کاربردها
- نمایش پیام کوتاه و سریع به کاربر.
- اطلاع‌رسانی موفقیت، خطا یا هشدار بدون باز کردن دیالوگ.
- استفاده بعد از عملیات‌هایی مثل کپی، ارسال یا ذخیره.
- نمایش نتیجه عملیات همراه با نام، کد یا مقدار تولیدشده.
تنظیمات
- متن پیغام: متنی که برای چند ثانیه نمایش داده می‌شود؛ متن ثابت و متغیر قابل ترکیب هستند.
استفاده از متغیر در پیام
برای قرار دادن مقدار متغیر، نام آن را بین دو آکولاد بنویسید:
{{sys.user.name}}، اطلاعات شما ذخیره شد.
کد پیگیری: {{trackingCode}}
مقدار متغیر هنگام نمایش پیام خوانده می‌شود. متغیرهای سیستمی، داده صفحه و مسیرهای تو‌در‌تو نیز پشتیبانی می‌شوند:
محصول {{sys.inPage.data.name}} به سبد اضافه شد.
{{ myvar }} و {{myvar}} یکسان هستند. متغیر ناموجود یا دارای مقدار null با متن خالی جایگزین می‌شود.
مراحل ساخت پیام پویا
- عملکرد «نمایش پیغام کوتاه» را بعد از عملیات موردنظر اضافه کنید.
- متن پیام را وارد کنید.
- مقدار پویا را با قالب
{{myvar}}در متن قرار دهید. - ترتیب عملکرد‌ها را طوری تنظیم کنید که متغیر قبل از نمایش پیام مقداردهی شود.
- پیام را با مقدارهای مختلف آزمایش کنید.
نکات تکمیلی
- این عملکرد را به رویدادی وصل کنید که از نظر کاربر قابل پیش‌بینی باشد؛ برای مثال کلیک دکمه، باز شدن صفحه یا تکمیل فرم.
- متن پیام را کوتاه و خوانا نگه دارید.
- برای متغیر سیستمی، نام کامل را با پیشوند
sys.وارد کنید. - در سناریوهای حساس، برای جلوگیری از اجرای ناخواسته از شرط مناسب استفاده کنید.
- اگر متغیر ممکن است خالی باشد، پیش از اجرا شرط مناسب قرار دهید.
خطاهای رایج
- قالب ناقص یا نام اشتباه متغیر.
- نمایش پیام قبل از مقداردهی متغیر.
- اتصال عملکرد به رویداد اشتباه یا تکراری.