استوديو السمات
استوديو السمات أداة تفاعلية: اختر قالبًا مسبق الإعداد، عدِّل كل رمز لوني، عاين النتيجة فوريًا، ثم صدِّر ملف SCSS جاهزًا للاستخدام مباشرة.
نص أساسي·نص عادي·نص ثانوي
الرموز التي تُعدّلها تطبَّق على منطقة المعاينة فقط (نفس آلية ConfigProvider)؛ الملف المُصدَّر يشمل دعم الوضع الداكن.
طريقة الاستخدام
- اختيار القالب المسبق: بدِّل عبر القائمة المنسدلة العلوية بين خمسة ألواح ألوان مدمجة (青花瓷 (الخزف الأزرق) / 松花绿 (أخضر الصنوبر) / 朱砂 (زنجفر) / 水墨 (رسم الحبر) / 藤黄 (أصفر عشبي))، ويغطّي القالب المسبق ما يصرِّح به من رموز فقط، بينما تحتفظ البقية بقيمها الحالية.
- تعديل الرموز: لكل مجموعة رموز منتقي ألوان وحقل نص hex متزامنان. والرموز الاختيارية الموصومة بـ «تابع للسلسلة الافتراضية» (مثل
--lh-selected-color) تُترَك فارغةً لتتبع علاقة الاشتقاق الافتراضية في ورقة الأنماط. - المعاينة: تُصوِّر منطقة المعاينة مكوّنات حقيقية من lh-ui، وتُحقَن الرموز كمتغيّرات CSS موضعية (بالآلية نفسها لـ
LhConfigProvider) فتؤثر في المعاينة وحدها دون التأثير في الموقع. وبدِّل بين الفاتح / الداكن لرؤية التكيُّف مع الوضع الداكن. - التصدير: يحتوي نص SCSS المُصدَّر (منسوخًا أو محمَّلًا) على كتلة رموز
:rootوكتلة الوضع الداكن[data-theme='dark']، ومنطق الوضع الداكن يستمد من آلية القوالب المسبقة في share بالكامل (القوالب ذات الألوان الأساسية الداكنة تُفتِّح لونها الأساسي تلقائيًا في الوضع الداكن، وإلا انصهر الزر مع الخلفية).
بنية النص المُصدَّر
/* سمة lh-ui مخصَّصة — أُنشئت بواسطة استوديو السمات (2026-01-01) */
@use '@lh-ui/share/styles/index.scss';
:root {
--lh-primary-color: #2B4C7C;
/* ... */
}
[data-theme='dark'],
.dark {
--lh-primary-color-bg: color-mix(in srgb, var(--lh-primary-color) 25%, transparent);
/* ... */
}
- يُدرِج
@useخط الأساس الكامل للرموز، وتغطِّي كتلة:rootالرموز المُعدَّلة فقط. - تُشتَقّ كتلة الوضع الداكن عبر
buildPresetDarkVars، وهي مطابقة تمامًا لما تراه في منطقة المعاينة.
ملاحظات
عند تطبيق متغيّرات القالب المسبق يجب كتابتها في عنصر <style> (خصوصية 0,1,0)، لا في النمط المضمَّن لـ documentElement — فالخصوصية المضمَّنة 1,0,0,0 أعلى من أي ورقة أنماط، وستطغي على كتلة متغيّرات الوضع الداكن بأكملها في var-dark.scss ممَّا يُفسِد ألوان الوضع الداكن. وكل من useLhPresetTheme في المكتبة وسكربت منع الوميض في هذا الموقع يلتزمان بهذه القاعدة.
القوالب ذات اللون الأساسي الفاتح (مثل 松花绿) تحتاج إلى تعيين --lh-color-on-primary صراحةً (استخدام الحبر الداكن على أرضية اللون الأساسي) و--lh-selected-color (تعميق نص حالة التحديد)، وإلا فإن النص الأبيض على اللون الأساسي الفاتح لا يحقِّق نسبة التباين AA. وقد عولجت القوالب المدمجة، فعليك فحص ذلك بنفسك عند التخصيص.
نُقِلت أداة هذه الصفحة من ThemeStudio في lh-ui-plus، والقيم الافتراضية للرموز والتجميعات ومنطق اشتقاق الوضع الداكن كلها متطابقة، فيصلح ملف SCSS المُصدَّر للاستخدام في المكتبتين (تُعرَّف الرموز في الطبقة المشتركة @lh-ui/share/styles/theme/common/var.scss).