أنواع أسئلة الاختيار

الاختيار المتعدد

قدم قائمة خيارات نصية للمستجيب للاختيار منها. يدعم الاختيار المفرد والمتعدد وإدخال "أخرى" الحر والترتيب العشوائي والترتيب الأبجدي.

معرّف النوع: multiple_choice

الخصائص

الخاصية	النوع	الوصف	الافتراضي
`choices`	Choice[]	مصفوفة خيارات الاختيار. لكل خيار `id` و `label` و `imageUrl` اختياري.	`[]`
`allowMultiple`	boolean	السماح للمستجيب باختيار أكثر من خيار واحد.	`false`
`allowOther`	boolean	عرض خيار "أخرى" مع إدخال نص حر يمكن للمستجيب كتابة إجابة مخصصة فيه.	`false`
`randomize`	boolean	ترتيب الخيارات عشوائيًا في كل مرة يُعرض فيها السؤال.	`false`
`alphabeticalOrder`	boolean	ترتيب الخيارات أبجديًا. يُتجاهل إذا كان `randomize` مفعّلًا (العشوائي يأخذ الأولوية).	`false`

كائن الخيار

كل خيار في مصفوفة choices يحتوي على:

الحقل	النوع	الوصف
`id`	string	معرّف فريد لهذا الخيار. يُستخدم في القفزات المنطقية والتسجيل.
`label`	string	نص العرض للخيار.
`imageUrl`	string	رابط صورة اختياري للخيار (لا يُستخدم عادة في الاختيار المتعدد القياسي؛ راجع اختيار الصور).

التحقق

إذا كان required صحيحًا، يجب على المستجيب اختيار خيار واحد على الأقل قبل المتابعة.

معاملات القفز المنطقي

equals, not_equals, is_answered, is_not_answered

عند استخدام equals أو not_equals، قيمة المقارنة هي معرّف الخيار. للأسئلة متعددة الاختيار، equals يتحقق مما إذا كانت القيمة ضمن العناصر المحددة.

تنسيق الإجابة

اختيار مفرد (allowMultiple: false): سلسلة نصية (معرّف الخيار المحدد).
اختيار متعدد (allowMultiple: true): مصفوفة سلاسل نصية (معرّفات الخيارات المحددة).

تسجيل وضع الاختبار

الاختيار المتعدد هو نوع سؤال قابل للتسجيل في جميع أوضاع الاختبار:

اختبار المعرفة: عيّن correctAnswers (مصفوفة معرّفات الخيارات الصحيحة) و correctAnswerScore (النقاط لكل إجابة صحيحة).
تأهيل العملاء المحتملين: عيّن choiceScores (ربط معرّف الخيار بقيمة النقاط).
اختبار المطابقة: عيّن choiceOutcomes (ربط معرّف الخيار بمعرّفات أسئلة شاشة النهاية).

تتوفر اختصارات لوحة المفاتيح لتحديد الخيارات. يمكن للمستجيبين الضغط على مفاتيح الأحرف (A, B, C, إلخ.) لتحديد الخيارات، والتي تظهر كمؤشرات بجانب كل خيار.

القائمة المنسدلة

قائمة منسدلة للاختيار من قائمة خيارات. تدعم نفس إعدادات الاختيار المتعدد لكن تعرض الخيارات بتنسيق قائمة منسدلة مدمجة.

معرّف النوع: dropdown

الخصائص

الخاصية	النوع	الوصف	الافتراضي
`choices`	Choice[]	مصفوفة خيارات الاختيار.	`[]`
`allowMultiple`	boolean	السماح بتحديد خيارات متعددة من القائمة المنسدلة.	`false`
`allowOther`	boolean	عرض خيار "أخرى" مع إدخال نص حر.	`false`
`placeholder`	string	نص توضيحي يُعرض قبل إجراء التحديد.	بدون
`randomize`	boolean	ترتيب الخيارات عشوائيًا.	`false`
`alphabeticalOrder`	boolean	ترتيب الخيارات أبجديًا.	`false`

التحقق

إذا كان required صحيحًا، يجب على المستجيب اختيار خيار واحد على الأقل.

معاملات القفز المنطقي

equals, not_equals, is_answered, is_not_answered

تنسيق الإجابة

اختيار مفرد: سلسلة نصية (معرّف الخيار المحدد).
اختيار متعدد: مصفوفة سلاسل نصية (معرّفات الخيارات المحددة).

تسجيل وضع الاختبار

القائمة المنسدلة نوع سؤال قابل للتسجيل. إعداد التسجيل مطابق للاختيار المتعدد.

اختيار الصور

قدم خيارات قائمة على الصور للمستجيب للاختيار منها. كل خيار يعرض صورة مع تسمية نصية اختيارية أسفلها.

معرّف النوع: picture_choice

الخصائص

الخاصية	النوع	الوصف	الافتراضي
`choices`	Choice[]	مصفوفة خيارات الاختيار. يجب أن يحتوي كل خيار على `imageUrl` بالإضافة إلى `id` و `label`.	`[]`
`allowMultiple`	boolean	السماح بتحديد صور متعددة.	`false`
`allowOther`	boolean	عرض خيار "أخرى" مع إدخال نص حر.	`false`
`randomize`	boolean	ترتيب خيارات الصور عشوائيًا.	`false`
`alphabeticalOrder`	boolean	ترتيب الخيارات أبجديًا حسب التسمية.	`false`

كائن الخيار (اختيار الصور)

الحقل	النوع	الوصف
`id`	string	معرّف فريد لهذا الخيار.
`label`	string	تسمية نصية تُعرض أسفل الصورة.
`imageUrl`	string	رابط الصورة المعروضة لهذا الخيار.

التحقق

إذا كان required صحيحًا، يجب على المستجيب اختيار صورة واحدة على الأقل.

معاملات القفز المنطقي

equals, not_equals, is_answered, is_not_answered

تنسيق الإجابة

اختيار مفرد: سلسلة نصية (معرّف الخيار المحدد).
اختيار متعدد: مصفوفة سلاسل نصية (معرّفات الخيارات المحددة).

تسجيل وضع الاختبار

اختيار الصور نوع سؤال قابل للتسجيل. إعداد التسجيل مطابق للاختيار المتعدد.

تُعرض خيارات اختيار الصور في تخطيط شبكة متجاوب. على سطح المكتب، تُعرض الصور في شبكة متعددة الأعمدة؛ على الهاتف المحمول، تتراكم عموديًا.

نعم / لا

سؤال ثنائي بسيط يقدم زري "نعم" و "لا".

معرّف النوع: yes_no

الخصائص

لا يحتوي نوع سؤال نعم/لا على خصائص إضافية بخلاف خصائص السؤال المشتركة.

التحقق

إذا كان required صحيحًا، يجب على المستجيب النقر على "نعم" أو "لا".

معاملات القفز المنطقي

equals, not_equals, is_answered, is_not_answered

عند استخدام equals، قارن مع true (نعم) أو false (لا). القيم النصية "true" و "false" مقبولة أيضًا.

تنسيق الإجابة

تُخزن الإجابة كـ قيمة منطقية (true لنعم، false للا، أو null إذا لم تُجب).

تسجيل وضع الاختبار

نعم/لا نوع سؤال قابل للتسجيل:

اختبار المعرفة: عيّن correctAnswers بقيمة واحدة "true" أو "false".
تأهيل العملاء المحتملين: عيّن choiceScores بمفاتيح "true" و "false".
اختبار المطابقة: عيّن choiceOutcomes بمفاتيح "true" و "false".

يتقدم سؤال نعم/لا تلقائيًا إلى السؤال التالي فور التحديد. لا يوجد زر "موافق" منفصل.

الترتيب

قدم قائمة عناصر للمستجيب لترتيبها حسب تفضيله بالسحب والإفلات.

معرّف النوع: ranking

الخصائص

الخاصية	النوع	الوصف	الافتراضي
`choices`	Choice[]	مصفوفة عناصر للترتيب. لكل منها `id` و `label`.	`[]`

التحقق

إذا كان required صحيحًا، يجب على المستجيب إرسال ترتيب (جميع العناصر يجب أن تكون في ترتيب محدد).

معاملات القفز المنطقي

equals, not_equals, is_answered, is_not_answered

تنسيق الإجابة

تُخزن الإجابة كـ مصفوفة سلاسل نصية (معرّفات الخيارات بترتيب المستجيب المفضل، من الأول إلى الأخير).

json

["choice_3", "choice_1", "choice_2"]

يستخدم حقل الترتيب تفاعل السحب والإفلات. على الأجهزة المحمولة، يمكن للمستجيبين استخدام إيماءات اللمس لإعادة ترتيب العناصر.

المصفوفة

نوع سؤال شبكي حيث يقيّم المستجيبون عناصر متعددة (صفوف) عبر فئات متعددة (أعمدة). كل تقاطع صف-عمود هو خيار قابل للتحديد.

معرّف النوع: matrix

الخصائص

الخاصية	النوع	الوصف	الافتراضي
`rows`	string[]	مصفوفة تسميات الصفوف (العناصر المُقيّمة).	`[]`
`columns`	string[]	مصفوفة تسميات الأعمدة (فئات التقييم).	`[]`
`randomizeRows`	boolean	ترتيب الصفوف عشوائيًا.	`false`
`randomizeColumns`	boolean	ترتيب الأعمدة عشوائيًا.	`false`

التحقق

إذا كان required صحيحًا، يجب على المستجيب تحديد خيار واحد لكل صف.

معاملات القفز المنطقي

equals, not_equals, is_answered, is_not_answered

تنسيق الإجابة

تُخزن الإجابة ككائن object (Record<string, string>) يربط كل تسمية صف بتسمية العمود المحدد:

json

{
  "Product Quality": "Excellent",
  "Customer Service": "Good",
  "Value for Money": "Average"
}

تُعرض أسئلة المصفوفة كشبكة متجاوبة على سطح المكتب وتتكيف مع تنسيق متراكم على الأجهزة المحمولة لسهولة الاستخدام. تدعم الصفوف والأعمدة ترتيبًا عشوائيًا مستقلًا.