Ugrás a tartalomhoz

Tailwind CSS

Az Blockstudio beépített Tailwind CSS v4 támogatást tartalmaz. Ha engedélyezve van, minden frontendoldal szerveroldalon fordul le a TailwindPHP segítségével, automatikus fájlalapú gyorsítótárazással. A blokk szerkesztőjében egy csomagolt Tailwind CDN szkript biztosít élő előnézetet szerkesztés közben.

Nincs szükség buildlépésre, CLI-re vagy Node.js-re.

Működés

Az Blockstudio a környezettől függően két külön fordítási stratégiát használ:

Frontend (szerveroldal)

Minden frontendkérésnél az Blockstudio kimeneti pufferrel rögzíti az oldal teljes HTML tartalmát, kinyeri az összes CSS osztályjelöltet, lefordítja csak a ténylegesen használt CSS elemet, majd az eredményt egy beágyazott <style> címkeként, az </head> elé illeszti be.

A fordítás menete:

  1. Az WordPress a teljes oldal HTML tartalmát egy kimeneti pufferbe rendereli
  2. Az TailwindPHP::extractCandidates() átvizsgálja a HTML elemet, és kinyeri az összes lehetséges CSS osztálynevet (gyors regex, fordítás nélkül)
  3. A rendezett jelöltekből a rendszer az CSS konfigurációval együtt kivonatot készít a gyorsítótárkulcshoz
  4. Gyorsítótár-találat esetén: a lefordított CSS beolvasódik a lemezről, majd bekerül a kimenetbe
  5. Gyorsítótár-találat hiányában: az TailwindPHP::generate() lefordítja a CSS elemet, beírja a gyorsítótár-könyvtárba, majd bekerül a kimenetbe

A lefordított CSS a következőként kerül beillesztésre:

HTML
<style id="blockstudio-tailwind">
  /* compiled CSS */
</style>

Ez tartalmazza az Tailwind előfeldolgozását (CSS alaphelyzetbe állítás) és az összes illeszkedő segédosztályt.

Szerkesztő (kliensoldal)

A blokkszerkesztőben egy csomagolt Tailwind CDN szkript fut kliensoldalon (az Tailwind CSS v4 böngészős változata). Gépelés közben azonnali élő előnézetet biztosít, szerverkérések nélkül. Az CDN csak a szerkesztőben töltődik be, a frontendoldalakon soha.

Amikor az assets.reset.enabled aktív, az Blockstudio a szerkesztő vásznán az Tailwind általános megjelenítési és pozicionálási segédosztályait is visszaállítja. Így a burkolóelemek szintjén használt osztályokat, például a flex, grid, absolute, fixed és sticky osztályt nem írják felül az WordPress szerkesztői blokkok burkolóelemeire vonatkozó szabályai, ezért a segédosztályokkal kialakított elrendezések jobban hasonlítanak a frontend megjelenésére.

Az Tailwind engedélyezése

Adja hozzá az tailwind konfigurációt ehhez: blockstudio.json:

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

Vagy engedélyezze egy szűrővel:

PHP
add_filter('blockstudio/settings/tailwind/enabled', '__return_true');

Ha az enabled true állapotban van, minden frontendoldal automatikusan lefordított Tailwind CSS elemet kap a kimenetbe. Az Tailwind segédosztályokat bárhol használhatja: blokk sablonokban, sablonfájlokban, the_content szűrőkben vagy az oldal kimenetében megjelenő bármely HTML elemben.

Frontendkimenet

Alapértelmezés szerint a lefordított CSS beágyazott, így megőrzi a korábbi verziók kimenetét. A sok közös szabályt használó webhelyek helyette tartalomkivonattal ellátott stíluslapot is választhatnak:

JSON
{
  "tailwind": {
    "enabled": true,
    "output": "link"
  }
}

Az "output": "link" a meglévő tailwind/{content-hash}.css gyorsítótárfájlt <link rel="stylesheet"> formátumban bocsátja ki. Az URL értéke megváltozik, ha a futtatókörnyezet identitása, a jelöltek, a motor vagy a CSS bemenete megváltozik, így a böngészők és az éltárolók biztonságosan megőrizhetik a régi URL-eket. Állítsa be a webszervert vagy az CDN rendszert, hogy hosszú élettartamú Cache-Control: public, immutable fejlécet küldjön ehhez a gyorsítótár-hatókörhöz.

Az alapértelmezett gyorsítótárgyökér nyilvánosan elérhető, az wp-content alatt. Ha az cache.path egy privát, abszolút elérési úttal megadott kötetre mutat, az Blockstudio beágyazott CSS formátumra vált, kivéve ha a meglévő blockstudio/files/url szűrő nyilvános URL értéket ad meg az tailwind hatókörhöz:

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
);

Sablon-összeállítási segédfüggvények

Az Blockstudio ugyanazt a csomagolt TailwindPHP motort biztosítja az PHP sablonokhoz is. Nincs szükség a sablonba másolt változatra vagy tartalékmegvalósításra:

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() elfogadja a beágyazott osztályértékeket, és feloldja az ütköző Tailwind segédosztályokat. bs_tw_variants() egy CVA-stílusú hívható értéket ad vissza, amely támogatja az alapértékeket, a variánsokat, az alapértelmezett variánsokat, az összetett variánsokat, a class és a className lehetőségeket.

Konfiguráció

A Tailwind v4 konfigurációs megközelítése a CSS-t helyezi előtérbe. Külön JavaScript konfigurációs fájl helyett közvetlenül CSS formájában írhatja meg a konfigurációt a @theme direktívával.

JSON
{
  "tailwind": {
    "enabled": true,
    "config": "@theme { --color-primary: #3b82f6; --color-secondary: #10b981; --font-family-heading: 'Inter', sans-serif; }"
  }
}

A config érték egy CSS karakterlánc, amely a @import "tailwindcss" direktíva után kerül. Itt bármilyen érvényes Tailwind v4 CSS szintaxist használhat:

JSON
{
  "tailwind": {
    "enabled": true,
    "config": "@theme { --color-brand: oklch(0.7 0.15 200); } @layer base { h1 { font-size: var(--text-4xl); } }"
  }
}

Többsoros konfigurációknál kényelmesebb a szűrős megközelítés:

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;
});

Egyéni segédosztályok

Újrahasználható osztály-aliasok definiálásához használja a @layer utilities elemet a Tailwind @apply direktívájával közvetlenül a konfigurációs karakterláncban:

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; } }"
  }
}

Ezeket az osztályokat a rendszer a szokásos Tailwind segédosztályokkal együtt fordítja le. A frontend felületen (szerveroldali fordítással) és a szerkesztőben (CDN előnézetben) is működnek.

A Blockstudio megőrzi a Tailwind kanonikus lépcsőréteg-sorrendjét: theme, base, components, majd utilities. Ez megfelel a Tailwind CSS sorrendjének, így a későbbi rétegek szabályai a várakozásoknak megfelelően felülírhatják a korábbi rétegekét.

Az osztálymező típusa

Ha automatikus kiegészítéssel szeretné használni a Tailwind osztályokat egy blokk classes mezőjében, állítsa be a mezőn a tailwind: true értéket:

JSON
{
  "name": "my-theme/hero",
  "title": "Hero",
  "blockstudio": {
    "attributes": [
      {
        "id": "classes",
        "type": "classes",
        "label": "Classes",
        "tailwind": true,
        "default": "bg-white text-gray-900"
      }
    ]
  }
}

Ha a tailwind értéke true:

  • A mező a teljes Tailwind osztálylistából kínál automatikus kiegészítési javaslatokat
  • A szerkesztőben betöltődik az Tailwind CDN szkript az élő előnézethez
  • Az osztályok szóközzel elválasztott karakterláncként tárolódnak a blokk attribútumai között

Használja az osztályok értékét a sablonban:

PHP
<div class="<?php echo $a['classes']; ?>">
  <!-- block content -->
</div>

Beállítások referenciája

Beállítás Típus Alapértelmezett Leírás
enabled logikai false A Tailwind CSS fordításának engedélyezése a frontend felületen
config karakterlánc "" Tailwind v4 CSS-alapú konfigurációs karakterlánc

Beállítás JSON használatával

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

Beállítás szűrőkkel

PHP
add_filter('blockstudio/settings/tailwind/enabled', '__return_true');

add_filter('blockstudio/settings/tailwind/config', function () {
    return '@theme { --color-brand: pink; }';
});

Gyorsítótárazás

A Blockstudio egyéni gyorsítótárazási stratégiát használ, amelyet a Tailwind segédosztály-alapú architektúrájához terveztek.

A gyorsítótár működése

A teljes oldal HTML lenyomata helyett (amely az egyes kérések során a nonce-ok, időbélyegek és más dinamikus tartalmak miatt érvénytelenítené a gyorsítótárat) a Blockstudio csak a CSS osztályjelölteket nyeri ki a HTML elemből. Ezeket a jelölteket rendezi, majd a CSS konfigurációval együtt hasheli egy stabil gyorsítótárkulcs előállításához.

Ez azt jelenti, hogy:

  • Az azonos Tailwind osztálykészletet használó oldalak ugyanazt a gyorsítótárazott CSS fájlt használják, még akkor is, ha a HTML teljesen eltérő
  • A dinamikus tartalmak, például a nonce-ok, a bejelentkezett felhasználók sávjai, a hozzászólások száma és az időbélyegek nem érvénytelenítik a gyorsítótárat
  • A gyorsítótár csak akkor érvénytelenül, ha megváltozik az oldalon található CSS osztályok készlete vagy a Tailwind konfiguráció

Ha egy futtatókörnyezet logikai felderítési forrást használ, a kiválasztott forrás és a futtatókörnyezet kontextusa is része a gyorsítótár névterének. A legutóbbi sikeres CSS elkülönül az előnézetek között, és nem szivároghat át egyik forrásválasztásból a másikba.

A gyorsítótár helye

A gyorsítótárfájlok helye:

Kód
wp-content/blockstudio/cache/sites/{network-blog}/{runtime-identity}/tailwind/

A beállított cache.path, az aktuális többhelyes telepítés azonosítója és a futtatókörnyezet teljes azonosítója határozza meg a pontos előtagot. Minden fájl neve egy MD5 hashből áll: {hash}.css.

A gyorsítótár törlése

Az újrafordítás kikényszerítéséhez törölje a gyorsítótár könyvtárának tartalmát:

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

Vagy a WP-CLI használatával:

Shell
wp eval "Blockstudio\\Runtime_Cache::purge('tailwind');"

A következő frontend kérés automatikusan újrafordítja és gyorsítótárazza a CSS elemet.

Szűrők

blockstudio/tailwind/css

Módosítsa a CSS bemenetet a fordítás előtt. A CSS bemeneti karakterlánc a @import "tailwindcss"; értékkel kezdődik, amelyet tetszőleges konfiguráció követ. Ezzel a szűrővel további CSS direktívákat, egyéni @layer szabályokat vagy bővítményimportokat adhat hozzá.

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;
});

A teljes lefordított CSS bemenet így néz ki:

CSS
/* Base import */
@import 'tailwindcss';

/* Config from settings (if set) */
@theme {
  --color-brand: pink;
}

/* Anything added via the blockstudio/tailwind/css filter */

Kimeneti puffer

A Tailwind fordítása a Blockstudio kimeneti pufferrendszeréhez kapcsolódik. A puffer a teljes oldal HTML tartalmát rögzíti, miután a WordPress befejezte a megjelenítést. Így a Tailwind minden forrásból beolvashatja az összes osztályt: blokk- és sablonfájlokból, témasablonokból, bővítmények kimenetéből, the_content szűrőkből és widgetterületekről.

A fordítási szűrő a blockstudio/buffer/output horgon, 999999 prioritással fut, így az összes módosítás után a végleges HTML tartalmat dolgozza fel. A puffer a template_redirect műveletnél indul, ezért csak frontend kéréseknél fut, az adminisztrációs felületen, a REST API környezetben és AJAX kontextusban nem.

A teljes dokumentum pufferelése teszi ezt lehetővé, ezért alapértelmezés szerint engedélyezett. Az a webhely, amely sem Tailwind-t, sem blokkeszközöket nem használ, kikapcsolhatja:

PHP
add_filter( 'blockstudio/buffer/enabled', '__return_false' );

A false visszaadása teljesen kihagyja a puffert, ami egyben letiltja a Tailwind fordítását, valamint a blokkstílusok és -szkriptek fejlécbe és láblécbe emelését.

Architektúra

Kód
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

Teljes példa

Teljes, működő beállítás egyéni témaszínekkel és egy ezeket használó blokkal:

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>

A frontend felületen az összes Tailwind segédosztály és egyéni témaszín egyetlen inline <style> címkébe fordítva jelenik meg.

Blokkkönyvtár építése

Tervezési tokenek, egyéni segédosztályok és a teljes Tailwind v4 beállítása éles környezethez készülő témához.