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

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

قدم قائمة خيارات للمستجيب للاختيار منها. يدعم الاختيار المفرد والمتعدد وإدخال "أخرى" الحر والترتيب العشوائي والترتيب الأبجدي. يمكن لكل خيار أن يحمل صورته أو مقطعه المرئي أو أيقونته الخاصة، وتبدّل الخاصية layout بين قائمة عمودية وشبكة بطاقات صور — لذا يغطي هذا النوع الواحد الخيارات النصية العادية والخيارات القائمة على الصور معًا.

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

الخصائص

كائن الخيار

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

وسائط الخيار

يمكن لأي خيار أن يحمل وسائطه الخاصة. تحدد media.display كيفية استقرارها على الخيار:

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

التحقق

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

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

equals, not_equals, is_answered, is_not_answered

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

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

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

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

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

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

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

قائمة منسدلة للاختيار من قائمة خيارات. تدعم نفس إعدادات الاختيار المتعدد لكن تعرض الخيارات بتنسيق قائمة منسدلة مدمجة. لا تنطبق هنا خاصية media لكل خيار ولا layout — تعرض القائمة المنسدلة خياراتها دائمًا كنص عادي.

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

الخصائص

التحقق

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

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

equals, not_equals, is_answered, is_not_answered

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

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

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

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

اختيار الصور

لبناء الشيء نفسه، استخدم سؤال اختيار متعدد مع ضبط layout على blocks وكائن media لكل خيار. كل ما كان يفعله اختيار الصور ما زال متاحًا، بالإضافة إلى معالجات لم تكن متوفرة فيه من قبل: خيارات المقاطع المرئية والأيقونات، والفلاتر، والصبغة، ونقطة التركيز، والتكبير، ووضع الاحتواء الذي يعرض الصور العريضة كاملة بدل اقتصاصها.

{
  "type": "multiple_choice",
  "properties": {
    "layout": "blocks",
    "choices": [
      { "id": "c1", "label": "Mountains", "media": { "type": "image", "url": "https://…", "display": "background" } },
      { "id": "c2", "label": "Coast", "media": { "type": "image", "url": "https://…", "display": "background" } }
    ]
  }
}

النماذج الحالية والاستيرادات من Typeform مُعالَجة نيابة عنك — يُحوَّل سؤال picture_choice تلقائيًا إلى اختيار متعدد مع layout: "blocks"، فلا حاجة لإعادة تأليف أي شيء.

نعم / لا

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

معرّف النوع: 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

الخصائص

التحقق

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

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

equals, not_equals, is_answered, is_not_answered

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

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

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

المصفوفة

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

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

الخصائص

التحقق

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

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

equals, not_equals, is_answered, is_not_answered

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

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

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

القائمة

اجمع عدة إدخالات من النوع نفسه. تحتوي القائمة إما على عناصر نصية عادية (اكتب واضغط Enter، أو انقر على إضافة) أو عناصر مركّبة متكررة — إدخالات منظمة مبنية من مركّب قابل لإعادة الاستخدام، مثل إضافة أي عدد من أعضاء مجلس الإدارة إلى سؤال واحد.

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

الخصائص

التحقق

إذا كان required صحيحًا، يجب إضافة عنصر واحد على الأقل. تُفرض minItems / maxItems عند الإرسال؛ وتُفرض قواعد النمط والطول لكل عنصر (العناصر النصية) عند إضافة كل عنصر.

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

list_count_equals, list_count_greater_than, list_count_less_than, contains, not_contains, is_answered, is_not_answered

تقارن معاملات العدد مع عدد العناصر في الإجابة.

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

• العناصر النصية: مصفوفة سلاسل نصية.
• العناصر المركّبة: مصفوفة كائنات، كل منها مفهرس بمعرّف الحقل الفرعي:

[
  { "sub_first_name": "Ada", "sub_email": "ada@example.com" },
  { "sub_first_name": "Grace", "sub_email": "grace@example.com" }
]

يُسجَّل كل عنصر مركّب أيضًا كـ إدخال مركّب مستقل — راجع دليل المركّبات لعرض الإدخالات عبر النماذج وأوضاع العرض المطوي.

الخيارات من متغيّر

يمكن لأسئلة الاختيار المتعدد والقائمة المنسدلة والترتيب أن تحمّل خياراتها من متغيّر بدلًا من قائمة ثابتة — وعادةً ما يكون ذلك استجابة عقدة بيانات تستدعي واجهتك البرمجية (API). ويمكن للمصفوفة أن تفعل الشيء نفسه مع صفوفها أو أعمدتها أو كليهما.

الإعداد

1. أضف عقدة بيانات تُرجع القائمة، وحدّد لها متغير الاستجابة — مثل breeds.
2. في إعدادات السؤال، غيّر مصدر الخيارات من قائمة ثابتة (الإعداد الافتراضي) إلى من متغيّر. وفي المصفوفة، استخدم مصدر الصفوف ومصدر الأعمدة.
3. أدخل المتغيّر الذي يحتوي على القائمة: {breeds}، أو مسارًا داخل الاستجابة مثل {breeds.data}.
4. إذا كانت عناصرك لا تستخدم المفتاحين label وvalue، فافتح هل تستخدم عناصرك أسماء حقول أخرى؟ وأدخل حقل التسمية وحقل القيمة اللذين تستخدمهما بياناتك.

في النموذج بنمط NueForm، ضع عقدة البيانات قبل السؤال. وفي النموذج بنمط الاستبيان، اضبط وقت التشغيل لعقدة البيانات على إبقاؤه محدّثًا كي تتبع القائمة إجابات المستجيب — راجع نمط الاستبيان.

لا تتوفر إعدادات المصدر هذه إلا للأسئلة الموضوعة مباشرة في النموذج. فلا يعرضها المُنشئ لسؤال داخل مجموعة أسئلة أو صفحة أسئلة متعددة أو مركّب، لأن هذه الأسئلة تحفظ إجابتها داخل إجابة العنصر الذي يحتويها، حيث لا يمكن الاحتفاظ بالتسميات. أما السؤال الذي يحمّل خياراته من متغيّر بالفعل فيحتفظ بالإعداد إذا نقلته إلى أحدها، لكن استجاباته تعرض حينها قيم العناصر بدلًا من تسمياتها.

وعلى لوحة المُنشئ، يعرض السؤال «خيارات من {breeds}» بدلًا من خياراته.

الصيغ المقبولة

يجب أن يحتوي المتغيّر على قائمة JSON — إما من نصوص بسيطة، يكون كل نص فيها هو التسمية والقيمة معًا:

["Siamese", "Persian"]

وإما من كائنات لها تسمية وقيمة:

[
  { "label": "Siamese", "value": "siamese" },
  { "label": "Persian", "value": "persian" }
]

وتعمل أيضًا الكائنات التي تستخدم مفاتيح أخرى — حدّد تلك المفاتيح في حقل التسمية وحقل القيمة. بالنسبة إلى الاستجابة التالية، استخدم المتغيّر {breeds.data}، وحقل التسمية name، وحقل القيمة id:

{ "data": [{ "name": "Siamese", "id": "siamese" }, { "name": "Persian", "id": "persian" }] }

وفي الاختيار المتعدد، يمكن للعنصر أيضًا أن يحمل عنوان URL في المفتاح image، فيصبح صورة ذلك الخيار:

[{ "label": "Siamese", "value": "siamese", "image": "https://example.com/siamese.jpg" }]

إذا كانت الاستجابة كائنًا، فأشِر إلى القائمة داخله بمسار نقطي مثل {breeds.data}. وإذا كان المفتاح ليس كلمة بسيطة، فاستخدم {breeds["the list"]}.

كيف تُقرأ العناصر

• تصبح قيمة كل عنصر هي معرّف الخيار الخاص به. وهي ما تخزّنه الإجابة، وما تقارنه الشروط المنطقية، وما يطابقه تسجيل نقاط الاختبار.
• إذا كان للكائن تسمية فقط أو قيمة فقط، فتُستخدم لكليهما. وتُقرأ الأرقام وtrue/false كنص.
• تُتخطّى العناصر التي ليست لها قيمة، أو التي تكرر قيمة عنصر سابق، وكذلك القيم التي تتجاوز 500 حرف. وتُختصر التسميات التي تتجاوز 500 حرف، ولا يُستخدم إلا أول 1,000 عنصر.
• تُعرض التسميات كنص عادي: لا يُطبَّق عليها أي تنسيق، ولا تُستبدل رموز {variable} الموجودة فيها.
• لا يزال خيار «أخرى» يعمل في الاختيار المتعدد والقائمة المنسدلة: ويظهر بعد العناصر المحمَّلة.
• تنطبق إعدادات السؤال الأخرى — مثل السماح بتحديدات متعددة وترتيب عشوائي وترتيب أبجدي — على العناصر المحمَّلة كالمعتاد.
• تحتفظ عقدة البيانات بما يصل إلى 4,096 حرفًا من استجابتها، لذا قد تصل القائمة الطويلة مقطوعة. راجع قسم «استجابات عُقد البيانات كقوائم خيارات» في المتغيرات.

ما يراه المستجيبون

لا توجد قائمة ثابتة احتياطية. فإلى أن يحتوي المتغيّر على قائمة صالحة للاستخدام، يعرض السؤال إحدى الرسائل الثلاث الأولى أدناه بدلًا من الخيارات. أما الرسالة الأخيرة فتظهر فوق الخيارات بعد أن تتغيّر القائمة:

الإجابات المحفوظة

• تخزّن الإجابة قيم العناصر، تمامًا مثل معرّفات الخيارات. وفي المصفوفة، تربط الإجابة قيمة كل صف بقيمة العمود المختار.
• تُحفظ التسميات التي رآها المستجيب مع الإجابة، لذا تعرض الردود وملفات CSV المُصدَّرة ورسائل الإشعار التسميات بدلًا من القيم.
• تُرسل الـ Webhooks القيم ومعها خريطة valueLabels تربط كل قيمة مختارة بتسميتها، سواء في الإرسالات عبر الويب أو عبر المكالمات الهاتفية.
• تُحمَّل القائمة أثناء تعبئة المستجيب للنموذج، لذلك لا يعيد NueForm التحقق من القيم المُرسَلة مقابلها. ولا تزال الأسئلة الإلزامية مفروضة. وإذا كان يجب أن تكون الإجابة أحد عناصرك، فتحقّق من ذلك في نظامك عند معالجة الاستجابة.

التسجيل والشروط

• التسجيل: لا توجد قائمة ثابتة لتحديدها، لذا يطلب محرر التسجيل قيم العناصر بدلًا منها، ويجب أن تتطابق تمامًا («يطابق قيمة العنصر تمامًا.»). راجع قسم «تسجيل نقاط الخيارات من متغيّر» في أوضاع النموذج.
• الشروط: تستخدم القفزات المنطقية وشروط الرؤية لهذه الأسئلة المُشغّلات النصية وقيمة مكتوبة. وفي المصفوفة، لا يعرض محرر الشروط إلا is_answered وis_not_answered، لأن إجابتها تربط الصفوف بالأعمدة. راجع قسم «الشروط على الخيارات من متغيّر» في القفزات المنطقية.
• المكالمات الهاتفية: يقرأ الوكيل جميع خيارات القائمة، ويمكن للمتصل أن ينطق خيارًا أو يضغط رقمه. راجع قسم «الخيارات من متغيّر» في الهاتف.

خصائص المصدر

وللمصفوفة المجموعة نفسها لكل محور: rowSource وrowVariable وrowLabelField وrowValueField، وcolumnSource وcolumnVariable وcolumnLabelField وcolumnValueField.