Командная строка (CLI)

Интерфейс командной строки для UnoCSS: @unocss/cli.

• 🍱 Подходит для традиционных бэкендов, таких как Laravel или Kirby
• 👀 Режим наблюдения включен
• 🔌 Поддерживает пользовательские конфигурации через uno.config.ts

Установка

Этот пакет поставляется с пакетом unocss:

pnpm

pnpm add -D unocss

yarn

yarn add -D unocss

npm

npm install -D unocss

bun

bun add -D unocss

Вы также можете установить автономный пакет:

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

Если вы не можете найти бинарный файл (например, с pnpm и установлен только unocss), вам нужно явно установить автономный пакет @unocss/cli.

Использование

Вы также можете передать несколько шаблонов glob в @unocss/cli:

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

Пример конфигурации пакета:

INFO

Убедитесь, что добавили экранированные кавычки к шаблонам glob в npm-скрипте.

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

Разработка

Добавьте флаг --watch (или -w) для включения наблюдения за изменениями файлов:

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

Продакшен

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

Итоговый файл uno.css будет сгенерирован в текущем каталоге по умолчанию.

Встроенные функции

Конфигурации

Создайте файл конфигурации uno.config.js или uno.config.ts в корневой директории вашего проекта для настройки UnoCSS.

import { defineConfig } from 'unocss'

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

interface CliEntryItem {
  /**
   * Шаблоны glob для сопоставления файлов
   */
  patterns: string[]
  /**
   * Имя выходного файла для сгенерированного файла UnoCSS
   */
  outFile: string
}

Список параметров можно найти в документации по конфигурациям UnoCSS.

Параметры

Параметр
-v, --version	Отобразить текущую версию UnoCSS
-c, --config-file <file>	Файл конфигурации
-o, --out-file <file>	Имя выходного файла для сгенерированного файла UnoCSS. По умолчанию uno.css в текущей рабочей директории
--stdout	Записать сгенерированный файл UnoCSS в STDOUT. Приведет к игнорированию --watch и --out-file
-w, --watch	Указывает, должны ли файлы, найденные по шаблону glob, отслеживаться
--preflights	Включить стили preflight
--write-transformed	Обновить исходные файлы преобразованными утилитами
-m, --minify	Минифицировать сгенерированный CSS
-h, --help	Отобразить доступные параметры CLI