Tailwind CSS
Az Blockstudio beépített Tailwind CSS v4 támogatást tartalmaz. Ha engedélyezve van, minden frontendoldal szerveroldalon fordul le a TailwindPHP segítségével, automatikus fájlalapú gyorsítótárazással. A blokk szerkesztőjében egy csomagolt Tailwind CDN szkript biztosít élő előnézetet szerkesztés közben.
Nincs szükség buildlépésre, CLI-re vagy Node.js-re.
Működés
Az Blockstudio a környezettől függően két külön fordítási stratégiát használ:
Frontend (szerveroldal)
Minden frontendkérésnél az Blockstudio kimeneti pufferrel rögzíti az oldal teljes HTML tartalmát, kinyeri az összes CSS osztályjelöltet, lefordítja csak a ténylegesen használt CSS elemet, majd az eredményt egy beágyazott <style> címkeként, az </head> elé illeszti be.
A fordítás menete:
- Az WordPress a teljes oldal HTML tartalmát egy kimeneti pufferbe rendereli
- Az
TailwindPHP::extractCandidates()átvizsgálja a HTML elemet, és kinyeri az összes lehetséges CSS osztálynevet (gyors regex, fordítás nélkül) - A rendezett jelöltekből a rendszer az CSS konfigurációval együtt kivonatot készít a gyorsítótárkulcshoz
- Gyorsítótár-találat esetén: a lefordított CSS beolvasódik a lemezről, majd bekerül a kimenetbe
- Gyorsítótár-találat hiányában: az
TailwindPHP::generate()lefordítja a CSS elemet, beírja a gyorsítótár-könyvtárba, majd bekerül a kimenetbe
A lefordított CSS a következőként kerül beillesztésre:
<style id="blockstudio-tailwind">
/* compiled CSS */
</style>
Ez tartalmazza az Tailwind előfeldolgozását (CSS alaphelyzetbe állítás) és az összes illeszkedő segédosztályt.
Szerkesztő (kliensoldal)
A blokkszerkesztőben egy csomagolt Tailwind CDN szkript fut kliensoldalon (az Tailwind CSS v4 böngészős változata). Gépelés közben azonnali élő előnézetet biztosít, szerverkérések nélkül. Az CDN csak a szerkesztőben töltődik be, a frontendoldalakon soha.
Amikor az assets.reset.enabled aktív, az Blockstudio a szerkesztő vásznán az Tailwind általános megjelenítési és pozicionálási segédosztályait is visszaállítja. Így a burkolóelemek szintjén használt osztályokat, például a flex, grid, absolute, fixed és sticky osztályt nem írják felül az WordPress szerkesztői blokkok burkolóelemeire vonatkozó szabályai, ezért a segédosztályokkal kialakított elrendezések jobban hasonlítanak a frontend megjelenésére.
Az Tailwind engedélyezése
Adja hozzá az tailwind konfigurációt ehhez: blockstudio.json:
{
"$schema": "https://blockstudio.dev/schema/blockstudio",
"tailwind": {
"enabled": true
}
}
Vagy engedélyezze egy szűrővel:
add_filter('blockstudio/settings/tailwind/enabled', '__return_true');
Ha az enabled true állapotban van, minden frontendoldal automatikusan lefordított Tailwind CSS elemet kap a kimenetbe. Az Tailwind segédosztályokat bárhol használhatja: blokk sablonokban, sablonfájlokban, the_content szűrőkben vagy az oldal kimenetében megjelenő bármely HTML elemben.
Frontendkimenet
Alapértelmezés szerint a lefordított CSS beágyazott, így megőrzi a korábbi verziók kimenetét. A sok közös szabályt használó webhelyek helyette tartalomkivonattal ellátott stíluslapot is választhatnak:
{
"tailwind": {
"enabled": true,
"output": "link"
}
}
Az "output": "link" a meglévő tailwind/{content-hash}.css gyorsítótárfájlt <link rel="stylesheet"> formátumban bocsátja ki. Az URL értéke megváltozik, ha a futtatókörnyezet identitása, a jelöltek, a motor vagy a CSS bemenete megváltozik, így a böngészők és az éltárolók biztonságosan megőrizhetik a régi URL-eket. Állítsa be a webszervert vagy az CDN rendszert, hogy hosszú élettartamú Cache-Control: public, immutable fejlécet küldjön ehhez a gyorsítótár-hatókörhöz.
Az alapértelmezett gyorsítótárgyökér nyilvánosan elérhető, az wp-content alatt. Ha az cache.path egy privát, abszolút elérési úttal megadott kötetre mutat, az Blockstudio beágyazott CSS formátumra vált, kivéve ha a meglévő blockstudio/files/url szűrő nyilvános URL értéket ad meg az tailwind hatókörhöz:
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
);
Sablon-összeállítási segédfüggvények
Az Blockstudio ugyanazt a csomagolt TailwindPHP motort biztosítja az PHP sablonokhoz is. Nincs szükség a sablonba másolt változatra vagy tartalékmegvalósításra:
$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() elfogadja a beágyazott osztályértékeket, és feloldja az ütköző Tailwind segédosztályokat. bs_tw_variants() egy CVA-stílusú hívható értéket ad vissza, amely támogatja az alapértékeket, a variánsokat, az alapértelmezett variánsokat, az összetett variánsokat, a class és a className lehetőségeket.
Konfiguráció
A Tailwind v4 konfigurációs megközelítése a CSS-t helyezi előtérbe. Külön JavaScript konfigurációs fájl helyett közvetlenül CSS formájában írhatja meg a konfigurációt a @theme direktívával.
{
"tailwind": {
"enabled": true,
"config": "@theme { --color-primary: #3b82f6; --color-secondary: #10b981; --font-family-heading: 'Inter', sans-serif; }"
}
}
A config érték egy CSS karakterlánc, amely a @import "tailwindcss" direktíva után kerül. Itt bármilyen érvényes Tailwind v4 CSS szintaxist használhat:
{
"tailwind": {
"enabled": true,
"config": "@theme { --color-brand: oklch(0.7 0.15 200); } @layer base { h1 { font-size: var(--text-4xl); } }"
}
}
Többsoros konfigurációknál kényelmesebb a szűrős megközelítés:
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;
});
Egyéni segédosztályok
Újrahasználható osztály-aliasok definiálásához használja a @layer utilities elemet a Tailwind @apply direktívájával közvetlenül a konfigurációs karakterláncban:
{
"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; } }"
}
}
Ezeket az osztályokat a rendszer a szokásos Tailwind segédosztályokkal együtt fordítja le. A frontend felületen (szerveroldali fordítással) és a szerkesztőben (CDN előnézetben) is működnek.
A Blockstudio megőrzi a Tailwind kanonikus lépcsőréteg-sorrendjét:
theme, base, components, majd utilities. Ez megfelel a Tailwind CSS sorrendjének, így
a későbbi rétegek szabályai a várakozásoknak megfelelően felülírhatják a korábbi rétegekét.
Az osztálymező típusa
Ha automatikus kiegészítéssel szeretné használni a Tailwind osztályokat egy blokk classes mezőjében, állítsa be a mezőn a tailwind: true értéket:
{
"name": "my-theme/hero",
"title": "Hero",
"blockstudio": {
"attributes": [
{
"id": "classes",
"type": "classes",
"label": "Classes",
"tailwind": true,
"default": "bg-white text-gray-900"
}
]
}
}
Ha a tailwind értéke true:
- A mező a teljes Tailwind osztálylistából kínál automatikus kiegészítési javaslatokat
- A szerkesztőben betöltődik az Tailwind CDN szkript az élő előnézethez
- Az osztályok szóközzel elválasztott karakterláncként tárolódnak a blokk attribútumai között
Használja az osztályok értékét a sablonban:
<div class="<?php echo $a['classes']; ?>">
<!-- block content -->
</div>
Beállítások referenciája
| Beállítás | Típus | Alapértelmezett | Leírás |
|---|---|---|---|
enabled |
logikai | false |
A Tailwind CSS fordításának engedélyezése a frontend felületen |
config |
karakterlánc | "" |
Tailwind v4 CSS-alapú konfigurációs karakterlánc |
Beállítás JSON használatával
{
"tailwind": {
"enabled": true,
"config": "@theme { --color-brand: pink; }"
}
}
Beállítás szűrőkkel
add_filter('blockstudio/settings/tailwind/enabled', '__return_true');
add_filter('blockstudio/settings/tailwind/config', function () {
return '@theme { --color-brand: pink; }';
});
Gyorsítótárazás
A Blockstudio egyéni gyorsítótárazási stratégiát használ, amelyet a Tailwind segédosztály-alapú architektúrájához terveztek.
A gyorsítótár működése
A teljes oldal HTML lenyomata helyett (amely az egyes kérések során a nonce-ok, időbélyegek és más dinamikus tartalmak miatt érvénytelenítené a gyorsítótárat) a Blockstudio csak a CSS osztályjelölteket nyeri ki a HTML elemből. Ezeket a jelölteket rendezi, majd a CSS konfigurációval együtt hasheli egy stabil gyorsítótárkulcs előállításához.
Ez azt jelenti, hogy:
- Az azonos Tailwind osztálykészletet használó oldalak ugyanazt a gyorsítótárazott CSS fájlt használják, még akkor is, ha a HTML teljesen eltérő
- A dinamikus tartalmak, például a nonce-ok, a bejelentkezett felhasználók sávjai, a hozzászólások száma és az időbélyegek nem érvénytelenítik a gyorsítótárat
- A gyorsítótár csak akkor érvénytelenül, ha megváltozik az oldalon található CSS osztályok készlete vagy a Tailwind konfiguráció
Ha egy futtatókörnyezet logikai felderítési forrást használ, a kiválasztott forrás és a futtatókörnyezet kontextusa is része a gyorsítótár névterének. A legutóbbi sikeres CSS elkülönül az előnézetek között, és nem szivároghat át egyik forrásválasztásból a másikba.
A gyorsítótár helye
A gyorsítótárfájlok helye:
wp-content/blockstudio/cache/sites/{network-blog}/{runtime-identity}/tailwind/
A beállított cache.path, az aktuális többhelyes telepítés azonosítója és a futtatókörnyezet teljes azonosítója határozza meg a pontos előtagot. Minden fájl neve egy MD5 hashből áll:
{hash}.css.
A gyorsítótár törlése
Az újrafordítás kikényszerítéséhez törölje a gyorsítótár könyvtárának tartalmát:
// Clear all cached Tailwind CSS
Blockstudio\Runtime_Cache::purge('tailwind');
Vagy a WP-CLI használatával:
wp eval "Blockstudio\\Runtime_Cache::purge('tailwind');"
A következő frontend kérés automatikusan újrafordítja és gyorsítótárazza a CSS elemet.
Szűrők
blockstudio/tailwind/css
Módosítsa a CSS bemenetet a fordítás előtt. A CSS bemeneti karakterlánc a @import "tailwindcss"; értékkel kezdődik, amelyet tetszőleges konfiguráció követ. Ezzel a szűrővel további CSS direktívákat, egyéni @layer szabályokat vagy bővítményimportokat adhat hozzá.
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;
});
A teljes lefordított CSS bemenet így néz ki:
/* Base import */
@import 'tailwindcss';
/* Config from settings (if set) */
@theme {
--color-brand: pink;
}
/* Anything added via the blockstudio/tailwind/css filter */
Kimeneti puffer
A Tailwind fordítása a Blockstudio kimeneti pufferrendszeréhez kapcsolódik. A puffer a teljes oldal HTML tartalmát rögzíti, miután a WordPress befejezte a megjelenítést. Így a Tailwind minden forrásból beolvashatja az összes osztályt: blokk- és sablonfájlokból, témasablonokból, bővítmények kimenetéből, the_content szűrőkből és widgetterületekről.
A fordítási szűrő a blockstudio/buffer/output horgon, 999999 prioritással fut, így az összes módosítás után a végleges HTML tartalmat dolgozza fel. A puffer a template_redirect műveletnél indul, ezért csak frontend kéréseknél fut, az adminisztrációs felületen, a REST API környezetben és AJAX kontextusban nem.
A teljes dokumentum pufferelése teszi ezt lehetővé, ezért alapértelmezés szerint engedélyezett. Az a webhely, amely sem Tailwind-t, sem blokkeszközöket nem használ, kikapcsolhatja:
add_filter( 'blockstudio/buffer/enabled', '__return_false' );
A false visszaadása teljesen kihagyja a puffert, ami egyben letiltja a Tailwind fordítását, valamint a blokkstílusok és -szkriptek fejlécbe és láblécbe emelését.
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
Teljes példa
Teljes, működő beállítás egyéni témaszínekkel és egy ezeket használó blokkal:
{
"$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>
A frontend felületen az összes Tailwind segédosztály és egyéni témaszín egyetlen inline <style> címkébe fordítva jelenik meg.
Tervezési tokenek, egyéni segédosztályok és a teljes Tailwind v4 beállítása éles környezethez készülő témához.