UnoCSS Konfiguracija

Konfiguracija

Konfiguracije so tisto, kar naredi UnoCSS zmogljiv.

• Pravila - Definirajte atomske CSS pripomočke
• Bližnjice - Združite več pravil v eno bližnjico.
• Tema - Definirajte spremenljivke teme.
• Variante - Uporabite prilagojene konvencije za pravila.
• Ekstraktorji - Definirajte kje in kako se izvleče uporaba pripomočkov.
• Preflighti - Definirajte globalni surovi CSS.
• Sloji - Definirajte vrstni red vsakega sloja pripomočkov.
• Prednastavitve - Prednastavljene konfiguracije za pogoste primere uporabe.
• Transformerji - Transformerji izvorne kode za podporo konvencijam.
• Samodejno dokončevanje - Definirajte prilagojene predloge samodejnega dokončevanja.

Možnosti

rules

• Tip: Rule<Theme>[]

Pravila za generiranje CSS pripomočkov. Poznejši vnosi imajo višjo prioriteto.

shortcuts

• Tip: UserShortcuts<Theme>

Podobno kot Windi CSS bližnjice, omogoča ustvarjanje novih pripomočkov z združevanjem obstoječih. Poznejši vnosi imajo višjo prioriteto.

theme

• Tip: Theme

Predmet teme za skupno konfiguracijo med pravili.

extendTheme

• Tip: Arrayable<ThemeExtender<Theme>> Prilagojene funkcije mutirajo predmet teme.

Mogoče je tudi vrniti nov predmet teme za popolno zamenjavo izvirnika.

variants

• Tip: Variant<Theme>[]

Variante, ki obdelajo selektorje vnaprej, imajo možnost prepisati CSS predmet.

extractors

• Tip: Extractor[]

Ekstraktorji za obdelavo izvorne datoteke in izpis možnih razredov/selektorjev. Lahko so jezikovno ozaveščeni.

preflights

• Tip: Preflight<Theme>[]

Vstavitve surovega CSS.

layers

• Tip: Record<string, number>

Vrstni red slojev. Privzeto 0.

outputToCssLayers

• Tip: boolean | UseCssLayersOptions
• Privzeto: false

Izpiše sloje v CSS Cascade Sloje.

cssLayerName

• Tip: (internalLayer: string) => string | undefined | null

Določi ime CSS sloja v katerega naj se izpiše notranji sloj (lahko je pod-sloj npr. "mojsloj.mojpod-sloj").

Če je vrnjeno undefined, bo ime notranjega sloja uporabljeno kot ime CSS sloja. Če je vrnjeno null, notranji sloj ne bo izpisan v CSS sloj.

sortLayers

• Tip: (layers: string[]) => string[]

Prilagojena funkcija za razvrščanje slojev.

presets

• Tip: (PresetOrFactory<Theme> | PresetOrFactory<Theme>[])[]

Prednastavljene konfiguracije za pogoste primere uporabe.

transformers

• Tip: SourceCodeTransformer[]

Prilagojeni transformerji za izvorno kodo.

blocklist

• Tip: BlocklistRule[]

Pravila za izključitev selektorjev za vaš sistem oblikovanja (za zožitev možnosti). Združevanje možnosti warnExcluded lahko pomaga tudi pri identifikaciji napačnih uporab.

safelist

• Tip: string[]

Pripomočki, ki so vedno vključeni.

preprocess

• Tip: Arrayable<Preprocessor>

Predobdelava dohodnih pripomočkov, vrnite neresnično vrednost za izključitev.

postprocess

• Tip: Arrayable<Postprocessor>

Naknadna obdelava generiranega predmeta pripomočkov.

separators

• Tip: Arrayable<string>
• Privzeto: [':', '-']

Ločila variant.

extractorDefault

• Tip: Extractor | null | false
• Privzeto: import('@unocss/core').defaultExtractor

Privzeti ekstraktor, ki se vedno uporabi. Privzeto razdeli izvorno kodo po presledkih in narekovajih.

Lahko ga nadomesti prednastavitev ali uporabniška konfiguracija, lahko je prisoten le en privzeti ekstraktor, poznejši bo nadomestil prejšnjega.

Posredujte null ali false za onemogočitev privzetega ekstraktorja.

autocomplete

Dodatne možnosti za samodejno dokončevanje.

templates

• Tip: Arrayable<AutoCompleteFunction | AutoCompleteTemplate>

Prilagojene funkcije / predloge za zagotavljanje predlogov samodejnega dokončevanja.

extractors

• Tip: Arrayable<AutoCompleteExtractor>

Prilagojeni ekstraktorji za zajem možnih razredov in pretvorbo predlogov sloga imen razredov v pravilno obliko.

shorthands

• Tip: Record<string, string | string[]>

Prilagojene bližnjice za zagotavljanje predlogov samodejnega dokončevanja. Če so vrednosti polje, bodo združene z | in ovite z ().

content

Možnosti za vire, ki bodo izvlečeni kot uporabe pripomočkov.

Podprti viri:

• filesystem - ekstrakcija iz datotečnega sistema
• inline - ekstrakcija iz navadnega inline besedila
• pipeline - ekstrakcija iz gradbenih orodij transformacijskega cevovoda, kot sta Vite in Webpack

Uporaba, izvlečena iz vsakega vira, bo združena skupaj.

filesystem

• Tip: string[]
• Privzeto: []

Glob vzorci za ekstrakcijo iz datotečnega sistema, poleg drugih virov vsebine.

V načinu razvijanja bodo datoteke nadzorovane in sprožile HMR.

inline

• Tip: string | { code: string; id?: string } | (() => Awaitable<string | { code: string; id?: string }>)) []

Inline besedilo za ekstrakcijo.

pipeline

Filtri za določanje ali izvleči določene module iz cevovoda transformacije gradbenih orodij.

Trenutno deluje le za Vite in Webpack integracijo.

Nastavite false za onemogočitev.

include

• Tip: FilterPattern
• Privzeto: [/\.(vue|svelte|[jt]sx|mdx?|astro|elm|php|phtml|html)($|\?)/]

Vzorci, ki filtrirajo datoteke, ki se ekstrahirajo. Podpira regularne izraze in picomatch glob vzorce.

Privzeto datoteke .ts in .js NISO ekstrahirane.

exclude

• Tip: FilterPattern
• Privzeto: [/\.(css|postcss|sass|scss|less|stylus|styl)($|\?)/]

Vzorci, ki filtrirajo datoteke, ki se NE ekstrahirajo. Podpira regularne izraze in picomatch glob vzorce.

Privzeto so node_modules in dist prav tako ekstrahirani.

configResolved

• Tip: (config: ResolvedConfig) => void

Hook za spremembo razrešene konfiguracije.

Najprej se izvedejo prednastavitve in nato uporabniška konfiguracija.

configFile

• Tip: string | false

Naloži iz konfiguracijskih datotek.

Nastavite false za onemogočitev.

configDeps

• Tip: string[]

Seznam datotek, ki prav tako sprožijo ponovno nalaganje konfiguracije.

cli

UnoCSS CLI možnosti.

entry

• Tip: Arrayable<CliEntryItem>

UnoCSS cli vstopne točke.

patterns

• Tip: string[]

Glob vzorci za ekstrakcijo iz datotečnega sistema.

outFile

• Tip: string

Izhodna pot datoteke.

shortcutsLayer

• Tip: string
• Privzeto: 'shortcuts'

Ime razporeda bližnjic.

envMode

• Tip: 'dev' | 'build'
• Privzeto: 'build'

Način okolja.

details

• Tip: boolean

Razkrije notranje podrobnosti za razhroščevanje / inspekcijo.

warn

• Tip: boolean
• Privzeto: true

Izpiše opozorilo, ko se ujemajoči selektorji pojavijo na seznamu blokiranih.