コンテンツへスキップ

CLI

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

インストール

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

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

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

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

情報

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

使い方

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

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

パッケージ構成例

情報

npmスクリプトのglobパターンには、エスケープされた引用符を追加してください。

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

開発

ファイルの変更を監視できるようにするには、--watch (または -w) フラグを追加します

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

本番

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

最終的なuno.cssは、デフォルトで現在のディレクトリに生成されます。

組み込み機能

設定

UnoCSSをカスタマイズするには、プロジェクトのルートレベルにuno.config.jsまたはuno.config.ts設定ファイルを作成します。

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

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

interface CliEntryItem {
  /**
   * Glob patterns to match files
   */
  patterns: string[]
  /**
   * The output filename for the generated UnoCSS file
   */
  outFile: string
}

オプションの一覧については、UnoCSSの設定ドキュメントを参照してください。

オプション

オプション
-v, --versionUnoCSSの現在のバージョンを表示します
-c, --config-file <file>設定ファイル
-o, --out-file <file>生成されたUnoCSSファイルの出力ファイル名。デフォルトは現在の作業ディレクトリのuno.cssです
--stdout生成されたUnoCSSファイルをSTDOUTに書き込みます。これにより、--watch--out-fileは無視されます
-w, --watchglobパターンで見つかったファイルを監視するかどうかを示します
--preflightsプリフライトスタイルを有効にします
--write-transformed変換されたユーティリティでソースファイルを更新します
-m, --minify生成されたCSSを最小化します
-h, --help利用可能なCLIオプションを表示します

MITライセンスの下でリリースされています。