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

البيان

سؤال عرض فقط يعرض نصًا للمستجيب دون الحاجة لإجابة. مفيد للتعليمات أو انتقالات الأقسام أو المحتوى المعلوماتي.

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

الخصائص

الخاصية	النوع	الوصف	الافتراضي
`buttonText`	string	النص المعروض على زر المتابعة.	"Continue"

السلوك

لا يُعرض رقم السؤال للبيانات.
لا يُعرض حقل إدخال.
ينقر المستجيب على الزر للتقدم إلى السؤال التالي.
البيانات ليست "مطلوبة" أبدًا لأنه لا توجد إجابة للتحقق منها.

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

equals, not_equals, is_answered, is_not_answered

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

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

لا تنتج البيانات إجابة. القيمة فعليًا undefined.

شاشة الترحيب

شاشة تمهيدية تُعرض في بداية النموذج، قبل أي أسئلة.

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

الخصائص

الخاصية	النوع	الوصف	الافتراضي
`buttonText`	string	النص على الزر الذي يبدأ النموذج.	"Start"

السلوك

تُعرض شاشة الترحيب قبل السؤال 1.
يدعم العنوان والوصف النص المنسق واستبدال {variable}.
النقر على الزر يبدأ النموذج.

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

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

لا تنتج شاشات الترحيب إجابة.

شاشة النهاية

شاشة ختامية تُعرض بعد إرسال النموذج. في أوضاع الاختبار، يمكن إضافة عدة شاشات نهاية مع عرض مشروط بناءً على درجة المستجيب.

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

الخصائص

الخاصية	النوع	الوصف	الافتراضي
`buttonText`	string	نص زر اختياري (مثل "أعد الاختبار").	بدون
`scoreRange`	object	لأوضاع الاختبار: نطاق الدرجات الذي يُفعّل شاشة النهاية هذه.	بدون
`scoreRange.min`	number	الحد الأدنى للدرجة لعرض شاشة النهاية هذه (شامل).	بدون
`scoreRange.max`	number	الحد الأقصى للدرجة لعرض شاشة النهاية هذه (شامل).	بدون

سلوك الوضع القياسي

في الوضع القياسي، تحل شاشة نهاية واحدة محل شاشة الشكر الافتراضية. يُعرض عنوانها ووصفها بعد الإرسال.

سلوك وضع الاختبار

في أوضاع الاختبار، يمكن تعريف عدة شاشات نهاية:

اختبار المعرفة / تأهيل العملاء المحتملين: تُعرض شاشة النهاية التي يتطابق scoreRange الخاص بها مع إجمالي درجات المستجيب.
اختبار المطابقة: تُعرض شاشة النهاية التي جمعت أكبر عدد من العلامات من نتائج خيارات المستجيب.

تظهر أسئلة شاشة النهاية في قائمة الأسئلة لكنها لا تُعرض أثناء تدفق النموذج. تُعرض فقط بعد الإرسال بناءً على منطق التسجيل.

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

لا تنتج شاشات النهاية إجابة.

الملخص

شاشة مراجعة تعرض جميع إجابات المستجيب قبل الإرسال النهائي. يمكن للمستجيب مراجعة إجاباته والعودة اختياريًا لتعديل أي سؤال.

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

الخصائص

الخاصية	النوع	الوصف	الافتراضي
`summaryLabel`	string	عنوان مخصص لقسم الملخص.	"Review your answers"
`summaryYesText`	string	تسمية زر التأكيد/الإرسال.	"Looks good, submit!"
`summaryNoText`	string	تسمية زر العودة والتعديل.	"I want to change something"

السلوك

يعرض الملخص جميع الأسئلة المُجاب عليها مع ردودها.
كل سؤال في الملخص قابل للنقر، مما يسمح للمستجيب بالعودة لذلك السؤال وتعديل إجابته.
تُخفى بادئة رقم السؤال.
يُقدم زران: تأكيد (إرسال) وتعديل (العودة).

الاعتماديات

يتطلب سؤال الملخص الوصول إلى جميع الأسئلة وجميع الإجابات. يمرر عارض النموذج خصائص allQuestions و allAnswers و onGoToQuestion و onRestart لهذا الحقل.

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

لا ينتج سؤال الملخص إجابته الخاصة. هو مكون عرض فقط.

ضع سؤال الملخص كآخر سؤال في نموذجك (قبل أي شاشات نهاية) لمنح المستجيبين فرصة للمراجعة قبل الإرسال. هذا مفيد بشكل خاص للنماذج الطويلة أو النماذج ذات الحقول المطلوبة.

حفظ الإجابات

يمنح المستجيبين خيار حفظ إجاباتهم الحالية في التخزين المحلي لمتصفحهم. عند زيارة نموذج NueForm آخر، يمكن ملء أي إجابات محفوظة مسبقًا تلقائيًا.

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

الخصائص

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

السلوك

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

حالة الاستخدام

هذا مفيد لسير عمل النماذج المتعددة حيث يملأ المستجيبون عدة نماذج ذات صلة. يمكن حفظ المعلومات الشائعة (الاسم، البريد الإلكتروني، الشركة، إلخ.) مرة واحدة وملئها تلقائيًا في النماذج اللاحقة.

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

لا ينتج سؤال حفظ الإجابات إجابته الخاصة. تُخزن البيانات المحفوظة في التخزين المحلي للمتصفح.

مجموعة الأسئلة

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

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

الخصائص

الخاصية	النوع	الوصف	الافتراضي
`fields`	FormQuestion[]	مصفوفة أسئلة فرعية داخل المجموعة. كل سؤال فرعي هو كائن سؤال كامل بنوعه وعنوانه وخصائصه وقفزاته المنطقية.	`[]`

السلوك

تظهر المجموعة كخطوة واحدة في النموذج العام.
تُعرض الأسئلة الفرعية واحدة تلو الأخرى مع تنقل أمامي/خلفي داخل المجموعة.
يمكن لكل سؤال فرعي أن يكون له قفزات منطقية خاصة. إذا كانت وجهة القفزة المنطقية:
- سؤال فرعي آخر داخل المجموعة: يحدث التنقل داخليًا.
- سؤال خارج المجموعة: تخرج المجموعة ويستمر التنقل على المستوى الأعلى.
- end: يتخطى النموذج إلى الإرسال.
يتنقل زر "رجوع" داخل المجموعة أولًا. إذا كان المستجيب على أول سؤال فرعي، الضغط على "رجوع" يخرج من المجموعة ويذهب إلى السؤال الأعلى السابق.
تُخفى بادئة رقم السؤال لحاوية المجموعة.

منطق الأسئلة الفرعية

يمكن للقفزات المنطقية على الأسئلة الفرعية الإشارة إلى إجابات من أسئلة فرعية أخرى داخل نفس المجموعة، أو إجابات من أسئلة المستوى الأعلى خارج المجموعة (عبر خريطة flatAnswers).

تُنفذ إجراءات المتغيرات على قفزات منطق الأسئلة الفرعية ضد نفس حالة المتغير الخاصة بالنموذج الأب.

التحقق

يُتحقق من كل سؤال فرعي داخل المجموعة بشكل فردي. يجب على المستجيب تلبية كل سؤال فرعي مطلوب أثناء التنقل عبر المجموعة.

الأسئلة الفرعية التي تُتخطى بواسطة القفزات المنطقية الداخلية لا يُتحقق منها (يُعفى قيد المطلوب الخاص بها).

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

تُخزن الإجابة ككائن object (Record<string, unknown>) يربط كل معرّف سؤال فرعي بإجابته:

json

{
  "sub_q1": "John Smith",
  "sub_q2": "john@example.com",
  "sub_q3": 5
}

مجموعات الأسئلة مثالية لتنظيم الأسئلة متعددة الأجزاء (مثل قسم نموذج اتصال، قسم تفضيلات) مع الحفاظ على تدفق سؤال واحد في كل مرة داخل المجموعة.

صفحة الأسئلة المتعددة

تعرض عدة أسئلة على شاشة واحدة في وقت واحد. على عكس مجموعات الأسئلة (التي تعرض سؤالًا فرعيًا واحدًا في كل مرة)، تعرض صفحات الأسئلة المتعددة جميع أسئلتها الفرعية دفعة واحدة.

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

الخصائص

الخاصية	النوع	الوصف	الافتراضي
`fields`	FormQuestion[]	مصفوفة أسئلة فرعية لعرضها على الصفحة. كل سؤال فرعي هو كائن سؤال كامل.	`[]`

السلوك

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

التحقق

يجب الإجابة على جميع الأسئلة الفرعية المطلوبة قبل إرسال الصفحة. تُعرض أخطاء التحقق مضمنة بجانب السؤال الفرعي المعني.

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

تُخزن الإجابة ككائن object (Record<string, unknown>) يربط كل معرّف سؤال فرعي بإجابته:

json

{
  "sub_q1": "Jane Doe",
  "sub_q2": "jane@example.com",
  "sub_q3": "Engineering"
}

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

Markdown

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

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

الخصائص

الخاصية	النوع	الوصف	الافتراضي
`markdown`	string	سلسلة محتوى Markdown. تدعم تنسيق Markdown القياسي بالإضافة إلى صيغة الحقول المضمنة.	`""`

صيغة الحقول المضمنة

ضمّن حقول النموذج داخل Markdown باستخدام أقواس معقوفة مزدوجة:

text

{{type:label}}

حيث type هو نوع الحقل و label هو تسمية العرض للحقل.

السلوك

يُخفى رأس السؤال (العنوان والوصف) لأسئلة Markdown. محتوى Markdown هو السؤال.
تُحلل الحقول المضمنة من محتوى Markdown وتُعرض كمدخلات تفاعلية داخل النص.
يملأ المستجيب الحقول المضمنة ويرسل كتلة Markdown بالكامل كإجابة واحدة.

التحقق

يتبع كل حقل مضمن قواعد التحقق الخاصة به بناءً على نوعه.

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

تُخزن الإجابة ككائن object (Record<string, unknown>) يربط كل تسمية حقل مضمن بقيمتها.

أسئلة Markdown مثالية لإنشاء تمارين ملء الفراغات والنماذج بنمط العقود أو أي محتوى تحتاج فيه حقول النموذج إلى التداخل مع نص منسق.