Tailwind CSS
Blockstudio sisaldab sisseehitatud Tailwind CSS v4 tuge. Kui see on lubatud, kompileeritakse iga kasutajaliidese leht serveris TailwindPHP abil ja tulemused puhverdatakse automaatselt failidesse. Plokiredaktoris pakub komplektis olev Tailwind CDN skript muutmise ajal reaalaja eelvaadet.
Ehitusetappi pole vaja, CLI pole vaja ja Node.js pole vaja.
Kuidas see töötab
Blockstudio kasutab olenevalt kontekstist kahte eraldi kompileerimisstrateegiat:
Kasutajaliides (serveripoolne)
Iga kasutajaliidese päringu korral püüab Blockstudio väljundpuhvrisse kogu lehe HTML, eraldab kõik CSS klassikandidaadid, kompileerib ainult tegelikult kasutatava CSS ning lisab tulemuse tekstisisese <style> märgendina enne elementi </head>.
Kompileerimise käik:
- WordPress renderdab kogu lehe HTML väljundpuhvrisse
TailwindPHP::extractCandidates()skannib HTML ja eraldab kõik võimalikud CSS klassinimed (kiire regex, kompileerimist ei toimu)- Kandidaadid sorditakse ja räsitakse koos CSS seadistusega, et luua puhvri võti
- Puhvrivaste korral loetakse kompileeritud CSS kettalt ja lisatakse lehele
- Puhvrivaste puudumisel kompileerib
TailwindPHP::generate()CSS, kirjutab selle puhverkataloogi ja lisab lehele
Kompileeritud CSS lisatakse nii:
<style id="blockstudio-tailwind">
/* compiled CSS */
</style>
See hõlmab Tailwind eeltöötlust (CSS lähtestamist) ja kõiki vastavaid utiliidiklasse.
Redaktor (kliendipoolne)
Plokiredaktoris töötab komplektis olev Tailwind CDN skript (Tailwind CSS v4 brauseriversioon) kliendipoolselt. See annab klassinimede sisestamisel kohe reaalaja eelvaate, ilma serveriga edasi-tagasi suhtlemata. CDN laaditakse ainult redaktoris ja seda ei esitata kunagi kasutajaliideses.
Kui assets.reset.enabled on aktiivne, taastab Blockstudio redaktori lõuendil ka Tailwind levinud kuvamis- ja paigutusutiliidid. Nii ei kirjuta WordPress redaktori plokikonteineri reeglid üle konteineri taseme klasse, nagu flex, grid, absolute, fixed ja sticky, ning utiliitidel põhinevad paigutused vastavad paremini kasutajaliidesele.
Tailwind lubamine
Lisa tailwind seadistus faili blockstudio.json:
{
"$schema": "https://blockstudio.dev/schema/blockstudio",
"tailwind": {
"enabled": true
}
}
Võid selle lubada ka filtri kaudu:
add_filter('blockstudio/settings/tailwind/enabled', '__return_true');
Kui enabled on väärtuseks true, kompileeritakse ja lisatakse igale kasutajaliidese lehele automaatselt Tailwind CSS. Tailwind utiliidiklasse saad kasutada kõikjal: plokimallides, kujundusmallides, the_content filtrites või lehe väljundisse jõudvas HTML-is.
Kasutajaliidese väljund
Vaikimisi lisatakse kompileeritud CSS tekstisiseselt, säilitades varasemate versioonide väljundi. Paljude ühiste reeglitega saidid saavad selle asemel kasutada sisuräsiga laaditabelit:
{
"tailwind": {
"enabled": true,
"output": "link"
}
}
"output": "link" väljastab olemasoleva tailwind/{content-hash}.css puhverfaili failina <link rel="stylesheet">. URL muutub käituskeskkonna identiteedi, kandidaatide, mootori või CSS sisendi muutumisel, nii et brauserid ja servapuhvrid saavad vanu URL-e turvaliselt alles hoida. Seadista veebiserver või CDN saatma selle puhvri ulatuse jaoks pika kehtivusajaga päise Cache-Control: public, immutable.
Vaikimisi asub puhvri juurkataloog avalikult wp-content all. Kui cache.path viitab privaatsele absoluutsele köitele, kasutab Blockstudio tekstisisest CSS-i, välja arvatud juhul, kui olemasolev blockstudio/files/url filter pakub ulatuse tailwind jaoks avalikku URL-i:
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
);
Mallide koostamise abifunktsioonid
Blockstudio pakub mallidele PHP sama komplektis olevat TailwindPHP mootorit. Kujunduse poolel pole vaja eraldi koopiat ega tagavarateostust:
$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() aktsepteerib pesastatud klassiväärtusi ja lahendab konfliktid Tailwind utiliitide vahel. bs_tw_variants() tagastab CVA-laadse väljakutsutava funktsiooni, mis toetab põhiklasse, variante, vaikevariante, liitvariante, class ja className.
Konfiguratsioon
Tailwind v4 kasutab konfiguratsiooni määramiseks lähenemist, kus esikohal on CSS. Eraldi JavaScript konfiguratsioonifaili asemel kirjutate konfiguratsiooni otse CSS-ina, kasutades direktiivi @theme.
{
"tailwind": {
"enabled": true,
"config": "@theme { --color-primary: #3b82f6; --color-secondary: #10b981; --font-family-heading: 'Inter', sans-serif; }"
}
}
Väärtus config on CSS string, mis lisatakse direktiivi @import "tailwindcss" järele. Siin saate kasutada mis tahes kehtivat Tailwind v4 CSS süntaksit:
{
"tailwind": {
"enabled": true,
"config": "@theme { --color-brand: oklch(0.7 0.15 200); } @layer base { h1 { font-size: var(--text-4xl); } }"
}
}
Mitmerealiste konfiguratsioonide puhul on filtrite kasutamine mugavam:
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;
});
Kohandatud utiliidiklassid
Korduvkasutatavate klassialiaste määramiseks kasutage konfiguratsioonistringis otse @layer utilities koos Tailwind direktiiviga @apply:
{
"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; } }"
}
}
See kompileerib need klassid koos kõigi standardsete Tailwind utiliitidega. Need töötavad nii esiosas (serveripoolne kompileerimine) kui ka redaktoris (CDN eelvaade).
Blockstudio säilitab Tailwind kanoonilise kaskaadikihi järjestuse:
theme, base, components ja seejärel utilities. See vastab Tailwind CSS-ile, nii et hilisemates kihtides olevad reeglid saavad ootuspäraselt varasemates kihtides olevaid reegleid tühistada.
Välja Classes tüüp
Tailwind klasside kasutamiseks ploki väljal classes koos automaatse täitmise toega määrake väljale tailwind: true:
{
"name": "my-theme/hero",
"title": "Hero",
"blockstudio": {
"attributes": [
{
"id": "classes",
"type": "classes",
"label": "Classes",
"tailwind": true,
"default": "bg-white text-gray-900"
}
]
}
}
Kui tailwind on true:
- Väli pakub automaatse täitmise soovitusi kogu Tailwind klasside loendi põhjal
- Redaktoris laaditakse reaalajas eelvaate kuvamiseks Tailwind CDN skript
- Klasse salvestatakse ploki atribuutides tühikutega eraldatud stringina
Kasutage mallis väärtust classes:
<div class="<?php echo $a['classes']; ?>">
<!-- block content -->
</div>
Seadete viide
| Valik | Tüüp | Vaikeväärtus | Kirjeldus |
|---|---|---|---|
enabled |
tõeväärtus | false |
Luba Tailwind CSS kompileerimine kasutajaliideses |
config |
string | "" |
Tailwind v4 CSS-i esimene konfiguratsioonistring |
Määramine JSON kaudu
{
"tailwind": {
"enabled": true,
"config": "@theme { --color-brand: pink; }"
}
}
Määramine filtrite kaudu
add_filter('blockstudio/settings/tailwind/enabled', '__return_true');
add_filter('blockstudio/settings/tailwind/config', function () {
return '@theme { --color-brand: pink; }';
});
Vahemällu salvestamine
Blockstudio kasutab kohandatud vahemällu salvestamise strateegiat, mis on loodud Tailwind utiliidipõhise arhitektuuri jaoks.
Vahemälu tööpõhimõte
Kogu lehe HTML räsimise asemel (mis tühjendaks vahemälu iga päringuga nonce’ide, ajatemplite ja muu dünaamilise sisu tõttu) eraldab Blockstudio HTML-ist ainult CSS klassikandidaadid. Need kandidaadid sorditakse ja räsitakse koos konfiguratsiooniga CSS, et luua püsiv vahemäluvõti.
See tähendab järgmist:
- Kaks sama Tailwind klassikomplektiga lehte kasutavad sama vahemällu salvestatud CSS faili, isegi kui nende HTML on täiesti erinev
- Dünaamiline sisu, nagu nonce’id, sisseloginud kasutajate ribad, kommentaaride arv ja ajatemplid, ei tühjenda vahemälu
- Vahemälu kehtivus lõpeb ainult siis, kui lehel olevate CSS klasside komplekt muutub või muutub konfiguratsioon Tailwind
Kui käituskeskkond kasutab loogilist avastamisallikat, osalevad vahemälu nimeruumis ka valitud allikas ja käituskontekst. Viimati õnnestunud CSS hoitakse eelvaadete vahel eraldi ning see ei saa ühelt allikavalikult teisele lekkida.
Vahemälu asukoht
Vahemälufailid salvestatakse siia:
wp-content/blockstudio/cache/sites/{network-blog}/{runtime-identity}/tailwind/
Täpset eesliidet määravad seadistatud cache.path, praeguse mitme saidi identiteet ja täielik käituskeskkonna identiteet. Iga fail nimetatakse MD5 räsi järgi:
{hash}.css.
Vahemälu tühjendamine
Kompileerimise sundimiseks kustutage vahemälukataloogi sisu:
// Clear all cached Tailwind CSS
Blockstudio\Runtime_Cache::purge('tailwind');
Või WP-CLI kaudu:
wp eval "Blockstudio\\Runtime_Cache::purge('tailwind');"
Järgmise esiosa päringu ajal kompileeritakse CSS uuesti ja salvestatakse automaatselt vahemällu.
Filtrid
blockstudio/tailwind/css
Muutke sisendit CSS enne kompileerimist. Sisendstring CSS algab väärtusega @import "tailwindcss";, millele järgneb mis tahes konfiguratsioon. Kasutage seda filtrit täiendavate direktiivide CSS, kohandatud reeglite @layer või plugina importide lisamiseks.
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;
});
Kompileeritav täielik sisend CSS näeb välja selline:
/* Base import */
@import 'tailwindcss';
/* Config from settings (if set) */
@theme {
--color-brand: pink;
}
/* Anything added via the blockstudio/tailwind/css filter */
Väljundpuhver
Tailwind kompileerimine haakub Blockstudio väljundpuhvri süsteemiga. Puhver kogub kogu lehe HTML pärast seda, kui WordPress on renderdamise lõpetanud. Nii saab Tailwind skannida kõiki klasse kõigist allikatest: plokimallidest, teema mallidest, plugina väljundist, filtritest the_content ja vidinaaladelt.
Kompileerimisfilter käivitatakse prioriteediga 999999 hook’il blockstudio/buffer/output, et töödelda lõplikku HTML pärast kõiki muid muudatusi. Puhver käivitatakse toimingul template_redirect, mis tähendab, et see töötab ainult esiosa päringutel, mitte halduses, REST API ega AJAX-kontekstides.
Kogu dokumendi puhverdus teeb selle võimalikuks, seega on see vaikimisi sisse lülitatud. Sait, mis ei kasuta ei Tailwind ega ploki varasid, võib selle välja lülitada:
add_filter( 'blockstudio/buffer/enabled', '__return_false' );
false tagastamine jätab puhvri täielikult vahele, mis lülitab välja ka Tailwind kompileerimise ning plokkide stiilide ja skriptide tõstmise päisesse ja jalusesse.
Arhitektuur
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
Täielik näide
Täielik toimiv seadistus kohandatud teemavärvide ja neid kasutava plokiga:
{
"$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>
Esiosas renderdatakse see nii, et kõik Tailwind utiliidid ja kohandatud teemavärvid kompileeritakse ühte tekstisisesesse <style> silti.
Kujundustokenid, kohandatud utiliidid ja täielik Tailwind v4 seadistus tootmisteema jaoks.