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

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

رموز التصميم

كل شيء عن رموز التصميم: ما هي، وأنواعها، والطبقات الثلاث (أولية، دلالية، خاصة بالمكوّن)، وأعراف التسمية، والسمات، وصيغة رموز W3C، وكيف تنتقل الرموز من Figma إلى الكود.

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

ما هو رمز التصميم؟

رمز التصميم (Design token) قيمة مسمّاة تخزّن قرار تصميم: color-action-primary = #146ef5، وspace-4 = 16px، وradius-md = 8px. فبدلًا من كتابة القيم مباشرة في مئات الأماكن، يشير المصممون والمطورون إلى اسم الرمز.

الرموز هي الجسر بين التصميم والكود. الأسماء نفسها موجودة في Figma (كمتغيرات) وفي الكود (كمتغيرات CSS، وثوابت iOS/Android، وJSON). وعندما تتغير قيمة، تتغير في كل مكان يستخدم الرمز.

مثال · لماذا توفر الرموز الوقت

تغيّر شركة لونها الأزرق. دون رموز، يبحث شخص ما في الكود عن #146ef5 — ويفوّت الأماكن التي تستخدم #146EF5 أو rgb(20,110,245) أو أزرق مختلفًا قليلًا اختاره أحدهم بالنظر.

مع الرموز، يحدّث الفريق قيمة واحدة — color.blue.500 — فيتحدث كل زر ورابط وحلقة تركيز، في التصميم والكود.

أنواع الرموز

النوعأمثلة
اللونألوان العلامة، والمحايدات، والنص، والسطح، والحدود، والحالة
الطباعةعائلة الخط، والحجم، والوزن، وارتفاع السطر، وتباعد الحروف — وغالبًا تُجمع في أنماط نص مركّبة
المسافات4، 8، 12، 16، 24، 32…
الأحجامأحجام الأيقونات، وارتفاعات عناصر التحكم، وأحجام الصور الشخصية
نصف قطر الزواياnone وsm وmd وlg وfull
الحدودالسماكات والأنماط
الارتفاع / الظلshadow-1 وshadow-2 وshadow-3
الحركةالمدد ومنحنيات التسارع
الشفافية، وترتيب الطبقات، ونقاط التوقفشفافية الطبقة المعتمة، وترتيب الطبقات، وعروض الشاشة

الطبقات الثلاث

تنظّم معظم الأنظمة الناضجة الرموز في طبقات، تشير كل منها إلى التي تحتها:

1. الرموز الأولية (العامة، الأساسية)

اللوحة الخام للقيم المتاحة، بأسماء تصف القيمة نفسها: blue-500 وgray-100 وspace-4 وfont-size-16. لا تقول شيئًا عن طريقة استخدام القيمة. ويجب ألا تستخدمها المكوّنات مباشرة.

2. الرموز الدلالية (المستعارة)

أسماء تصف الغرض: color-text-primary وcolor-surface وcolor-action-primary وcolor-border-error وspace-inset-md. تشير إلى الرموز الأولية. وهذه هي الطبقة التي تستخدمها معظم المكوّنات، والتي تعيد ربطها للسمات.

3. رموز المكوّنات (اختيارية)

قيم خاصة بمكوّن واحد: button-primary-background وinput-border-radius. تشير إلى الرموز الدلالية وتمنح تحكمًا دقيقًا. وتتخطى فرق كثيرة هذه الطبقة حتى تحتاجها، لأنها تضاعف عدد الرموز.

معاينة حية

1. Primitive

blue-500

#146ef5

2. Semantic

color-action-primary

→ blue-500

3. Component

button-primary-bg

→ color-action-primary

مثالcss
:root {
  /* 1. primitives */
  --blue-500: #146ef5;
  --blue-600: #0d5ad6;
  --gray-0:   #ffffff;
  --gray-900: #0f0f0d;

  /* 2. semantic */
  --color-action-primary:       var(--blue-500);
  --color-action-primary-hover: var(--blue-600);
  --color-surface:              var(--gray-0);
  --color-text-primary:         var(--gray-900);

  /* 3. component */
  --button-primary-bg:       var(--color-action-primary);
  --button-primary-bg-hover: var(--color-action-primary-hover);
}

.button-primary { background: var(--button-primary-bg); }
.button-primary:hover { background: var(--button-primary-bg-hover); }

تسمية الرموز

الأسماء هي واجهة برمجة نظام التصميم. بنية شائعة تنتقل من العام إلى الخاص:

افعل

  • استخدم ترتيبًا وفاصلًا ثابتين (نقاط أو شرطات).
  • سمِّ الرموز الدلالية حسب الغرض: text وsurface وborder وaction.
  • استخدم مقاييس قابلة للتوقع: sm/md/lg أو 100–900.
  • وثّق كل رمز بقيمته واستخدامه.

لا تفعل

  • تسمّي الرموز الدلالية باللون: color-blue-button ينكسر عندما تتحول العلامة إلى الأخضر.
  • تخلط أساليب التسمية: textPrimary وtext-secondary وTEXT_MUTED.
  • تنشئ رمزًا لكل قيمة منفردة.
  • تدع المكوّنات تشير إلى الرموز الأولية مباشرة.
مثالtext
[category]-[concept/property]-[variant]-[state]

color-text-primary
color-text-secondary
color-action-primary-hover
color-border-error
space-inset-md
radius-control
motion-duration-fast

السمات بالرموز

لأن المكوّنات تستخدم الرموز الدلالية، تستطيع إنشاء سمات — فاتحة، وداكنة، وعالية التباين، أو علامات مختلفة — بإعادة ربط الطبقة الدلالية وحدها.

الرمز الدلاليالسمة الفاتحةالسمة الداكنة
color-surfacegray-0 (#FFFFFF)gray-950 (#121212)
color-text-primarygray-900gray-50
color-action-primaryblue-500blue-300
color-bordergray-200gray-800

الفكرة نفسها تدعم الأنظمة متعددة العلامات: مجموعة واحدة من المكوّنات، وعدة سمات للعلامات تربط الرموز الدلالية برموز أولية مختلفة.

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

تُخزَّن الرموز عادة بصيغة JSON. وقد نشرت مجموعة W3C لرموز التصميم مواصفة لصيغة مشتركة، تستخدم مفاتيح مثل $value و$type، مع إحالات مكتوبة بين أقواس معقوفة:

  1. 1يدير المصممون الرموز كـمتغيرات في Figma (أو بإضافة مثل Tokens Studio).
  2. 2تُصدَّر الرموز أو تُزامن كملف JSON إلى مستودع Git.
  3. 3تحوّل أداة بناء مثل Style Dictionary ملف JSON إلى مخرجات المنصات: متغيرات CSS، وSCSS، وSwift لـiOS، وXML/Compose لـAndroid، وJavaScript.
  4. 4تستورد التطبيقات هذه المخرجات. وأي تغيير في JSON يحدّث كل المنصات.
مثالjson
{
  "color": {
    "blue": {
      "500": { "$type": "color", "$value": "#146ef5" }
    },
    "action": {
      "primary": { "$type": "color", "$value": "{color.blue.500}" }
    }
  },
  "space": {
    "4": { "$type": "dimension", "$value": "16px" }
  }
}

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

أهم النقاط

  • الرموز قيم تصميم مسمّاة تتشاركها أدوات التصميم والكود.
  • استخدم الطبقات: أولية (قيم خام) ← دلالية (غرض) ← مكوّن (اختيارية).
  • يجب أن تستخدم المكوّنات الرموز الدلالية؛ وهذا ما يجعل السمات ممكنة.
  • سمِّ الرموز باتساق، حسب الغرض، من العام إلى الخاص.
  • خزّن الرموز في مصدر حقيقة واحد (غالبًا JSON بصيغة W3C) وولّد مخرجات المنصات بأدوات مثل Style Dictionary.

تمرين

ابنِ مجموعة رموز

  1. عرّف رموزًا أولية: مقياس أزرق من 9 درجات، ومقياس رمادي من 10 درجات، ومقياس مسافات.
  2. عرّف 10 رموز ألوان دلالية (النص، السطح، الحدود، الفعل، الخطأ…).
  3. اربطها لسمة فاتحة وأخرى داكنة.
  4. أنشئها كمتغيرات Figma بوضعين فاتح وداكن.
  5. اكتب الرموز نفسها كمتغيرات CSS ونسّق زرًا واحدًا بها.

اختبر نفسك

اختبار: رموز التصميم

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

  1. 1.ما هو رمز التصميم؟
  2. 2.أي رمز دلالي؟
  3. 3.لماذا يجب أن تشير المكوّنات إلى الرموز الدلالية بدلًا من الأولية؟
  4. 4.في JSON رموز W3C، ماذا تعني {color.blue.500}؟
  5. 5.ماذا تفعل أداة مثل Style Dictionary؟