النص
نوع سؤال النص الحر في rtSurvey
يجمع نوع سؤال text استجابة نصية حرة — أي سلسلة من الأحرف. وهو النوع الأكثر مرونة للإدخال ويُستخدم للأسماء والعناوين والأوصاف والرموز وأي شيء لا يناسب نوعاً أكثر تحديداً.
يمتد rtSurvey أيضاً text بـ أدوات إدخال الوقت التي تتيح إدخالاً دقيقاً للوقت باستخدام منتقي الساعة.
مواصفة XLSForm الأساسية
| type | name | label |
|---|---|---|
| text | respondent_name | Full name of respondent |
| text | address | Home address |
لمزيد من التفاصيل حول نوع النص القياسي في XLSForm، راجع مواصفة XLSForm.
الاستخدامات
تُستخدم أسئلة النص لـ:
- الأسماء والعناوين والأوصاف الحرة
- التعليقات المفتوحة أو ردود الفعل
- الرموز ومعرّفات الهوية أو الأرقام المرجعية التي لا تناسب integer/decimal
- جمع قيم الوقت باستخدام امتدادات إدخال الوقت من rtSurvey
- حقول النص ذات الإكمال التلقائي (عبر
search-autocomplete-noedit-v2())
خيارات المظهر القياسية
| المظهر | الوصف |
|---|---|
| (none) | إدخال نص أحادي السطر |
multiline | منطقة نص متعددة الأسطر — الأفضل للنصوص الحرة الأطول على الويب |
امتدادات إدخال الوقت في rtSurvey
يمتد rtSurvey text بـ أداة منتقي الساعة لجمع قيم الوقت. تعرض خيارات المظهر هذه أيقونة ساعة يمكن للمعداد النقر عليها لاختيار الساعات والدقائق والثواني أو المللي ثانية.
متغيرات المظهر
| المظهر | الوصف |
|---|---|
inline | أيقونة الساعة معروضة بجانب الحقل |
inline colors("RRGGBB") | أيقونة الساعة بلون hex مخصص |
inline-1line | الساعة معروضة بتنسيق صف واحد مضغوط |
inline-1line-RRGGBB | صف واحد مع لون أيقونة مخصص (hex، بدون #) |
inline-1line colors("RRGGBB","RRGGBB") | صف واحد مع لونين |
inline-onlyresult | أيقونة الساعة تختفي بعد التحديد؛ يُعرض القيمة فقط |
inline-onlyresult colors("RRGGBB") | نفسه، مع لون أيقونة مخصص |
رموز تنسيق الوقت
أضف سلسلة تنسيق بين أقواس للتحكم في مكونات الوقت المعروضة:
| سلسلة التنسيق | يعرض |
|---|---|
inline-[%H:%M] | الساعات والدقائق (24 ساعة) |
inline-[%h:%M] | الساعات والدقائق (12 ساعة) |
inline-[%H:%M:%S] | الساعات والدقائق والثواني (24 ساعة) |
inline-[%h:%M:%S] | الساعات والدقائق والثواني (12 ساعة) |
inline-[%H:%M:%3] | الساعات والدقائق والمللي ثانية |
inline-[%M:%S] | الدقائق والثواني فقط |
inline-[%M:%3] | الدقائق والمللي ثانية فقط |
inline-[%S] | الثواني فقط |
inline-[%3] | المللي ثانية فقط |
inline-[%H] | الساعات فقط (24 ساعة) |
inline-[%h] | الساعات فقط (12 ساعة) |
مثال: تسجيل مدة مهمة بالدقائق والثواني
| type | name | label | appearance |
|---|---|---|---|
| text | task_duration | Time taken to complete the task | inline-[%M:%S] |
مثال: تسجيل وقت حدث بتنسيق 24 ساعة مع لون مخصص
| type | name | label | appearance |
|---|---|---|---|
| text | event_time | Time of event | inline-1line colors("0099FF") |
تنسيق البيانات
يُخزَّن ويُصدَّر بيانات النص كسلسلة نصية عادية. بالنسبة للإدخالات المستندة إلى الوقت باستخدام أداة الساعة المضمّنة، يُخزَّن القيمة بالتنسيق المطابق لسلسلة التنسيق المختارة (مثل 14:32 لـ %H:%M).
القيود والتحقق
طبّق قيوداً لفرض التنسيق أو الطول أو النمط:
| type | name | label | constraint | constraint_message |
|---|---|---|---|---|
| text | name | Full name | string-length(.) >= 2 | Name must be at least 2 characters |
| text | code | Reference code | regex(., '^[A-Z]{2}[0-9]{4}$') | Enter 2 uppercase letters followed by 4 digits |
| text | phone | Phone number | regex(., '^[0-9]{9,15}$') | Enter a valid phone number |
أفضل الممارسات
- استخدم أنواعاً أكثر تحديداً (
integer،decimal،date) كلما كانت البيانات ذات بنية معروفة — هذا يمنع الإدخالات غير الصالحة ويبسّط التحليل. - أضف
constraintمعstring-length()أوregex()للتحقق من الرموز أو المعرّفات. - استخدم مظهر
multilineللأسئلة المفتوحة حيث قد يكتب المستجيبون عدة جمل. - لجمع الوقت، اختر رموز تنسيق الوقت التي تتطابق مع الدقة التي تتطلبها تحليلاتك — جمع المللي ثانية عندما تحتاج فقط إلى الدقائق يُضيّع جهد المعداد.
دعم المنصات
نوع سؤال النص وجميع مظاهر إدخال الوقت مدعومة على منصات iOS وAndroid والويب.
القيود
- استجابات النص حرة الشكل — لا يوجد فحص تدقيق إملائي مدمج أو قيد مفردات يتجاوز أنماط regex.
- أداة الساعة المضمّنة هي امتداد لـ rtSurvey وليست جزءاً من مواصفة XLSForm القياسية.