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

Dennis · 19 мая 2026 г.

Blockstudio 7.3

Blockstudio 7.3 добавляет новый уровень в фреймворк: повторно используемые компоненты UI, которые можно выводить как любые другие блоки.

Если в версии 7.1 блоки превратились в полнофункциональные приложения, а в 7.2 упростились просмотр, проверка и распространение крупных проектов, то версия 7.3 сосредоточена на повседневной разработке и редактировании этих приложений.

Кратко:

  • Компоненты UI: библиотека компонентов bsui/* в составе пакета, подключаемая по желанию и работающая на основе WordPress Interactivity API.
  • Приложения: примеры app/* в составе пакета, показывающие, как компоненты UI объединяются в более крупные интерфейсы.
  • Расширенный редактор: более широкая выдвижная панель для редактирования полей Blockstudio, когда боковая панель становится слишком тесной.
  • Область действия селекторов ресурсов: ресурсы CSS и SCSS могут использовать %selector% для выбора класса-обёртки блока.
  • Зависимости плагинов: блоки могут требовать активные плагины WordPress, при необходимости с ограничениями по версии.
  • Политики редактора: blockstudio.json могут настраивать глобальные блоки, паттерны и работу с медиафайлами с помощью хуков редактора, основанных на WordPress PHP.
  • Псевдонимы тегов блоков: пользовательские псевдонимы для создания тегов блоков.
  • Статический анализ и документация: более полный охват PHPStan для внешних библиотек блоков и сгенерированная документация по настройкам и хукам.
  • Исправления страниц и редактора: более надёжный разбор страниц из файлов, обнаружение кандидатов Tailwind, режим сброса, изоляция кэша рендеринга и предварительная загрузка данных редактора.

Библиотека UI

В версии 7.3 появилась библиотека компонентов в составе пакета и созданные на её основе примеры приложений.

Компоненты UI

Blockstudio 7.3 включает библиотеку UI в составе пакета под пространством имён bsui/*. Эти компоненты — обычные блоки Blockstudio, поэтому их можно выводить в шаблонах, страницах из файлов, паттернах и содержимом записей с помощью уже знакомого вам синтаксиса тегов блоков.

Библиотека компонентов UI находится в бета-версии, пока мы собираем отзывы. Цель версии 7.3 — представить первый набор компонентов, проверить его на реальных проектах и до объявления стабильности интерфейса API уточнить названия, поведение и значения по умолчанию.

Библиотеку можно подключить по желанию:

JSON
{
  "$schema": "https://blockstudio.dev/schema/blockstudio",
  "ui": {
    "enabled": true
  }
}

После подключения простые компоненты можно выводить напрямую:

HTML
<block name="bsui/button" label="Save" variant="default"></block>
<block name="bsui/badge" label="Beta"></block>
<block
  name="bsui/input"
  nameAlt="email"
  type="email"
  placeholder="Email"
></block>

Также доступен сокращённый синтаксис bs::

HTML
<bs:bsui-button label="Save" variant="default" />

Цель не в том, чтобы превратить Blockstudio в набор инструментов UI для создания страниц. Нужно сделать распространённые элементы интерфейса доступными в виде блоков, чтобы приложения на основе Blockstudio не создавали заново кнопки, диалоги, вкладки, списки выбора, поля формы, меню, панели инструментов и компоненты обратной связи для каждого проекта.

Первый набор компонентов включает базовые элементы для компоновки, действий, ввода, наложений, навигации, обратной связи, форм и отображения данных:

  • bsui/button, bsui/button-group, bsui/toggle, bsui/toggle-group, bsui/toolbar
  • bsui/input, bsui/textarea, bsui/select, bsui/checkbox, bsui/radio-group, bsui/slider, bsui/switch, bsui/number-field, bsui/password-input, bsui/phone-input, bsui/otp-input, bsui/date-input, bsui/time-picker
  • bsui/dialog, bsui/drawer, bsui/popover, bsui/menu, bsui/context-menu, bsui/menubar, bsui/tooltip, bsui/alert-dialog
  • bsui/tabs, bsui/accordion, bsui/breadcrumb, bsui/pagination, bsui/navigation-menu
  • bsui/card, bsui/table, bsui/stack, bsui/separator, bsui/aspect-ratio, bsui/badge, bsui/avatar, bsui/progress, bsui/meter, bsui/skeleton, bsui/spinner, bsui/kbd
  • bsui/form, bsui/field, bsui/field-group, bsui/file-upload, bsui/color-picker, bsui/rating

Многие из них — составные блоки. Блок bsui/tabs управляет интерактивным состоянием, а дочерние блоки, такие как bsui/tabs-list, bsui/tabs-trigger и bsui/tabs-panel, описывают структуру.

HTML
<block name="bsui/tabs" defaultValue="features">
  <block name="bsui/tabs-list">
    <block name="bsui/tabs-trigger" value="features" title="Features"></block>
    <block name="bsui/tabs-trigger" value="pricing" title="Pricing"></block>
  </block>
  <block name="bsui/tabs-panel" value="features">
    <p>Features content.</p>
  </block>
  <block name="bsui/tabs-panel" value="pricing">
    <p>Pricing content.</p>
  </block>
</block>

Благодаря этому разметка остаётся читаемой, а состояние и поведение обрабатывает API Interactivity.

Примеры приложений

В пространстве имён app/* находятся примеры, созданные из тех же компонентов UI.

Это не отдельный фреймворк, а примеры реализации более крупных интерфейсов Blockstudio: составные блоки, вложенные UI, состояние Interactivity API и ситуации, в которых компоненты UI взаимодействуют с функциями RPC или базы данных.

HTML
<block name="app/kitchen-sink"></block>

<block name="app/chat">
  <block name="app/chat-sidebar"></block>
  <block name="app/chat-header"></block>
  <block name="app/chat-messages"></block>
  <block name="app/chat-input"></block>
</block>

Библиотека UI также включает собственную документацию и интерактивный справочник компонентов. Поведение компонентов — не просто набор шаблонов, а часть условий использования фреймворка, которая остаётся согласованной по мере роста библиотеки.

Разработка и редактирование

Несколько изменений упрощают разработку и редактирование блоков.

Расширенный редактор

В боковой панели инспектора быстро становится тесно при редактировании сложных блоков. Особенно это заметно при работе с повторителями, полями кода, форматированным текстом и вложенными группами.

Blockstudio 7.3 добавляет в инспектор блока действие «Расширенный редактор». Оно открывает более широкую выдвижную панель справа в редакторе и отображает там те же поля Blockstudio.

Главное, что используется та же система полей. Отрисовка полей не дублируется и не появляется второй путь сохранения данных; изменения в расширенном редакторе обновляют выбранный блок так же, как изменения в обычной боковой панели.

Используйте его, когда боковая панель удобна для просмотра, но слишком тесна для ввода данных.

Селекторы ресурсов с заданной областью действия

В Blockstudio уже была поддержка %selector% для полей кода. В версии 7.3 для ресурсов блока CSS и SCSS можно использовать тот же подход.

В файле CSS конструкция %selector% преобразуется в класс с заданной областью действия блока:

CSS
%selector% {
  --hero-gap: var(--wp--preset--spacing--space-10);
}

%selector%.hero {
  border-bottom: 1px solid currentColor;
}

.hero__title {
  color: red;
}

Это позволяет стилизовать сам элемент-обёртку:

PHP
<section class="hero <?php echo bs_get_scoped_class($b['name']); ?>">
  <h1 class="hero__title">Hero</h1>
</section>

Обычные селекторы в *.scoped.css по-прежнему выбирают потомков. %selector% — явный хук для корневого элемента блока.

Зависимости плагинов

Теперь блоки могут объявлять зависимости от плагинов WordPress в ключе blockstudio объекта block.json.

Простая форма проверяет, активен ли каждый указанный идентификатор плагина:

JSON
{
  "blockstudio": {
    "pluginDependencies": ["woocommerce"]
  }
}

В форме объекта можно указать ограничения по версии:

JSON
{
  "blockstudio": {
    "pluginDependencies": {
      "woocommerce": {
        "version": ">6"
      }
    }
  }
}

Идентификаторы — это слаги плагинов WordPress, соответствующие системе зависимостей плагинов ядра WordPress. Blockstudio определяет активные плагины по их слагам и пропускает регистрацию, если необходимый плагин отсутствует, неактивен или его версия ниже требуемой.

Ограничение версии использует ту же модель сравнения, что и version_compare() в PHP. Обычная версия, например "6", считается версией >=6.

Это полезно для блоков, которым необходим определённый плагин: карточек товаров WooCommerce, интеграций с формами, интеграций SEO, компонентов членства, виджетов бронирования или элементов админ-панели UI, связанных со сторонним плагином.

Политики редактора

Файл blockstudio.json становится ещё полезнее как файл политик редактора на уровне проекта.

В версии 7.3 добавлен уровень политик blockEditor на основе PHP для настроек WordPress, уже доступных через серверные хуки. Это позволяет задавать глобальное поведение вставщика блоков, паттернов и медиафайлов без отдельного связующего кода темы.

JSON
{
  "$schema": "https://blockstudio.dev/schema/blockstudio",
  "blockEditor": {
    "blocks": {
      "allow": ["core/*", "my-theme/*"],
      "deny": ["core/embed", "core/freeform"],
      "directory": false,
      "categories": {
        "rename": {
          "text": "Writing",
          "design": "Layout"
        },
        "order": ["my-theme", "text", "media"]
      }
    },
    "patterns": {
      "core": false,
      "remote": false,
      "categories": {
        "deny": ["gallery"],
        "order": ["featured", "buttons"]
      }
    },
    "media": {
      "openverse": false,
      "imageSizes": {
        "allow": ["thumbnail", "large"]
      }
    }
  }
}

Первая версия намеренно ограничена возможностями, поддерживаемыми через PHP: разрешёнными и запрещёнными блоками, загрузкой каталога блоков, метками и порядком категорий вставщика, источниками и категориями паттернов, Openverse, вариантами размеров изображений, видимостью устаревших виджетов и удалением стилей блоков, зарегистрированных через PHP.

Функция не пытается переопределять произвольные настройки блоков ядра по умолчанию. Такие настройки, как core/columns.isStackedOnMobile, задаются на этапе регистрации JavaScript в редакторе блоков, поэтому для них нужен отдельный, более явный API, вместо того чтобы имитировать их поддержку в файле JSON.

Псевдонимы тегов блоков

Для тегов блоков появился фильтр псевдонимов:

PHP
add_filter('blockstudio/block_tags/tag_aliases', function ($aliases) {
    $aliases['theme-button'] = 'bsui/button';
    return $aliases;
});

Так проект может задавать удобные для автора теги, которые внутри системы по-прежнему соответствуют каноническому имени блока.

HTML
<bs:theme-button label="Continue" />

Это особенно удобно при создании шаблонов с большим количеством UI: канонические имена блоков остаются корректными, но писать их не всегда удобно.

Инструменты и надёжность

Статический анализ, надёжность и инструменты повышения производительности стали лучше.

Статический анализ и сгенерированная документация

Расширение PHPStan теперь поддерживает явное указание корневых директорий для сканирования внешних библиотек блоков. Благодаря этому проект может проверять теги <bs:*> и <block> по блокам за пределами текущего плагина или темы, учитывая эти директории только в реестре для целей анализа.

Проверки схем также расширены для метаданных страницы и pluginDependencies. Благодаря этому недопустимую конфигурацию при выпуске проще обнаружить до её появления в WordPress.

Теперь генератор документации включает описания фильтров для настроек и хуков PHP. Это особенно полезно, поскольку blockstudio.json становится полноценным файлом политик проекта, а не просто местом для нескольких разрозненных переключателей.

Надёжность страниц и редактора

В версию 7.3 также вошёл ряд исправлений для страниц из файлов, отображения редактора и режима сброса.

Разбор страниц на основе файлов теперь учитывает атрибуты при сопоставлении пользовательских контейнеров во время разбора HTML. Теги страниц bs: также корректно обрабатывают пространства имен блоков с дефисами, поэтому такие имена, как custom-theme/card, больше не сбивают парсер.

Универсальные теги контейнеров, не относящиеся к ядру, теперь сериализуют корректный innerContent, если не предоставляют разметку оболочки. Благодаря этому синхронизированное содержимое страниц становится предсказуемее, а сериализация блоков WordPress остается корректной.

В редакторе исправлено несколько проблем с предварительным просмотром и предварительной загрузкой:

  • Tailwind редактор CSS теперь включает кандидаты классов из файловых шаблонов страниц.
  • Предварительная загрузка редактора сохраняет классы обёртки RichText для повторяющихся блоков одного типа.
  • Предварительная загрузка редактора учитывает блоки, значения полей по умолчанию которых раскрываются с помощью Gutenberg, но отсутствуют в сохранённой разметке блока.
  • Зарегистрированные атрибуты по умолчанию, раскрываемые с помощью Gutenberg, игнорируются перед сравнением ключей кэша рендеринга.
  • Предварительный просмотр в редакторе и вставщике теперь хранится в отдельных записях кэша, даже если у них общий идентификатор клиента.
  • bs_get_group() теперь корректно работает с повторно используемыми группами пользовательских полей, в том числе с группами, идентификатор которых совпадает с именем пользовательского поля, и извлекает только точные префиксы групп.
  • Поля ссылок с withCreateSuggestion теперь корректно подключают сценарий создания WordPress LinkControl и создают черновые страницы через REST API.
  • Шаблоны блоков PHP теперь выполняются один раз за рендеринг вместо запуска отброшенного предварительного подключения.

Режим сброса также стал точнее. Теперь он нейтрализует правила ширины и вертикальных отступов блоков редактора Gutenberg для настроенных типов записей, при необходимости удаляет стили содержимого и сброса в iframe WordPress, а также улучшает наложения при наведении и выборе в Blockstudio.

Проверки регрессий для сложных шаблонов InnerBlocks также расширены: теперь они охватывают вложенные блоки Blockstudio, чтобы проверить путь рендеринга редактора на самых трудных для ручной проверки сценариях вставки шаблонов.

Инструменты оценки производительности

Локальные анонимные пробы blockstudio-perf=1 теперь могут добавлять заголовки Server-Timing, не внедряя панель отладки.

Теперь замеры охватывают больше этапов сборки: обнаружение, обработку ресурсов, регистрацию и переопределения. Так проще увидеть, куда уходит время, не включая видимую панель профилирования UI.

Почему этот релиз важен

Главная тема версии 7.3 — композиция.

Компоненты UI упрощают создание интерфейсов приложений. Расширенный редактор облегчает работу с крупными блоками. Зависимости плагинов позволяют блокам указывать, какой контекст плагинов им нужен. Политики редактора переносят правила редактора блоков на уровне проекта в blockstudio.json. Псевдонимы тегов блоков упрощают создание шаблонов. Исправления парсера, PHPStan и редактора повышают надежность этих композиций при прохождении через WordPress.

Blockstudio по-прежнему основан на файлах. Блоки по-прежнему представлены папками. Шаблоны по-прежнему выполняют свою работу. Но теперь поверх этой основы у фреймворка есть более развитый слой UI.