Přejít k obsahu

Tailwind v4 bez Node

Každá stránka zkompiluje pouze používané třídy v PHP.

Jedno nastavení, bez sestavování

Nastavte tailwind.enabled v blockstudio.json a v libovolné šabloně pište utility třídy. Při každém požadavku na frontend Blockstudio shromáždí kandidáty na třídy z dokončeného HTML a zkompiluje přesně ty, které obsahují TailwindPHP, port Tailwind CSS 4.3 v jazyce PHP.

Nepoužívá se žádné Node.js, žádné CLI ani sledovací proces. Počítají se třídy ze šablon bloků, šablon motivu, pluginů i the_content, protože se prohledává celá stránka.

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

Bez běhového prostředí Node

TailwindPHP kompiluje při požadavku; není třeba nic sestavovat ani nasazovat.

Utility Tailwind 4.3

Utility, varianty, libovolné hodnoty a direktivy z Tailwind CSS 4.3.

Prohledávání celé stránky

Počítají se třídy, ať už se ve výsledném HTML nacházejí kdekoli.

Cache podle sady tříd

Stránky se stejnými třídami sdílejí jeden zkompilovaný soubor.

Konfigurace s důrazem na CSS

Tokeny @theme a pravidla @utility v blockstudio.json nebo ve filtru.

Náhled v editoru v reálném čase

Přibalená verze prohlížeče zobrazuje náhled tříd během psaní.

Výstup v samostatném souboru

Jeden soubor šablony stylů s hashem obsahu, který mohou uchovávat prohlížeče i edge cache.

Typografie a formuláře

Oba oficiální pluginy jsou portovány do PHP a načítají se pomocí @plugin.

Nakonfigurováno v CSS

Tailwind v4 je nakonfigurováno pomocí CSS, nikoli souboru JavaScript. Vložte tokeny @theme, pravidla @utility a vrstvy do tailwind.config nebo je přidejte prostřednictvím filtru blockstudio/tailwind/css, pokud zabírají několik řádků.

Oficiální pluginy pro typografii a formuláře jsou portovány do PHP a načítají se pomocí @plugin. Pluginy dostupné pouze jako balíčky JavaScript se nespustí, protože se nevykonává žádný kód Node.

Aliasy tříd jsou pravidla @apply uvnitř @layer utilities, například .btn vytvořený z utilit pro vnitřní odsazení a zaoblení rohů. Kompilují se stejně na webu i v náhledu editoru.

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

Třídy jako pole

Nastavte poli classes hodnotu "tailwind": true a editoři získají automatické doplňování z úplného seznamu tříd. Každou změnu přitom v plátně zobrazí přibalená verze Tailwind pro prohlížeč.

Se zapnutým assets.reset.enabled plátno obnoví také utility pro zobrazení a pozici, například flex, grid a sticky, které by jinak přepsala pravidla obalu editoru.

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

Jedna šablona stylů, cache podle sady tříd

Zkompilované CSS se ukládá do cache na disk pod klíčem vytvořeným ze seřazených kandidátů na třídy stránky a vstupu CSS. Nonce ani časová razítka proto cache nezneplatní a stránky se stejnými třídami sdílejí jeden soubor.

Ve výchozím nastavení se výstup vkládá přímo do stránky. "output": "link" místo toho vytvoří z tohoto souboru cache šablonu stylů s hashem obsahu. Při měření na místní kopii tohoto webu dne 8. října 2026 se velikost úvodní stránky změnila z 451,648 na 296,379 bajtů, tedy z HTML.

Když cache.path odkazuje na soukromý svazek, Blockstudio použije inline CSS, ledaže filtr blockstudio/files/url vrátí veřejné URL pro rozsah tailwind, například hostitele CDN.

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

Sloučení tříd pomocí PHP

bs_tw_merge() řeší konflikty mezi utilitami, takže vlastní třída má přednost před výchozí. bs_tw_variants() vrací variantu, kterou lze volat se základními třídami, variantami, výchozími hodnotami a kombinovanými variantami.

Oba používají stroj TailwindPHP, který už Blockstudio obsahuje, takže šablona nepotřebuje vlastní kopii.

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

Vymazání na vyžádání

Runtime_Cache::purge(‘tailwind’) vymaže zkompilované CSS a při dalším požadavku se znovu zkompiluje.

Volitelná mezipaměť stránky

Web, který nepoužívá ani Tailwind, ani assety bloků, může vypnout mezipaměť stránky pomocí filtru blockstudio/buffer/enabled.

Oddělené podle zdroje

Při použití logického zdroje pro vyhledávání se vybraný zdroj a kontext běhu přidají do jmenného prostoru mezipaměti, takže poslední funkční CSS nikdy neunikne mezi náhledy.

Kanické pořadí vrstev

Šablona, základ, komponenty a potom utility, stejně jako v Tailwind CSS, takže pozdější vrstvy přepisují dřívější.

Plus

Oficiální sada rozšíření

Prémiové šablony webů, systémové pokyny pro umělou inteligenci a soukromá komunita Discord. Jednorázový nákup, doživotní aktualizace.

  • 500+ šablon webů
  • Systémové instrukce AI
  • Doživotní aktualizace
  • Soukromá komunita Discord