Tailwind CSS
Blockstudio ir iebūvēts Tailwind CSS v4 atbalsts. Kad tas ir iespējots, katra priekšgala lapa tiek kompilēta servera pusē ar TailwindPHP un automātiski kešota failos. Bloku redaktorā komplektā iekļauts Tailwind CDN skripts nodrošina priekšskatījumu reāllaikā rediģēšanas laikā.
Nav nepieciešama būvēšanas darbība, CLI vai Node.js.
Kā tas darbojas
Blockstudio izmanto divas atsevišķas kompilēšanas stratēģijas atkarībā no konteksta:
Priekšgals (servera pusē)
Katrā priekšgala pieprasījumā Blockstudio uztver visu lapas HTML saturu izvades buferī, izgūst visas CSS klašu kandidātes, kompilē tikai faktiski izmantoto CSS un ievieto rezultātu iekļautā <style> birkā pirms </head>.
Kompilēšanas plūsma:
- WordPress renderē pilnu lapas HTML saturu izvades buferī
TailwindPHP::extractCandidates()pārmeklē HTML un izgūst visus iespējamos CSS klašu nosaukumus (ātra regulārā izteiksme, bez kompilēšanas)- Sakārtotās kandidātes tiek jauktas kopā ar CSS konfigurāciju, lai izveidotu kešatmiņas atslēgu
- Kešatmiņas trāpījuma gadījumā kompilētais CSS tiek nolasīts no diska un ievietots
- Kešatmiņas kļūmes gadījumā
TailwindPHP::generate()kompilē CSS, ieraksta to kešatmiņas direktorijā un ievieto
Kompilētais CSS tiek ievietots šādi:
<style id="blockstudio-tailwind">
/* compiled CSS */
</style>
Tas ietver Tailwind sākotnējos stilus (CSS atiestatījumu) un visas atbilstošās utilītklases.
Redaktors (klienta pusē)
Bloku redaktorā komplektā iekļauts Tailwind CDN skripts (pārlūkprogrammas būvējums no Tailwind CSS v4) darbojas klienta pusē. Tas nodrošina tūlītēju priekšskatījumu reāllaikā, kad ievadāt klašu nosaukumus, bez turp-atpakaļ pieprasījumiem serverim. CDN tiek ielādēts tikai redaktorā un nekad netiek piegādāts priekšgalā.
Kad assets.reset.enabled ir aktīvs, Blockstudio redaktora kanvā atjauno arī Tailwind biežāk izmantotās displeja un novietojuma utilītas. Tādējādi bloka aptverošā elementa klases, piemēram, flex, grid, absolute, fixed un sticky, netiek pārrakstītas ar WordPress redaktora bloka aptverošā elementa kārtulām, tāpēc ar utilītām veidoti izkārtojumi vairāk līdzinās priekšgala izkārtojumam.
Iespējošana: Tailwind
Pievienojiet tailwind konfigurāciju savam blockstudio.json:
{
"$schema": "https://blockstudio.dev/schema/blockstudio",
"tailwind": {
"enabled": true
}
}
Vai iespējojiet to ar filtru:
add_filter('blockstudio/settings/tailwind/enabled', '__return_true');
Kad enabled ir true, katrā priekšgala lapā Tailwind CSS tiek automātiski kompilēts un ievietots. Tailwind utilītklases var izmantot jebkur: bloku veidnēs, tēmas veidnēs, the_content filtros vai jebkurā HTML, kas parādās lapas izvadē.
Priekšgala izvade
Pēc noklusējuma kompilētais CSS tiek ievietots iekļauti, saglabājot iepriekšējās versijās izmantoto izvadi. Vietnes ar daudziem koplietotiem noteikumiem tā vietā var izvēlēties stila lapu, kuras nosaukums balstīts uz satura jaucējvērtību:
{
"tailwind": {
"enabled": true,
"output": "link"
}
}
"output": "link" izvada esošo tailwind/{content-hash}.css kešatmiņas failu kā <link rel="stylesheet">. URL mainās, ja mainās izpildlaika identitāte, kandidātes, dzinis vai CSS ievade, tāpēc pārlūkprogrammas un malas kešatmiņas var droši saglabāt vecos URL. Konfigurējiet tīmekļa serveri vai CDN, lai šai kešatmiņas tvērumam sūtītu ilgtermiņa Cache-Control: public, immutable galveni.
Noklusējuma kešatmiņas sakne ir publiski pieejama zem wp-content. Ja cache.path norāda uz privātu absolūto sējumu, Blockstudio atgriežas pie iekļauta CSS, ja vien esošais blockstudio/files/url filtrs nenorāda publisku URL tvērumam 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
);
Veidņu kompozīcijas palīgfunkcijas
Blockstudio nodrošina veidnēm to pašu komplektā iekļauto TailwindPHP dzini, ko izmanto PHP. Nav nepieciešama atsevišķa tēmas kopija vai rezerves implementācija:
$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() pieņem ligzdotas klašu vērtības un atrisina konfliktējošas Tailwind utilītas. bs_tw_variants() atgriež CVA veida izsaucamu funkciju, kas atbalsta bāzes vērtības, variantus, noklusējuma variantus, saliktos variantus, class un className.
Konfigurācija
Tailwind v4 izmanto konfigurēšanas pieeju, kuras pamatā ir CSS. Tā vietā, lai izveidotu JavaScript konfigurācijas failu, konfigurāciju raksta tieši kā CSS, izmantojot direktīvu @theme.
{
"tailwind": {
"enabled": true,
"config": "@theme { --color-primary: #3b82f6; --color-secondary: #10b981; --font-family-heading: 'Inter', sans-serif; }"
}
}
config vērtība ir CSS virkne, kas tiek pievienota pēc direktīvas @import "tailwindcss". Šeit var izmantot jebkuru derīgu Tailwind v4 CSS sintaksi:
{
"tailwind": {
"enabled": true,
"config": "@theme { --color-brand: oklch(0.7 0.15 200); } @layer base { h1 { font-size: var(--text-4xl); } }"
}
}
Vairākrindu konfigurācijām ērtāk izmantot filtra pieeju:
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;
});
Pielāgotas utilītklases
Lai definētu atkārtoti izmantojamus klašu aizstājvārdus, izmantojiet @layer utilities ar Tailwind direktīvu @apply tieši konfigurācijas virknē:
{
"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; } }"
}
}
Šādi šīs klases tiek kompilētas kopā ar visām standarta Tailwind utilītām. Tās darbojas gan priekšgalā (kompilēšana servera pusē), gan redaktorā (CDN priekšskatījumā).
Blockstudio saglabā Tailwind kanonisko kaskādes slāņu secību:
theme, base, components un pēc tam utilities. Tas atbilst Tailwind CSS, tāpēc
noteikumi vēlākos slāņos var paredzētajā veidā pārrakstīt agrāko slāņu noteikumus.
Klašu lauka tips
Lai izmantotu Tailwind klases bloka laukā classes ar automātiskās pabeigšanas atbalstu, iestatiet laukam tailwind: true:
{
"name": "my-theme/hero",
"title": "Hero",
"blockstudio": {
"attributes": [
{
"id": "classes",
"type": "classes",
"label": "Classes",
"tailwind": true,
"default": "bg-white text-gray-900"
}
]
}
}
Ja tailwind ir true:
- Laukā tiek piedāvāti ieteikumi automātiskai pabeigšanai no pilna Tailwind klašu saraksta
- Redaktorā tiek ielādēts Tailwind CDN skripts reāllaika priekšskatījumam
- Klases bloka atribūtos tiek saglabātas kā ar atstarpēm atdalīta virkne
Izmantojiet klašu vērtību savā veidnē:
<div class="<?php echo $a['classes']; ?>">
<!-- block content -->
</div>
Iestatījumu uzziņa
| Opcija | Tips | Noklusējums | Apraksts |
|---|---|---|---|
enabled |
boolean | false |
Iespējot Tailwind CSS kompilēšanu priekšgalā |
config |
string | "" |
Tailwind v4 konfigurācijas virkne, kuras pamatā ir CSS |
Iestatīšana, izmantojot JSON
{
"tailwind": {
"enabled": true,
"config": "@theme { --color-brand: pink; }"
}
}
Iestatīšana, izmantojot filtrus
add_filter('blockstudio/settings/tailwind/enabled', '__return_true');
add_filter('blockstudio/settings/tailwind/config', function () {
return '@theme { --color-brand: pink; }';
});
Kešatmiņa
Blockstudio izmanto pielāgotu kešošanas stratēģiju, kas izstrādāta Tailwind utilītās balstītajai arhitektūrai.
Kešatmiņas darbība
Tā vietā, lai jauktu visas lapas HTML (kas katrā pieprasījumā anulētu kešatmiņu nonce vērtību, laika zīmogu un cita dinamiska satura dēļ), Blockstudio no HTML izvelk tikai CSS klašu kandidātus. Šie kandidāti tiek sakārtoti un kopā ar konfigurāciju CSS izmantoti jaucējvērtības aprēķināšanai, lai izveidotu stabilu kešatmiņas atslēgu.
Tas nozīmē:
- Divām lapām, kurās izmantots viens un tas pats Tailwind klašu kopums, ir kopīgs kešatmiņā saglabātais CSS fails, pat ja to HTML ir pilnīgi atšķirīgs
- Dinamisks saturs, piemēram, nonce vērtības, pieteikušos lietotāju joslas, komentāru skaits un laika zīmogi, neanulē kešatmiņu
- Kešatmiņa tiek anulēta tikai tad, ja lapā mainās CSS klašu kopums vai Tailwind konfigurācija
Ja izpildvide izmanto loģisku atklāšanas avotu, izvēlētais avots un izpildvides konteksts arī ir daļa no kešatmiņas nosaukumvietas. Pēdējais veiksmīgais CSS tiek nodalīts starp priekšskatījumiem, un tas nevar noplūst no vienas avota izvēles citā.
Kešatmiņas atrašanās vieta
Kešatmiņas faili tiek glabāti šeit:
wp-content/blockstudio/cache/sites/{network-blog}/{runtime-identity}/tailwind/
Konfigurētā cache.path, pašreizējā multisite identitāte un pilna izpildvides
identitāte nosaka precīzu prefiksu. Katrs fails tiek nosaukts ar MD5 jaucējvērtību:
{hash}.css.
Kešatmiņas notīrīšana
Lai piespiestu veikt atkārtotu kompilēšanu, izdzēsiet kešatmiņas direktorijas saturu:
// Clear all cached Tailwind CSS
Blockstudio\Runtime_Cache::purge('tailwind');
Vai arī izmantojiet WP-CLI:
wp eval "Blockstudio\\Runtime_Cache::purge('tailwind');"
Nākamajā priekšgala pieprasījumā CSS tiks automātiski kompilēts no jauna un saglabāts kešatmiņā.
Filtri
blockstudio/tailwind/css
Pirms kompilēšanas mainiet CSS ievadi. CSS ievades virkne sākas ar @import "tailwindcss";, kam seko jebkāda konfigurācija. Izmantojiet šo filtru, lai pievienotu papildu CSS direktīvas, pielāgotus @layer noteikumus vai spraudņu importus.
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;
});
Pilnā CSS ievade, kas tiek kompilēta, izskatās šādi:
/* Base import */
@import 'tailwindcss';
/* Config from settings (if set) */
@theme {
--color-brand: pink;
}
/* Anything added via the blockstudio/tailwind/css filter */
Izvades buferis
Tailwind kompilēšana ir integrēta Blockstudio izvades bufera sistēmā. Buferis uztver visu lapas HTML pēc tam, kad WordPress ir pabeidzis renderēšanu, ļaujot Tailwind pārbaudīt visas klases no visiem avotiem: bloku veidnēm, tēmas veidnēm, spraudņu izvades, the_content filtriem un logrīku apgabaliem.
Kompilēšanas filtrs darbojas ar prioritāti 999999 pie āķa blockstudio/buffer/output, nodrošinot, ka tas apstrādā galīgo HTML pēc visām pārējām izmaiņām. Buferis tiek palaists darbībā template_redirect, tāpēc tas darbojas tikai priekšgala pieprasījumos, nevis administrēšanas, REST API vai AJAX kontekstos.
Visa dokumenta buferēšana padara to iespējamu, tāpēc tā ir ieslēgta pēc noklusējuma. Vietnē, kurā netiek izmantoti ne Tailwind, ne bloku resursi, to var izslēgt:
add_filter( 'blockstudio/buffer/enabled', '__return_false' );
Atgriežot false, buferis tiek pilnībā izlaists, tādējādi tiek atspējota arī Tailwind kompilēšana un bloku stilu un skriptu pārvietošana uz galveni un kājeni.
Arhitektū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
Pilns piemērs
Pilnībā funkcionējoša konfigurācija ar pielāgotām tēmas krāsām un bloku, kurā tās tiek izmantotas:
{
"$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>
Priekšgalā tas tiek renderēts ar visām Tailwind utilītām un pielāgotajām tēmas krāsām, kas kompilētas vienā iekļautā taga <style> saturā.
Dizaina tokeni, pielāgotas utilītas un pilna Tailwind v4 konfigurācija ražošanas tēmai.