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 уточнить названия, поведение и значения по умолчанию.
Библиотеку можно подключить по желанию:
{
"$schema": "https://blockstudio.dev/schema/blockstudio",
"ui": {
"enabled": true
}
}
После подключения простые компоненты можно выводить напрямую:
<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::
<bs:bsui-button label="Save" variant="default" />
Цель не в том, чтобы превратить Blockstudio в набор инструментов UI для создания страниц. Нужно сделать распространённые элементы интерфейса доступными в виде блоков, чтобы приложения на основе Blockstudio не создавали заново кнопки, диалоги, вкладки, списки выбора, поля формы, меню, панели инструментов и компоненты обратной связи для каждого проекта.
Первый набор компонентов включает базовые элементы для компоновки, действий, ввода, наложений, навигации, обратной связи, форм и отображения данных:
bsui/button,bsui/button-group,bsui/toggle,bsui/toggle-group,bsui/toolbarbsui/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-pickerbsui/dialog,bsui/drawer,bsui/popover,bsui/menu,bsui/context-menu,bsui/menubar,bsui/tooltip,bsui/alert-dialogbsui/tabs,bsui/accordion,bsui/breadcrumb,bsui/pagination,bsui/navigation-menubsui/card,bsui/table,bsui/stack,bsui/separator,bsui/aspect-ratio,bsui/badge,bsui/avatar,bsui/progress,bsui/meter,bsui/skeleton,bsui/spinner,bsui/kbdbsui/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, описывают структуру.
<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 или базы данных.
<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% преобразуется в класс с заданной областью действия блока:
%selector% {
--hero-gap: var(--wp--preset--spacing--space-10);
}
%selector%.hero {
border-bottom: 1px solid currentColor;
}
.hero__title {
color: red;
}
Это позволяет стилизовать сам элемент-обёртку:
<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.
Простая форма проверяет, активен ли каждый указанный идентификатор плагина:
{
"blockstudio": {
"pluginDependencies": ["woocommerce"]
}
}
В форме объекта можно указать ограничения по версии:
{
"blockstudio": {
"pluginDependencies": {
"woocommerce": {
"version": ">6"
}
}
}
}
Идентификаторы — это слаги плагинов WordPress, соответствующие системе зависимостей плагинов ядра WordPress. Blockstudio определяет активные плагины по их слагам и пропускает регистрацию, если необходимый плагин отсутствует, неактивен или его версия ниже требуемой.
Ограничение версии использует ту же модель сравнения, что и version_compare() в PHP. Обычная версия, например "6", считается версией >=6.
Это полезно для блоков, которым необходим определённый плагин: карточек товаров WooCommerce, интеграций с формами, интеграций SEO, компонентов членства, виджетов бронирования или элементов админ-панели UI, связанных со сторонним плагином.
Политики редактора
Файл blockstudio.json становится ещё полезнее как файл политик редактора на уровне проекта.
В версии 7.3 добавлен уровень политик blockEditor на основе PHP для настроек WordPress, уже доступных через серверные хуки. Это позволяет задавать глобальное поведение вставщика блоков, паттернов и медиафайлов без отдельного связующего кода темы.
{
"$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.
Псевдонимы тегов блоков
Для тегов блоков появился фильтр псевдонимов:
add_filter('blockstudio/block_tags/tag_aliases', function ($aliases) {
$aliases['theme-button'] = 'bsui/button';
return $aliases;
});
Так проект может задавать удобные для автора теги, которые внутри системы по-прежнему соответствуют каноническому имени блока.
<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.