# NodeなしでTailwind v4

各ページは、使用するクラスだけをPHPでコンパイルします。

## 設定は1つ、ビルド手順は不要

`blockstudio.json` で `tailwind.enabled` を設定し、任意のテンプレートにユーティリティクラスを記述します。フロントエンドへの各リクエストで、Blockstudioが完成したHTML内のクラス候補を収集し、Tailwind CSS 4.3をPHPに移植したTailwindPHPで、候補だけを正確にコンパイルします。

Node.jsもCLIもウォッチャーも必要ありません。ページ全体をスキャンするため、ブロックテンプレート、テーマテンプレート、プラグイン、`the_content` のクラスもすべて対象になります。

[Tailwindを有効にする](https://blockstudio.dev/ja/docs/tailwind/#enabling-tailwind)

blockstudio.json

```
{
  "tailwind": {
    "enabled": true
  }
}
```

## Nodeランタイム不要

TailwindPHPはリクエスト中にコンパイルされるため、ビルドもデプロイも不要です。

## Tailwind 4.3のユーティリティ

Tailwind CSS 4.3のユーティリティ、バリアント、任意値、ディレクティブ。

## ページ全体をスキャン

最終的なHTML内にあれば、どこにあるクラスも対象になります。

## クラスセットごとにキャッシュ

同じクラスを使うページは、コンパイル済みファイルを1つ共有します。

## CSSを優先する設定

blockstudio.jsonまたはフィルターで@themeトークンと@utilityルールを設定。

## エディターでライブプレビュー

入力中のクラスを、同梱のブラウザビルドでプレビューできます。

## リンクされた出力

ブラウザーとエッジキャッシュが保持できる、コンテンツハッシュ付きのスタイルシート1つ。

## タイポグラフィとフォーム

公式プラグイン2つはPHPに移植され、@pluginで読み込まれます。

## CSSで設定

Tailwind v4はJavaScriptファイルではなくCSSで設定します。`tailwind.config` に `@theme` トークン、`@utility` ルール、レイヤーを記述するか、複数行にわたる場合は `blockstudio/tailwind/css` フィルターで追加します。

公式のタイポグラフィプラグインとフォームプラグインはPHPに移植され、`@plugin` で読み込まれます。JavaScriptパッケージとしてのみ提供されるプラグインは、Nodeを実行するものがないため動作しません。

クラスエイリアスは `@layer utilities` 内の `@apply` ルールです。たとえば、パディングと角丸のユーティリティから作成した `.btn` があります。フロントエンドとエディターのプレビューの両方でコンパイルされます。

[設定](https://blockstudio.dev/ja/docs/tailwind/#configuration)

functions.php

```
add_filter('blockstudio/tailwind/css', function (string $css): string {
  return $css . '
    @plugin "@tailwindcss/typography";
    @theme { --color-brand: #4f46e5; }
    @utility container-narrow {
      max-width: 48rem;
      margin-inline: auto;
    }
  ';
});
```

## フィールドとしてのクラス

`classes` フィールドに `"tailwind": true` を指定すると、編集者はクラス一覧全体から入力補完を利用でき、同梱のTailwindブラウザビルドでキャンバス上の変更をプレビューできます。

`assets.reset.enabled` を使うと、エディターのラッパーのルールで上書きされる `flex`、`grid`、`sticky` などの表示・配置ユーティリティもキャンバスで復元されます。

[クラスフィールドの種類](https://blockstudio.dev/ja/docs/tailwind/#classes-field-type)

block.json

```
{
  "name": "acme/hero",
  "title": "Hero",
  "blockstudio": {
    "attributes": [
      {
        "id": "classes",
        "type": "classes",
        "label": "Classes",
        "tailwind": true,
        "default": "bg-white text-gray-900"
      }
    ]
  }
}
```

## クラスセットごとにキャッシュされる1つのスタイルシート

コンパイル済みCSSは、ページのクラス候補をソートした一覧とCSS入力から作成したキーを使ってディスクにキャッシュされます。そのため、nonceやタイムスタンプでキャッシュが無効にならず、同じクラスを使うページは1つのファイルを共有します。

デフォルトではインライン出力です。`"output": "link"` を使うと、そのキャッシュファイルをコンテンツハッシュ付きのスタイルシートとして出力します。2026年10月8日にこのサイトのローカルコピーで計測したところ、ホームページのサイズはHTMLで451,648バイトから296,379バイトになりました。

`cache.path` が非公開ボリュームを指す場合、`blockstudio/files/url` フィルターが `tailwind` スコープで公開URLを返さない限り、BlockstudioはインラインCSSにフォールバックします。たとえばCDNホストが該当します。

[フロントエンドの出力](https://blockstudio.dev/ja/docs/tailwind/#frontend-output)

blockstudio.json

```
{
  "tailwind": {
    "enabled": true,
    "output": "link"
  }
}
```

## PHPでクラスをマージ

`bs_tw_merge()` は競合するユーティリティを解決し、作成者が指定したクラスをデフォルトより優先します。`bs_tw_variants()` は、基本クラス、バリアント、デフォルト、複合バリアントを指定できる呼び出し可能なバリアントを返します。

どちらもBlockstudioに同梱済みのTailwindPHPエンジンを使うため、テーマごとに独自のコピーを用意する必要はありません。

[テンプレートヘルパー](https://blockstudio.dev/ja/docs/tailwind/#template-composition-helpers)

index.php

```
echo bs_tw_merge('px-2 text-sm', 'px-4');
// text-sm px-4

$button = bs_tw_variants([
  'base' => 'inline-flex items-center',
  'variants' => [
    'size' => ['sm' => 'h-8 px-3', 'lg' => 'h-12 px-6'],
  ],
  'defaultVariants' => ['size' => 'sm'],
]);

echo $button(['size' => 'lg', 'class' => 'rounded']);
```

## 必要なときに消去

Runtime_Cache::purge(‘tailwind’)でコンパイル済みのCSSを消去します。次のリクエストで再コンパイルされます。

## 任意のページバッファ

Tailwindもブロックアセットも使わないサイトでは、blockstudio/buffer/enabledフィルターを使ってページバッファを無効にできます。

## ソースごとに分離

論理的な検出ソースを使うと、選択したソースと実行時コンテキストがキャッシュの名前空間に加わるため、プレビュー間で前回正常だったCSSが漏れることはありません。

## 正規のレイヤー順序

Tailwind CSSと同じく、テーマ、ベース、コンポーネント、ユーティリティの順に適用され、後のレイヤーが前のレイヤーを上書きします。

Plus

## 公式拡張キット

プレミアムサイトテンプレート、AIシステム指示、会員限定Discordコミュニティ。買い切りで、アップデートは生涯無料です。

- 500+のサイトテンプレート
- AIシステム向け指示
- 無期限アップデート
- 非公開Discordコミュニティ

[Plusを入手](https://blockstudio.dev/ja/plus/)
