تكوين UnoCSS
التكوين
التكوينات هي ما يجعل UnoCSS قوياً.
- القواعد - تعريف أدوات CSS الذرية
- الاختصارات - دمج قواعد متعددة في اختصار واحد.
- السمة - تعريف متغيرات السمة.
- المتغيرات - تطبيق اتفاقيات مخصصة على القواعد.
- المستخرجون - تعريف مكان وكيفية استخراج استخدامات الأدوات.
- Preflights - تعريف CSS الخام العام.
- الطبقات - تعريف ترتيب كل طبقة أدوات.
- الإعدادات المسبقة - تكوينات محددة مسبقاً لحالات الاستخدام الشائعة.
- المحولون - محولات الكود إلى كود المصدر للمستخدم لدعم الاتفاقيات.
- الإكمال التلقائي - تعريف اقتراحات الإكمال التلقائي المخصصة.
الخيارات
rules
- النوع:
Rule<Theme>[]
قواعد لتوليد أدوات CSS. الإدخالات اللاحقة لها أولوية أعلى.
shortcuts
- النوع:
UserShortcuts<Theme>
مشابه لاختصارات Windi CSS، يسمح لك بإنشاء أدوات جديدة عن طريق دمج الموجودة. الإدخالات اللاحقة لها أولوية أعلى.
theme
- النوع:
Theme
كائن السمة للتكوين المشترك بين القواعد.
extendTheme
- النوع:
Arrayable<ThemeExtender<Theme>>دوال مخصصة تغير كائن السمة.
من الممكن أيضاً إرجاع كائن سمة جديد لاستبدال الأصلي بالكامل.
variants
- النوع:
Variant<Theme>[]
متغيرات تعالج محددات مسبقاً، لديها القدرة على إعادة كتابة كائن CSS.
extractors
- النوع:
Extractor[]
مستخرجون للتعامل مع ملف المصدر وإخراج الفئات/المحددات المحتملة. يمكن أن يكون واعياً باللغة.
preflights
- النوع:
Preflight<Theme>[]
حقن CSS الخام.
layers
- النوع:
Record<string, number>
ترتيبات الطبقات. افتراضي 0.
outputToCssLayers
- النوع:
boolean | UseCssLayersOptions - افتراضي:
false
يخرج الطبقات إلى CSS Cascade Layers.
cssLayerName
- النوع:
(internalLayer: string) => string | undefined | null
يحدد اسم طبقة CSS التي يجب إخراج الطبقة الداخلية إليها (يمكن أن تكون طبقة فرعية على سبيل المثال "mylayer.mysublayer").
إذا تم إرجاع undefined، سيتم استخدام اسم الطبقة الداخلية كاسم طبقة CSS. إذا تم إرجاع null، لن يتم إخراج الطبقة الداخلية إلى طبقة CSS.
sortLayers
- النوع:
(layers: string[]) => string[]
دالة مخصصة لترتيب الطبقات.
presets
- النوع:
(PresetOrFactory<Theme> | PresetOrFactory<Theme>[])[]
تكوينات محددة مسبقاً لحالات الاستخدام الشائعة.
transformers
- النوع:
SourceCodeTransformer[]
محولات مخصصة للكود المصدري.
blocklist
- النوع:
BlocklistRule[]
قواعد لاستبعاد المحددات لنظام التصميم الخاص بك (لتضييق الاحتمالات). يمكن أن يساعد دمج خيارات warnExcluded أيضاً في تحديد الاستخدامات الخاطئة.
safelist
- النوع:
string[]
الأدوات التي يتم تضمينها دائماً.
preprocess
- النوع:
Arrayable<Preprocessor>
معالجة مسبقة للأدوات الواردة، إرجاع قيمة falsy للاستبعاد.
postprocess
- النوع:
Arrayable<Postprocessor>
معالجة لاحقة لكائن utils المُنشأ.
separators
- النوع:
Arrayable<string> - افتراضي:
[':', '-']
فاصل المتغير.
extractorDefault
- النوع:
Extractor | null | false - افتراضي:
import('@unocss/core').defaultExtractor
المستخرج الافتراضي الذي يتم تطبيقه دائماً. افتراضياً يقسم الكود المصدري حسب المسافات البيضاء والاقتباسات.
قد يتم استبداله بواسطة الإعداد المسبق أو تكوين المستخدم، يمكن تقديم مستخرج افتراضي واحد فقط، المستخرج اللاحق سيتجاوز السابق.
مرر null أو false لتعطيل المستخرج الافتراضي.
autocomplete
خيارات إضافية للإكمال التلقائي.
templates
- النوع:
Arrayable<AutoCompleteFunction | AutoCompleteTemplate>
دوال/قوالب مخصصة لتوفير اقتراحات الإكمال التلقائي.
extractors
- النوع:
Arrayable<AutoCompleteExtractor>
مستخرجون مخصصون لالتقاط الفئات المحتملة وتحويل اقتراحات نمط اسم الفئة إلى التنسيق الصحيح.
shorthands
- النوع:
Record<string, string | string[]>
اختصارات مخصصة لتوفير اقتراحات الإكمال التلقائي. إذا كانت القيم مصفوفة، سيتم ربطها بـ | ولفها بـ ().
content
خيارات للمصادر ليتم استخراجها كاستخدامات أدوات.
المصادر المدعومة:
filesystem- استخراج من نظام الملفاتinline- استخراج من نص مضمن عاديpipeline- استخراج من خط أنابيب التحويل لأدوات البناء، مثل Vite و Webpack
سيتم دمج الاستخدام المستخرج من كل مصدر معاً.
filesystem
- النوع:
string[] - افتراضي:
[]
أنماط glob للاستخراج من نظام الملفات، بالإضافة إلى مصادر المحتوى الأخرى.
في وضع التطوير، سيتم مراقبة الملفات وتشغيل HMR.
inline
- النوع:
string | { code: string; id?: string } | (() => Awaitable<string | { code: string; id?: string }>)) []
نص مضمن ليتم استخراجه.
pipeline
مرشحات لتحديد ما إذا كان سيتم استخراج وحدات معينة من خط أنابيب التحويل لأدوات البناء.
يعمل حالياً فقط لتكاملات Vite و Webpack.
اضبط false للتعطيل.
include
- النوع:
FilterPattern - افتراضي:
[/\.(vue|svelte|[jt]sx|mdx?|astro|elm|php|phtml|html)($|\?)/]
أنماط ترشح الملفات التي يتم استخراجها. يدعم التعبيرات العادية وأنماط glob picomatch.
افتراضياً، ملفات .ts و .js غير مستخرجة.
exclude
- النوع:
FilterPattern - افتراضي:
[/\.(css|postcss|sass|scss|less|stylus|styl)($|\?)/]
أنماط ترشح الملفات غير المستخرجة. يدعم التعبيرات العادية وأنماط glob picomatch.
افتراضياً، يتم استخراج node_modules و dist أيضاً.
configResolved
- النوع:
(config: ResolvedConfig) => void
خطاف لتعديل التكوين المحلول.
الإعدادات المسبقة الأولى تعمل أولاً وتكوين المستخدم.
configFile
- النوع:
string | false
تحميل من ملفات التكوين.
اضبط false للتعطيل.
configDeps
- النوع:
string[]
قائمة الملفات التي ستؤدي أيضاً إلى إعادة تحميل التكوين.
cli
خيارات UnoCSS CLI.
entry
- النوع:
Arrayable<CliEntryItem>
نقاط دخول UnoCSS cli.
patterns
- النوع:
string[]
أنماط glob للاستخراج من نظام الملفات.
outFile
- النوع:
string
مسار ملف الإخراج.
shortcutsLayer
- النوع:
string - افتراضي:
'shortcuts'
اسم التخطيط للاختصارات.
envMode
- النوع:
'dev' | 'build' - افتراضي:
'build'
وضع البيئة.
details
- النوع:
boolean
كشف التفاصيل الداخلية للتصحيح/الفحص.
warn
- النوع:
boolean - افتراضي:
true
إصدار تحذير عندما تكون المحددات المطابقة موجودة في blocklist.