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

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

من التصميم إلى الكود

كيف يعيش نظام التصميم في الكود: خط إنتاج الرموز، وبناء مكتبة المكوّنات، ومطابقة الواجهات البرمجية، والسمات، والتحزيم والإصدارات، وStorybook، والاختبارات البصرية واختبارات إمكانية الوصول، والحفاظ على تزامن Figma والكود.

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

التصميم والكود: نظام واحد في مكانين

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

الهدف هو التكافؤ: الرموز نفسها، والمكوّنات نفسها، والأسماء نفسها، والخيارات نفسها، والحالات نفسها.

خط إنتاج الرموز

  1. 1مصدر الحقيقة — تُعرَّف الرموز في مكان واحد: متغيرات Figma، أو إضافة للرموز، أو JSON في مستودع Git.
  2. 2التصدير — تُصدَّر الرموز كـJSON، ويُفضّل بصيغة رموز تصميم W3C.
  3. 3التحويل — تحوّل أداة بناء مثل Style Dictionary ملف JSON إلى صيغ المنصات.
  4. 4التوزيع — تُنشر المخرجات في حزمة تثبّتها التطبيقات.
  5. 5الاستخدام — تستخدم المكوّنات والتطبيقات أسماء الرموز، لا القيم الخام أبدًا.
مثالtext
tokens/*.json  ──▶  Style Dictionary  ──▶  build/
                                           ├── css/variables.css     (--color-action-primary)
                                           ├── js/tokens.ts          (colorActionPrimary)
                                           ├── ios/Tokens.swift      (Color.actionPrimary)
                                           └── android/colors.xml    (@color/action_primary)

بناء مكتبة المكوّنات

  • اختر أطر العمل التي تستخدمها منتجاتك (مثل React للويب، وSwiftUI لـiOS، وJetpack Compose لـAndroid). وتقدّم أنظمة كثيرة أيضًا Web Components لتعمل عبر الأطر.
  • ابنِ المكوّنات على أسس متاحة للجميع — العناصر الأصلية، أو مكتبات "بلا واجهة" مجرّبة (مثل Radix UI أو React Aria أو Headless UI) تتولى سلوك لوحة المفاتيح وARIA.
  • نسّق المكوّنات بالرموز فقط.
  • ادعم السمات عبر متغيرات CSS أو مزوّد سمات.
  • ادعم RTL بالخصائص المنطقية.
  • اجعل المكوّنات قابلة للتكوين ومرّر المراجع والخصائص الأصلية حتى لا تُعاق الفرق.

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

يجب أن تكون خصائص Figma وخصائص الكود ترجمة مباشرة لبعضها:

خاصية Figmaخاصية الكود
Variant = Primary / Secondary / Dangervariant="primary" | "secondary" | "danger"
Size = SM / MD / LGsize="sm" | "md" | "lg"
Show icon = true (منطقية)iconStart={<Icon />}
Label = "Continue" (نص)children="Continue"
State = Disableddisabled
State = Hover / Focus / Pressedتتولاها CSS (:hover و:focus-visible و:active) — ليست خصائص
مثالtsx
import { Button } from "@acme/design-system";
import { ArrowRight } from "@acme/icons";

export function CheckoutFooter() {
  return (
    <Button variant="primary" size="md" iconEnd={<ArrowRight />}>
      Continue to payment
    </Button>
  );
}

حالات التفاعل مثل المرور والتركيز تُصمَّم في Figma كمتغيرات، لكنها في الكود عادة حالات CSS لا خصائص. وثّق ذلك حتى لا يتوقع المصممون خاصية state.

التحزيم والإصدارات

  • انشر المكتبة كحزمة (مثل npm أو سجل خاص) حتى تثبّت المنتجات إصدارًا محددًا.
  • استخدم الإصدارات الدلالية: MAJOR للتغييرات الكاسرة، وMINOR للميزات الجديدة، وPATCH للإصلاحات.
  • اكتب سجل تغييرات لكل إصدار، مع ملاحظات الترحيل للتغييرات الكاسرة.
  • فكّر في Codemods — سكربتات تحدّث كود المنتجات تلقائيًا للتغييرات الكاسرة في الواجهة البرمجية.
  • أصدر بانتظام وبشكل قابل للتوقع حتى تخطط الفرق للترقيات.

التوثيق والاختبار في الكود

الممارسةما تفعله
قصص Storybookكل مكوّن ومتغير وحالة معروضة منفردة؛ مع خصائص تفاعلية
اختبارات الانحدار البصريمقارنة لقطات الشاشة مع كل تغيير لاكتشاف التغييرات البصرية غير المقصودة (مثل Chromatic ولقطات Playwright)
اختبارات إمكانية الوصولفحوص axe آلية في القصص واختبارات الوحدات؛ وفحوص يدوية بلوحة المفاتيح وقارئ الشاشة
اختبارات الوحدات / التفاعلالسلوك: النقر، والكتابة، والتنقل بلوحة المفاتيح، وإدارة التركيز
فحص الأنواعأنواع TypeScript توثّق الواجهة البرمجية وتمنع الخصائص غير الصالحة

الحفاظ على تزامن Figma والكود

  • استخدم الأسماء نفسها للرموز والمكوّنات والخصائص في المكانين.
  • أتمت مزامنة الرموز حتى لا تتباعد القيم.
  • استخدم Figma Dev Mode وCode Connect (حيث يتوفر) حتى يُظهر فحص المكوّن في Figma مقتطف الكود الحقيقي.
  • أشرك المصممين والمطورين في مراجعات بعضهم: المكوّن "منجز" فقط عندما يوجد ويتطابق ويُوثَّق على الجانبين.
  • تتبّع التكافؤ في جدول بسيط: المكوّن، وحالة Figma، وحالة الكود، وحالة التوثيق.
المكوّنFigmaالكودالتوثيق
Buttonمستقرمستقرمكتمل
Text fieldمستقرمستقرمكتمل
Date pickerتجريبيقيد العملمسودة
Data tableمخطط——

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

أهم النقاط

  • نظام التصميم الحقيقي يعيش في التصميم والكود معًا، مع تكافؤ بينهما.
  • تتدفق الرموز من مصدر حقيقة واحد عبر أدوات مثل Style Dictionary إلى كل منصة.
  • ابنِ مكوّنات متاحة للجميع، منسقة بالرموز، قابلة للسمات، بواجهات برمجية تعكس خصائص Figma.
  • حزّم بالإصدارات الدلالية وسجلات التغييرات وملاحظات الترحيل.
  • اختبر بصريًا وللإتاحة وللسلوك، وحافظ على تزامن Figma والكود عن قصد.

تمرين

اعكس مكوّنًا في الكود

  1. خذ الزر الذي بنيته في Figma.
  2. اكتب خصائصه كنوع TypeScript يعكس خصائص Figma.
  3. نفّذه بمتغيرات CSS من رموزك (بأي إطار، أو HTML/CSS عادي).
  4. أضف أنماط المرور والتركيز المرئي والنشاط والتعطيل والتحميل.
  5. املأ جدول تكافؤ يقارن نسختي Figma والكود.

اختبر نفسك

اختبار: من التصميم إلى الكود

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

  1. 1.ماذا يعني "التكافؤ" بين التصميم والكود؟
  2. 2.ماذا تفعل أداة مثل Style Dictionary؟
  3. 3.إعادة تسمية خاصية مكوّن هي أي نوع من الإصدارات؟
  4. 4.في الكود، حالات المرور والتركيز عادة…
  5. 5.ماذا تكتشف اختبارات الانحدار البصري؟