تخصيص الثيم
الثيم ملف Figma ومجموعة رموز تصميم: ما يغيّره، وما لا يغيّره أبدًا، وكيف تخصّص الثيم الافتراضي دون أن تخسر العربية.
الثيم ملف Figma ومجموعة رموز تصميم. مكوّنات Ritla UI لا تقرأ إلا رموز التصميم، فالثيم يقرّر شكلها، والمكوّنات تقرّر سلوكها: الاتجاه والأرقام ولوحة المفاتيح وإمكانية الوصول. والثيم الافتراضي هو الأول، ويأتي به كل مكوّن.
يضيف الثيم قيمه بجانب قيم Tailwind الافتراضية ولا يغيّر أي صنف من أصنافك، فيعمل في التطبيقات الجديدة والقائمة: راجع التثبيت. والاستثناء الوحيد متغير في ثيمك يحمل اسمًا يطابق تمامًا أحد أسماء الثيم (رموز التصميم).
ما الثيم#
- ملف Figma. فيه كل لون ونمط نص وزاوية ومسافة متغيرًا، وكل مكوّن بنسختين من اليسار إلى اليمين ومن اليمين إلى اليسار. هنا يعمل المصممون.
- مجموعة رموز التصميم. المتغيرات نفسها مبنية في ملف المتغيرات و
theme.cssوtokens.json(راجع رموز التصميم). يثبّتها المطورون بالأمرnpx ritla init.
يأتي الاثنان من مصدر واحد هو متغيرات Figma، فيصل تعديل المصمم إلى الكود تغييرًا في رمز تصميم، لا قيمةً منسوخة باليد.
ما يغيّره الثيم وما لا يغيّره#
يغيّر الثيم القيم: الألوان في الوضعين، وعائلتي الخط اللاتيني والعربي، وأحجام النص وارتفاع الأسطر، والزوايا والمسافات والظلال والحركة.
ولا يغيّر السلوك أبدًا. أي الأيقونات تنعكس، وكيف تُنسَّق الأرقام، وكيف تبقى حقول الهاتف والبطاقة من اليسار إلى اليمين، وكيف ترث الطبقات الاتجاه واللغة: كل ذلك في المكوّنات وفي @ritla/core، ويبقى كما هو أيًّا كان الثيم. أما قواعد الخط التي على الثيم أن يحافظ عليها فتجدها أدناه.
خصّص الثيم الافتراضي#
غيّر قيمة رمز التصميم في ملف أنماطك، بعد أسطر @import التي أضافها npx ritla init، في المستوى الذي تحتاجه. كل متغيّر CSS لرمز تصميم يبدأ بـ --ritla-، ويذكره tokens.json لكل رمز باسم cssVar:
/* After the theme's @import lines */:root { --ritla-radius-8: 6px; /* a radius, spacing or motion token's cssVar: your value */}للزوايا والمسافات والحركة قيمة واحدة، فيكفي :root. أما الألوان فلها قيمة لكل وضع، والخطوط قيمة لكل لغة: غيّرها بالمحددات نفسها التي تستخدمها ملفات الثيم، وإلا لن تتغير قيمتها في الوضع الداكن أو في العربية. وتأخذ القيم الداكنة محدد الملف الداكن الذي استوردته: .dark، أو [data-theme="dark"]، أو مع ملف إعداد النظام :root:not(.light, [data-theme="light"]) داخل @media (prefers-color-scheme: dark).
/* Colors: once per mode, with the selectors the theme's files use */:root, .light, [data-theme="light"] { /* the color's cssVar: your light value */ }.dark, [data-theme="dark"] { /* the color's cssVar: your dark value */ } /* Type: once per language */:root, :lang(en) { /* the body font's cssVar: your Latin face, then the Arabic face */ }:lang(ar) { /* the body font's cssVar: the Arabic face, then your Latin face */ }غيّر رموز التصميم الدلالية (ما يعنيه سطحٌ أو قوةُ نص) لا الأصناف على المكوّنات، فتأخذ المكوّنات القيمة الجديدة في كل مكان دفعة واحدة. إن غيّرت لون العلامة، فأبقِ تباينه مع النص الأبيض عند 4.5:1 على الأقل، وأبقِ ألوان النص الذي يحتاج الناس إلى قراءته بتباين يحقق معيار WCAG AA على الأسطح التي يظهر عليها، في الوضعين.
الخطوط#
تقرأ المكوّنات عائلة الخط من ثلاثة متغيرات، وإن لم يُضبط أحدها عادت إلى خطوط الثيم لكل لغة:
| الصنف | المتغيّر |
|---|---|
font-family-body | --ritla-font-sans |
font-family-display | --ritla-font-display |
font-family-numeric | --ritla-font-numeric |
لتستخدم خطك في كل المكوّنات، أضف سطرًا واحدًا بعد أسطر استيراد الثيم، وأبقِ var(--ritla-font-arabic) في السلسلة لتبقى العربية بخطها العربي:
:root { --ritla-font-sans: "Inter", var(--ritla-font-arabic), system-ui, sans-serif; }ولتستخدم الخط نفسه في العناوين، اضبط --ritla-font-display في السطر نفسه.
أما npx ritla init --font app فيسلك الطريق الآخر: ترث المكوّنات خط صفحتك (التثبيت). أما font-mono فمن Tailwind نفسه، فالكود يتبع أصلًا خط تطبيقك ذا العرض الثابت.
العربية في الثيم#
على الثيم أن يحمل خطًا عربيًا، لا خطًا لاتينيًا وحده. يقرن الثيم الافتراضي خط Geist بخط IBM Plex Sans Arabic، ويعطي العربية ارتفاعات أسطرها الخاصة دون تباعد بين الحروف، ويضع العائلتين في كل سلسلة خطوط فلا تسقط العربية إلى خط النظام. والثيم المخصص يحافظ على هذه القواعد: راجع مبادئ العربية والاتجاه.
ثيمات أخرى#
ثيمات أخرى في الخطة على أسماء رموز التصميم نفسها، فيكون استبدال ثيم بآخر تغييرًا في CSS. راجع الثيمات لما هو متاح اليوم.