تخطّي إلى المحتوى الرئيسي

استوديو السمات

استوديو السمات أداة تفاعلية: اختر قالبًا مسبق الإعداد، عدِّل كل رمز لوني، عاين النتيجة فوريًا، ثم صدِّر ملف SCSS جاهزًا للاستخدام مباشرة.

主色
主色
悬停
按压
主色底
主色边框
主色衍生
主色底文字
选中态文字
功能色
成功
警告
危险
信息
文本
主要文字
常规文字
次要文字
背景
容器背景
页面背景
边框
基础边框
浅边框
معاينة فورية
وسم أساسيوسم نجاحوسم خطر

نص أساسي·نص عادي·نص ثانوي

الرموز التي تُعدّلها تطبَّق على منطقة المعاينة فقط (نفس آلية ConfigProvider)؛ الملف المُصدَّر يشمل دعم الوضع الداكن.

تصدير SCSS

طريقة الاستخدام​

  1. اختيار القالب المسبق: بدِّل عبر القائمة المنسدلة العلوية بين خمسة ألواح ألوان مدمجة (青花瓷 (الخزف الأزرق) / 松花绿 (أخضر الصنوبر) / 朱砂 (زنجفر) / 水墨 (رسم الحبر) / 藤黄 (أصفر عشبي))، ويغطّي القالب المسبق ما يصرِّح به من رموز فقط، بينما تحتفظ البقية بقيمها الحالية.
  2. تعديل الرموز: لكل مجموعة رموز منتقي ألوان وحقل نص hex متزامنان. والرموز الاختيارية الموصومة بـ «تابع للسلسلة الافتراضية» (مثل --lh-selected-color) تُترَك فارغةً لتتبع علاقة الاشتقاق الافتراضية في ورقة الأنماط.
  3. المعاينة: تُصوِّر منطقة المعاينة مكوّنات حقيقية من lh-ui، وتُحقَن الرموز كمتغيّرات CSS موضعية (بالآلية نفسها لـ LhConfigProvider) فتؤثر في المعاينة وحدها دون التأثير في الموقع. وبدِّل بين الفاتح / الداكن لرؤية التكيُّف مع الوضع الداكن.
  4. التصدير: يحتوي نص 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> فقط

عند تطبيق متغيّرات القالب المسبق يجب كتابتها في عنصر <style> (خصوصية 0,1,0)، لا في النمط المضمَّن لـ documentElement — فالخصوصية المضمَّنة 1,0,0,0 أعلى من أي ورقة أنماط، وستطغي على كتلة متغيّرات الوضع الداكن بأكملها في var-dark.scss ممَّا يُفسِد ألوان الوضع الداكن. وكل من useLhPresetTheme في المكتبة وسكربت منع الوميض في هذا الموقع يلتزمان بهذه القاعدة.

تباين الألوان الأساسية الفاتحة

القوالب ذات اللون الأساسي الفاتح (مثل 松花绿) تحتاج إلى تعيين --lh-color-on-primary صراحةً (استخدام الحبر الداكن على أرضية اللون الأساسي) و--lh-selected-color (تعميق نص حالة التحديد)، وإلا فإن النص الأبيض على اللون الأساسي الفاتح لا يحقِّق نسبة التباين AA. وقد عولجت القوالب المدمجة، فعليك فحص ذلك بنفسك عند التخصيص.

العلاقة بنسخة Vue

نُقِلت أداة هذه الصفحة من ThemeStudio في lh-ui-plus، والقيم الافتراضية للرموز والتجميعات ومنطق اشتقاق الوضع الداكن كلها متطابقة، فيصلح ملف SCSS المُصدَّر للاستخدام في المكتبتين (تُعرَّف الرموز في الطبقة المشتركة @lh-ui/share/styles/theme/common/var.scss).