Tailwind v4 без Node
Для каждой страницы в PHP компилируются только используемые на ней классы.
Одна настройка, без этапа сборки
Задайте tailwind.enabled в blockstudio.json и пишите утилитарные классы в любом шаблоне. При каждом запросе к фронтенду Blockstudio собирает кандидаты в классы из готового HTML и компилирует только их с помощью TailwindPHP — порта Tailwind CSS 4.3 для PHP.
Здесь нет Node.js, CLI и наблюдателя. Учитываются классы из шаблонов блоков, темы и плагинов, а также из the_content, поскольку сканируется вся страница.
{
"tailwind": {
"enabled": true
}
}<section class="bg-slate-950 px-6 py-24">
<h1 class="text-5xl font-semibold tracking-tight text-white">
<?php echo esc_html( $a['title'] ); ?>
</h1>
</section>Без среды выполнения 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, созданное из утилит отступов и скругления. Они компилируются и на сайте, и в предварительном просмотре редактора.
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;
}
';
});{
"tailwind": {
"enabled": true,
"config": "@theme { --color-brand: #6366f1; } @layer utilities { .btn { @apply px-4 py-2 rounded-lg font-medium; } }"
}
}Классы в виде поля
Укажите для поля classes значение "tailwind": true, чтобы редакторы получали автодополнение по полному списку классов; встроенная Tailwind-сборка для браузера показывает предпросмотр каждого изменения на холсте.
С assets.reset.enabled холст также восстанавливает утилиты отображения и позиционирования, например flex, grid и sticky, которые иначе переопределяются правилами обертки редактора.
{
"name": "acme/hero",
"title": "Hero",
"blockstudio": {
"attributes": [
{
"id": "classes",
"type": "classes",
"label": "Classes",
"tailwind": true,
"default": "bg-white text-gray-900"
}
]
}
}<div class="<?php echo esc_attr( $a['classes'] ); ?>">
<InnerBlocks />
</div>Одна таблица стилей, кэшируемая по набору классов
Скомпилированный CSS кэшируется на диске по ключу, составленному из отсортированных кандидатов в классы страницы и входных данных CSS. Поэтому nonce и временные метки не сбрасывают кэш, а страницы с одинаковыми классами используют один файл.
По умолчанию вывод встраивается в страницу. "output": "link" вместо этого создает из файла кэша таблицу стилей с хешем содержимого. Согласно замерам на локальной копии этого сайта от 8 октября 2026, размер главной страницы сократился с 451,648 до 296,379 байт благодаря HTML.
Если cache.path указывает на закрытый том, Blockstudio использует встроенный CSS, если только фильтр blockstudio/files/url не возвращает публичный URL для области tailwind, например для хоста CDN.
{
"tailwind": {
"enabled": true,
"output": "link"
}
}add_filter(
'blockstudio/files/url',
function (string $url, string $path, string $scope): string {
if ('tailwind' !== $scope) {
return $url;
}
return 'https://static.example.com/blockstudio/' . basename($path);
},
10,
3
);Объединение классов в PHP
bs_tw_merge() разрешает конфликты между утилитами, чтобы заданный вручную класс имел приоритет над значением по умолчанию. bs_tw_variants() возвращает функцию варианта с базовыми классами, вариантами, значениями по умолчанию и составными вариантами.
Оба используют движок TailwindPHP, уже включенный в Blockstudio, поэтому теме не нужна собственная копия.
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, поэтому более поздние слои переопределяют ранние.
Официальный набор расширений
Премиум-шаблоны сайтов, системные инструкции для ИИ и закрытое сообщество Discord. Разовая покупка, обновления навсегда.
- 500+ шаблонов сайтов
- Системные инструкции для ИИ
- Пожизненные обновления
- Закрытое сообщество Discord