Skip to content

CLI

Kommandoradsgränssnittet för UnoCSS: @unocss/cli.

  • 🍱 Lämpligt för traditionella backends som Laravel eller Kirby
  • 👀 Watch-läge inkluderat
  • 🔌 Stöder anpassade konfigurationer via uno.config.ts

Installation

Detta paket levereras med unocss-paketet:

bash
pnpm add -D unocss
bash
yarn add -D unocss
bash
npm install -D unocss
bash
bun add -D unocss

Du kan också installera det fristående paketet:

bash
pnpm add -D @unocss/cli
bash
yarn add -D @unocss/cli
bash
npm install -D @unocss/cli
bash
bun add -D @unocss/cli

INFO

Om du inte kan hitta den binära filen (t.ex. med pnpm och endast unocss är installerat), måste du explicit installera @unocss/cli fristående paket.

Användning

Du kan också skicka flera glob-mönster till @unocss/cli:

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

Exempel på paketkonfiguration:

INFO

Se till att lägga till escaperade citattecken till dina npm script glob-mönster.

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

Development

Lägg till --watch (eller -w) flaggan för att aktivera övervakning av filändringar:

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

Production

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

Den slutliga uno.css kommer att genereras till den aktuella katalogen som standard.

Inbyggda funktioner

Konfigurationer

Skapa en uno.config.js eller uno.config.ts konfigurationsfil i rotkatalogen för ditt projekt för att anpassa UnoCSS.

ts
import { defineConfig } from 'unocss'

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

interface CliEntryItem {
  /**
   * Glob-mönster för att matcha filer
   */
  patterns: string[]
  /**
   * Utdatafilnamnet för den genererade UnoCSS-filen
   */
  outFile: string
}

För en lista över alternativ, gå till UnoCSS-konfigurationer dokumentationen.

Alternativ

Alternativ
-v, --versionVisa den aktuella versionen av UnoCSS
-c, --config-file <file>Konfigurationsfil
-o, --out-file <file>Utdatafilnamnet för den genererade UnoCSS-filen. Standard är uno.css i den aktuella arbetskatalogen
--stdoutSkriv den genererade UnoCSS-filen till STDOUT. Kommer att göra att --watch och --out-file ignoreras
-w, --watchIndikerar om filerna som hittas av glob-mönstret ska övervakas
--preflightsAktivera preflight-stilar
--write-transformedUppdatera källfiler med transformerade verktyg
-m, --minifyMinifiera genererad CSS
-h, --helpVisa tillgängliga CLI-alternativ

Released under the MIT License.