مرور کلی عملکردها
این صفحه فهرست عملکردهای مستندشده در پنل اپادیتور را نشان میدهد. «عملکرد» کاری است که پس از یک رویداد، مانند کلیک روی دکمه یا باز شدن صفحه، اجرا میشود.
کاربردهای عملکردها
عملکردها در اپادیتور برای تبدیل تعامل کاربر یا رویدادهای صفحه به یک اقدام واقعی استفاده میشوند. مهمترین کاربردهای آنها عبارتند از:
- جابهجایی بین صفحات و کنترل مسیر حرکت کاربر در اپ.
- ارسال فرمها، ورود، ثبتنام و مدیریت حساب کاربری.
- پخش رسانه، باز کردن لینک، نمایش پیام و اشتراکگذاری محتوا.
- تغییر مقدار متغیرها و ساخت رفتارهای پویا و هوشمند.
- اتصال اپ به وردپرس، ووکامرس، مارکتها، پرداخت و قابلیتهای دستگاه.
پیشنهاد
برای طراحی منطق اپ، ابتدا رویداد را مشخص کنید، سپس اگر لازم بود شرط بگذارید و در نهایت عملکرد مناسب را انتخاب کنید.
هشدار
از اتصال تعداد زیادی عملکرد سنگین به یک رویداد خودداری کنید؛ این کار میتواند باعث کندی، خطایابی سخت و تجربه کاربری نامناسب شود.
روش استفاده
- ویجت یا صفحه مقصد را انتخاب کنید.
- رویداد مناسب، مانند کلیک، را باز کنید.
- عملکرد را اضافه و مقدارهای ضروری آن را کامل کنید.
- اگر عملکرد فقط در شرایط خاصی باید اجرا شود، برای آن شرط تعریف کنید.
- نتیجه را ابتدا در پیشنمایش و سپس روی پلتفرم واقعی آزمایش کنید.
یادداشت
بعضی عملکردها به قابلیت دستگاه یا یک پلتفرم خاص وابستهاند. برای مثال Intent سفارشی و تنظیم تصویر پسزمینه مخصوص اندروید هستند و ممکن است در پیشنمایش فقط یک پیام آزمایشی نشان دهند.
عمومی
| عملکرد | توضیح کوتاه |
|---|---|
| باز کردن صفحه | این عملکرد یک صفحه را باز میکند و میتواند نحوه باز شدن صفحه را کنترل کند. |
| باز کردن صفحه با متغیر | این عملکرد شناسه صفحه مقصد را هنگام اجرا از یک متغیر میخواند و همان صفحه را باز میکند. |
| باز کردن منوی صفحه | این عملکرد منوی صفحه را باز میکند. |
| پخش ویدئو | این عملکرد برای پخش ویدئو (آفلاین یا آنلاین) استفاده میشود. |
| پخش صدا | این عملکرد برای پخش یک فایل صوتی (آفلاین یا آنلاین) استفاده میشود. |
| باز کردن لینک | این عملکرد یک لینک را باز میکند (داخل اپ یا در مرورگر). |
| اشتراکگذاری متن | این عملکرد یک متن مشخص را به اشتراک میگذارد. |
| اشتراگگذاری فایل | این عملکرد برای اشتراکگذاری یا ذخیره فایلها (ویدئو/صوت/عکس/PDF) استفاده میشود. |
| اشتراکگذاری فایل برنامه | این عملکرد فایل اپلیکیشن را برای دیگران قابل ارسال میکند. |
| جستجو | این عملکرد صفحه مخصوص جستجو در محتوای اپلیکیشن را باز میکند. |
| بازکردن تنظیمات اپ | این عملکرد صفحه تنظیمات دروناپلیکیشن را باز میکند. |
| تنظیم تصویر بهعنوان پشتزمینه | این عملکرد تصویر انتخابشده را بهعنوان تصویر پسزمینه دستگاه اندرویدی تنظیم میکند. |
| ارسال پیامک | این عملکرد صفحه ارسال پیامک گوشی را باز میکند و متن/شماره را وارد میکند. |
| ارسال ایمیل | این عملکرد برنامه ارسال ایمیل روی گوشی کاربر را باز میکند و فیلدهای اصلی را پر میکند. |
| تماس تلفنی | این عملکرد صفحه شمارهگیری تلفن را باز میکند و شماره تعیینشده را وارد میکند. |
| اینتنت سفارشی | این عملکرد برای اجرای Intent سفارشی (اندروید) استفاده میشود. |
| بستن صفحه فعلی | این عملکرد صفحه فعلی را میبندد. |
| ارجاع به یک برنامه در مارکت | این عملکرد کاربر را به صفحه یک اپ در مارکت هدایت میکند. |
| ارجاع به صفحه نظردهی یک برنامه در مارکت | این عملکرد کاربر را به صفحه نظردهی یک اپ در مارکت هدایت میکند. |
| نمایش فایل Pdf | این عملکرد یک فایل PDF را نمایش میدهد (از فایل یا لینک). |
| اشتراکگذاری متنهای صفحه | این عملکرد تمام متنها و مطالب درون صفحه را به اشتراک میگذارد. |
| کپی متنهای صفحه | این عملکرد تمام متنها و مطالب درون صفحه را کپی میکند. |
| خروج از برنامه | این عملکرد برنامه را میبندد. |
| نمایش عکس | این عملکرد یک تصویر را نمایش میدهد (از فایل یا لینک). |
| ارسال اطلاعات فرم | این عملکرد اطلاعات فرم را ارسال میکند و کاربر را به صفحه نتیجه منتقل میکند. |
| پاکسازی اطلاعات فرم | این عملکرد اطلاعات فرم را به حالت اولیه برمیگرداند. |
| نمایش دیالوگ | این عملکرد یک دیالوگ/پیغام را به کاربر نمایش میدهد. |
| بروزرسانی صفحه | این عملکرد آخرین تغییرات منتشر شده را دریافت میکند و صفحه را با داده جدید نمایش میدهد. |
| مدیریت علاقهمندیهای صفحه | این عملکرد یک صفحه دلخواه را به علاقهمندیها اضافه میکند، حذف میکند یا وضعیت آن را سوئیچ میکند. |
حساب کاربری
| عملکرد | توضیح کوتاه |
|---|---|
| ارسال فرم ورود | این عملکرد اطلاعات فرم ورود را ارسال میکند و کاربر را وارد حساب کاربری میکند. |
| ارسال فرم بازیابی رمز | این عملکرد اطلاعات فرم بازیابی رمز (نام کاربری/موبایل/ایمیل) را ارسال میکند. |
| ارسال فرم عضویت | این عملکرد اطلاعات فرم عضویت را ارسال میکند. |
| ورود به صفحه عضویت | این عملکرد صفحه عضویت (ثبتنام) را باز میکند. |
| ورود به صفحه ورود | این عملکرد صفحه ورود را باز میکند. |
| ورود به صفحه بازیابی رمز | این عملکرد صفحه بازیابی رمز را باز میکند. |
| ورود به صفحه پروفایل | این عملکرد صفحه پروفایل/اطلاعات حساب کاربری را باز میکند. |
| خروج از حساب کاربری | این عملکرد کاربر را از حساب کاربری خارج میکند. |
عملکرد چندگانه و کنترل اجرا
| عملکرد | توضیح کوتاه |
|---|---|
| عملکرد چندگانه | این عملکرد یک لیست از عملکردها را اجرا میکند. |
| توقف عملکرد چندگانه | این عملکرد (در داخل لیست عملکرد چندگانه) اجرای عملکردهای بعدی را متوقف میکند. |
| شروع مجدد عملکرد چندگانه | این عملکرد (در داخل لیست عملکرد چندگانه) اجرای لیست را از ابتدا شروع میکند. |
کنترل UI و رسانه
| عملکرد | توضیح کوتاه |
|---|---|
| تغییر یک تب | این عملکرد تب فعال در «گروه تب» را بر اساس شناسه تب تغییر میدهد. |
| تغییر یک اسلاید | این عملکرد اسلاید فعال در «گروه اسلاید» را بر اساس شناسه اسلاید تغییر میدهد. |
| باز یا بستن گروه بازشونده | یک «گروه بازشونده» را بر اساس شناسه آن باز، بسته یا سوئیچ میکند. |
| شروع پخش کننده صوت | این عملکرد پخشکننده صوت را بر اساس شناسه، شروع به پخش میکند. |
| توقف پخش کننده صوت | این عملکرد پخشکننده صوت را بر اساس شناسه متوقف میکند. |
| نمایش پیغام کوتاه | این عملکرد یک پیام کوتاه (Toast) نمایش میدهد که بعد از چند ثانیه محو میشود. |
| کپی از متن | این عملکرد یک متن مشخص را در کلیپبورد دستگاه کپی میکند. |
| بارکد خوان | این عملکرد دوربین/اسکنر بارکد را باز میکند و نتیجه اسکن را در یک متغیر ذخیره میکند. |
| تغییر صفحه اصلی | این عملکرد «صفحه اصلی» اپ را تغییر میدهد. |
| اسکرول به.. | این عملکرد اسکرول صفحه را طوری جابجا میکند که یک ویجت مشخص در دید کاربر قرار بگیرد. |
| تغییر سرعت پخش صدا | این عملکرد سرعت پخش صوت را تغییر میدهد. |
| تغییر تکرار پخش صدا | این عملکرد تعداد تکرار (Repeat) پخش صوت را تنظیم میکند. |
| نمایش، مخفیسازی یا سوئیچ ویجت | وضعیت نمایش یک ویجت در صفحه جاری را با امکان اجرای انیمیشن کنترل میکند. |
| اجرای مجدد انیمیشن ورود ویجت | انیمیشن ورود یک ویجت قابل مشاهده را دوباره از ابتدا اجرا میکند. |
| اجرای انیمیشن خروج و مخفیسازی ویجت | انیمیشن خروج را اجرا میکند و سپس ویجت را مخفی میکند. |
اعلان و یادآوری
| عملکرد | توضیح کوتاه |
|---|---|
| نمایش نوتیفیکیشن محلی | یک اعلان را بلافاصله و بدون نیاز به سرور روی دستگاه کاربر نمایش میدهد. |
| ثبت یادآوری | یک اعلان را برای زمانی در آینده، با امکان تکرار روزانه یا هفتگی، در سیستمعامل ثبت میکند. |
| لغو یادآوری | یک یادآوری ثبتشده را بر اساس کلید آن لغو میکند. |
| لغو همه یادآوریها | تمام اعلانهای زمانبندیشده این اپ را یکجا لغو میکند. |
یادداشت
این عملکردها اعلان محلی میسازند و به اینترنت یا سرور نیاز ندارند. برای ارسال نوتیفیکیشن از پنل یا سرور، به سرویس نوتیفیکیشن مراجعه کنید. اعلان محلی در نسخه فعلی فقط روی Android و iOS پشتیبانی میشود.
متغیرها، زبان، جاوااسکریپت
| عملکرد | توضیح کوتاه |
|---|---|
| ایجاد متغیر | این عملکرد برای ساخت یک متغیر جدید در اپ استفاده میشود. |
| مقدار دهی متغیر | این عملکرد مقدار یک متغیر را تنظیم میکند. |
| کاهش یا افزایش متغیر | این عملکرد مقدار یک متغیر عددی را کم یا زیاد میکند. |
| تغییر وضعیت مقدار بولی | این عملکرد مقدار یک متغیر بولی را بین صحیح/غلط جابجا میکند (Toggle). |
| تغییر رنگ متغیر با انیمیشن | رنگ ذخیرهشده در متغیر و تمام رنگهای متصل به آن را بهصورت انیمیشنی تغییر میدهد. |
| تغییر زبان | این عملکرد زبان اپ را بر اساس شناسه زبان تغییر میدهد. |
| تغییر پوسته | این عملکرد پوسته اپ را روشن، تاریک یا بین این دو حالت جابهجا میکند. |
| اجرای کد جاوااسکریپت | این عملکرد کد JavaScript وارد شده را اجرا میکند و امکان دسترسی به متغیرها، نمایش پیام و اجرای سایر عملکردها از داخل کد را فراهم میکند. |
وردپرس / ووکامرس
| عملکرد | توضیح کوتاه |
|---|---|
| بازکردن یک نوشته وردپرسی | این عملکرد یک نوشته (Post) وردپرسی را باز میکند. |
| بازکردن یک محصول ووکامرس | این عملکرد یک محصول ووکامرس را باز میکند. |
اگر عملکرد اجرا نمیشود
- بررسی کنید عملکرد به رویداد درست متصل و فعال باشد.
- مقدارهای ضروری، مانند صفحه، شناسه ویجت، فایل یا متغیر را متناسب با همان عملکرد کنترل کنید.
- اگر شرط تعریف کردهاید، مقدارهای شرط را در زمان اجرا بررسی کنید.
- تفاوت پیشنمایش با خروجی واقعی را در نظر بگیرید؛ بعضی قابلیتهای دستگاه در مرورگر قابل اجرا نیستند.
- در عملکرد چندگانه، ترتیب اجرا، تأخیر و گزینه انتظار برای پایان هر مرحله را بررسی کنید.