Tailwind v4 без Node
Всяка страница компилира само използваните от нея класове в PHP.
Една настройка, без стъпка за компилация
Задайте tailwind.enabled в blockstudio.json и пишете помощни класове във всеки шаблон. При всяка заявка към предната част на сайта Blockstudio събира възможните класове от завършения HTML и компилира точно тях с TailwindPHP — PHP порт на Tailwind CSS 4.3.
Няма 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, така че по-късните слоеве да надделяват над по-ранните.
Официалният комплект за разширения
Премиум шаблони за сайтове, системни инструкции за AI и частна общност в Discord. Еднократна покупка, актуализации за цял живот.
- 500+ шаблона за сайтове
- Системни инструкции за AI
- Актуализации за целия период
- Частна общност на Discord