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 库的情况。
Core 也在转向 PHP。从 WordPress 7.0 起,使用 autoRegister 注册且带有 render 回调的区块,会为字符串、数字、整数和布尔属性生成控件,无需 JavaScript。在这种情况下,富文本、内部区块和媒体仍需要编辑组件。
两者可以并行使用
Blockstudio 会通过 register_block_type() 注册任何没有 blockstudio 键的 block.json。使用 wp-scripts 构建一个 create-block 区块,将输出文件夹放入 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 怎么样?
两者都支持。create-block 交互式模板会配置 supports.interactivity、viewScriptModule 和实验性模块构建标志。在 Blockstudio 中,你可以在 blockstudio 键下设置 interactivity,script.js 会作为模块加载,并自动为你生成导入映射。
编写区块,跳过构建
在 block.json 中定义字段,在 PHP、Twig 或 Blade 中编写模板;文件夹一旦存在,区块就会立即出现在编辑器中。
来源,已选中
- 区块编辑器手册:@wordpress/create-block
- 区块编辑器手册:开始使用 create-block
- 区块编辑器手册:区块的文件结构
- 区块编辑器手册:编辑和保存
- 区块编辑器手册:弃用
- 区块编辑器手册:静态或动态渲染
- 区块编辑器手册:交互性 API
- 区块编辑器手册:@wordpress/scripts
- 区块编辑器手册:@wordpress/create-block-interactive-template
- @wordpress/create-block 在 npm 上
- @wordpress/scripts 在 npm 上
- Gutenberg 源码:create-block-interactive-template
- 让 WordPress Core 仅通过 PHP 注册区块
官方扩展套件
高级站点模板、AI 系统指令和私人 Discord 社区。一次购买,终身更新。
- 500+ 个网站模板
- AI 系统指令
- 终身更新
- 私有 Discord 社区