# Tailwind v4 без Node

Кожна сторінка компілює лише ті класи, які використовує, у PHP.

## Одне налаштування, без етапу збірки

Установіть `tailwind.enabled` у `blockstudio.json` і використовуйте утилітарні класи в будь-якому шаблоні. Під час кожного запиту фронтенду Blockstudio збирає можливі класи в готовому HTML і компілює саме їх за допомогою TailwindPHP — Tailwind CSS 4.3, портованого на PHP.

Немає Node.js, CLI чи спостерігача. Ураховуються класи з шаблонів блоків, шаблонів тем, плагінів і `the_content`, оскільки сканується вся сторінка.

[Увімкнення Tailwind](https://blockstudio.dev/uk/docs/tailwind/#enabling-tailwind)

blockstudio.json

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

## Без середовища виконання Node

TailwindPHP компілює під час запиту; нічого не потрібно збирати чи розгортати.

## Утиліти Tailwind 4.3

Утиліти, варіанти, довільні значення та директиви з Tailwind CSS 4.3.

## Сканування всієї сторінки

Класи враховуються, де б вони не з’являлися в готовому HTML.

## Кешування за набором класів

Сторінки з однаковими класами використовують один скомпільований файл.

## Конфігурація з пріоритетом CSS

Токени @theme і правила @utility у blockstudio.json або фільтрі.

## Попередній перегляд у редакторі наживо

Вбудована браузерна збірка попередньо переглядає класи під час введення.

## Окремий файл стилів

Одна таблиця стилів із хешем вмісту, яку можуть зберігати браузери та периферійні кеші.

## Типографіка та форми

Два офіційні плагіни портовано на PHP, і вони завантажуються через @plugin.

## Налаштовано в CSS

Tailwind v4 налаштовується за допомогою CSS, а не файлу JavaScript. Додавайте токени `@theme`, правила `@utility` і шари в `tailwind.config` або додавайте їх через фільтр `blockstudio/tailwind/css`, якщо вони займають кілька рядків.

Офіційні плагіни typography і forms портовано на PHP, і вони завантажуються через `@plugin`. Плагіни, доступні лише як пакети JavaScript, не запускаються, оскільки Node нічого не виконує.

Псевдоніми класів — це правила `@apply` усередині `@layer utilities`, як-от `.btn`, створений з утиліт відступів і радіусів. Вони однаково компілюються на фронтенді та в попередньому перегляді редактора.

[Конфігурація](https://blockstudio.dev/uk/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;
    }
  ';
});
```

## Класи як поле

Додайте полю `classes` тип `"tailwind": true` — і редактори отримають автодоповнення з повного списку класів, а вбудована браузерна збірка Tailwind відображатиме кожну зміну на полотні.

З `assets.reset.enabled` полотно також відновлює утиліти відображення й позиціювання, як-от `flex`, `grid` і `sticky`, які інакше перевизначили б правила обгортки редактора.

[Тип поля класів](https://blockstudio.dev/uk/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"
      }
    ]
  }
}
```

## Одна таблиця стилів, кешована за набором класів

Скомпільований CSS кешується на диску за ключем, сформованим із відсортованих кандидатів у класи сторінки та вхідних даних CSS. Тому nonce і часові мітки не скидають кеш, а сторінки з однаковими класами використовують один файл.

За замовчуванням вивід вбудований. `"output": "link"` натомість створює з цього кеш-файлу таблицю стилів із хешем вмісту. За вимірюваннями на локальній копії цього сайту 8 жовтня 2026 розмір головної сторінки зменшився з 451,648 до 296,379 байтів: HTML.

Якщо `cache.path` вказує на приватний том, Blockstudio використовує вбудований CSS, якщо фільтр `blockstudio/files/url` не поверне публічний URL для області `tailwind`, наприклад хост CDN.

[Вивід на фронтенді](https://blockstudio.dev/uk/docs/tailwind/#frontend-output)

blockstudio.json

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

## Об’єднання класів у PHP

`bs_tw_merge()` розв’язує конфлікти між утилітами, щоб авторський клас мав пріоритет над стандартним. `bs_tw_variants()` повертає функцію варіанта з базовими класами, варіантами, значеннями за замовчуванням і складеними варіантами.

Обидва використовують рушій TailwindPHP, який Blockstudio уже містить, тож темі не потрібна власна копія.

[Помічники шаблонів](https://blockstudio.dev/uk/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']);
```

## Очищення за запитом

Runtime_Cache::purge(‘tailwind’) очищає скомпільований CSS, а під час наступного запиту компілює його знову.

## Необов’язковий буфер сторінок

На сайті, де не використовуються ані Tailwind, ані ресурси блоків, можна вимкнути буфер сторінок за допомогою фільтра blockstudio/buffer/enabled.

## Ізоляція для кожного джерела

Якщо використовується логічне джерело пошуку, вибране джерело й контекст виконання входять до простору імен кешу, тож останній справний CSS не потрапляє в інші попередні перегляди.

## Канонічний порядок шарів

Тема, базовий шар, компоненти, потім утиліти — як у Tailwind CSS; пізніші шари перекривають попередні.

Plus

## Офіційний набір розширень

Преміумшаблони сайтів, системні інструкції для ШІ та приватна спільнота Discord. Одноразова покупка, довічні оновлення.

- Понад 500 шаблонів сайтів
- Системні інструкції для ШІ
- Оновлення назавжди
- Приватна спільнота Discord

[Отримати Plus](https://blockstudio.dev/uk/plus/)
