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