Preskočiť na obsah

Tailwind v4 bez Node

Každá stránka kompiluje iba triedy, ktoré používa, v PHP.

Jedno nastavenie, bez zostavovania

Nastavte tailwind.enabled v blockstudio.json a v ľubovoľnej šablóne píšte pomocné triedy. Pri každej požiadavke frontendu Blockstudio zhromaždí kandidátov na triedy z hotového HTML a pomocou TailwindPHP skompiluje presne tie, ktoré sa v ňom nachádzajú. Ide o PHP port Tailwind CSS 4.3.

Nepotrebujete Node.js, CLI ani sledovací proces. Počítajú sa triedy zo šablón blokov, šablón témy, pluginov aj the_content, pretože sa prehľadáva celá stránka.

blockstudio.json
{
  "tailwind": {
    "enabled": true
  }
}

Bez prostredia Node

TailwindPHP sa kompiluje počas požiadavky; netreba nič zostavovať ani nasadzovať.

Pomocné triedy Tailwind 4.3

Pomocné triedy, varianty, ľubovoľné hodnoty a direktívy z Tailwind CSS 4.3.

Skenovanie celej stránky

Počítajú sa triedy bez ohľadu na to, kde sa nachádzajú vo finálnom HTML.

Uložené podľa množiny tried

Stránky s rovnakými triedami zdieľajú jeden skompilovaný súbor.

Konfigurácia s CSS na prvom mieste

Tokeny @theme a pravidlá @utility v blockstudio.json alebo filtri.

Živý náhľad v editore

Zostavenie prehliadača v balíku zobrazuje ukážku tried počas písania.

Prepojený výstup

Jeden štýlový súbor s hashom obsahu, ktorý môžu uchovávať prehliadače aj okrajové vyrovnávacie pamäte.

Typografia a formuláre

Dva oficiálne pluginy sú portované na PHP a načítavajú sa pomocou @plugin.

Konfigurované v CSS

Tailwind v4 sa konfiguruje pomocou CSS, nie súboru JavaScript. Vložte tokeny @theme, pravidlá @utility a vrstvy do tailwind.config alebo ich pridajte pomocou filtra blockstudio/tailwind/css, ak zaberajú viacero riadkov.

Oficiálne pluginy pre typografiu a formuláre sú portované na PHP a načítavajú sa pomocou @plugin. Pluginy dostupné iba ako balíky JavaScript nefungujú, pretože sa nespúšťa Node.

Aliasy tried sú pravidlá @apply v rámci @layer utilities, napríklad .btn vytvorený z pomocných tried pre odsadenie a zaoblenie rohov. Kompilujú sa rovnako na webe aj v ukážke editora.

functions.php
add_filter('blockstudio/tailwind/css', function (string $css): string {
  return $css . '
    @plugin "@tailwindcss/typography";
    @theme { --color-brand: #4f46e5; }
    @utility container-narrow {
      max-width: 48rem;
      margin-inline: auto;
    }
  ';
});

Triedy ako pole

Nastavte poľu classes hodnotu "tailwind": true a editori získajú automatické dopĺňanie z úplného zoznamu tried. Súčasťou balíka je aj zostavenie prehliadača Tailwind, ktoré zobrazuje ukážku každej zmeny na plátne.

Pri použití assets.reset.enabled plátno obnoví aj pomocné triedy pre zobrazenie a pozíciu, ako sú flex, grid a sticky, ktoré by inak prepísali pravidlá obalu editora.

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

Jeden štýlový súbor, uložený podľa množiny tried

Skompilovaný súbor CSS sa ukladá na disk pod kľúčom vytvoreným z usporiadaných kandidátov na triedy danej stránky a vstupu CSS. Vďaka tomu ho nezneplatnia nonce ani časové značky a stránky s rovnakými triedami zdieľajú jeden súbor.

Predvolene sa výstup vkladá priamo do stránky. "output": "link" namiesto toho vytvorí zo súboru vyrovnávacej pamäte štýlový súbor s hashom obsahu. Pri meraní na lokálnej kópii tohto webu 8. októbra 2026 sa veľkosť úvodnej stránky zmenila z 451,648 na 296,379 bajtov pri použití HTML.

Ak cache.path smeruje na súkromný zväzok, Blockstudio použije vložený CSS, pokiaľ filter blockstudio/files/url nevráti verejný URL pre rozsah tailwind, napríklad hostiteľa CDN.

blockstudio.json
{
  "tailwind": {
    "enabled": true,
    "output": "link"
  }
}

Zlučovanie tried v PHP

bs_tw_merge() rieši konflikty medzi pomocnými triedami, takže autorská trieda má prednosť pred predvolenou. bs_tw_variants() vracia volateľnú variantu so základnými triedami, variantmi, predvolenými hodnotami a zloženými variantmi.

Oba používajú modul TailwindPHP, ktorý už obsahuje balík Blockstudio, takže téma nepotrebuje vlastnú kópiu.

index.php
echo 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']);

Vymazanie na požiadanie

Runtime_Cache::purge(‘tailwind’) vymaže skompilovaný CSS a pri ďalšej požiadavke sa skompiluje znova.

Voliteľná vyrovnávacia pamäť stránok

Stránka, ktorá nepoužíva ani Tailwind, ani prostriedky blokov, môže vypnúť vyrovnávaciu pamäť stránok pomocou filtra blockstudio/buffer/enabled.

Oddelené pre každý zdroj

Pri logickom zdroji zisťovania sa vybraný zdroj a kontext behu pridajú do menného priestoru vyrovnávacej pamäte, takže posledný platný CSS neunikne medzi ukážkami.

Štandardné poradie vrstiev

Téma, základ, komponenty a potom pomocné triedy, rovnako ako v Tailwind CSS, takže neskoršie vrstvy prepisujú skoršie.

Plus

Oficiálna súprava rozšírení

Prémiové šablóny webov, systémové pokyny pre AI a súkromná komunita Discord. Jednorazový nákup, aktualizácie na celý život.

  • 500+ šablón stránok
  • Systémové pokyny pre AI
  • Doživotné aktualizácie
  • Súkromná komunita Discord