İçeriğe geç

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.

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.

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.

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.

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.

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