Przejdź do treści

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.

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.

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.

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.

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.

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