Preskoči na vsebino

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:

  1. WordPress izriše celotno stran HTML v izhodni medpomnilnik
  2. TailwindPHP::extractCandidates() pregleda HTML in izlušči vsa morebitna imena razredov CSS (hiter regex brez prevajanja)
  3. Razvrščene kandidate združi z zgoščevanjem konfiguracijo CSS, da ustvari ključ predpomnilnika
  4. Ob zadetek v predpomnilniku: prebrani prevedeni CSS se zapiše z diska in vstavi
  5. Ob zgrešen zadetek v predpomnilniku: TailwindPHP::generate() prevede CSS, ga zapiše v imenik predpomnilnika in vstavi

Prevedeni CSS se vstavi kot:

HTML
<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:

JSON
{
  "$schema": "https://blockstudio.dev/schema/blockstudio",
  "tailwind": {
    "enabled": true
  }
}

Lahko ga omogočite tudi prek filtra:

PHP
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:

JSON
{
  "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:

PHP
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:

PHP
$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.

JSON
{
  "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:

JSON
{
  "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:

PHP
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:

JSON
{
  "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:

JSON
{
  "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:

PHP
<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

JSON
{
  "tailwind": {
    "enabled": true,
    "config": "@theme { --color-brand: pink; }"
  }
}

Nastavitev prek filtrov

PHP
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:

Koda
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:

PHP
// Clear all cached Tailwind CSS
Blockstudio\Runtime_Cache::purge('tailwind');

Ali prek WP-CLI:

Lupina
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.

PHP
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:

CSS
/* 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:

PHP
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

Koda
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:

JSON
{
  "$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; } }"
  }
}
JSON
{
  "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"
      }
    ]
  }
}
PHP
<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>.

Izdelava knjižnice blokov

Oblikovni žetoni, pripomočki po meri in celotna nastavitev Tailwind v4 za produkcijsko temo.