Tailwind v4 uden Node
Hver side kompilerer kun de klasser, den bruger, i PHP.
Én indstilling, intet build-trin
Angiv tailwind.enabled i blockstudio.json, og skriv utility-klasser i enhver skabelon. Ved hver frontend-forespørgsel indsamler Blockstudio klassekandidaterne i den færdige HTML og kompilerer præcis dem med TailwindPHP, en PHP-portering af Tailwind CSS 4.3.
Der er ingen Node.js, ingen CLI og ingen watcher. Klasser fra blokskabeloner, temaskabeloner, plugins og the_content tæller alle med, fordi hele siden scannes.
{
"tailwind": {
"enabled": true
}
}<section class="bg-slate-950 px-6 py-24">
<h1 class="text-5xl font-semibold tracking-tight text-white">
<?php echo esc_html( $a['title'] ); ?>
</h1>
</section>Ingen Node-runtime
TailwindPHP kompilerer ved forespørgslen; der er intet at bygge eller deploye.
Tailwind 4.3-værktøjer
Værktøjer, varianter, vilkårlige værdier og direktiver fra Tailwind CSS 4.3.
Scanning af hele siden
Klasser tæller med, uanset hvor de optræder i den endelige HTML.
Cachelagret efter klassesæt
Sider med de samme klasser deler én kompileret fil.
CSS-først-konfiguration
@theme-tokens og @utility-regler i blockstudio.json eller et filter.
Direkte forhåndsvisning i editoren
En medfølgende browserbuild viser klasserne, mens du skriver.
Sammenkædet output
Ét content-hash’et stylesheet, som browsere og edge-caches kan gemme.
Typografi og formularer
De to officielle plugins er porteret til PHP og indlæses med @plugin.
Konfigureret i CSS
Tailwind v4 konfigureres med CSS, ikke en JavaScript-fil. Placer @theme-tokens, @utility-regler og lag i tailwind.config, eller tilføj dem via blockstudio/tailwind/css-filteret, når de strækker sig over flere linjer.
De officielle typografi- og formularplugins er porteret til PHP og indlæses med @plugin. Plugins, der kun findes som JavaScript-pakker, kører ikke, fordi intet afvikler Node.
Klassealiasser er @apply-regler i @layer utilities, såsom en .btn bygget af padding- og radius-utilities. De kompileres både på frontend og i editorens forhåndsvisning.
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;
}
';
});{
"tailwind": {
"enabled": true,
"config": "@theme { --color-brand: #6366f1; } @layer utilities { .btn { @apply px-4 py-2 rounded-lg font-medium; } }"
}
}Klasser som felt
Giv et classes-felt "tailwind": true, så får redaktører autofuldførelse fra hele klasselisten, mens en medfølgende Tailwind-browserbuild viser hver ændring på lærredet.
Med assets.reset.enabled gendanner lærredet også visnings- og positionsværktøjer som flex, grid og sticky, som editorens wrapper-regler ellers ville tilsidesætte.
{
"name": "acme/hero",
"title": "Hero",
"blockstudio": {
"attributes": [
{
"id": "classes",
"type": "classes",
"label": "Classes",
"tailwind": true,
"default": "bg-white text-gray-900"
}
]
}
}<div class="<?php echo esc_attr( $a['classes'] ); ?>">
<InnerBlocks />
</div>Ét stylesheet, cachelagret efter klassesæt
Kompileret CSS cachelagres på disken med en nøgle, der er baseret på sidens sorterede klassekandidater og inputtet CSS, så nonces og tidsstempler aldrig ugyldiggør det, og sider med de samme klasser deler én fil.
Inline-output er standard. "output": "link" udsender i stedet cachefilen som et content-hash’et stylesheet. Ved måling på en lokal kopi af dette websted den 8. oktober 2026 tog det hjemmesiden fra 451,648 til 296,379 bytes med HTML.
Når cache.path peger på et privat volumen, falder Blockstudio tilbage til inline CSS, medmindre filteret blockstudio/files/url returnerer en offentlig URL for scopet tailwind, såsom en CDN-vært.
{
"tailwind": {
"enabled": true,
"output": "link"
}
}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
);Sammenflet klasser i PHP
bs_tw_merge() løser konflikter mellem utility-klasser, så en brugerdefineret klasse vinder over en standardklasse. bs_tw_variants() returnerer en variantfunktion med basisklasser, varianter, standardindstillinger og sammensatte varianter.
Begge bruger den TailwindPHP-motor, som Blockstudio allerede indeholder, så et tema behøver ikke sin egen kopi.
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']);Ryd efter behov
Runtime_Cache::purge(‘tailwind’) rydder den kompilerede CSS, og den næste anmodning kompilerer den igen.
Valgfri sidebuffer
Et websted, der hverken bruger Tailwind eller blokaktiver, kan slå sidebufferen fra med filteret blockstudio/buffer/enabled.
Isoleret pr. kilde
Med en logisk opdagelseskilde indgår den valgte kilde og runtimekonteksten i cachenavnerummet, så den senest fungerende CSS aldrig lækker mellem forhåndsvisninger.
Kanonisk lagrækkefølge
Tema, base, komponenter og derefter utilities, som i Tailwind CSS, så senere lag tilsidesætter tidligere.
Det officielle udvidelsessæt
Premiumskabeloner til websteder, AI-systeminstruktioner og et privat Discord-fællesskab. Engangskøb med opdateringer hele livet.
- 500+ hjemmesideskabeloner
- AI-systeminstruktioner
- Opdateringer hele livet
- Privat Discord-fællesskab