انتقل إلى المحتوى
جديدقوالب وأدوات رقمية قيد الإطلاق — انضم لقائمة الانتظار
Hecham Gazhi

أنظمة التصميم · الدرس 07 / 13

المكوّنات

كيف تصمم مكوّنات نظام تدوم: التصميم الذري، والتشريح، والمتغيرات والخصائص، والأحجام، والحالات، والتكوين مقابل الإعداد، وتصميم واجهة البرمجة، وقائمة تحقق للمكوّنات.

4 دقائق قراءة · 5 أسئلة

ما الذي يجعل مكوّن النظام جيدًا

المكوّن في نظام التصميم قطعة واجهة قابلة لإعادة الاستخدام — زر، حقل، بطاقة — بتشريح محدد، ومجموعة خيارات ثابتة، وكل الحالات مصممة، وإمكانية وصول مدمجة، وتنفيذات متطابقة في التصميم والكود.

المكوّنات الجيدة مرنة بما يكفي لتغطي احتياجات المنتج الحقيقية، ومقيّدة بما يكفي لتُبقي الواجهة متسقة، وموثقة جيدًا حتى يستخدمها الناس بشكل صحيح.

التصميم الذري

التصميم الذري (Atomic design) لبراد فروست طريقة شائعة للتفكير في كيفية بناء المكوّنات بعضها على بعض:

المستوىالوصفأمثلة
الذراتأصغر اللبناتزر، حقل، تسمية، أيقونة، صورة شخصية
الجزيئاتمجموعات بسيطة من الذرات تعمل معًاحقل بحث (حقل + زر)، حقل نموذج (تسمية + حقل + نص مساعد)
الكائناتأقسام معقدة من الجزيئات والذراتالرأس، شبكة بطاقات المنتجات، جدول البيانات
القوالبتخطيطات على مستوى الصفحة بمحتوى مؤقتتخطيط قائمة المنتجات
الصفحاتقوالب بمحتوى حقيقيصفحة فئة الأحذية الفعلية

لست مضطرًا لاستخدام هذه الأسماء. الفكرة المفيدة أن الأجزاء الصغيرة المبنية جيدًا تتركّب في أجزاء أكبر — فإصلاح ذرة يحسّن كل ما بُني منها.

التشريح

وثّق الأجزاء المسمّاة لكل مكوّن. الأسماء المشتركة تسهّل مراجعات التصميم والكود.

مثالtext
تشريح حقل النص
┌─────────────────────────────────────────┐
  ① التسمية  "البريد الإلكتروني"        ② مؤشر الاختياري
┌─────────────────────────────────────────┐
│ ③ أيقونة البداية  ④ نص الإدخال   ⑤ فعل النهاية │  ← ⑥ الحاوية
└─────────────────────────────────────────┘
  ⑦ النص المساعد / رسالة الخطأ      ⑧ عدّاد الأحرف

المتغيرات والخصائص والأحجام

المتغيرات

نسخ بصرية لدرجات إبراز أو أغراض مختلفة: أساسي، ثانوي، ثالثي، هدّام. ولكل متغير قاعدة واضحة "متى يُستخدم".

الخصائص

خيارات يمكن الجمع بينها: الحجم (sm وmd وlg)، والأيقونة (لا شيء، بداية، نهاية، أيقونة فقط)، والعرض الكامل (نعم/لا)، والتحميل (نعم/لا).

الأحجام

أحجام ثابتة مربوطة برموز الأحجام والمسافات، حتى تتحاذى المكوّنات من الحجم نفسه في صف واحد.

خطأ شائع: انفجار المتغيرات. كل متغير جديد يضاعف عمل التصميم والكود والاختبار والتوثيق — زر بـ5 متغيرات × 3 أحجام × 4 خيارات أيقونة × 6 حالات يعني بالفعل 360 تركيبة. أضف المتغيرات فقط عند وجود حاجة حقيقية متكررة.

الحالات

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

معاينة حية

Button

Default

Button

Hover

Button

Focus

Button

Pressed

Button

Disabled

Button

Loading

الإعداد مقابل التكوين

هناك طريقتان لجعل المكوّنات مرنة:

  • الإعداد (Configuration) — مكوّن واحد بخصائص كثيرة: <Card title image badge footer actions variant />. سهل الاستخدام للحالات الشائعة، لكن الخصائص تتراكم مع نمو الاحتياجات.
  • التكوين (Composition) — أجزاء أصغر تُجمع بحرية: <Card><Card.Media/><Card.Body/><Card.Actions/></Card>. أكثر مرونة للتخطيطات غير المعتادة، لكن فيه ما يُتعلم أكثر.

تستخدم أنظمة كثيرة الاثنين: الإعداد للمكوّنات البسيطة شديدة الاتساق (Button وBadge)، والتكوين للحاويات ذات المحتوى المتنوع (Card وModal وTable).

تصميم واجهة برمجة المكوّن

واجهة البرمجة هي مجموعة الأسماء والخيارات التي يستخدمها الناس — في خصائص Figma وفي خصائص الكود. حافظ على تطابقها وقابليتها للتوقع.

  • استخدم الأسماء نفسها في خصائص Figma وخصائص الكود.
  • اختر قيمًا افتراضية معقولة حتى يكون أبسط استخدام هو الأكثر شيوعًا.
  • فضّل القيم المعدودة (variant="danger") على الخصائص المنطقية الكثيرة (isDanger isPrimary) التي قد تتعارض.
  • لا تكشف تجاوزات أنماط خام (ألوان وهوامش مخصصة) ما لم يلزم — فهي تقوّض الاتساق.
مثالtsx
type ButtonProps = {
  variant?: "primary" | "secondary" | "tertiary" | "danger"; // default "primary"
  size?: "sm" | "md" | "lg";                                   // default "md"
  iconStart?: React.ReactNode;
  iconEnd?: React.ReactNode;
  loading?: boolean;
  disabled?: boolean;
  fullWidth?: boolean;
  type?: "button" | "submit" | "reset";
  children: React.ReactNode; // the label
};

<Button variant="primary" size="md" iconEnd={<ArrowRight />}>Continue</Button>

قائمة تحقق المكوّن

قبل اعتبار المكوّن جاهزًا، تحقق من أن لديه:

  1. 1غرضًا واضحًا وإرشادات "متى يُستخدم / متى لا يُستخدم".
  2. 2تشريحًا مسمّى.
  3. 3كل المتغيرات والأحجام والحالات مصممة ومبنية.
  4. 4تنسيقًا بالرموز فقط — دون قيم مكتوبة مباشرة.
  5. 5سلوكًا متجاوبًا وحدودًا للمحتوى (التسميات الطويلة، الالتفاف، القص).
  6. 6دعمًا لـRTL.
  7. 7تفاعلًا بلوحة المفاتيح، وإدارة للتركيز، وتسميات لقارئات الشاشة.
  8. 8تباينًا مفحوصًا في كل السمات.
  9. 9مكوّن Figma ومكوّن كود متطابقين بالواجهة البرمجية نفسها.
  10. 10توثيقًا بأمثلة وما يجب فعله وتجنبه.
  11. 11اختبارات: انحدار بصري، وإمكانية وصول، واختبارات وحدات في الكود.

أهم النقاط

  • مكوّنات النظام لها تشريح محدد، وخيارات محدودة، وكل الحالات، وإمكانية وصول مدمجة، ونسخ متطابقة في التصميم والكود.
  • يُظهر التصميم الذري كيف تتركّب الأجزاء الصغيرة في أجزاء أكبر.
  • أضف المتغيرات فقط لاحتياجات حقيقية متكررة — فانفجار المتغيرات مكلف.
  • استخدم الإعداد للمكوّنات البسيطة والتكوين للحاويات المرنة.
  • طابِق واجهة البرمجة بين Figma والكود، مع قيم افتراضية جيدة وخيارات معدودة.

تمرين

حدد مواصفات مكوّن

  1. اختر مكوّنًا: حقل نص، أو قائمة منسدلة، أو بطاقة.
  2. ارسم تشريحه وسمِّ كل جزء.
  3. اكتب المتغيرات والأحجام والحالات، واحذف ما لا يلزم فعلًا.
  4. اكتب واجهته البرمجية كنوع TypeScript وكخصائص Figma بالأسماء نفسها.
  5. مُرّ على قائمة تحقق المكوّن ودوّن ما ينقص.

اختبر نفسك

اختبار: المكوّنات

5 أسئلة. احصل على 70٪ أو أكثر لإكمال الدرس.

  1. 1.في التصميم الذري، حقل بحث مكوّن من حقل وزر هو…
  2. 2.أي حالة يعتمد عليها مستخدمو لوحة المفاتيح أكثر؟
  3. 3.لماذا نُبقي عدد المتغيرات قليلًا؟
  4. 4.لماذا نفضّل variant="danger" على خصائص منطقية مثل isDanger وisPrimary؟
  5. 5.مكوّن مكوّن من أجزاء تُجمع بحرية مثل Card.Media وCard.Body يستخدم…