Tailwind CSS
Blockstudio turi integruotą Tailwind CSS v4 palaikymą. Įjungus šią funkciją, kiekvienas pagrindinės svetainės puslapis kompiliuojamas serverio pusėje per TailwindPHP ir automatiškai podėliuojamas failais. Blokų rengyklėje pridėtas Tailwind CDN scenarijus suteikia tiesioginę peržiūrą redaguojant.
Nereikia kūrimo etapo, CLI ar Node.js.
Kaip tai veikia
Blockstudio naudoja dvi atskiras kompiliavimo strategijas, atsižvelgdamas į kontekstą:
Pagrindinė svetainė (serverio pusė)
Kiekvienos pagrindinės svetainės užklausos metu Blockstudio įvesties išvesties buferyje surenka visą puslapio HTML, išskiria visas CSS klasių kandidates, sukompiliuoja tik faktiškai naudojamą CSS ir įterpia rezultatą kaip tiesioginę <style> žymą prieš </head>.
Kompiliavimo eiga:
- WordPress pateikia visą puslapio HTML įvesties išvesties buferyje
TailwindPHP::extractCandidates()nuskaito HTML ir išskiria visus galimus CSS klasių pavadinimus (greita regex paieška, be kompiliavimo)- Surūšiuotos kandidatės sujungiamos su CSS konfigūracija ir pagal jas apskaičiuojamas podėlio raktas
- Pataikius į podėlį: sukompiliuotas CSS nuskaitomas iš disko ir įterpiamas
- Nepataikius į podėlį:
TailwindPHP::generate()sukompiliuoja CSS, įrašo į podėlio katalogą ir įterpia
Sukompiliuotas CSS įterpiamas taip:
<style id="blockstudio-tailwind">
/* compiled CSS */
</style>
Tai apima Tailwind pradinį stilių rinkinį (CSS atstatymą) ir visas atitinkančias pagalbinių klasių taisykles.
Rengyklė (kliento pusė)
Blokų rengyklėje kartu įdiegtas Tailwind CDN scenarijus (naršyklinė Tailwind CSS v4 versija) veikia kliento pusėje. Įvedant klasių pavadinimus rodoma tiesioginė peržiūra be jokių pakartotinių kreipinių į serverį. CDN įkeliamas tik rengyklėje ir niekada nesiunčiamas pagrindinei svetainei.
Kai aktyvus assets.reset.enabled, Blockstudio rengyklės drobėje taip pat atkuria dažniausiai naudojamas Tailwind rodymo ir padėties nustatymo pagalbines klases. Taip išvengiama, kad WordPress rengyklės blokų apvalkalo taisyklės pakeistų apvalkalo lygmens klases, tokias kaip flex, grid, absolute, fixed ir sticky, todėl pagalbinėmis klasėmis pagrįsti maketai labiau atitinka pagrindinės svetainės išvaizdą.
Tailwind įjungimas
Įtraukite tailwind konfigūraciją į savo blockstudio.json:
{
"$schema": "https://blockstudio.dev/schema/blockstudio",
"tailwind": {
"enabled": true
}
}
Arba įjunkite naudodami filtrą:
add_filter('blockstudio/settings/tailwind/enabled', '__return_true');
Kai enabled yra true, prie kiekvieno pagrindinės svetainės puslapio bus automatiškai sukompiliuojamas ir įterpiamas Tailwind CSS. Tailwind pagalbines klases galite naudoti bet kur: blokų šablonuose, temų šablonuose, the_content filtruose arba bet kuriame puslapio išvestyje pasirodančiame HTML.
Pagrindinės svetainės išvestis
Pagal numatytuosius nustatymus sukompiliuotas CSS įterpiamas tiesiogiai puslapyje, kaip ir ankstesnėse versijose. Svetainėse, kuriose naudojama daug bendrų taisyklių, vietoj to galima pasirinkti turinio maiša pavadintą stiliaus failą:
{
"tailwind": {
"enabled": true,
"output": "link"
}
}
"output": "link" pateikia esamą
tailwind/{content-hash}.css podėlio failą kaip <link rel="stylesheet">. URL pasikeičia pasikeitus vykdymo aplinkos tapatybei, kandidatėms, varikliui ar CSS įvesčiai, todėl naršyklės ir tinklo krašto podėliai gali saugiai išsaugoti senus URL adresus. Konfigūruokite žiniatinklio serverį arba CDN, kad šiai podėlio sričiai siųstų ilgalaikę Cache-Control: public, immutable antraštę.
Numatytasis podėlio šakninis katalogas yra viešas ir yra po wp-content. Jei cache.path nurodo į privatų absoliutų tomą, Blockstudio vietoj to grąžina tiesiogiai įterpiamą CSS, nebent esamas blockstudio/files/url filtras pateikia viešą URL, skirtą sričiai 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
);
Šablonų komponavimo pagalbinės priemonės
Blockstudio šablonams pateikia tą patį į paketą įtrauktą TailwindPHP variklį kaip ir PHP. Nereikia jokios temos kopijos ar atsarginio įgyvendinimo:
$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() priima įdėtines klasių reikšmes ir išsprendžia konfliktus tarp Tailwind utilitų. bs_tw_variants() grąžina CVA tipo iškviečiamą objektą, palaikantį bazines, variantų, numatytųjų variantų, sudėtinių variantų, class ir className reikšmes.
Konfigūracija
Tailwind v4 konfigūruojamas pirmiausia naudojant CSS. Užuot kūrę JavaScript konfigūracijos failą, konfigūraciją rašote tiesiogiai kaip CSS, naudodami direktyvą @theme.
{
"tailwind": {
"enabled": true,
"config": "@theme { --color-primary: #3b82f6; --color-secondary: #10b981; --font-family-heading: 'Inter', sans-serif; }"
}
}
Reikšmė config yra CSS eilutė, pridedama po direktyvos @import "tailwindcss". Čia galite naudoti bet kokią galiojančią Tailwind v4 CSS sintaksę:
{
"tailwind": {
"enabled": true,
"config": "@theme { --color-brand: oklch(0.7 0.15 200); } @layer base { h1 { font-size: var(--text-4xl); } }"
}
}
Kelių eilučių konfigūracijoms patogiau naudoti filtrą:
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;
});
Tinkintos utilitų klasės
Norėdami apibrėžti pakartotinai naudojamus klasių pseudonimus, naudokite @layer utilities ir tiesiogiai konfigūracijos eilutėje įrašykite Tailwind direktyvą @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; } }"
}
}
Šios klasės kompiliuojamos kartu su visomis standartinėmis Tailwind utilitų klasėmis. Jos veikia tiek svetainės priekinėje dalyje (kompiliuojant serveryje), tiek redaktoriuje (CDN peržiūra).
Blockstudio išlaiko kanoninę Tailwind kaskados sluoksnių tvarką:
theme, base, components, tada utilities. Tai atitinka Tailwind CSS, todėl
vėlesnių sluoksnių taisyklės gali, kaip tikėtasi, pakeisti ankstesnių sluoksnių taisykles.
Klasės lauko tipas
Jei norite bloko classes lauke naudoti Tailwind klases su automatinio užbaigimo funkcija, laukui nustatykite tailwind: true:
{
"name": "my-theme/hero",
"title": "Hero",
"blockstudio": {
"attributes": [
{
"id": "classes",
"type": "classes",
"label": "Classes",
"tailwind": true,
"default": "bg-white text-gray-900"
}
]
}
}
Kai tailwind yra true:
- Lauke pateikiami automatinio užbaigimo pasiūlymai iš viso Tailwind klasių sąrašo
- Redaktoriuje įkeliamas Tailwind CDN scenarijus, kad būtų galima tiesioginė peržiūra
- Klasės bloko atributuose saugomos kaip tarpu atskirta eilutė
Naudokite klasių reikšmę savo šablone:
<div class="<?php echo $a['classes']; ?>">
<!-- block content -->
</div>
Nustatymų žinynas
| Parinktis | Tipas | Numatytoji reikšmė | Aprašymas |
|---|---|---|---|
enabled |
loginė reikšmė | false |
Įjungti Tailwind CSS kompiliavimą svetainės priekinėje dalyje |
config |
eilutė | "" |
Konfigūracijos eilutė, kurioje pirmiausia naudojamas Tailwind v4 CSS |
Nustatymas naudojant JSON
{
"tailwind": {
"enabled": true,
"config": "@theme { --color-brand: pink; }"
}
}
Nustatymas naudojant filtrus
add_filter('blockstudio/settings/tailwind/enabled', '__return_true');
add_filter('blockstudio/settings/tailwind/config', function () {
return '@theme { --color-brand: pink; }';
});
Spartinančioji talpykla
Blockstudio naudoja tinkintą spartinimo strategiją, pritaikytą Tailwind utilitų architektūrai.
Kaip veikia talpykla
Užuot maišos funkcija apdorojus visą puslapio HTML (dėl to talpykla būtų atnaujinama su kiekviena užklausa, nes keičiasi vienkartiniai kodai, laiko žymos ir kitas dinaminis turinys), Blockstudio iš HTML išrenka tik CSS klasių kandidatus. Šie kandidatai surikiuojami, o kartu su CSS konfigūracija apskaičiuota maiša naudojama pastoviam talpyklos raktui sukurti.
Tai reiškia:
- Du puslapiai, kuriuose naudojamas tas pats Tailwind klasių rinkinys, dalijasi tuo pačiu talpykloje saugomu CSS failu, net jei jų HTML visiškai skiriasi
- Dinaminis turinys, pavyzdžiui, vienkartiniai kodai, prisijungusių naudotojų juostos, komentarų skaičius ir laiko žymos, neatnaujina talpyklos
- Talpykla atnaujinama tik pasikeitus puslapio CSS klasių rinkiniui arba Tailwind konfigūracijai
Kai vykdymo aplinka naudoja loginės paieškos šaltinį , pasirinktas šaltinis ir vykdymo kontekstas taip pat įtraukiami į talpyklos vardų sritį. Paskutinė sėkminga CSS versija atskiriama peržiūroms ir negali patekti iš vieno šaltinio pasirinkimo į kitą.
Talpyklos vieta
Talpyklos failai saugomi čia:
wp-content/blockstudio/cache/sites/{network-blog}/{runtime-identity}/tailwind/
Tikslią prefikso reikšmę lemia sukonfigūruota cache.path, dabartinė kelių svetainių tapatybė ir visa vykdymo aplinkos tapatybė. Kiekvienas failas pavadinamas pagal MD5 maišą:
{hash}.css.
Talpyklos išvalymas
Kad kompiliavimas būtų atliktas iš naujo, ištrinkite talpyklos katalogo turinį:
// Clear all cached Tailwind CSS
Blockstudio\Runtime_Cache::purge('tailwind');
Arba naudokite WP-CLI:
wp eval "Blockstudio\\Runtime_Cache::purge('tailwind');"
Kita užklausa svetainės priekinėje dalyje iš naujo sukompiliuos CSS ir automatiškai įrašys į talpyklą.
Filtrai
blockstudio/tailwind/css
Prieš kompiliavimą pakeiskite CSS įvestį. CSS įvesties eilutė prasideda @import "tailwindcss";, po kurio pateikiama bet kokia konfigūracija. Naudokite šį filtrą, jei norite pridėti CSS direktyvų, tinkintų @layer taisyklių arba įskiepių importų.
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;
});
Visa kompiliuojama CSS įvestis atrodo taip:
/* Base import */
@import 'tailwindcss';
/* Config from settings (if set) */
@theme {
--color-brand: pink;
}
/* Anything added via the blockstudio/tailwind/css filter */
Išvesties buferis
Tailwind kompiliavimas integruojamas į Blockstudio išvesties buferių sistemą. Buferis užfiksuoja visą puslapio HTML, kai WordPress baigia jį atvaizduoti, todėl Tailwind gali nuskaityti visas klases iš kiekvieno šaltinio: blokų šablonų, temos šablonų, įskiepių išvesties, the_content filtrų ir valdiklių sričių.
Kompiliavimo filtras vykdomas su prioritetu 999999 per blockstudio/buffer/output veiksmą, todėl apdoroja galutinį HTML po visų kitų pakeitimų. Buferis paleidžiamas per template_redirect veiksmą, todėl veikia tik svetainės priekinės dalies užklausoms, o ne administravimo, REST API ar AJAX kontekstuose.
Tai, kad buferizuojamas visas dokumentas, suteikia šią galimybę, todėl buferizavimas įjungtas pagal numatytąsias nuostatas. Jei svetainėje nenaudojami nei Tailwind, nei blokų ištekliai, buferizavimą galima išjungti:
add_filter( 'blockstudio/buffer/enabled', '__return_false' );
Grąžinus false, buferis visai nenaudojamas; taip pat išjungiamas Tailwind kompiliavimas ir blokų stilių bei scenarijų perkėlimas į antraštę ir poraš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
Visas pavyzdys
Išsami veikianti sąranka su tinkintomis temos spalvomis ir jas naudojančiu bloku:
{
"$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>
Svetainės priekinėje dalyje atvaizduojama viena įdėtinė <style> žyma su visomis Tailwind utilitų klasėmis ir sukompiliuotomis tinkintomis temos spalvomis.
Dizaino žetonai, tinkintos utilitų klasės ir visa Tailwind v4 sąranka produkcinei temai.