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

[Zapnutí Tailwind](https://blockstudio.dev/cs/docs/tailwind/#enabling-tailwind)

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.

[Konfigurace](https://blockstudio.dev/cs/docs/tailwind/#configuration)

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.

[Typ pole Classes](https://blockstudio.dev/cs/docs/tailwind/#classes-field-type)

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.

[Výstup frontendu](https://blockstudio.dev/cs/docs/tailwind/#frontend-output)

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.

[Pomocné funkce pro šablony](https://blockstudio.dev/cs/docs/tailwind/#template-composition-helpers)

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

[Získat Plus](https://blockstudio.dev/cs/plus/)
