المجموعات

تُستخدم المجموعات لتنظيم الأسئلة ذات الصلة في النموذج الخاص بك. يتم تعريف المجموعة باستخدام begin_group و end_group الأنواع. يمكنك التحكم في كيفية تصرف المجموعة باستخدام appearance العمود.

📄 مجموعة بمظهر: field-list

عند استخدام field-list كمظهر للمجموعة، ستظهر جميع الأسئلة داخل المجموعة على نفس الشاشة. هذا ينشئ تخطيطًا على شكل صفحة حيث يمكن للمستخدمين الإجابة على عدة أسئلة ذات صلة دفعة واحدة.

يتم التعامل مع كل صف داخل المجموعة كـ سؤال فردي، وقد يتم عرض تسمية المجموعة (إذا تم استخدامها) كعنوان للقسم اعتمادًا على المنصة.

مثال – مجموعة field-list مع أنواع أسئلة مختلطة

النوع	الاسم	label	appearance	مطلوب
begin_group	contact	تفاصيل الاتصال	field-list
text	fname	الاسم الأول		yes
text	lname	اسم العائلة		yes
select_one gender	gender	النوع
select_multiple	contact_way	طرق الاتصال المفضلة
end_group

ورقة Choices

list_name	الاسم	label
gender	male	Male
gender	female	Female
gender	other	Other
contact_way	البريد الإلكتروني	البريد الإلكتروني
contact_way	phone	الهاتف
contact_way	sms	الرسائل النصية

ما الذي يحدث: سيتم عرض هذه المجموعة كصفحة واحدة تحتوي على الحقول التالية:

• الاسم الأول (نص)

• اسم العائلة (نص)

• النوع (اختر خيارًا واحدًا)

• طرق الاتصال المفضلة (اختر عدة خيارات)

جميع المدخلات على صفحة واحدة، مما يتيح للمستخدم إدخال عدة معلومات ذات صلة دفعة واحدة.

🔠 مجموعة بمظهر table-list

عندما تطبق appearance: table-list على مجموعة تحتوي أسئلة الاختيار فيها على نفس قائمة الخيارات، يمكن أن تظهر كمصفوفة/شبكة — صف واحد لكل سؤال، وعمود واحد لكل خيار.

ورقة survey

النوع	الاسم	label	appearance
begin_group	opinion_grp	يرجى إبداء رأيك:	table-list
select_one agree_disagree	q1	أثق بخدمات الصيدلة عبر الإنترنت.
select_one agree_disagree	q2	الموقع سهل الاستخدام.
select_one agree_disagree	q3	سأوصي بهذه المنصة.
end_group

ورقة choices

list_name	الاسم	label
agree_disagree	agree	موافقة
agree_disagree	disagree	غير موافقة

⁉️ مجموعة بدون مظهر

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

مثال – بدون مظهر

النوع	الاسم	label
begin_group	contact	قدّم تفاصيل الاتصال الخاصة بك
text	fname	الاسم الأول
text	lname	اسم العائلة
text	address	عنوان الشارع
integer	zip	الرمز البريدي
end_group

كمكافأة يمكنك إضافة قيد على سؤال الرمز البريدي للتأكد من أنه رمز بريدي أمريكي صالح (5 أرقام):

النوع	الاسم	label	constraint	constraint_message
integer	zip	الرمز البريدي	regex(., '^\d{5}$')	يجب أن يكون رمزًا بريديًا أمريكيًا مكونًا من 5 أرقام

ما الذي يحدث: سيعرض النموذج سلسلة من الأسئلة ذات الصلة تحت الموجه "قدّم تفاصيل الاتصال الخاصة بك"، مع اعتبار كل حقل جزءًا من ذلك الموجه الواحد.

الملخص

يتغير سلوك المجموعة بناءً على ما إذا كنت تستخدم أم لا field-list appearance:

المظهر	السلوك
field-list	يعرض جميع الأسئلة في المجموعة على نفس الشاشة
(none)	يتعامل مع المجموعة كسؤال واحد ذو أجزاء متعددة أو حقول فرعية

📰 مجموعة بمظهر: field-list تحتوي على مجموعة متداخلة

يمكنك إنشاء مجموعة بمظهر appearance: field-list ووضع عناصر أخرى داخلها، بما في ذلك:

• مجموعة متداخلة بدون أي مظهر (تتصرف كسؤال منظم متعدد الأجزاء)

• أسئلة فردية أخرى (مثل select_one أو text)

يتيح لك هذا عرض صفحة كاملة من المدخلات ذات الصلة مع الاستفادة أيضًا من الأقسام الفرعية المنظمة داخل تلك الصفحة مثل تخطيط صفحة يحتوي على كتلة معلومات الاتصال وطريقة الاتصال المفضلة

في هذا المثال:

• تستخدم المجموعة الرئيسية field-list، لذا يظهر كل شيء على صفحة واحدة.

• في داخلها، توجد مجموعة متداخلة (بدون مظهر)، تعمل ككتلة من الأسئلة النصية ذات الصلة.

• بعد المجموعة المتداخلة، يوجد سؤال select_one يسأل كيف يفضل المستجيب أن يتم الاتصال به.

ورقة survey

النوع	الاسم	label	appearance
begin_group	full_block	صفحة الاتصال	field-list
begin_group	contact	قدّم تفاصيل الاتصال الخاصة بك
text	fname	الاسم الأول
text	lname	اسم العائلة
text	address	عنوان الشارع
integer	zip	الرمز البريدي
end_group
select_one method	contact_way	طريقة الاتصال المفضلة
end_group

ورقة choices

list_name	الاسم	label
method	البريد الإلكتروني	البريد الإلكتروني
method	phone	الهاتف
method	sms	الرسائل النصية

ما الذي يحدث:

• يرى المستجيب صفحة واحدة.

• في الأعلى، يُطلب منهم ملء تفاصيل الاتصال الخاصة بهم (الاسم الأول، اسم العائلة، إلخ) — تظهر هذه كعناصر مجمعة معًا لكنها تُعتبر أجزاء من قسم منظم واحد.

• أسفل ذلك، على نفس الشاشة، يمكنهم اختيار طريقة الاتصال المفضلة لديهم.

هذا النهج يبقي المعلومات ذات الصلة منظمة بشكل أنيق وفعالة لملئها.