Tailwind CSS
Blockstudio vključuje vgrajeno podporo za Tailwind CSS v4. Ko je omogočena, se vsaka stran v ospredju prevede na strani strežnika prek TailwindPHP s samodejnim predpomnjenjem na podlagi datotek. V urejevalniku blokov vgrajeni skript Tailwind CDN omogoča predogled v živo med urejanjem.
Brez koraka gradnje, brez CLI, brez zahteve po Node.js.
Kako deluje
Blockstudio uporablja dve ločeni strategiji prevajanja, odvisno od konteksta:
Sprednji del (na strani strežnika)
Ob vsaki zahtevi v ospredju Blockstudio zajame celotno stran HTML prek izhodnega medpomnilnika, izlušči vse možne razrede CSS, prevede samo CSS, ki se dejansko uporablja, in rezultat vstavi kot oznako <style> v vrstici pred </head>.
Potek prevajanja:
- WordPress izriše celotno stran HTML v izhodni medpomnilnik
TailwindPHP::extractCandidates()pregleda HTML in izlušči vsa morebitna imena razredov CSS (hiter regex brez prevajanja)- Razvrščene kandidate združi z zgoščevanjem konfiguracijo CSS, da ustvari ključ predpomnilnika
- Ob zadetek v predpomnilniku: prebrani prevedeni CSS se zapiše z diska in vstavi
- Ob zgrešen zadetek v predpomnilniku:
TailwindPHP::generate()prevede CSS, ga zapiše v imenik predpomnilnika in vstavi
Prevedeni CSS se vstavi kot:
<style id="blockstudio-tailwind">
/* compiled CSS */
</style>
To vključuje začetno ponastavitev Tailwind (CSS reset) in vse ujemajoče se uporabne razrede.
Urejevalnik (na strani odjemalca)
V urejevalniku blokov se vgrajeni skript Tailwind CDN (brskalniška različica Tailwind CSS v4) izvaja na strani odjemalca. Med vnašanjem imen razredov omogoča takojšen predogled v živo brez povratnih klicev strežnika. CDN se naloži samo v urejevalniku in nikoli ni poslan v ospredje.
Ko je assets.reset.enabled aktiven, Blockstudio v platnu urejevalnika obnovi tudi običajne prikazne in pozicijske pripomočke za Tailwind. Tako razredi na ravni ovojnika, kot so flex, grid, absolute, fixed in sticky, niso prepisani s pravili ovojnika blokov urejevalnika WordPress, zato se postavitve, ki uporabljajo pripomočke, bolj ujemajo z ospredjem.
Omogočanje Tailwind
Dodajte konfiguracijo tailwind v svojo datoteko blockstudio.json:
{
"$schema": "https://blockstudio.dev/schema/blockstudio",
"tailwind": {
"enabled": true
}
}
Lahko ga omogočite tudi prek filtra:
add_filter('blockstudio/settings/tailwind/enabled', '__return_true');
Ko je enabled true, se na vsaki strani v ospredju samodejno prevede in vstavi Tailwind CSS. Uporabne razrede Tailwind lahko uporabite kjer koli: v predlogah blokov, predlogah tem, filtrih the_content ali katerem koli HTML, ki se pojavi v izhodu strani.
Izhod v ospredju
Prevedeni CSS je privzeto v vrstici, kar ohranja izhod, ki so ga uporabljale prejšnje različice. Spletna mesta z veliko skupnimi pravili lahko namesto tega izberejo slogovno datoteko z vsebinsko zgoščeno vrednostjo:
{
"tailwind": {
"enabled": true,
"output": "link"
}
}
"output": "link" ustvari obstoječo datoteko predpomnilnika tailwind/{content-hash}.css kot <link rel="stylesheet">. URL se spremeni, ko se spremenijo identiteta izvajalnega okolja, kandidati, mehanizem ali vhod CSS, zato lahko brskalniki in robni predpomnilniki varno obdržijo stare URL-je. Spletni strežnik ali CDN nastavite tako, da za ta obseg predpomnilnika pošilja glavo Cache-Control: public, immutable z dolgo veljavnostjo.
Privzeti koren predpomnilnika je javno dostopen pod wp-content. Če cache.path kaže na zaseben absolutni nosilec, Blockstudio uporabi CSS v vrstici, razen če obstoječi filter blockstudio/files/url za obseg tailwind določi javni URL:
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
);
Pomočniki za sestavljanje predlog
Blockstudio predlogam PHP omogoča uporabo istega vgrajenega mehanizma TailwindPHP. Ni potrebna kopija v temi ali nadomestna izvedba:
$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() sprejema ugnezdene vrednosti razredov in razreši spore med pripomočki Tailwind. bs_tw_variants() vrne klicno funkcijo v slogu CVA, ki podpira osnovne vrednosti, različice, privzete različice, sestavljene različice, class in className.
Konfiguracija
Tailwind v4 uporablja pristop konfiguracije, pri katerem je v ospredju CSS. Namesto konfiguracijske datoteke JavaScript konfiguracijo zapišete neposredno kot CSS z direktivo @theme.
{
"tailwind": {
"enabled": true,
"config": "@theme { --color-primary: #3b82f6; --color-secondary: #10b981; --font-family-heading: 'Inter', sans-serif; }"
}
}
Vrednost config je niz CSS, ki se doda za direktivo @import "tailwindcss". Tukaj lahko uporabite poljubno veljavno sintakso 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 večvrstičnih konfiguracijah je pristop s filtrom udobnejši:
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;
});
Razredi pripomočkov po meri
Za določitev vzdevkov za razrede, ki jih želite znova uporabiti, v konfiguracijskem nizu neposredno uporabite @layer utilities z direktivo @apply v 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; } }"
}
}
Ti razredi se prevedejo skupaj z vsemi standardnimi pripomočki Tailwind. Delujejo tako na spletnem mestu (strežniško prevajanje) kot v urejevalniku (predogled CDN).
Blockstudio ohrani kanonični vrstni red kaskadnih plasti Tailwind:
theme, base, components, nato utilities. To se ujema z Tailwind CSS, zato
lahko pravila v poznejših plasteh po pričakovanjih preglasijo pravila v zgodnejših.
Vrsta polja Classes
Če želite v polju classes bloka uporabljati razrede Tailwind s podporo za samodokončanje, polju nastavite tailwind: true:
{
"name": "my-theme/hero",
"title": "Hero",
"blockstudio": {
"attributes": [
{
"id": "classes",
"type": "classes",
"label": "Classes",
"tailwind": true,
"default": "bg-white text-gray-900"
}
]
}
}
Ko je tailwind nastavljeno na true:
- Polje ponuja predloge za samodokončanje iz celotnega seznama razredov Tailwind
- V urejevalniku se naloži skript Tailwind CDN za predogled v živo
- Razredi so v atributih bloka shranjeni kot niz, v katerem so ločeni s presledki
Vrednost classes uporabite v predlogi:
<div class="<?php echo $a['classes']; ?>">
<!-- block content -->
</div>
Referenca nastavitev
| Možnost | Vrsta | Privzeto | Opis |
|---|---|---|---|
enabled |
boolova vrednost | false |
Omogoči prevajanje Tailwind CSS na spletnem mestu |
config |
niz | "" |
Konfiguracijski niz, pri katerem je v ospredju Tailwind v4 CSS |
Nastavitev prek JSON
{
"tailwind": {
"enabled": true,
"config": "@theme { --color-brand: pink; }"
}
}
Nastavitev prek filtrov
add_filter('blockstudio/settings/tailwind/enabled', '__return_true');
add_filter('blockstudio/settings/tailwind/config', function () {
return '@theme { --color-brand: pink; }';
});
Predpomnjenje
Blockstudio uporablja prilagojeno strategijo predpomnjenja, zasnovano za arhitekturo pripomočkov Tailwind.
Kako deluje predpomnilnik
Namesto da bi zgostil HTML celotne strani (kar bi ob vsaki zahtevi izpraznilo predpomnilnik zaradi enkratnih žetonov, časovnih žigov in druge dinamične vsebine), Blockstudio iz HTML izlušči samo kandidate za razrede CSS. Te kandidate razvrsti in skupaj s konfiguracijo CSS zgosti, da ustvari stabilen ključ predpomnilnika.
To pomeni:
- Dve strani, ki uporabljata isti nabor razredov Tailwind, imata isto predpomnjeno datoteko CSS, tudi če je njuna vrednost HTML povsem drugačna
- Dinamična vsebina, kot so enkratni žetoni, vrstice za prijavljene uporabnike, število komentarjev in časovni žigi, ne izprazni predpomnilnika
- Predpomnilnik se razveljavi samo, če se spremeni nabor razredov CSS na strani ali konfiguracija Tailwind
Ko izvajalno okolje uporablja vir za odkrivanje logical discovery source, izbrani vir in kontekst izvajalnega okolja prav tako sodelujeta pri določanju imenskega prostora predpomnilnika. Zadnja uspešna različica CSS je ločena med predogledi in ne more preiti iz enega izbora vira v drugega.
Mesto predpomnilnika
Datoteke predpomnilnika so shranjene v:
wp-content/blockstudio/cache/sites/{network-blog}/{runtime-identity}/tailwind/
Nastavljeni cache.path, trenutna identiteta večmestne namestitve in celotna identiteta izvajalnega okolja določajo natančno predpono. Ime vsake datoteke vsebuje zgoščeno vrednost MD5:
{hash}.css.
Brisanje predpomnilnika
Izbrišite vsebino imenika predpomnilnika, da vsilite ponovno prevajanje:
// Clear all cached Tailwind CSS
Blockstudio\Runtime_Cache::purge('tailwind');
Ali prek WP-CLI:
wp eval "Blockstudio\\Runtime_Cache::purge('tailwind');"
Ob naslednji zahtevi s spletnega mesta se bo CSS samodejno ponovno prevedel in shranil v predpomnilnik.
Filtri
blockstudio/tailwind/css
Pred prevajanjem spremenite vhod CSS. Vhodni niz CSS se začne z @import "tailwindcss";, ki mu sledi poljubna konfiguracija. S tem filtrom lahko dodate dodatne direktive CSS, pravila @layer po meri ali uvoze vtičnikov.
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;
});
Celoten vhod CSS, ki se prevede, je videti takole:
/* Base import */
@import 'tailwindcss';
/* Config from settings (if set) */
@theme {
--color-brand: pink;
}
/* Anything added via the blockstudio/tailwind/css filter */
Izhodni medpomnilnik
Prevajanje Tailwind se priključi na sistem izhodnega medpomnilnika v Blockstudio. Medpomnilnik zajame celoten izhod strani HTML, ko WordPress konča izris, kar omogoča, da Tailwind pregleda vse razrede iz vseh virov: predlog blokov, predlog tem, izhode vtičnikov, filtre the_content in območja gradnikov.
Filter za prevajanje se izvede s prioriteto 999999 na pripenjalniku blockstudio/buffer/output, kar zagotavlja obdelavo končnega HTML po vseh drugih spremembah. Medpomnilnik se zažene ob dejanju template_redirect, zato se izvaja samo pri zahtevah s spletnega mesta, ne pa v skrbništvu, REST API ali kontekstih AJAX.
To omogoča medpomnjenje celotnega dokumenta, zato je ta možnost privzeto vklopljena. Spletno mesto, ki ne uporablja ne Tailwind ne sredstev blokov, jo lahko izklopi:
add_filter( 'blockstudio/buffer/enabled', '__return_false' );
Če vrnete false, v celoti preskočite medpomnilnik, s čimer onemogočite tudi prevajanje Tailwind ter premikanje slogov in skript blokov v glavo in nogo.
Arhitektura
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
Celoten primer
Popolna delujoča nastavitev z barvami teme po meri in blokom, ki jih uporablja:
{
"$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 spletnem mestu se to izriše z vsemi pripomočki Tailwind in barvami teme po meri, prevedenimi v eno samo vstavljeno oznako <style>.
Oblikovni žetoni, pripomočki po meri in celotna nastavitev Tailwind v4 za produkcijsko temo.