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, два способа создать часть для редактора.
Вопросы о 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 — и блок появится в редакторе сразу после создания папки.
Источники, отмечено
- Руководство по редактору блоков: @wordpress/create-block
- Руководство по редактору блоков: начало работы с create-block
- Руководство по редактору блоков: структура файлов блока
- Руководство по редактору блоков: редактирование и сохранение
- Руководство по редактору блоков: устаревшие версии
- Руководство по редактору блоков: статическое или динамическое отображение
- Руководство по редактору блоков: API интерактивности API
- Руководство по редактору блоков: @wordpress/scripts
- Руководство по редактору блоков: @wordpress/create-block-interactive-template
- @wordpress/create-block на npm
- @wordpress/scripts на npm
- Исходный код Gutenberg: create-block-interactive-template
- Создание ядра WordPress: регистрация блоков только через PHP
Официальный набор расширений
Премиум-шаблоны сайтов, системные инструкции для ИИ и закрытое сообщество Discord. Разовая покупка, обновления навсегда.
- 500+ шаблонов сайтов
- Системные инструкции для ИИ
- Пожизненные обновления
- Закрытое сообщество Discord