# Tailwind v4 bez Node.js

Każda strona kompiluje tylko używane przez siebie klasy, w PHP.

## Jedno ustawienie, bez etapu kompilacji

Ustaw `tailwind.enabled` w `blockstudio.json` i używaj klas narzędziowych w dowolnym szablonie. Przy każdym żądaniu frontendu Blockstudio zbiera kandydatów na klasy z gotowego HTML i kompiluje dokładnie te z użyciem TailwindPHP, portu Tailwind CSS 4.3 dla PHP.

Nie ma Node.js ani CLI, nie ma też obserwatora. Liczą się klasy z szablonów bloków, szablonów motywu, wtyczek i `the_content`, ponieważ skanowana jest cała strona.

[Włączanie Tailwind](https://blockstudio.dev/pl/docs/tailwind/#enabling-tailwind)

blockstudio.json

```
{
  "tailwind": {
    "enabled": true
  }
}
```

## Bez środowiska Node

TailwindPHP kompiluje przy obsłudze żądania; nie ma niczego do zbudowania ani wdrożenia.

## Narzędzia Tailwind 4.3

Narzędzia, warianty, wartości dowolne i dyrektywy z Tailwind CSS 4.3.

## Skanowanie całej strony

Klasy są uwzględniane wszędzie, gdzie pojawiają się w gotowym HTML.

## Pamięć podręczna według zestawu klas

Strony używające tych samych klas współdzielą jeden skompilowany plik.

## Konfiguracja z priorytetem CSS

Tokeny @theme i reguły @utility w blockstudio.json lub filtrze.

## Podgląd na żywo w edytorze

Dołączona wersja przeglądarkowa podgląda klasy podczas pisania.

## Plik wynikowy

Jeden arkusz stylów z hashem treści, który przeglądarki i pamięci podręczne na brzegu sieci mogą przechowywać.

## Typografia i formularze

Dwie oficjalne wtyczki przeniesiono do PHP i ładuje się je za pomocą @plugin.

## Konfiguracja w CSS

Tailwind v4 jest skonfigurowane z użyciem CSS, a nie pliku JavaScript. Umieść tokeny `@theme`, reguły `@utility` i warstwy w `tailwind.config` albo dodawaj je przez filtr `blockstudio/tailwind/css`, gdy zajmują kilka wierszy.

Oficjalne wtyczki typograficzna i formularzy zostały przeniesione do PHP i ładują się za pomocą `@plugin`. Wtyczki dostępne wyłącznie jako pakiety JavaScript nie działają, ponieważ nic nie uruchamia Node.

Aliasy klas to reguły `@apply` wewnątrz `@layer utilities`, takie jak `.btn` utworzone z narzędzi dopełnienia i zaokrąglania narożników. Kompilują się zarówno na stronie, jak i w podglądzie edytora.

[Konfiguracja](https://blockstudio.dev/pl/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;
    }
  ';
});
```

## Klasy jako pole

Nadaj polu `classes` typ `"tailwind": true`, a redaktorzy otrzymają autouzupełnianie z pełną listą klas; dołączona wersja przeglądarkowa Tailwind będzie podglądać każdą zmianę na kanwie.

Dzięki `assets.reset.enabled` kanwa przywraca również narzędzia wyświetlania i pozycjonowania, takie jak `flex`, `grid` i `sticky`, które w przeciwnym razie zostałyby nadpisane przez reguły opakowujące edytora.

[Typ pola Classes](https://blockstudio.dev/pl/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"
      }
    ]
  }
}
```

## Jeden arkusz stylów, pamięć podręczna według zestawu klas

Skompilowany plik CSS jest przechowywany na dysku pod kluczem utworzonym na podstawie posortowanych kandydatów na klasy ze strony oraz danych wejściowych CSS. Dzięki temu wartości nonce i znaczniki czasu nie unieważniają go, a strony z tymi samymi klasami współdzielą jeden plik.

Domyślnie wynik jest umieszczany w kodzie inline. `"output": "link"` emituje ten plik z pamięci podręcznej jako arkusz stylów z hashem treści. Pomiar na lokalnej kopii tej witryny z 8 października 2026 wykazał, że rozmiar strony głównej zmniejszył się z 451,648 do 296,379 bajtów, czyli z HTML.

Gdy `cache.path` wskazuje prywatny wolumin, Blockstudio przechodzi na osadzone CSS, chyba że filtr `blockstudio/files/url` zwróci publiczny URL dla zakresu `tailwind`, na przykład host CDN.

[Wynik frontendu](https://blockstudio.dev/pl/docs/tailwind/#frontend-output)

blockstudio.json

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

## Łączenie klas w PHP

`bs_tw_merge()` rozwiązuje konflikty między narzędziami, dzięki czemu klasa określona przez autora ma pierwszeństwo przed domyślną. `bs_tw_variants()` zwraca funkcję wariantową z klasami bazowymi, wariantami, wartościami domyślnymi i wariantami złożonymi.

Oba używają silnika TailwindPHP, który Blockstudio już dołącza, więc motyw nie potrzebuje własnej kopii.

[Funkcje pomocnicze szablonów](https://blockstudio.dev/pl/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']);
```

## Czyszczenie na żądanie

Runtime_Cache::purge(‘tailwind’) usuwa skompilowane CSS, a przy następnym żądaniu zostaje ono ponownie skompilowane.

## Opcjonalny bufor stron

Witryna, która nie korzysta ani z Tailwind, ani z zasobów bloków, może wyłączyć bufor stron za pomocą filtra blockstudio/buffer/enabled.

## Izolacja dla każdego źródła

Gdy używasz logicznego źródła wykrywania, wybrane źródło i kontekst środowiska uruchomieniowego wchodzą w skład przestrzeni nazw pamięci podręcznej, dzięki czemu ostatnie poprawne CSS nie przenika między podglądami.

## Kanoniczna kolejność warstw

Motyw, baza, komponenty, a następnie narzędzia — tak jak w Tailwind CSS, aby późniejsze warstwy nadpisywały wcześniejsze.

Plus

## Oficjalny zestaw rozszerzeń

Wysokiej jakości szablony witryn, systemowe instrukcje AI i prywatna społeczność Discord. Jednorazowy zakup, dożywotnie aktualizacje.

- 500+ szablonów stron
- Instrukcje systemowe AI
- Dożywotnie aktualizacje
- Prywatna społeczność Discord

[Uzyskaj Plus](https://blockstudio.dev/pl/plus/)
