Перейти к содержимому

Tailwind v4 без Node

Для каждой страницы в PHP компилируются только используемые на ней классы.

Одна настройка, без этапа сборки

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

Здесь нет 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

Официальный набор расширений

Премиум-шаблоны сайтов, системные инструкции для ИИ и закрытое сообщество Discord. Разовая покупка, обновления навсегда.

  • 500+ шаблонов сайтов
  • Системные инструкции для ИИ
  • Пожизненные обновления
  • Закрытое сообщество Discord