# Tailwind v4 без Node

Всяка страница компилира само използваните от нея класове в PHP.

## Една настройка, без стъпка за компилация

Задайте `tailwind.enabled` в `blockstudio.json` и пишете помощни класове във всеки шаблон. При всяка заявка към предната част на сайта Blockstudio събира възможните класове от завършения HTML и компилира точно тях с TailwindPHP — PHP порт на Tailwind CSS 4.3.

Няма Node.js, няма CLI и няма наблюдател. Класовете от шаблоните на блокове, шаблоните на темата, разширенията и `the_content` също се включват, защото се сканира цялата страница.

[Активиране на Tailwind](https://blockstudio.dev/bg/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`, когато са разпределени на няколко реда.

Официалните разширения за типография и формуляри са пренесени към PHP и се зареждат с `@plugin`. Разширенията, налични само като пакети JavaScript, не работят, защото Node не се изпълнява.

Псевдонимите на класове са правила `@apply` в `@layer utilities`, например `.btn`, съставен от помощни класове за отстъпи и заобляне. Те се компилират както на сайта, така и в редакторския визуален преглед.

[Конфигурация](https://blockstudio.dev/bg/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/bg/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/bg/docs/tailwind/#frontend-output)

blockstudio.json

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

## Обединяване на класове в PHP

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

И двата използват механизма TailwindPHP, който Blockstudio вече включва, така че темата няма нужда от собствено копие.

[Помощни функции за шаблони](https://blockstudio.dev/bg/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

## Официалният комплект за разширения

Премиум шаблони за сайтове, системни инструкции за AI и частна общност в Discord. Еднократна покупка, актуализации за цял живот.

- 500+ шаблона за сайтове
- Системни инструкции за AI
- Актуализации за целия период
- Частна общност на Discord

[Вземете Plus](https://blockstudio.dev/bg/plus/)
