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

Blockstudio и create-block

Тот же block.json без редактора React и сборки.

@wordpress/create-block — официально поддерживаемый инструмент для создания блока: плагина, block.json, компонента редактирования React и сборки webpack. Blockstudio сохраняет block.json и WordPress блока API, заменяя компонент редактирования полями, которые отображает за вас, и шаблоном, обрабатываемым на сервере, — сборка не требуется.

Что меняется без сборки

Блок Blockstudio — это папка: block.json для полей, шаблон для разметки и дополнительные ресурсы рядом с ними.

Поля вместо элементов управления

Объявите поле в block.json, и появится элемент управления для него. Встроенных типов — 27, от текстовых полей до повторителей.

Один шаблон

Один и тот же шаблон PHP, Twig или Blade отображает предпросмотр в редакторе и на странице.

Компоненты редактора в виде тегов

Добавьте в шаблон теги RichText или InnerBlocks; редактор подставит React.

Ресурсы по именам файлов

style.scss компилируется на сервере, а импорты npm из script.js загружаются в блок.

Когда лучше выбрать create-block

Когда редакторский опыт — это и есть продукт: с пользовательскими панелями инструментов, взаимодействиями перетаскиванием, холстами или другими функциями, требующими состояния React в редакторе. Когда блок должен сохранять статическую разметку, отображаемую без PHP. А также когда ваша команда уже пишет на React и ей нужна вся библиотека @wordpress/components.

Ядро также движется в сторону PHP. Начиная с WordPress 7.0, для блока, зарегистрированного с autoRegister и функцией обратного вызова render, создаются элементы управления для атрибутов string, number, integer и boolean без JavaScript. Для расширенного текста, вложенных блоков и медиафайлов там по-прежнему нужен компонент редактирования.

Они работают бок о бок

Blockstudio регистрирует любые block.json без ключа blockstudio через register_block_type(). Соберите блок create-block с помощью wp-scripts, поместите папку с результатом в каталог Blockstudio, и он загрузится рядом с вашими блоками Blockstudio.

Реестр Blockstudio копирует папки блоков между проектами, поэтому ими так же удобно делиться: папку create-block можно передать, как и любую другую папку блока.

Сравнение бок о бок

Один и тот же блок API, два способа создать часть для редактора.

Редактор UI
create-blockНет: Компонент редактирования React, который вы пишете
BlockstudioДа: Создается на основе полей в block.json
Этап сборки
create-blockНет: Сборка wp-scripts перед загрузкой блока
BlockstudioДа: Не требуется: шаблоны и ресурсы загружаются как файлы
Предварительный просмотр в редакторе
create-blockНет: Ваш компонент редактирования, отдельно от вывода
BlockstudioДа: Тот же шаблон, обрабатываемый на сервере
Изменение разметки позднее
create-blockНет: По умолчанию статический; изменения save() требуют устаревших версий
BlockstudioДа: Существующие блоки повторно отображаются по шаблону
Interactivity API
create-blockДа: Интерактивный шаблон, флаг сборки модулей
BlockstudioДа: Один флаг; script.js загружается как модуль
Пользовательские взаимодействия в редакторе
create-blockДа: Все, что умеет React
BlockstudioНет: Поля, пользовательские элементы управления полями, RichText, InnerBlocks, медиафайлы
Лицензия
create-blockДа: Бесплатно, GPL-2.0-or-later
BlockstudioДа: Бесплатно, GPLv2 или более поздняя версия

Вопросы о create-block

Что разработчики блоков спрашивают о переходе на работу без сборки.

Node по-прежнему нужен?

Для блоков Blockstudio — нет: шаблонами, SCSS и импортами ES-модулей управляет PHP. Проекту create-block Node нужен для wp-scripts, а для @wordpress/scripts 36.1.0 требуется Node 22.22.2 или более поздняя версия 22.x, 24.15.0 или более поздняя версия 24.x либо Node 26 или новее.

Это тот же block.json?

Да. Blockstudio читает стандартный block.json и добавляет ключ blockstudio для полей и настроек. Название, заголовок, категория, поддерживаемые возможности и остальные параметры означают то же, что и в WordPress.

Можно оставить свои блоки create-block?

Да. Поместите результат их сборки в каталог Blockstudio, и Blockstudio зарегистрирует их с помощью register_block_type(); либо оставьте их в собственном плагине. Переписывайте блок только в том случае, если сгенерированные поля лучше ему подходят.

Когда лучше выбрать create-block?

Когда вам нужно поведение редактора, которое нельзя выразить полями и шаблонами, статический результат сохранения или команда, уже работающая с React. Blockstudio подходит для множества блоков, состоящих из полей и разметки, где компонент редактирования в основном представляет собой шаблонный код.

А как насчет API интерактивности API?

Поддержка есть в обоих вариантах. Интерактивный шаблон create-block настраивает supports.interactivity, viewScriptModule и экспериментальный флаг сборки модулей. В Blockstudio интерактивность задается под ключом blockstudio, а script.js загружается как модуль со сгенерированной для вас картой импортов.

Создайте блок без сборки

Поля в block.json, шаблон в PHP, Twig или Blade — и блок появится в редакторе сразу после создания папки.

Источники, отмечено

Plus

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

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

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