Tailwind CSS
Blockstudio har inbyggt stöd för Tailwind CSS v4. När funktionen är aktiverad kompileras varje frontend-sida på serversidan via TailwindPHP med automatisk filbaserad cachning. I blockredigeraren ger ett paketerat Tailwind CDN-skript en direkt förhandsvisning medan du redigerar.
Inget byggsteg, ingen CLI och ingen Node.js krävs.
Så fungerar det
Blockstudio använder två separata kompileringsstrategier beroende på sammanhanget:
Frontend (serversidan)
Vid varje frontend-begäran fångar Blockstudio in hela sidans HTML via en utdatabuffert, extraherar alla potentiella CSS-klasser, kompilerar endast den CSS som faktiskt används och infogar resultatet som en infogad <style>-tagg före </head>.
Kompileringsflödet:
- WordPress renderar hela sidans HTML till en utdatabuffert
TailwindPHP::extractCandidates()genomsöker HTML och extraherar alla möjliga CSS-klassnamn (snabbt reguljärt uttryck, ingen kompilering)- De sorterade kandidaterna hashas tillsammans med CSS-konfigurationen för att skapa en cache-nyckel
- Vid cacheträff läses den kompilerade CSS från disken och infogas
- Vid cachemiss kompilerar
TailwindPHP::generate()CSS, skriver den till cachekatalogen och infogar den
Den kompilerade CSS infogas så här:
<style id="blockstudio-tailwind">
/* compiled CSS */
</style>
Detta omfattar Tailwinds förberedande stilregler (återställningen CSS) och alla matchande verktygsklasser.
Redigerare (klientsidan)
Inne i blockredigeraren körs ett paketerat Tailwind CDN-skript (webbläsarbygget av Tailwind CSS v4) på klientsidan. Det ger en omedelbar förhandsvisning medan du skriver klassnamn, utan några anrop till servern. CDN läses endast in i redigeraren och skickas aldrig till frontend.
När assets.reset.enabled är aktivt återställer Blockstudio även Tailwinds vanliga visnings- och positioneringsverktyg i redigerarens canvas. Då åsidosätts inte klasser på omslagsnivå som flex, grid, absolute, fixed och sticky av WordPress-redigerarens omslagsregler för block, så layouter som använder verktygsklasser stämmer bättre överens med frontend.
Aktivera Tailwind
Lägg till konfigurationen tailwind i din blockstudio.json:
{
"$schema": "https://blockstudio.dev/schema/blockstudio",
"tailwind": {
"enabled": true
}
}
Eller aktivera det via ett filter:
add_filter('blockstudio/settings/tailwind/enabled', '__return_true');
När enabled är true kompileras och infogas Tailwind CSS automatiskt på varje frontend-sida. Du kan använda verktygsklasser från Tailwind var som helst: i blockmallar, temamallar, the_content-filter eller vilket HTML som helst som förekommer i sidans utdata.
Frontend-utdata
Kompilerad CSS infogas som standard direkt i dokumentet, vilket bevarar utdataformatet från tidigare versioner. Webbplatser med många delade regler kan välja en stilmall med innehållshash i stället:
{
"tailwind": {
"enabled": true,
"output": "link"
}
}
"output": "link" skickar ut den befintliga cachefilen tailwind/{content-hash}.css som en <link rel="stylesheet">. URL ändras när körningsidentiteten, kandidaterna, motorn eller indata av typen CSS ändras, så webbläsare och edge-cacher tryggt kan behålla gamla URL:er. Konfigurera webbservern eller CDN att skicka en långlivad Cache-Control: public, immutable-rubrik för detta cacheomfång.
Standardroten för cachen är publik under wp-content. Om cache.path pekar på en privat absolut volym använder Blockstudio infogad CSS i stället, om inte det befintliga filtret blockstudio/files/url tillhandahåller en publik URL för omfånget 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
);
Hjälpfunktioner för mallkomposition
Blockstudio tillhandahåller samma paketerade TailwindPHP-motor för PHP-mallar. Ingen kopia eller reservimplementation på temasidan behövs:
$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() godtar kapslade klassvärden och löser konflikter mellan Tailwind-verktyg. bs_tw_variants() returnerar en anropsbar funktion i CVA-stil som stöder basvärden, varianter, standardvarianter, sammansatta varianter, class och className.
Konfiguration
Tailwind v4 använder en konfigurationsmetod där CSS kommer först. I stället för en JavaScript-konfigurationsfil skriver du konfigurationen direkt som CSS med direktivet @theme.
{
"tailwind": {
"enabled": true,
"config": "@theme { --color-primary: #3b82f6; --color-secondary: #10b981; --font-family-heading: 'Inter', sans-serif; }"
}
}
Värdet config är en sträng av typen CSS som läggs till efter direktivet @import "tailwindcss". Här kan du använda valfri giltig syntax för Tailwind v4 CSS:
{
"tailwind": {
"enabled": true,
"config": "@theme { --color-brand: oklch(0.7 0.15 200); } @layer base { h1 { font-size: var(--text-4xl); } }"
}
}
För konfigurationer med flera rader är filtermetoden smidigare:
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;
});
Anpassade verktygsklasser
Om du vill definiera återanvändbara klassalias använder du @layer utilities direkt med direktivet @apply från Tailwind i konfigurationssträngen:
{
"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; } }"
}
}
Dessa klasser kompileras tillsammans med alla vanliga Tailwind-verktyg. De fungerar både på frontend (kompilering på serversidan) och i redigeraren (CDN-förhandsgranskning).
Blockstudio bevarar den kanoniska ordningen för kaskadlager i Tailwind:
theme, base, components och sedan utilities. Detta stämmer med Tailwind CSS, så
regler i senare lager kan åsidosätta tidigare lager som förväntat.
Fälttypen Classes
Om du vill använda klasser från Tailwind i ett blocks fält classes med stöd för automatisk komplettering anger du tailwind: true för fältet:
{
"name": "my-theme/hero",
"title": "Hero",
"blockstudio": {
"attributes": [
{
"id": "classes",
"type": "classes",
"label": "Classes",
"tailwind": true,
"default": "bg-white text-gray-900"
}
]
}
}
När tailwind är true:
- Fältet ger förslag på automatisk komplettering från den fullständiga klasslistan i Tailwind
- Skriptet Tailwind CDN läses in i redigeraren för förhandsgranskning i realtid
- Klasser lagras som en sträng med blankstegsavgränsare i blockattributen
Använd klassvärdet i din mall:
<div class="<?php echo $a['classes']; ?>">
<!-- block content -->
</div>
Referens för inställningar
| Alternativ | Typ | Standardvärde | Beskrivning |
|---|---|---|---|
enabled |
boolean | false |
Aktivera kompilering av Tailwind CSS i frontend |
config |
string | "" |
Konfigurationssträng där Tailwind v4 CSS kommer först |
Ange via JSON
{
"tailwind": {
"enabled": true,
"config": "@theme { --color-brand: pink; }"
}
}
Ange via filter
add_filter('blockstudio/settings/tailwind/enabled', '__return_true');
add_filter('blockstudio/settings/tailwind/config', function () {
return '@theme { --color-brand: pink; }';
});
Cachning
Blockstudio använder en anpassad cachningsstrategi som är utformad för den verktygsbaserade arkitekturen i Tailwind.
Så fungerar cachen
I stället för att beräkna en hash av hela sidans HTML (vilket skulle tömma cachen vid varje begäran på grund av engångsvärden, tidsstämplar och annat dynamiskt innehåll), extraherar Blockstudio bara kandidaterna för CSS-klasser från HTML. Kandidaterna sorteras och hashas tillsammans med konfigurationen för CSS för att skapa en stabil cachenyckel.
Det innebär att:
- Två sidor som använder samma uppsättning Tailwind-klasser delar samma cachade CSS-fil, även om deras HTML skiljer sig helt åt
- Dynamiskt innehåll som engångsvärden, fält för inloggade användare, kommentarsantal och tidsstämplar tömmer inte cachen
- Cachen ogiltigförklaras bara när uppsättningen CSS-klasser på en sida ändras eller konfigurationen för Tailwind ändras
När en runtime använder en logisk identifieringskälla ingår även den valda källan och runtime-kontexten i cacheutrymmet. Den senast fungerande CSS hålls åtskild mellan förhandsgranskningar och kan inte läcka från ett källval till ett annat.
Cachens plats
Cachefiler lagras i:
wp-content/blockstudio/cache/sites/{network-blog}/{runtime-identity}/tailwind/
Det konfigurerade cache.path, den aktuella multisite-identiteten och hela runtime-identiteten avgör det exakta prefixet. Varje fil namnges med en MD5-hash:
{hash}.css.
Rensa cachen
Ta bort innehållet i cachekatalogen för att tvinga fram en ny kompilering:
// Clear all cached Tailwind CSS
Blockstudio\Runtime_Cache::purge('tailwind');
Eller via WP-CLI:
wp eval "Blockstudio\\Runtime_Cache::purge('tailwind');"
Nästa frontend-begäran kompilerar om och cachar CSS automatiskt.
Filter
blockstudio/tailwind/css
Ändra indata för CSS före kompilering. Indatasträngen för CSS börjar med @import "tailwindcss";, följt av valfri konfiguration. Använd det här filtret för att lägga till fler direktiv för CSS, anpassade regler för @layer eller plugin-importer.
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;
});
Hela indatan för CSS som kompileras ser ut så här:
/* Base import */
@import 'tailwindcss';
/* Config from settings (if set) */
@theme {
--color-brand: pink;
}
/* Anything added via the blockstudio/tailwind/css filter */
Utmatningsbuffert
Kompileringen av Tailwind integreras med utmatningsbuffertsystemet i Blockstudio. Bufferten fångar upp hela sidans HTML när WordPress har slutfört renderingen, så att Tailwind kan söka igenom alla klasser från varje källa: blockmallar, temamallar, pluginutdata, the_content-filter och widgetområden.
Kompileringsfiltret körs med prioriteten 999999 på hooken blockstudio/buffer/output, vilket säkerställer att det bearbetar den slutliga HTML efter alla andra ändringar. Bufferten startas vid åtgärden template_redirect, vilket innebär att den bara körs vid förfrågningar till frontend, inte i admin, REST API eller AJAX-kontexter.
Det är buffringen av hela dokumentet som gör detta möjligt, så den är aktiverad som standard. En webbplats som varken använder Tailwind eller blockresurser kan stänga av den:
add_filter( 'blockstudio/buffer/enabled', '__return_false' );
Om false returneras hoppas bufferten över helt, vilket också inaktiverar kompilering av Tailwind och flytt av blockens stilar och skript till sidhuvudet och sidfoten.
Arkitektur
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
Fullständigt exempel
En komplett fungerande konfiguration med anpassade temafärger och ett block som använder dem:
{
"$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>
Detta renderas i frontend med alla verktyg i Tailwind och anpassade temafärger kompilerade till en enda infogad <style>-tagg.
Designtoken, anpassade verktyg och en komplett konfiguration av Tailwind v4 för ett produktionstema.