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, ігноруються перед порівнянням ключів кешу рендерингу.
- Попередній перегляд редактора та вставника тепер мають окремі записи кешу, навіть якщо використовують один і той самий client id.
bs_get_group()тепер коректно працює з повторно використовуваними групами користувацьких полів, зокрема з групами, чиї ідентифікатори збігаються з назвами користувацьких полів, і витягує лише точні префікси груп.- Поля посилань із
withCreateSuggestionтепер коректно підключають процес створення WordPress LinkControl і створюють чернетки сторінок через REST API. - Шаблони блоків PHP тепер виконуються один раз за рендеринг, без попереднього виклику include, результат якого відкидається.
Режим скидання також було вдосконалено. Тепер він нейтралізує правила ширини блоків редактора Gutenberg і вертикальних відступів для налаштованих типів записів, за потреби видаляє стилі вмісту/скидання iframe WordPress і забезпечує чистіші накладки наведення/вибору Blockstudio.
Також розширено регресійне тестове покриття складних шаблонів InnerBlocks: додано вкладені блоки Blockstudio, щоб перевірити шлях рендерингу редактора для сценаріїв вставлення шаблонів, які найважче перевірити вручну.
Інструменти для вимірювання продуктивності
Локальні анонімні зонди blockstudio-perf=1 тепер можуть виводити заголовки Server-Timing без додавання панелі налагодження.
Тепер вимірювання охоплюють більше етапів життєвого циклу збірки: виявлення, обробку ресурсів, реєстрацію та перевизначення. Так легше побачити, куди насправді йде час, не вмикаючи видиму панель UI профілювання.
Чому цей випуск важливий
Головна тема версії 7.3 — композиція.
Компоненти UI спрощують компонування інтерфейсів застосунків. Розширений редактор полегшує редагування більших блоків. Залежності плагінів дають змогу блокам описувати потрібний їм контекст плагінів. Політики редактора переносять правила редактора блоків на рівні проєкту до blockstudio.json. Псевдоніми тегів блоків спрощують створення шаблонів. Виправлення парсера, PHPStan та редактора роблять такі композиції надійнішими під час проходження через WordPress.
Blockstudio і далі працює на основі файлів. Блоки й далі є папками. Шаблони й далі виконують свою роботу. Але тепер фреймворк має потужніший рівень UI поверх цієї основи.