أنظمة التصميم · الدرس 12 / 13
من التصميم إلى الكود
كيف يعيش نظام التصميم في الكود: خط إنتاج الرموز، وبناء مكتبة المكوّنات، ومطابقة الواجهات البرمجية، والسمات، والتحزيم والإصدارات، وStorybook، والاختبارات البصرية واختبارات إمكانية الوصول، والحفاظ على تزامن Figma والكود.
3 دقائق قراءة · 5 أسئلة
التصميم والكود: نظام واحد في مكانين
نظام التصميم الموجود في Figma فقط هو مجموعة واجهات. أما النظام الحقيقي فيعيش في الكود أيضًا — في مكتبة مكوّنات تثبّتها فرق المنتجات وتستخدمها. والتحدي هو إبقاء الجانبين متزامنين بحيث يكون ما يضعه المصممون في Figma هو بالضبط ما يستطيع المطورون بناءه.
الهدف هو التكافؤ: الرموز نفسها، والمكوّنات نفسها، والأسماء نفسها، والخيارات نفسها، والحالات نفسها.
خط إنتاج الرموز
- 1مصدر الحقيقة — تُعرَّف الرموز في مكان واحد: متغيرات Figma، أو إضافة للرموز، أو JSON في مستودع Git.
- 2التصدير — تُصدَّر الرموز كـJSON، ويُفضّل بصيغة رموز تصميم W3C.
- 3التحويل — تحوّل أداة بناء مثل Style Dictionary ملف JSON إلى صيغ المنصات.
- 4التوزيع — تُنشر المخرجات في حزمة تثبّتها التطبيقات.
- 5الاستخدام — تستخدم المكوّنات والتطبيقات أسماء الرموز، لا القيم الخام أبدًا.
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 / Danger | variant="primary" | "secondary" | "danger" |
| Size = SM / MD / LG | size="sm" | "md" | "lg" |
| Show icon = true (منطقية) | iconStart={<Icon />} |
| Label = "Continue" (نص) | children="Continue" |
| State = Disabled | disabled |
| State = Hover / Focus / Pressed | تتولاها CSS (:hover و:focus-visible و:active) — ليست خصائص |
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 والكود عن قصد.
تمرين
اعكس مكوّنًا في الكود
- خذ الزر الذي بنيته في Figma.
- اكتب خصائصه كنوع TypeScript يعكس خصائص Figma.
- نفّذه بمتغيرات CSS من رموزك (بأي إطار، أو HTML/CSS عادي).
- أضف أنماط المرور والتركيز المرئي والنشاط والتعطيل والتحميل.
- املأ جدول تكافؤ يقارن نسختي Figma والكود.
اختبر نفسك
اختبار: من التصميم إلى الكود
5 أسئلة. احصل على 70٪ أو أكثر لإكمال الدرس.
