Tailwind CSS
Blockstudio obsahuje vstavanú podporu Tailwind CSS v4. Keď je zapnutá, každá stránka na frontende sa kompiluje na strane servera pomocou TailwindPHP a výsledok sa automaticky ukladá do súborovej vyrovnávacej pamäte. V editore blokov poskytuje pribalený skript Tailwind CDN živý náhľad počas úprav.
Bez kroku zostavenia, bez CLI a bez potreby Node.js.
Ako to funguje
Blockstudio používa dve samostatné stratégie kompilácie podľa kontextu:
Frontend (na strane servera)
Pri každej požiadavke na frontend Blockstudio zachytí celý stránkový HTML do výstupného zásobníka, vyberie všetky kandidátne triedy CSS, skompiluje iba skutočne použité CSS a výsledok vloží ako vloženú značku <style> pred </head>.
Postup kompilácie:
- WordPress vykreslí celý stránkový HTML do výstupného zásobníka
TailwindPHP::extractCandidates()prehľadá HTML a vyberie všetky potenciálne názvy tried CSS (rýchly regulárny výraz, bez kompilácie)- Z kandidátov sa spolu s konfiguráciou CSS vytvorí hash kľúča vyrovnávacej pamäte
- Pri zásahu do vyrovnávacej pamäte sa skompilované CSS načíta z disku a vloží
- Pri minutí vyrovnávacej pamäte
TailwindPHP::generate()skompiluje CSS, zapíše ho do adresára vyrovnávacej pamäte a vloží
Skompilované CSS sa vkladá takto:
<style id="blockstudio-tailwind">
/* compiled CSS */
</style>
Patrí sem preflight Tailwind (reset CSS) aj všetky zodpovedajúce pomocné triedy.
Editor (na strane klienta)
V editore blokov sa pribalený skript Tailwind CDN (verzia Tailwind CSS v4 prehliadača) spúšťa na strane klienta. Poskytuje okamžitý živý náhľad pri zadávaní názvov tried bez opakovaných požiadaviek na server. Súbor CDN sa načítava iba v editore a nikdy sa neposkytuje na frontende.
Keď je aktívne assets.reset.enabled, Blockstudio v editore obnovuje aj bežné pomocné triedy Tailwind na zobrazenie a polohu. Vďaka tomu pravidlá WordPress pre obalové prvky blokov neprepisujú triedy na úrovni obalu, ako sú flex, grid, absolute, fixed a sticky, takže rozloženia založené na pomocných triedach sa viac podobajú tým na frontende.
Zapnutie Tailwind
Pridajte konfiguráciu tailwind do súboru blockstudio.json:
{
"$schema": "https://blockstudio.dev/schema/blockstudio",
"tailwind": {
"enabled": true
}
}
Alebo ho zapnite pomocou filtra:
add_filter('blockstudio/settings/tailwind/enabled', '__return_true');
Keď je enabled nastavené na true, každá stránka na frontende bude mať automaticky skompilované a vložené Tailwind CSS. Pomocné triedy Tailwind môžete používať kdekoľvek: v šablónach blokov, šablónach tém, filtroch the_content alebo v ľubovoľnom HTML, ktoré sa objaví vo výstupe stránky.
Výstup frontendu
Predvolene sa skompilované CSS vkladá priamo do stránky, čím sa zachováva výstup používaný v predchádzajúcich verziách. Weby s mnohými zdieľanými pravidlami môžu namiesto toho použiť hárok štýlov s hashom obsahu:
{
"tailwind": {
"enabled": true,
"output": "link"
}
}
"output": "link" vytvorí existujúci súbor vyrovnávacej pamäte tailwind/{content-hash}.css ako <link rel="stylesheet">. Hodnota URL sa zmení pri zmene identity prostredia, kandidátov, nástroja alebo vstupu CSS, takže prehliadače a hraničné vyrovnávacie pamäte môžu bezpečne ponechať staré URL adresy. Nakonfigurujte webový server alebo CDN tak, aby pre tento rozsah vyrovnávacej pamäte odosielali hlavičku Cache-Control: public, immutable s dlhou platnosťou.
Predvolený koreň vyrovnávacej pamäte je verejne dostupný pod wp-content. Ak cache.path odkazuje na súkromný absolútny zväzok, Blockstudio použije vložené CSS, pokiaľ existujúci filter blockstudio/files/url neposkytne verejné URL pre rozsah tailwind:
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
);
Pomocné nástroje na skladanie šablón
Blockstudio sprístupňuje šablónam PHP rovnaký zabalený engine TailwindPHP. Nie je potrebná žiadna kópia na strane témy ani náhradná implementácia:
$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() prijíma vnorené hodnoty tried a rieši konfliktné Tailwind utility. bs_tw_variants() vracia volateľný objekt v štýle CVA, ktorý podporuje základ, varianty, predvolené varianty, zložené varianty, class a className.
Konfigurácia
Tailwind v4 používa konfiguráciu, pri ktorej sú na prvom mieste CSS. Namiesto konfiguračného súboru JavaScript zapisujete konfiguráciu priamo ako CSS pomocou direktívy @theme.
{
"tailwind": {
"enabled": true,
"config": "@theme { --color-primary: #3b82f6; --color-secondary: #10b981; --font-family-heading: 'Inter', sans-serif; }"
}
}
Hodnota config je reťazec CSS, ktorý sa pripája za direktívu @import "tailwindcss". Môžete tu použiť ľubovoľnú platnú syntax Tailwind v4 CSS:
{
"tailwind": {
"enabled": true,
"config": "@theme { --color-brand: oklch(0.7 0.15 200); } @layer base { h1 { font-size: var(--text-4xl); } }"
}
}
Pri viacriadkových konfiguráciách je pohodlnejšie použiť filter:
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;
});
Vlastné utility triedy
Ak chcete definovať opakovane použiteľné aliasy tried, použite @layer utilities priamo v konfiguračnom reťazci spolu s direktívou @apply z Tailwind:
{
"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; } }"
}
}
Tieto triedy sa skompilujú spolu so všetkými štandardnými utilitami Tailwind. Fungujú na frontende (kompilácia na strane servera) aj v editore (náhľad CDN).
Blockstudio zachováva kanonické poradie kaskádových vrstiev Tailwind:
theme, base, components a potom utilities. Zodpovedá to Tailwind CSS, takže
pravidlá v neskorších vrstvách môžu podľa očakávania prepísať pravidlá v skorších vrstvách.
Typ poľa Classes
Ak chcete v poli classes bloku používať triedy Tailwind s podporou automatického dopĺňania, nastavte pre pole tailwind: true:
{
"name": "my-theme/hero",
"title": "Hero",
"blockstudio": {
"attributes": [
{
"id": "classes",
"type": "classes",
"label": "Classes",
"tailwind": true,
"default": "bg-white text-gray-900"
}
]
}
}
Keď je tailwind nastavené na true:
- Pole ponúka návrhy automatického dopĺňania z úplného zoznamu tried Tailwind
- V editore sa načíta skript Tailwind CDN na živý náhľad
- Triedy sa v atribútoch bloku ukladajú ako reťazec oddelený medzerami
Použite hodnotu classes v šablóne:
<div class="<?php echo $a['classes']; ?>">
<!-- block content -->
</div>
Referencia nastavení
| Možnosť | Typ | Predvolené | Popis |
|---|---|---|---|
enabled |
boolean | false |
Povoliť kompiláciu Tailwind CSS na frontende |
config |
string | "" |
Reťazec konfigurácie Tailwind v4 s CSS na prvom mieste |
Nastavenie cez JSON
{
"tailwind": {
"enabled": true,
"config": "@theme { --color-brand: pink; }"
}
}
Nastavenie cez filtre
add_filter('blockstudio/settings/tailwind/enabled', '__return_true');
add_filter('blockstudio/settings/tailwind/config', function () {
return '@theme { --color-brand: pink; }';
});
Ukladanie do vyrovnávacej pamäte
Blockstudio používa vlastnú stratégiu ukladania do vyrovnávacej pamäte navrhnutú pre utilitami založenú architektúru Tailwind.
Ako funguje vyrovnávacia pamäť
Namiesto hashovania celej stránky HTML (čo by pri každej požiadavke zneplatnilo vyrovnávaciu pamäť kvôli nonce, časovým značkám a ďalšiemu dynamickému obsahu) Blockstudio extrahuje z HTML iba kandidátne triedy CSS. Tieto kandidáty sa zoradia a spolu s konfiguráciou CSS sa použijú na vytvorenie stabilného kľúča vyrovnávacej pamäte.
To znamená:
- Dve stránky, ktoré používajú rovnakú množinu tried Tailwind, zdieľajú rovnaký súbor CSS vo vyrovnávacej pamäti, aj keď je ich HTML úplne odlišné
- Dynamický obsah, ako sú nonce, panely prihlásených používateľov, počty komentárov a časové značky, nezneplatňuje vyrovnávaciu pamäť
- Vyrovnávacia pamäť sa zneplatní iba vtedy, keď sa zmení množina tried CSS na stránke alebo konfigurácia Tailwind
Keď runtime používa zdroj logického objavovania logical discovery source, vybraný zdroj a kontext runtime sa tiež zahrnú do priestoru názvov vyrovnávacej pamäte. Posledný platný CSS je izolovaný medzi náhľadmi a nemôže preniknúť z jedného výberu zdroja do druhého.
Umiestnenie vyrovnávacej pamäte
Súbory vyrovnávacej pamäte sa ukladajú do:
wp-content/blockstudio/cache/sites/{network-blog}/{runtime-identity}/tailwind/
Nakonfigurované cache.path, aktuálna identita multisite a úplná identita runtime určujú presnú predponu. Názov každého súboru obsahuje hash MD5:
{hash}.css.
Vymazanie vyrovnávacej pamäte
Ak chcete vynútiť opätovnú kompiláciu, odstráňte obsah adresára vyrovnávacej pamäte:
// Clear all cached Tailwind CSS
Blockstudio\Runtime_Cache::purge('tailwind');
Alebo cez WP-CLI:
wp eval "Blockstudio\\Runtime_Cache::purge('tailwind');"
Pri ďalšej požiadavke na frontend sa CSS automaticky znova skompiluje a uloží do vyrovnávacej pamäte.
Filtre
blockstudio/tailwind/css
Pred kompiláciou upravte vstup CSS. Vstupný reťazec CSS sa začína na @import "tailwindcss"; a za ním nasleduje ľubovoľná konfigurácia. Pomocou tohto filtra môžete pridať ďalšie direktívy CSS, vlastné pravidlá @layer alebo importy pluginov.
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;
});
Úplný vstup CSS, ktorý sa skompiluje, vyzerá takto:
/* Base import */
@import 'tailwindcss';
/* Config from settings (if set) */
@theme {
--color-brand: pink;
}
/* Anything added via the blockstudio/tailwind/css filter */
Výstupná vyrovnávacia pamäť
Kompilácia Tailwind sa zapája do systému výstupnej vyrovnávacej pamäte Blockstudio. Tá zachytí celý obsah stránky HTML po dokončení vykresľovania WordPress, čo umožní nástroju Tailwind prehľadať všetky triedy zo všetkých zdrojov: šablón blokov, šablón témy, výstupu pluginov, filtrov the_content a oblastí widgetov.
Filter kompilácie sa spustí s prioritou 999999 pri hooku blockstudio/buffer/output, aby spracoval konečné HTML po všetkých ostatných úpravách. Vyrovnávacia pamäť sa spustí pri akcii template_redirect, takže sa používa iba pri požiadavkách na frontend, nie v správcovskej časti, REST API ani v kontextoch AJAX.
Práve ukladanie celého dokumentu do vyrovnávacej pamäte to umožňuje, preto je táto funkcia predvolene zapnutá. Stránka, ktorá nepoužíva Tailwind ani prostriedky blokov, ju môže vypnúť:
add_filter( 'blockstudio/buffer/enabled', '__return_false' );
Vrátením hodnoty false sa úplne preskočí vyrovnávacia pamäť, čím sa vypne aj kompilácia Tailwind a presunutie štýlov a skriptov blokov do hlavičky a päty.
Architektúra
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
Úplný príklad
Úplné funkčné nastavenie s vlastnými farbami témy a blokom, ktorý ich používa:
{
"$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>
Na frontende sa toto vykreslí so všetkými utilitami Tailwind a vlastnými farbami témy skompilovanými do jedného vloženého tagu <style>.
Dizajnové tokeny, vlastné utility a úplné nastavenie Tailwind v4 pre produkčnú tému.