# Tailwind v4 tanpa Node

Setiap halaman hanya mengompilasi kelas yang digunakannya, di PHP.

## Satu setelan, tanpa langkah build

Atur `tailwind.enabled` di `blockstudio.json` dan tulis kelas utilitas dalam template apa pun. Pada setiap permintaan frontend, Blockstudio mengumpulkan kandidat kelas dari HTML yang sudah dirender, lalu mengompilasi hanya kandidat tersebut dengan TailwindPHP, port Tailwind CSS 4.3 berbasis PHP.

Tidak ada Node.js, CLI, maupun watcher. Kelas dari template blok, template tema, plugin, dan `the_content` semuanya dihitung karena seluruh halaman dipindai.

[Mengaktifkan Tailwind](https://blockstudio.dev/id/docs/tailwind/#enabling-tailwind)

blockstudio.json

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

## Tanpa runtime Node

TailwindPHP mengompilasi saat permintaan berlangsung; tidak ada yang perlu di-build atau diterapkan.

## Utilitas Tailwind 4.3

Utilitas, varian, nilai arbitrer, dan direktif dari Tailwind CSS 4.3.

## Pemindaian seluruh halaman

Kelas dihitung di mana pun muncul dalam HTML akhir.

## Di-cache berdasarkan kumpulan kelas

Halaman yang menggunakan kelas sama berbagi satu file hasil kompilasi.

## Konfigurasi yang mengutamakan CSS

Token @theme dan aturan @utility di blockstudio.json atau filter.

## Pratinjau editor langsung

Build browser yang disertakan menampilkan pratinjau kelas saat Anda mengetik.

## Keluaran tertaut

Satu stylesheet dengan hash konten yang dapat disimpan oleh browser dan cache edge.

## Tipografi dan formulir

Kedua plugin resmi telah diport ke PHP dan dimuat dengan @plugin.

## Dikonfigurasi di CSS

Tailwind v4 dikonfigurasi dengan CSS, bukan file JavaScript. Letakkan token `@theme`, aturan `@utility`, dan layer di `tailwind.config`, atau tambahkan melalui filter `blockstudio/tailwind/css` jika tersebar di beberapa baris.

Plugin tipografi dan formulir resmi telah diport ke PHP dan dimuat dengan `@plugin`. Plugin yang hanya tersedia sebagai paket JavaScript tidak berjalan karena tidak ada proses yang menjalankan Node.

Alias kelas adalah aturan `@apply` di dalam `@layer utilities`, seperti `.btn` yang dibuat dari utilitas padding dan radius. Alias ini dikompilasi baik di frontend maupun pratinjau editor.

[Konfigurasi](https://blockstudio.dev/id/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;
    }
  ';
});
```

## Kelas sebagai kolom

Berikan kolom `classes` jenis `"tailwind": true` agar editor mendapat pelengkapan otomatis dari daftar kelas lengkap, dengan pratinjau setiap perubahan di kanvas melalui build browser Tailwind yang disertakan.

Dengan `assets.reset.enabled`, kanvas juga memulihkan utilitas tampilan dan posisi seperti `flex`, `grid`, dan `sticky` yang biasanya akan ditimpa oleh aturan pembungkus editor.

[Jenis kolom kelas](https://blockstudio.dev/id/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"
      }
    ]
  }
}
```

## Satu stylesheet, di-cache berdasarkan kumpulan kelas

CSS yang dikompilasi di-cache pada disk dengan kunci yang dibuat dari kandidat kelas halaman yang sudah diurutkan dan input CSS, sehingga nonce dan stempel waktu tidak pernah membatalkan cache, dan halaman dengan kelas yang sama berbagi satu file.

Output inline adalah pengaturan default. `"output": "link"` mengeluarkan file cache tersebut sebagai stylesheet dengan hash konten. Saat diukur pada salinan lokal situs ini pada 8 Oktober, 2026, halaman beranda menjadi HTML dari 451,648 menjadi 296,379 byte.

Saat `cache.path` mengarah ke volume privat, Blockstudio beralih ke CSS inline kecuali filter `blockstudio/files/url` mengembalikan URL publik untuk cakupan `tailwind`, seperti host CDN.

[Keluaran frontend](https://blockstudio.dev/id/docs/tailwind/#frontend-output)

blockstudio.json

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

## Gabungkan kelas di PHP

`bs_tw_merge()` menyelesaikan konflik utilitas agar kelas yang ditulis sendiri mengalahkan bawaan. `bs_tw_variants()` mengembalikan fungsi varian yang menerima kelas dasar, varian, nilai bawaan, dan varian majemuk.

Keduanya menggunakan mesin TailwindPHP yang sudah disertakan oleh Blockstudio, sehingga tema tidak memerlukan salinannya sendiri.

[Helper template](https://blockstudio.dev/id/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']);
```

## Bersihkan sesuai permintaan

Runtime_Cache::purge(‘tailwind’) menghapus CSS yang dikompilasi, lalu permintaan berikutnya mengompilasinya lagi.

## Buffer halaman opsional

Situs yang tidak menggunakan Tailwind maupun aset blok dapat menonaktifkan buffer halaman dengan filter blockstudio/buffer/enabled.

## Terisolasi per sumber

Dengan sumber penemuan logis, sumber yang dipilih dan konteks runtime menjadi bagian dari namespace cache, sehingga CSS terakhir yang berhasil tidak bocor antarpratinjau.

## Urutan lapisan kanonis

Tema, dasar, komponen, lalu utilitas, seperti pada Tailwind CSS, sehingga lapisan yang lebih akhir menimpa lapisan sebelumnya.

Plus

## Kit ekstensi resmi

Template situs premium, instruksi sistem AI, dan komunitas Discord privat. Pembelian satu kali, pembaruan seumur hidup.

- 500+ templat situs
- Instruksi sistem AI
- Pembaruan seumur hidup
- Komunitas privat Discord

[Dapatkan Plus](https://blockstudio.dev/id/plus/)
