پرش به مطلب اصلی

نمایش دیالوگ

این عملکرد یک دیالوگ/پیغام را به کاربر نمایش می‌دهد. عنوان، شرح و متن دکمه می‌توانند شامل متغیرهایی با قالب {{نام‌متغیر}} باشند.

کاربردها​

  • نمایش پیام، تأییدیه یا محتوای کوتاه در دیالوگ.
  • گرفتن تأیید کاربر قبل از انجام عملیات مهم.
  • نمایش توضیح بدون ترک صفحه فعلی.
  • نمایش اطلاعات اختصاصی کاربر یا داده همان صفحه.
فرم تنظیمات عملکرد «نمایش دیالوگ»
فرم تنظیمات عملکرد «نمایش دیالوگ» در پنل اپ‌ادیتور.

تنظیمات​

  • عنوان پیام: عنوان بالای دیالوگ.
  • شرح پیام: متن اصلی دیالوگ.
  • عنوان دکمه بستن: متن دکمه‌ای که دیالوگ را می‌بندد.

استفاده از متغیرها​

در هر سه فیلد می‌توانید متن ثابت و متغیر را ترکیب کنید. برای مثال:

عنوان پیام: سلام {{sys.user.name}}
شرح پیام: اعتبار شما {{credit}} تومان است.
عنوان دکمه: متوجه شدم {{sys.user.name}}

مقادیر درست پیش از نمایش دیالوگ خوانده می‌شوند. متغیرهای سیستمی، داده صفحه و مسیرهای تو‌در‌تو نیز قابل استفاده‌اند:

محصول: {{sys.inPage.data.name}}
انقضا: {{sys.user.buys[0].expiresAtJalali}}

قالب {{ myvar }} نیز معتبر است. اگر متغیر وجود نداشته باشد یا مقدار آن null باشد، جای آن متن خالی نمایش داده می‌شود.

مراحل ساخت دیالوگ پویا​

  1. عملکرد «نمایش دیالوگ» را به رویداد موردنظر اضافه کنید.
  2. عنوان، شرح و متن دکمه را وارد کنید.
  3. در هر فیلد موردنیاز، متغیر را با قالب {{myvar}} قرار دهید.
  4. اگر وجود مقدار الزامی است، پیش از نمایش دیالوگ یک شرط اضافه کنید.
  5. دیالوگ را با مقدارهای مختلف متغیر آزمایش کنید.

نکات تکمیلی​

  • این عملکرد را به رویدادی وصل کنید که از نظر کاربر قابل پیش‌بینی باشد؛ برای مثال کلیک دکمه، باز شدن صفحه یا تکمیل فرم.
  • متغیر در هر یک از سه فیلد به‌صورت مستقل جایگزین می‌شود.
  • برای دسترسی به فیلدهای آبجکت یا آرایه، مسیر کامل را وارد کنید.
  • در سناریوهای حساس، برای جلوگیری از اجرای ناخواسته از شرط مناسب استفاده کنید.
  • متن‌های طولانی و مقدارهای خالی را نیز آزمایش کنید.

خطاهای رایج​

  • جا انداختن یکی از آکولادهای قالب {{myvar}}.
  • استفاده از نام متغیر اشتباه یا مسیر ناقص.
  • اتصال عملکرد به رویداد اشتباه یا تکراری.
  • نمایش دیالوگ قبل از مقداردهی متغیرهای موردنیاز.