کپی متن
این عملکرد یک متن مشخص را در کلیپبورد دستگاه کپی میکند. متن میتواند ثابت باشد یا مقدار متغیرهای اپ را با الگوی {{ناممتغیر}} در خود داشته باشد.
کاربردها
- کپی کردن متن مشخص در کلیپبورد.
- ساخت دکمه کپی برای کد، لینک، شماره یا متن مهم.
- ساخت متن پویا با اطلاعات کاربر، داده صفحه یا متغیرهای سیستمی.
- ساده کردن انتقال اطلاعات توسط کاربر.
تنظیمات
- متن: محتوایی که باید در کلیپبورد قرار گیرد. در این فیلد میتوانید متن ثابت و متغیر را با هم ترکیب کنید.
قرار دادن متغیر در متن
نام متغیر را بین دو آکولاد باز و بسته قرار دهید:
{{myvar}}
برای مثال اگر مقدار متغیر discountCode برابر OFF-25 باشد، متن زیر:
کد تخفیف شما: {{discountCode}}
بهصورت زیر در کلیپبورد کپی میشود:
کد تخفیف شما: OFF-25
میتوانید چند متغیر را در یک متن قرار دهید:
نام: {{sys.user.name}}
موبایل: {{sys.user.mobile}}
کد پیگیری: {{trackingCode}}
مسیرهای تودرتو و آیتمهای آرایه نیز پشتیبانی میشوند:
محصول: {{sys.user.buys[0].name}}
تاریخ انقضا: {{sys.user.buys[0].expiresAtJalali}}
مقدار متغیر درست در لحظه اجرای عملکرد خوانده میشود؛ بنابراین اگر مقدار متغیر تغییر کند، متن کپیشده نیز مقدار جدید را خواهد داشت. وجود فاصله داخل آکولادها مجاز است و {{ myvar }} با {{myvar}} تفاوتی ندارد.
اگر متغیر وجود نداشته باشد یا مقدار آن null باشد، جای آن متن خالی قرار میگیرد. برای جلوگیری از خروجی ناقص، در صورت لزوم قبل از اجرای عملکرد شرط مناسب تعریف کنید.
اگر مقدار متغیر یک لیست یا آبجکت باشد، مقدار آن به شکل JSON در متن قرار میگیرد. برای گرفتن یک فیلد مشخص، بهتر است مسیر کامل آن فیلد را وارد کنید.
مراحل ساخت دکمه کپی پویا
- یک دکمه یا ویجت قابل کلیک انتخاب کنید.
- در رویداد کلیک، عملکرد «کپی از متن» را اضافه کنید.
- در فیلد متن، محتوای دلخواه را همراه با الگوی متغیر وارد کنید؛ برای مثال
کد شما: {{myvar}}. - مقدار متغیر را قبل از اجرای عملکرد تنظیم کنید.
- اپ را روی دستگاه اجرا و متن موجود در کلیپبورد را بررسی کنید.
نکات تکمیلی
- این عملکرد را به رویدادی وصل کنید که از نظر کاربر قابل پیشبینی باشد؛ برای مثال کلیک دکمه، باز شدن صفحه یا تکمیل فرم.
- نام متغیر باید دقیقاً مطابق نام تعریفشده در اپ باشد.
- برای متغیرهای سیستمی پیشوند کامل
sys.را وارد کنید. - اگر به داده صفحه جاری نیاز دارید، میتوانید از مسیرهایی مانند
{{sys.inPage.data.title}}استفاده کنید. - در سناریوهای حساس، برای جلوگیری از اجرای ناخواسته از شرط مناسب استفاده کنید.
- نتیجه کپی را روی دستگاه واقعی آزمایش کنید.
خطاهای رایج
- جا انداختن یکی از آکولادها؛ قالب صحیح
{{myvar}}است. - استفاده از نام اشتباه یا متغیری که هنوز مقداردهی نشده است.
- نوشتن مسیر ناقص برای دادههای تودرتو یا آرایهها.
- اتصال عملکرد به رویداد اشتباه یا تکراری.
- اجرای کپی قبل از عملکردی که مقدار متغیر را تنظیم میکند.