# Tailwind v4, Node olmadan

Her sayfa, yalnızca kullandığı sınıfları PHP içinde derler.

## Tek ayar, derleme adımı yok

`blockstudio.json` içinde `tailwind.enabled` ayarını yapın ve istediğiniz şablonda yardımcı sınıfları yazın. Her ön yüz isteğinde Blockstudio, tamamlanmış HTML içindeki sınıf adaylarını toplar ve Tailwind CSS 4.3’ün PHP sürümü olan TailwindPHP ile tam olarak bunları derler.

Node.js yok, CLI yok ve izleyici yok. Tüm sayfa tarandığı için blok şablonları, tema şablonları, eklentiler ve `the_content` içindeki sınıfların tümü hesaba katılır.

[Tailwind özelliğini etkinleştirme](https://blockstudio.dev/tr/docs/tailwind/#enabling-tailwind)

blockstudio.json

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

## Node çalışma zamanı yok

TailwindPHP istek sırasında derlenir; derlenecek veya dağıtılacak bir şey yoktur.

## Tailwind 4.3 yardımcı sınıfları

Tailwind CSS 4.3’ten yardımcı sınıflar, varyantlar, keyfî değerler ve yönergeler.

## Tüm sayfayı tarama

Sınıflar, son HTML içinde nerede görünürlerse görünsünler hesaba katılır.

## Sınıf kümesine göre önbelleğe alınır

Aynı sınıfları kullanan sayfalar tek bir derlenmiş dosyayı paylaşır.

## CSS öncelikli yapılandırma

blockstudio.json veya bir filtrede @theme belirteçleri ve @utility kuralları.

## Canlı düzenleyici önizlemesi

Birlikte sunulan tarayıcı derlemesi, siz yazarken sınıfları önizler.

## Bağlantılı çıktı

Tarayıcıların ve uç önbelleklerin saklayabileceği, içerik karması eklenmiş tek bir stil sayfası.

## Tipografi ve formlar

İki resmî eklenti PHP için uyarlanmıştır ve @plugin ile yüklenir.

## CSS içinde yapılandırılır

Tailwind v4, bir JavaScript dosyasıyla değil, CSS ile yapılandırılır. `@theme` belirteçlerini, `@utility` kurallarını ve katmanları `tailwind.config` içine koyun ya da birkaç satıra yayıldıklarında `blockstudio/tailwind/css` filtresiyle ekleyin.

Resmî tipografi ve formlar eklentileri PHP için uyarlanmıştır ve `@plugin` ile yüklenir. Yalnızca JavaScript paketleri olarak bulunan eklentiler çalışmaz, çünkü Node çalıştıran hiçbir şey yoktur.

Sınıf takma adları, `@layer utilities` içinde `@apply` kurallarıdır; örneğin dolgu ve köşe yarıçapı yardımcı sınıflarından oluşturulan bir `.btn`. Hem ön yüzde hem düzenleyici önizlemesinde derlenirler.

[Yapılandırma](https://blockstudio.dev/tr/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;
    }
  ';
});
```

## Alan olarak sınıflar

Bir `classes` alanına `"tailwind": true` verin; editörler tam sınıf listesinden otomatik tamamlama alırken, birlikte sunulan Tailwind tarayıcı derlemesi tuvalde her değişikliği önizler.

`assets.reset.enabled` ile tuval, editör sarmalayıcı kurallarının normalde üzerine yazacağı `flex`, `grid` ve `sticky` gibi görüntüleme ve konum yardımcı sınıflarını da geri yükler.

[Sınıflar alanı türü](https://blockstudio.dev/tr/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"
      }
    ]
  }
}
```

## Tek stil sayfası, sınıf kümesine göre önbelleğe alınır

Derlenmiş CSS, sayfanın sıralanmış sınıf adaylarından ve CSS girdisinden oluşturulan bir anahtarla diskte önbelleğe alınır; bu nedenle nonce değerleri ve zaman damgaları önbelleği geçersiz kılmaz, aynı sınıfları kullanan sayfalar da tek dosyayı paylaşır.

Varsayılan olarak çıktı satır içidir. `"output": "link"`, bu önbellek dosyasını içerik karması eklenmiş bir stil sayfası olarak sunar. Bu sitenin yerel bir kopyasında 8 Ekim tarihinde yapılan ölçümde 2026, ana sayfanın boyutu 451,648 değerinden 296,379 bayta düşerken HTML olarak ölçüldü.

`cache.path` özel bir birimi gösterdiğinde, `blockstudio/files/url` filtresi `tailwind` kapsamı için, örneğin CDN ana bilgisayarı gibi, herkese açık bir URL döndürmezse Blockstudio satır içi CSS kullanımına geri döner.

[Ön yüz çıktısı](https://blockstudio.dev/tr/docs/tailwind/#frontend-output)

blockstudio.json

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

## Sınıfları PHP ile birleştirin

`bs_tw_merge()`, çakışan yardımcı sınıfları çözerek yazılan bir sınıfın varsayılanın önüne geçmesini sağlar. `bs_tw_variants()`; temel sınıflar, varyantlar, varsayılanlar ve bileşik varyantlarla çağrılabilen bir varyant döndürür.

Her ikisi de TailwindPHP’ın zaten içerdiği Blockstudio altyapısını kullanır; bu nedenle temanın kendine ait bir kopyaya ihtiyacı olmaz.

[Şablon yardımcıları](https://blockstudio.dev/tr/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']);
```

## İsteğe bağlı temizleme

Runtime_Cache::purge(‘tailwind’) derlenmiş CSS öğesini temizler; sonraki istekte yeniden derlenir.

## İsteğe bağlı sayfa arabelleği

Ne Tailwind ne de blok varlıklarını kullanan bir site, blockstudio/buffer/enabled filtresiyle sayfa arabelleğini kapatabilir.

## Kaynak başına yalıtım

Mantıksal bir keşif kaynağı kullanıldığında, seçilen kaynak ve çalışma zamanı bağlamı önbellek ad alanına eklenir; böylece son geçerli CSS önizlemeler arasında sızmaz.

## Standart katman sırası

Tailwind CSS içindeki gibi tema, temel, bileşenler, ardından yardımcı sınıflar; böylece sonraki katmanlar öncekilerin üzerine yazar.

Plus

## Resmî uzantı kiti

Premium site şablonları, yapay zekâ sistem talimatları ve özel bir Discord topluluğu. Tek seferlik satın alma, ömür boyu güncellemeler.

- 500+ site şablonu
- Yapay zekâ sistem talimatları
- Ömür boyu güncellemeler
- Özel Discord topluluğu

[Plus edinin](https://blockstudio.dev/tr/plus/)
