Към съдържанието

Tailwind v4 без Node

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

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

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

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

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, съставен от помощни класове за отстъпи и заобляне. Те се компилират както на сайта, така и в редакторския визуален преглед.

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, които иначе биха били заменени от правилата на обвивките на редактора.

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.

blockstudio.json
{
  "tailwind": {
    "enabled": true,
    "output": "link"
  }
}

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

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

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

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