跳转到正文

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,以两种方式编写编辑器端。

编辑器 UI
create-block否: 你编写的 React 编辑组件
Blockstudio是: 根据 block.json 中的字段生成
构建步骤
create-block否: 区块加载前先运行 wp-scripts build
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 怎么样?

两者都支持。create-block 交互式模板会配置 supports.interactivity、viewScriptModule 和实验性模块构建标志。在 Blockstudio 中,你可以在 blockstudio 键下设置 interactivity,script.js 会作为模块加载,并自动为你生成导入映射。

编写区块,跳过构建

在 block.json 中定义字段,在 PHP、Twig 或 Blade 中编写模板;文件夹一旦存在,区块就会立即出现在编辑器中。

来源,已选中

Plus

官方扩展套件

高级站点模板、AI 系统指令和私人 Discord 社区。一次购买,终身更新。

  • 500+ 个网站模板
  • AI 系统指令
  • 终身更新
  • 私有 Discord 社区