CLI

L'interfaccia a riga di comando per UnoCSS: @unocss/cli.

• 🍱 Adatto per backend tradizionali come Laravel o Kirby
• 👀 Modalità watch inclusa
• 🔌 Supporta configurazioni personalizzate tramite uno.config.ts

Installazione

Questo pacchetto viene fornito con il pacchetto unocss:

pnpm

pnpm add -D unocss

yarn

yarn add -D unocss

npm

npm install -D unocss

bun

bun add -D unocss

Puoi anche installare il pacchetto standalone:

pnpm

pnpm add -D @unocss/cli

yarn

yarn add -D @unocss/cli

npm

npm install -D @unocss/cli

bun

bun add -D @unocss/cli

INFO

Se non riesci a trovare il binario (ad esempio con pnpm e solo unocss è installato), dovrai installare esplicitamente il pacchetto standalone @unocss/cli.

Utilizzo

Puoi anche passare più pattern glob a @unocss/cli:

unocss "site/snippets/**/*.php" "site/templates/**/*.php"

Esempio di configurazione del pacchetto:

INFO

Assicurati di aggiungere virgolette escape ai pattern glob degli script npm.

{
  "scripts": {
    "dev": "unocss \"site/{snippets,templates}/**/*.php\" --watch",
    "build": "unocss \"site/{snippets,templates}/**/*.php\""
  },
  "devDependencies": {
    "@unocss/cli": "latest"
  }
}

Sviluppo

Aggiungi il flag --watch (o -w) per abilitare il monitoraggio delle modifiche ai file:

unocss "site/{snippets,templates}/**/*.php" --watch

Produzione

unocss "site/{snippets,templates}/**/*.php"

Il file finale uno.css verrà generato nella directory corrente per impostazione predefinita.

Funzionalità integrate

Configurazioni

Crea un file di configurazione uno.config.js o uno.config.ts a livello root del tuo progetto per personalizzare UnoCSS.

import { defineConfig } from 'unocss'

export default defineConfig({
  cli: {
    entry: {}, // CliEntryItem | CliEntryItem[]
  },
  // ...
})

interface CliEntryItem {
  /**
   * Pattern glob per corrispondere ai file
   */
  patterns: string[]
  /**
   * Il nome del file di output per il file UnoCSS generato
   */
  outFile: string
}

Per un elenco di opzioni, vai alla documentazione delle configurazioni UnoCSS.

Opzioni

Opzioni
-v, --version	Mostra la versione corrente di UnoCSS
-c, --config-file <file>	File di configurazione
-o, --out-file <file>	Il nome del file di output per il file UnoCSS generato. Predefinito a uno.css nella directory di lavoro corrente
--stdout	Scrive il file UnoCSS generato su STDOUT. Causerà l'ignorare di --watch e --out-file
-w, --watch	Indica se i file trovati dal pattern glob dovrebbero essere monitorati
--preflights	Abilita gli stili preflight
--write-transformed	Aggiorna i file sorgente con utility trasformate
-m, --minify	Minifica il CSS generato
-h, --help	Mostra le opzioni CLI disponibili