ویجت امتیازدهی (فرم)
ویجت «امتیازدهی» مجموعهای از ستارهها را برای دریافت یا نمایش امتیاز میسازد. مقدار انتخابشده میتواند در فرم ثبت شود، به یک متغیر متصل باشد و پس از تغییر یک عملکرد را اجرا کند.
کاربردها
- دریافت امتیاز کاربر برای محتوا، خدمات یا یک تجربه.
- ساخت فرم نظرسنجی با امتیاز عددی.
- نمایش امتیاز ثبتشده در حالت فقطنمایش.
- اجرای یک عملکرد بلافاصله پس از تغییر امتیاز.
تنظیمات اصلی
- نام فیلد: نام داخلی فیلد در اطلاعات فرم؛ برای نمونه
rating. - برچسب: عنوانی که بالای ستارهها به کاربر نمایش داده میشود.
- بیشترین امتیاز: تعداد کل ستارهها؛ مقدار قابل انتخاب بین ۱ تا ۱۰ است.
- امتیاز نمایشی در طراحی: مقدار اولیهای که در طراحی و در صورت نبود مقدار متغیر نمایش داده میشود.
- اندازه ستاره: اندازه هر ستاره؛ مقدار قابل تنظیم بین ۱۲ تا ۹۶ است.
- فقط نمایش: لمس ستارهها را غیرفعال میکند و ویجت فقط مقدار فعلی را نشان میدهد.
- اجازه امتیاز خالی: اگر غیرفعال باشد، مقدار صفر نامعتبر است و کاربر باید امتیازی انتخاب کند.
- متن خطای خالی بودن: پیامی که هنگام اجباری بودن امتیاز و انتخابنشدن آن نمایش داده میشود.
- رنگ ستاره فعال: رنگ ستارههای انتخابشده.
- رنگ ستاره غیرفعال: رنگ ستارههای انتخابنشده.
اتصال به متغیر
در «متغیر امتیاز» یک متغیر عددی انتخاب کنید. مقدار معتبر از صفر تا بیشترین امتیاز است و مقادیر خارج از این محدوده به نزدیکترین حد تبدیل میشوند.
سه جهت اتصال در دسترس است:
- فیلد به متغیر: انتخاب کاربر در متغیر نوشته میشود، اما تغییر متغیر روی ویجت اثر نمیگذارد.
- متغیر به فیلد: مقدار متغیر در ویجت نمایش داده میشود، اما انتخاب کاربر متغیر را تغییر نمیدهد.
- همگامسازی دوطرفه: تغییر ویجت و متغیر در هر دو جهت همگام میشود.
اگر متغیر مقدار نداشته باشد، «امتیاز نمایشی در طراحی» بهعنوان مقدار اولیه استفاده میشود.
رویداد تغییر امتیاز
در بخش «رویداد تغییر امتیاز» میتوانید یک عملکرد یا عملکرد چندگانه انتخاب کنید. هنگام لمس یک ستاره:
- مقدار داخلی ویجت تغییر میکند.
- در حالتهای قابلنوشتن، متغیر امتیاز بهروز میشود.
- عملکرد انتخابشده اجرا میشود.
بنابراین عملکرد اجراشده میتواند مقدار جدید امتیاز را از متغیر بخواند.
در حالت «فقط نمایش»، کاربر نمیتواند امتیاز را تغییر دهد و رویداد تغییر نیز با لمس ستارهها اجرا نمیشود.
استفاده در فرم
اگر «اجازه امتیاز خالی» غیرفعال باشد، هنگام ارسال فرم مقدار صفر باعث نمایش خطا میشود. مقدار نهایی با نام تعیینشده در «نام فیلد» در دادههای فرم قرار میگیرد.
نکات طراحی و تست
- برای الگوی رایج امتیازدهی، بیشترین امتیاز را روی ۵ قرار دهید.
- اختلاف رنگ ستاره فعال و غیرفعال باید در تم روشن و تاریک واضح باشد.
- در اندازههای کوچک، فضای لمس هر ستاره را روی دستگاه واقعی بررسی کنید.
- اگر امتیاز از سرور یا متغیر خوانده میشود و قابل ویرایش نیست، گزینه «فقط نمایش» را فعال کنید.
- پیش از انتشار، حالت بدون مقدار، مقدار مرزی و اجرای رویداد تغییر را آزمایش کنید.