# المجموعات

تُستخدم المجموعات لتنظيم الأسئلة ذات الصلة في النموذج الخاص بك. يتم تعريف المجموعة باستخدام `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               | الرسائل النصية    |

ما الذي يحدث:

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

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