UnoCSS CLI

UnoCSS の CLI (@unocss/cli)。

CLI

UnoCSS のコマンドラインインターフェース: @unocss/cli

  • 🍱 Laravel や Kirby のような従来のバックエンドに適しています
  • 👀 ウォッチモードを含む
  • 🔌 uno.config.ts を介したカスタム設定をサポート

インストール

このパッケージは unocss パッケージに同梱されています:

::: code-group

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

:::

スタンドアロンパッケージをインストールすることもできます:

::: code-group

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 バイナリが見つからない場合(例: pnpmunocss のみがインストールされている場合)、@unocss/cli スタンドアロンパッケージを明示的にインストールする必要があります。 :::

使用法

@unocss/cli に複数のグロブパターンを渡すこともできます:

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

パッケージ設定の例:

::: info npm スクリプトのグロブパターンにはエスケープされた引用符を追加することを確認してください。 :::

package.json
{
  "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 をカスタマイズします。

uno.config.ts
import { defineConfig } from 'unocss'

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

interface CliEntryItem {
  /**
   * ファイルをマッチさせるグロブパターン
   */
  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グロブパターンで見つかったファイルを監視するかどうかを示します
--preflightsプリフライトスタイルを有効にします
--write-transformed変換されたユーティリティでソースファイルを更新します
-m, --minify生成された CSS を最小化します
-h, --help利用可能な CLI オプションを表示します