Tailwind CSS
Blockstudio, yerleşik Tailwind CSS v4 desteği sunar. Etkinleştirildiğinde her ön yüz sayfası, otomatik dosya tabanlı önbelleğe alma ile sunucu tarafında TailwindPHP üzerinden derlenir. Blok düzenleyicide, paketlenmiş bir Tailwind CDN betiği siz düzenleme yaparken canlı önizleme sağlar.
Derleme adımı yok, CLI yok, Node.js gerekmiyor.
Nasıl Çalışır
Blockstudio, bağlama göre iki ayrı derleme stratejisi kullanır:
Ön yüz (sunucu tarafı)
Her ön yüz isteğinde Blockstudio, tüm sayfa HTML içeriğini bir çıktı arabelleği aracılığıyla yakalar, tüm CSS sınıf adaylarını çıkarır, yalnızca gerçekten kullanılan CSS öğesini derler ve sonucu </head> öncesinde satır içi bir <style> etiketi olarak ekler.
Derleme akışı:
- WordPress, tüm sayfa HTML içeriğini bir çıktı arabelleğine render eder
TailwindPHP::extractCandidates(), HTML içeriğini tarar ve olası tüm CSS sınıf adlarını çıkarır (hızlı regex, derleme yok)- Sıralanmış adaylar, bir önbellek anahtarı oluşturmak için CSS yapılandırmasıyla birlikte karmalanır
- Önbellek isabetinde: derlenmiş CSS diskten okunur ve eklenir
- Önbellek kaçırmasında:
TailwindPHP::generate(), CSS öğesini derler, önbellek dizinine yazar ve ekler
Derlenmiş CSS şu şekilde eklenir:
<style id="blockstudio-tailwind">
/* compiled CSS */
</style>
Buna Tailwind’ın ön kontrolü (CSS sıfırlaması) ve eşleşen tüm yardımcı sınıflar dahildir.
Düzenleyici (istemci tarafı)
Blok düzenleyicide, paketlenmiş bir Tailwind CDN betiği (Tailwind CSS v4 tarayıcı derlemesi) istemci tarafında çalışır. Bu, sınıf adlarını yazarken sunucuya gidiş dönüş yapmadan anında canlı önizleme sağlar. CDN yalnızca düzenleyicide yüklenir ve ön yüzde hiçbir zaman sunulmaz.
assets.reset.enabled etkin olduğunda Blockstudio, düzenleyici tuvalinde Tailwind’nin yaygın görüntüleme ve konum yardımcı sınıflarını da geri yükler. Böylece flex, grid, absolute, fixed ve sticky gibi sarmalayıcı düzeyindeki sınıfların WordPress düzenleyici blok sarmalayıcı kuralları tarafından geçersiz kılınması önlenir; bu sayede yardımcı sınıflarla oluşturulan düzenler ön yüzdekiyle daha uyumlu olur.
Tailwind özelliğini etkinleştirme
blockstudio.json dosyanıza tailwind yapılandırmasını ekleyin:
{
"$schema": "https://blockstudio.dev/schema/blockstudio",
"tailwind": {
"enabled": true
}
}
Veya bir filtre aracılığıyla etkinleştirin:
add_filter('blockstudio/settings/tailwind/enabled', '__return_true');
enabled değeri true olduğunda her ön yüz sayfasında Tailwind CSS otomatik olarak derlenip eklenir. Tailwind yardımcı sınıflarını her yerde kullanabilirsiniz: blok şablonlarında, tema şablonlarında, the_content filtrelerinde veya sayfa çıktısında görünen herhangi bir HTML öğesinde.
Ön yüz çıktısı
Derlenmiş CSS varsayılan olarak satır içidir ve önceki sürümlerin kullandığı çıktıyı korur. Paylaşılan kural sayısı fazla olan siteler bunun yerine içerik karmalı bir stil dosyasını etkinleştirebilir:
{
"tailwind": {
"enabled": true,
"output": "link"
}
}
"output": "link", mevcut tailwind/{content-hash}.css önbellek dosyasını <link rel="stylesheet"> olarak sunar. Çalışma zamanı kimliği, adaylar, altyapı veya CSS girdisi değiştiğinde URL değişir; böylece tarayıcılar ve uç önbellekler eski URL’leri güvenle saklayabilir. Bu önbellek kapsamı için uzun ömürlü bir Cache-Control: public, immutable üstbilgisi gönderecek şekilde web sunucusunu veya CDN öğesini yapılandırın.
Varsayılan önbellek kökü, wp-content altında herkese açıktır. cache.path özel bir mutlak birimi gösteriyorsa, mevcut blockstudio/files/url filtresi tailwind kapsamı için herkese açık bir URL sağlamadığı sürece Blockstudio satır içi CSS kullanımına geri döner:
add_filter(
'blockstudio/files/url',
function (string $url, string $path, string $scope): string {
if ('tailwind' !== $scope) {
return $url;
}
return 'https://static.example.com/blockstudio/' . basename($path);
},
10,
3
);
Şablon oluşturma yardımcıları
Blockstudio, aynı paketlenmiş TailwindPHP altyapısını PHP şablonlarına sunar. Tema tarafında bir kopya veya yedek uygulama gerekmez:
$classes = 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']);
bs_tw_merge() iç içe geçmiş sınıf değerlerini kabul eder ve çakışan Tailwind yardımcı sınıflarını çözümler. bs_tw_variants(); temel, varyant, varsayılan varyant, bileşik varyant, class ve className desteği sunan CVA tarzı çağrılabilir bir işlev döndürür.
Yapılandırma
Tailwind v4, önce CSS kullanan bir yapılandırma yaklaşımını benimser. Ayrı bir JavaScript yapılandırma dosyası yerine, yapılandırmayı doğrudan @theme yönergesini kullanarak CSS biçiminde yazarsınız.
{
"tailwind": {
"enabled": true,
"config": "@theme { --color-primary: #3b82f6; --color-secondary: #10b981; --font-family-heading: 'Inter', sans-serif; }"
}
}
config değeri, @import "tailwindcss" yönergesinden sonra eklenen bir CSS dizesidir. Burada geçerli herhangi bir Tailwind v4 CSS sözdizimini kullanabilirsiniz:
{
"tailwind": {
"enabled": true,
"config": "@theme { --color-brand: oklch(0.7 0.15 200); } @layer base { h1 { font-size: var(--text-4xl); } }"
}
}
Çok satırlı yapılandırmalarda filtre yaklaşımı daha kullanışlıdır:
add_filter('blockstudio/settings/tailwind/config', function () {
return <<<CSS
@theme {
--color-primary: #3b82f6;
--color-secondary: #10b981;
--font-family-heading: 'Inter', sans-serif;
--breakpoint-xs: 30rem;
}
@layer base {
body {
font-family: var(--font-family-sans);
}
}
@layer utilities {
.btn { @apply px-4 py-2 rounded-lg font-medium; }
.btn-primary { @apply bg-blue-500 text-white hover:bg-blue-600; }
.card { @apply bg-white rounded-xl shadow-lg p-6; }
}
CSS;
});
Özel Yardımcı Sınıflar
Yeniden kullanılabilir sınıf takma adları tanımlamak için, yapılandırma dizenizde doğrudan Tailwind’in @apply yönergesiyle @layer utilities kullanın:
{
"tailwind": {
"enabled": true,
"config": "@theme { --color-brand: #6366f1; } @layer utilities { .btn { @apply px-4 py-2 rounded-lg font-medium; } .section { @apply py-16 px-4 max-w-7xl mx-auto; } }"
}
}
Bu, sınıfları tüm standart Tailwind yardımcı sınıflarıyla birlikte derler. Hem ön yüzde (sunucu tarafında derleme) hem de düzenleyicide (CDN önizlemesi) çalışırlar.
Blockstudio, Tailwind’in standart basamaklı katman sırasını korur:
theme, base, components ve ardından utilities. Bu sıra Tailwind CSS ile eşleşir; dolayısıyla
beklendiği gibi sonraki katmanlardaki kurallar önceki katmanlardakileri geçersiz kılabilir.
Sınıflar Alanının Türü
Otomatik tamamlama desteğiyle bir bloğun classes alanında Tailwind sınıflarını kullanmak için, alanda tailwind: true ayarını yapın:
{
"name": "my-theme/hero",
"title": "Hero",
"blockstudio": {
"attributes": [
{
"id": "classes",
"type": "classes",
"label": "Classes",
"tailwind": true,
"default": "bg-white text-gray-900"
}
]
}
}
tailwind true olduğunda:
- Alan, tüm Tailwind sınıf listesinden otomatik tamamlama önerileri sunar
- Canlı önizleme için düzenleyicide Tailwind CDN betiği yüklenir
- Sınıflar, blok özniteliklerinde boşluklarla ayrılmış bir dize olarak saklanır
Şablonunuzda sınıf değerini kullanın:
<div class="<?php echo $a['classes']; ?>">
<!-- block content -->
</div>
Ayarlar Referansı
| Seçenek | Tür | Varsayılan | Açıklama |
|---|---|---|---|
enabled |
boolean | false |
Ön yüzde Tailwind CSS derlemesini etkinleştirir |
config |
string | "" |
Önce Tailwind kullanan v4 CSS yapılandırma dizesi |
JSON Üzerinden Ayarlama
{
"tailwind": {
"enabled": true,
"config": "@theme { --color-brand: pink; }"
}
}
Filtreler Üzerinden Ayarlama
add_filter('blockstudio/settings/tailwind/enabled', '__return_true');
add_filter('blockstudio/settings/tailwind/config', function () {
return '@theme { --color-brand: pink; }';
});
Önbelleğe Alma
Blockstudio, Tailwind’in yardımcı sınıf tabanlı mimarisi için tasarlanmış özel bir önbelleğe alma stratejisi kullanır.
Önbelleğin Çalışma Şekli
Tüm sayfa HTML değerini karma değerine dönüştürmek yerine (bu, nonce’ler, zaman damgaları ve diğer dinamik içerik nedeniyle her istekte önbelleği geçersiz kılardı), Blockstudio, HTML içindeki yalnızca CSS sınıf adaylarını çıkarır. Kararlı bir önbellek anahtarı oluşturmak için bu adaylar sıralanır ve CSS yapılandırmasıyla birlikte karmaya dönüştürülür.
Bunun anlamı şudur:
- Farklı HTML içeriklerine sahip olsalar bile, aynı Tailwind sınıf kümesini kullanan iki sayfa aynı önbelleğe alınmış CSS dosyasını paylaşır
- Nonce’ler, oturum açmış kullanıcı çubukları, yorum sayıları ve zaman damgaları gibi dinamik içerikler önbelleği geçersiz kılmaz
- Önbellek yalnızca sayfadaki CSS sınıf kümesi veya Tailwind yapılandırması değiştiğinde geçersiz kılınır
Bir çalışma zamanı mantıksal keşif kaynağı kullandığında, seçilen kaynak ve çalışma zamanı bağlamı da önbellek ad alanına katılır. Son iyi CSS, önizlemeler arasında yalıtılır ve bir kaynak seçiminden diğerine sızamaz.
Önbellek Konumu
Önbellek dosyaları şurada saklanır:
wp-content/blockstudio/cache/sites/{network-blog}/{runtime-identity}/tailwind/
Yapılandırılan cache.path, mevcut çoklu site kimliği ve çalışma zamanının eksiksiz
kimliği, tam öneki belirler. Her dosya bir MD5 karmasıyla adlandırılır:
{hash}.css.
Önbelleği Temizleme
Yeniden derlemeyi zorlamak için önbellek dizininin içeriğini silin:
// Clear all cached Tailwind CSS
Blockstudio\Runtime_Cache::purge('tailwind');
Ya da WP-CLI üzerinden:
wp eval "Blockstudio\\Runtime_Cache::purge('tailwind');"
Bir sonraki ön yüz isteğinde CSS otomatik olarak yeniden derlenip önbelleğe alınır.
Filtreler
blockstudio/tailwind/css
Derlemeden önce CSS girdisini değiştirin. CSS girdi dizesi @import "tailwindcss"; ile başlar ve ardından herhangi bir yapılandırma gelir. Ek CSS yönergeleri, özel @layer kuralları veya eklenti içe aktarımları eklemek için bu filtreyi kullanın.
add_filter('blockstudio/tailwind/css', function (string $css): string {
// Add a custom utility
$css .= "\n@utility container-narrow { max-width: 48rem; margin-inline: auto; }";
return $css;
});
Derlenen CSS girdisinin tamamı şöyle görünür:
/* Base import */
@import 'tailwindcss';
/* Config from settings (if set) */
@theme {
--color-brand: pink;
}
/* Anything added via the blockstudio/tailwind/css filter */
Çıktı Tamponu
Tailwind derlemesi, Blockstudio’in çıktı tamponu sistemine bağlanır. Tampon, WordPress oluşturmayı bitirdikten sonra tüm sayfa HTML içeriğini yakalar; böylece Tailwind, blok şablonları, tema şablonları, eklenti çıktısı, the_content filtreleri ve bileşen alanları gibi tüm kaynaklardaki sınıfları tarayabilir.
Derleme filtresi, diğer tüm değişikliklerden sonra son HTML öğesini işlemesini sağlamak için blockstudio/buffer/output kancasındaki 999999 önceliğinde çalışır. Tampon template_redirect eyleminde başlatılır; yani yalnızca ön yüz isteklerinde çalışır, yönetici alanında, REST API veya AJAX bağlamlarında çalışmaz.
Tüm belgenin tamponlanması bunu mümkün kılar; bu nedenle varsayılan olarak etkindir. Ne Tailwind ne de blok varlıklarını kullanan bir site bunu kapatabilir:
add_filter( 'blockstudio/buffer/enabled', '__return_false' );
false döndürmek tamponu tamamen atlar; bu da Tailwind derlemesini ve blok stilleriyle betiklerinin başlık ve altbilgiye taşınmasını devre dışı bırakır.
Mimari
Frontend Request
│
├─ WordPress renders HTML into output buffer
│
├─ blockstudio/buffer/output filter (priority 999999)
│ │
│ ├─ Settings::get('tailwind/enabled') → false? Return HTML unchanged
│ │
│ ├─ build_css_input()
│ │ ├─ @import "tailwindcss"
│ │ ├─ + tailwind/config setting
│ │ └─ + blockstudio/tailwind/css filter
│ │
│ ├─ TailwindPHP::extractCandidates($html)
│ │ └─ Returns array of CSS class names found in HTML
│ │
│ ├─ Cache key = md5(sorted candidates + css input)
│ │
│ ├─ Cache hit?
│ │ ├─ Yes → Read CSS from the shared runtime `tailwind/{hash}.css` scope
│ │ └─ No → TailwindPHP::generate() → Write to cache file
│ │
│ └─ Inject inline CSS, or link the content-hashed cache file when tailwind.output is "link"
│
└─ Browser receives HTML with compiled CSS
Editor Request
│
├─ Admin loads block editor
│
├─ Block with classes field (tailwind: true) detected
│ └─ Block_Registry::set_tailwind_active(true)
│
├─ Admin passes isTailwindActive + tailwindUrl to JS
│
└─ useTailwind() hook
├─ Injects Tailwind CDN script into document
├─ Creates hidden template div with HTML content
├─ Creates style tag for config
└─ CDN compiles CSS in-browser for live preview
Eksiksiz Örnek
Özel tema renkleri ve bunları kullanan bir blokla eksiksiz, çalışan bir kurulum:
{
"$schema": "https://blockstudio.dev/schema/blockstudio",
"tailwind": {
"enabled": true,
"config": "@theme { --color-brand: #6366f1; --color-brand-light: #a5b4fc; --color-surface: #f8fafc; } @layer utilities { .section-padding { @apply py-20 px-6; } .content-width { @apply max-w-5xl mx-auto; } .heading-xl { @apply text-4xl font-bold tracking-tight; } }"
}
}
{
"name": "my-theme/hero",
"title": "Hero Section",
"blockstudio": {
"attributes": [
{
"id": "title",
"type": "text",
"label": "Title",
"default": "Welcome"
},
{
"id": "wrapperClasses",
"type": "classes",
"label": "Wrapper Classes",
"tailwind": true,
"default": "section-padding bg-surface"
},
{
"id": "titleClasses",
"type": "classes",
"label": "Title Classes",
"tailwind": true,
"default": "heading-xl text-brand"
}
]
}
}
<section class="<?php echo $a['wrapperClasses']; ?>">
<div class="content-width">
<h1 class="<?php echo $a['titleClasses']; ?>">
<?php echo esc_html($a['title']); ?>
</h1>
</div>
</section>
Bu, ön yüzde tüm Tailwind yardımcı sınıfları ve özel tema renkleri tek bir satır içi <style> etiketi içinde derlenmiş olarak görüntülenir.
Üretim teması için tasarım belirteçleri, özel yardımcı sınıflar ve eksiksiz Tailwind v4 kurulumu.