Tailwind CSS
Blockstudio включва вградена поддръжка на Tailwind CSS v4. Когато е включена, всяка страница във фронтенда се компилира от страна на сървъра чрез TailwindPHP с автоматично кеширане на база файлове. В редактора на блокове пакетираният скрипт Tailwind CDN осигурява визуализация на живо, докато редактирате.
Без стъпка за компилация, без CLI, без Node.js.
Как работи
Blockstudio използва две отделни стратегии за компилация според контекста:
Фронтенд (от страна на сървъра)
При всяка заявка към фронтенда Blockstudio улавя пълния HTML на страницата чрез изходен буфер, извлича всички потенциални класове CSS, компилира само CSS, които действително се използват, и вмъква резултата като вграден таг <style> преди </head>.
Потокът на компилация:
- WordPress визуализира пълния HTML на страницата в изходен буфер
TailwindPHP::extractCandidates()сканира HTML и извлича всички потенциални имена на класове CSS (бърз regex, без компилация)- Сортираните кандидати се хешират заедно с конфигурацията CSS, за да се създаде ключ за кеша
- При попадение в кеша: компилираният CSS се прочита от диска и се вмъква
- При пропуск в кеша:
TailwindPHP::generate()компилира CSS, записва го в директорията за кеш и го вмъква
Компилираният CSS се вмъква така:
<style id="blockstudio-tailwind">
/* compiled CSS */
</style>
Това включва preflight на Tailwind (нулиране на CSS) и всички съвпадащи помощни класове.
Редактор (от страна на клиента)
В редактора на блокове пакетираният скрипт Tailwind CDN (версия за браузър на Tailwind CSS v4) се изпълнява от страна на клиента. Той осигурява незабавна визуализация на живо, докато въвеждате имена на класове, без заявки към сървъра. CDN се зарежда само в редактора и никога не се предоставя във фронтенда.
Когато assets.reset.enabled е активен, Blockstudio възстановява и често използваните помощни класове за показване и позициониране на Tailwind в платното на редактора. Така класове на ниво обвивка, като flex, grid, absolute, fixed и sticky, не се отменят от правилата за обвивката на редакторските блокове на WordPress, така че оформленията, задвижвани от помощни класове, съвпадат по-добре с фронтенда.
Включване на Tailwind
Добавете конфигурацията tailwind към вашия blockstudio.json:
{
"$schema": "https://blockstudio.dev/schema/blockstudio",
"tailwind": {
"enabled": true
}
}
Или го включете чрез филтър:
add_filter('blockstudio/settings/tailwind/enabled', '__return_true');
Когато enabled е true, към всяка страница във фронтенда автоматично ще се компилира и добавя Tailwind CSS. Можете да използвате помощните класове Tailwind навсякъде: в шаблони на блокове, шаблони на теми, филтри the_content или във всеки HTML, който присъства в изхода на страницата.
Изход във фронтенда
Компилираният CSS се вмъква директно по подразбиране, като се запазва изходът, използван в предишните версии. Сайтовете с много споделени правила могат вместо това да използват стилов файл с хеш на съдържанието:
{
"tailwind": {
"enabled": true,
"output": "link"
}
}
"output": "link" извежда съществуващия кеш файл tailwind/{content-hash}.css като <link rel="stylesheet">. URL се променя при промяна на идентичността на средата за изпълнение, кандидатите, енджина или входа CSS, така че браузърите и кешовете на периферните възли могат безопасно да запазят старите URL адреси. Настройте уеб сървъра или CDN да изпраща дългосрочно кешираща заглавка Cache-Control: public, immutable за този обхват на кеша.
Основната директория за кеш е публична и се намира под wp-content. Ако cache.path сочи към частен абсолютен том, Blockstudio преминава към вграден CSS, освен ако съществуващият филтър blockstudio/files/url не предостави публичен URL за обхвата tailwind:
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
);
Помощни средства за композиция на шаблони
Blockstudio предоставя на шаблоните PHP същия пакетен енджин TailwindPHP. Не е необходима копия или резервна реализация от страна на темата:
$classes = 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']);
bs_tw_merge() приема вложени стойности на класове и разрешава конфликти между Tailwind помощни класове. bs_tw_variants() връща извикваема функция в стил CVA, която поддържа базови варианти, варианти по подразбиране, съставни варианти, class и className.
Конфигурация
Tailwind v4 използва конфигурационен подход, основан първо на CSS. Вместо конфигурационен файл за JavaScript, записвате конфигурацията директно като CSS с директивата @theme.
{
"tailwind": {
"enabled": true,
"config": "@theme { --color-primary: #3b82f6; --color-secondary: #10b981; --font-family-heading: 'Inter', sans-serif; }"
}
}
Стойността config е низ от CSS, който се добавя след директивата @import "tailwindcss". Тук можете да използвате всеки валиден синтаксис на Tailwind v4 CSS:
{
"tailwind": {
"enabled": true,
"config": "@theme { --color-brand: oklch(0.7 0.15 200); } @layer base { h1 { font-size: var(--text-4xl); } }"
}
}
При конфигурации на няколко реда подходът с филтър е по-удобен:
add_filter('blockstudio/settings/tailwind/config', function () {
return <<<CSS
@theme {
--color-primary: #3b82f6;
--color-secondary: #10b981;
--font-family-heading: 'Inter', sans-serif;
--breakpoint-xs: 30rem;
}
@layer base {
body {
font-family: var(--font-family-sans);
}
}
@layer utilities {
.btn { @apply px-4 py-2 rounded-lg font-medium; }
.btn-primary { @apply bg-blue-500 text-white hover:bg-blue-600; }
.card { @apply bg-white rounded-xl shadow-lg p-6; }
}
CSS;
});
Персонализирани помощни класове
За да дефинирате повторно използваеми псевдоними на класове, използвайте @layer utilities директно в низа за конфигурация с директивата @apply на Tailwind:
{
"tailwind": {
"enabled": true,
"config": "@theme { --color-brand: #6366f1; } @layer utilities { .btn { @apply px-4 py-2 rounded-lg font-medium; } .section { @apply py-16 px-4 max-w-7xl mx-auto; } }"
}
}
Това компилира тези класове заедно с всички стандартни помощни класове на Tailwind. Те работят както във фронтенда (компилация от страната на сървъра), така и в редактора (предварителен преглед на CDN).
Blockstudio запазва каноничния ред на каскадните слоеве на Tailwind:
theme, base, components, след това utilities. Това съответства на Tailwind CSS, така че
правилата в по-късните слоеве могат да заменят очаквано тези в по-ранните.
Тип на полето за класове
За да използвате класове на Tailwind в полето classes на блок с поддръжка за автоматично довършване, задайте tailwind: true за полето:
{
"name": "my-theme/hero",
"title": "Hero",
"blockstudio": {
"attributes": [
{
"id": "classes",
"type": "classes",
"label": "Classes",
"tailwind": true,
"default": "bg-white text-gray-900"
}
]
}
}
Когато tailwind е true:
- Полето предлага предложения за автоматично довършване от пълния списък с класове на Tailwind
- Скриптът Tailwind CDN се зарежда в редактора за визуализация на живо
- Класовете се съхраняват като низ, разделен с интервали, в атрибутите на блока
Използвайте стойността на класовете в шаблона си:
<div class="<?php echo $a['classes']; ?>">
<!-- block content -->
</div>
Справка за настройките
| Опция | Тип | По подразбиране | Описание |
|---|---|---|---|
enabled |
булева | false |
Включва компилацията на Tailwind CSS във фронтенда |
config |
низ | "" |
Конфигурационен низ, основан на Tailwind v4 CSS |
Задаване чрез JSON
{
"tailwind": {
"enabled": true,
"config": "@theme { --color-brand: pink; }"
}
}
Задаване чрез филтри
add_filter('blockstudio/settings/tailwind/enabled', '__return_true');
add_filter('blockstudio/settings/tailwind/config', function () {
return '@theme { --color-brand: pink; }';
});
Кеширане
Blockstudio използва персонализирана стратегия за кеширане, създадена за архитектурата на Tailwind, основана на помощни класове.
Как работи кешът
Вместо да хешира целия HTML на страницата (което би обезсмислило кеша при всяка заявка заради nonce стойности, времеви отметки и друго динамично съдържание), Blockstudio извлича само кандидат-класовете на CSS от HTML. Тези кандидати се сортират и хешират заедно с конфигурацията на CSS, за да се получи стабилен ключ за кеша.
Това означава:
- Две страници, които използват един и същ набор от класове на Tailwind, споделят един и същ кеширан файл CSS, дори ако HTML е напълно различен
- Динамично съдържание като nonce стойности, ленти за влезли потребители, брой коментари и времеви отметки не обезсмисля кеша
- Кешът се обезсилва само когато наборът от класове на CSS на страницата се промени или конфигурацията на Tailwind се промени
Когато средата за изпълнение използва логически източник за откриване, избраният източник и контекстът на средата за изпълнение също участват в пространството от имена на кеша. Последният успешно генериран CSS е изолиран между визуализациите и не може да изтече от един избор на източник към друг.
Местоположение на кеша
Кешираните файлове се съхраняват в:
wp-content/blockstudio/cache/sites/{network-blog}/{runtime-identity}/tailwind/
Конфигурираният cache.path, текущата самоличност на multisite и пълната самоличност на средата за изпълнение определят точния префикс. Името на всеки файл съдържа хеш MD5:
{hash}.css.
Изчистване на кеша
Изтрийте съдържанието на директорията на кеша, за да задействате повторна компилация:
// Clear all cached Tailwind CSS
Blockstudio\Runtime_Cache::purge('tailwind');
Или чрез WP-CLI:
wp eval "Blockstudio\\Runtime_Cache::purge('tailwind');"
При следващата заявка към фронтенда CSS ще бъде компилиран повторно и кеширан автоматично.
Филтри
blockstudio/tailwind/css
Променете входа CSS преди компилация. Входният низ CSS започва с @import "tailwindcss";, последвано от произволна конфигурация. Използвайте този филтър, за да добавите допълнителни директиви CSS, персонализирани правила @layer или импорти на плъгини.
add_filter('blockstudio/tailwind/css', function (string $css): string {
// Add a custom utility
$css .= "\n@utility container-narrow { max-width: 48rem; margin-inline: auto; }";
return $css;
});
Пълният вход CSS, който се компилира, изглежда така:
/* Base import */
@import 'tailwindcss';
/* Config from settings (if set) */
@theme {
--color-brand: pink;
}
/* Anything added via the blockstudio/tailwind/css filter */
Буфер за изход
Компилацията на Tailwind се включва в системата за буфер на изхода на Blockstudio. Буферът улавя пълния HTML на страницата, след като WordPress приключи изобразяването ѝ, което позволява на Tailwind да сканира всички класове от всеки източник: шаблони на блокове, шаблони на теми, изход от плъгини, филтри the_content и области с джаджи.
Филтърът за компилация се изпълнява с приоритет 999999 в hook-а blockstudio/buffer/output, за да обработи окончателния HTML след всички други промени. Буферът се стартира при действието template_redirect, което означава, че се изпълнява само при заявки към фронтенда, а не в администрацията, REST API или AJAX контексти.
Буферирането на целия документ прави това възможно, затова е включено по подразбиране. Сайт, който не използва нито Tailwind, нито ресурси на блокове, може да го изключи:
add_filter( 'blockstudio/buffer/enabled', '__return_false' );
Връщането на false пропуска буфера изцяло, което също изключва компилацията на Tailwind и преместването на стиловете и скриптовете на блоковете в head и footer.
Архитектура
Frontend Request
│
├─ WordPress renders HTML into output buffer
│
├─ blockstudio/buffer/output filter (priority 999999)
│ │
│ ├─ Settings::get('tailwind/enabled') → false? Return HTML unchanged
│ │
│ ├─ build_css_input()
│ │ ├─ @import "tailwindcss"
│ │ ├─ + tailwind/config setting
│ │ └─ + blockstudio/tailwind/css filter
│ │
│ ├─ TailwindPHP::extractCandidates($html)
│ │ └─ Returns array of CSS class names found in HTML
│ │
│ ├─ Cache key = md5(sorted candidates + css input)
│ │
│ ├─ Cache hit?
│ │ ├─ Yes → Read CSS from the shared runtime `tailwind/{hash}.css` scope
│ │ └─ No → TailwindPHP::generate() → Write to cache file
│ │
│ └─ Inject inline CSS, or link the content-hashed cache file when tailwind.output is "link"
│
└─ Browser receives HTML with compiled CSS
Editor Request
│
├─ Admin loads block editor
│
├─ Block with classes field (tailwind: true) detected
│ └─ Block_Registry::set_tailwind_active(true)
│
├─ Admin passes isTailwindActive + tailwindUrl to JS
│
└─ useTailwind() hook
├─ Injects Tailwind CDN script into document
├─ Creates hidden template div with HTML content
├─ Creates style tag for config
└─ CDN compiles CSS in-browser for live preview
Пълен пример
Пълна работеща настройка с персонализирани цветове на темата и блок, който ги използва:
{
"$schema": "https://blockstudio.dev/schema/blockstudio",
"tailwind": {
"enabled": true,
"config": "@theme { --color-brand: #6366f1; --color-brand-light: #a5b4fc; --color-surface: #f8fafc; } @layer utilities { .section-padding { @apply py-20 px-6; } .content-width { @apply max-w-5xl mx-auto; } .heading-xl { @apply text-4xl font-bold tracking-tight; } }"
}
}
{
"name": "my-theme/hero",
"title": "Hero Section",
"blockstudio": {
"attributes": [
{
"id": "title",
"type": "text",
"label": "Title",
"default": "Welcome"
},
{
"id": "wrapperClasses",
"type": "classes",
"label": "Wrapper Classes",
"tailwind": true,
"default": "section-padding bg-surface"
},
{
"id": "titleClasses",
"type": "classes",
"label": "Title Classes",
"tailwind": true,
"default": "heading-xl text-brand"
}
]
}
}
<section class="<?php echo $a['wrapperClasses']; ?>">
<div class="content-width">
<h1 class="<?php echo $a['titleClasses']; ?>">
<?php echo esc_html($a['title']); ?>
</h1>
</div>
</section>
Това се визуализира във фронтенда, като всички помощни класове на Tailwind и персонализираните цветове на темата са компилирани в един вграден HTML етикет <style>.
Създаване на библиотека от блокове
Токени за дизайн, персонализирани помощни класове и цялостната настройка на Tailwind v4 за готова за продукция тема.