On this page
code
المظهر
يتيح عمود appearance في rtSurvey تخصيص العرض المرئي وسلوك الأسئلة في استطلاعاتك. تُحسّن هذه الميزة تجربة المستخدم ويمكنها تحسين كفاءة جمع البيانات بشكل ملحوظ. يدعم rtSurvey سمات المظهر القياسية لـ XLSForm ويمدّها بخيارات إضافية.
سمات المظهر القياسية لـ XLSForm
يدعم rtSurvey سمات المظهر القياسية التالية لـ XLSForm:
| سمة المظهر | أنواع الأسئلة | الوصف |
|---|---|---|
| multiline | text | ينشئ مربع نص متعدد الأسطر (الأفضل لعملاء الويب) |
| minimal | select_one, select_multiple | يعرض الخيارات في قائمة منسدلة |
| quick | select_one | يتقدم تلقائياً إلى السؤال التالي بعد الاختيار (للجوال فقط) |
| no-calendar | date | يُخفي عرض التقويم (للجوال فقط) |
| month-year | date | يتيح اختيار الشهر والسنة فقط |
| year | date | يتيح اختيار السنة فقط |
| horizontal-compact | select_one, select_multiple | يعرض الخيارات أفقياً (للويب فقط) |
| horizontal | select_one, select_multiple | يعرض الخيارات أفقياً في أعمدة (للويب فقط) |
| likert | select_one | يعرض الخيارات كمقياس Likert |
| compact | select_one, select_multiple | يعرض الخيارات جنباً إلى جنب مع حشو أدنى |
| quickcompact | select_one | يجمع العرض المدمج مع التقدم التلقائي (للجوال فقط) |
| field-list | groups | يعرض المجموعة بأكملها على شاشة واحدة (للجوال فقط) |
| label | select_one, select_multiple | يعرض تسميات الخيارات بدون إدخالات |
| list-nolabel | select_one, select_multiple | يعرض الإدخالات بدون تسميات (استخدمه مع label) |
| table-list | groups | يعرض الأسئلة في تنسيق جدول |
| signature | image | يُتيح التقاط التوقيع (للجوال فقط) |
| draw | image | يتيح الرسم الحر (للجوال فقط) |
| map, quick map | select_one, select_one_from_file | يُتيح الاختيار من ميزات الخريطة |
أفضل الممارسات لاستخدام المظهر
- الاتساق: استخدم سمات المظهر باتساق عبر استطلاعك للحصول على مظهر موحّد.
- الجوال مقابل الويب: ضع في الاعتبار كيفية عرض المظاهر على الأجهزة والمنصات المختلفة.
- الأداء: كن حذراً مع سمات المظهر التي قد تُبطئ تحميل النموذج (مثل
table-listللمجموعات الكبيرة). - تجربة المستخدم: اختر المظاهر التي تجعل إدخال البيانات أسهل وأكثر سهولة للمستجيبين.
- الاختبار: اختبر نموذجك دائماً على الأجهزة المستهدفة للتأكد من أن المظاهر تعمل كما هو متوقع.
التقنيات المتقدمة
الجمع بين المظاهر
يمكن الجمع بين بعض سمات المظهر للحصول على تخطيطات أكثر تعقيداً:
| type | name | label | appearance |
|------|------|-------|------------|
| select_one options | choice | Select one: | minimal compact |
المظاهر الديناميكية
يتيح rtSurvey تغيير المظهر ديناميكياً بناءً على منطق النموذج:
| type | name | label | appearance | relevant |
|------|------|-------|------------|----------|
| text | time | Enter time: | inline-[%H:%M] | ${show_time} = 'yes' |
اعتبارات التطبيق المحمول
- بعض المظاهر (مثل
quickوsignature) خاصة بالأجهزة المحمولة. - اختبر جيداً على كل من Android وiOS لضمان السلوك المتسق.
سمات المظهر الموسّعة لـ rtSurvey
بالإضافة إلى مظاهر XLSForm القياسية، يدعم rtSurvey الخيارات الخاصة بالمنصة التالية:
التحكم في البيانات والعرض
| سمة المظهر | أنواع الأسئلة | الوصف |
|---|---|---|
invisible | أي نوع | يُخفي الحقل من العرض مع الاستمرار في جمع قيمته أو حسابها. يختلف عن نوع hidden — فالحقل لا يزال يشارك في المنطق. |
displaytitle | أي نوع | يفرض عرض تسمية/عنوان الحقل حتى عندما يتم إخفاؤه عادةً. |
autopull | select_one, select_multiple | يجلب تلقائياً بيانات خارجية لتعبئة الخيارات عند تحميل النموذج أو تغيير حقل مشغّل. |
floating_hint | text, integer, decimal | يعرض نص التلميح كتسمية عائمة فوق حقل الإدخال بدلاً من أدناه. |
calculate-button | calculate | يضيف زراً مرئياً يُطلق إعادة حساب الحقل عند الطلب، بدلاً من الحساب التلقائي. |
التخطيط
| سمة المظهر | أنواع الأسئلة | الوصف |
|---|---|---|
1screen | group | يفرض عرض المجموعة بأكملها على شاشة واحدة بغض النظر عن حجم المجموعة. |
columns(n) | select_one, select_multiple | يعرض الخيارات في n أعمدة. مثال: columns(3) يعرض ثلاثة أعمدة من أزرار الاختيار. |
gridformat<row=R col=C colspan=S align=center> | أي نوع | يضع الحقل في تخطيط CSS-grid في الصف R، العمود C، يمتد S أعمدة. يُستخدم مع advanced-extension/grid-layout. |
ignore-simplify | أي نوع | يوجّه مُصيّر النموذج لتجاهل التبسيط أو الضغط التلقائي لتخطيط هذا الحقل. |
الأدوات
| سمة المظهر | أنواع الأسئلة | الوصف |
|---|---|---|
likert | select_one | يعرض الخيارات كصف مقياس Likert (مدرج بالفعل في الجدول القياسي أعلاه؛ مؤكد الدعم). |
distress | select_one | يُصيّر الخيارات كأداة بصرية لمقياس الضائقة النفسية لـ Kessler (K10) مع أيقونات عاطفية. |
تكامل API
| سمة المظهر | أنواع الأسئلة | الوصف |
|---|---|---|
callapi | text, integer, decimal, select_one | يُتيح تكامل استدعاء API لهذا الحقل. يجب أن يحتوي عمود calculation على تعبير callapi(). راجع Call API. |
callapi-verify(params) | text, integer, decimal | يُطلق استدعاء تحقق API باستخدام معلمات ثابتة. يحظر النموذج التقدم حتى يؤكد API القيمة. |
callapi-verify(dynamicParams) | text, integer, decimal | نفس callapi-verify ولكن مع معلمات مشتقة من قيم الحقول الأخرى في وقت التشغيل. |
تنسيق التاريخ/الوقت المضمّن
للحقول من نوع date وtime وdatetime، يمكنك تحديد تنسيق عرض مخصص باستخدام سلسلة التنسيق المُلحقة بالمظهر:
inline-[%d/%m/%Y]
inline-1line-[%d/%m/%Y %H:%M]
رموز التنسيق هي نفسها format-date() وformat-date-time(). راجع الدوال — دوال التاريخ والوقت.
مثال:
| type | name | label | appearance |
|---|---|---|---|
| datetime | event_time | Event date and time | inline-[%d/%m/%Y %I:%M %p] |
| date | birth_date | Date of birth | inline-[%d/%m/%Y] |
القيود المعروفة
- قد لا تُصيَّر المظاهر المعقدة بشكل متطابق عبر جميع المنصات.
- قد لا تكون بعض مظاهر rtSurvey المتقدمة مدعومة في وضع عدم الاتصال.
استكشاف مشكلات المظهر
- المظهر غير مطبّق: تحقق من الأخطاء الإملائية في عمود appearance.
- التصيير غير المتسق: تحقق من التوافق مع نوع السؤال والمنصة.
- مشكلات الأداء: ضع في الاعتبار تبسيط المظاهر المعقدة، خاصةً للاستطلاعات الكبيرة.
هل كانت هذه الصفحة مفيدة؟