跳转到正文

加载

Blockstudio 区块是动态的,这意味着它们会在服务器上渲染,以便显示在 Gutenberg 中。Blockstudio 会预加载编辑器载荷中已有区块的渲染输出,并在可行时将其用于编辑器首次绘制。

这样,编辑器初次加载每个已保存区块时,就无需单独请求渲染器。同步模式中的嵌套 Blockstudio 区块和可复用 core/block 引用也会包含在预加载载荷中。

回退渲染

插入或编辑区块时,或者无法匹配预加载输出时,编辑器仍会调用 Blockstudio 渲染器。当属性、上下文或内部区块树与预加载条目不再匹配时,就可能发生这种情况。回退机制可确保预览准确,同时让大多数初始渲染使用预加载数据。

在速度较慢的主机上,大量回退渲染器请求仍可能导致超时,或延迟编辑器的其他资源加载。对于无需立即预览的区块,可以禁用加载。

媒体水合

在可行时,文件字段和启用了媒体功能的属性会从初始编辑器载荷中进行水合。准备媒体数据时,Blockstudio 会遍历嵌套组、标签页、重复器和字段 ID 前缀。

当字段存储 URL 返回格式时,Blockstudio 会将其视为 URL,不会尝试通过 WordPress 媒体端点解析。如果预加载载荷中没有附件数据,编辑器仍可能将 /wp/v2/media 作为回退请求。

禁用

将 block.json 中的 disableLoading 键设为 true,即可禁用模板渲染加载。区块模板将由占位内容代替。打开侧边栏时,仍可使用所有字段设置。

JSON
{
  "name": "blockstudio/native",
  "title": "Native Block",
  "category": "text",
  "icon": "star-filled",
  "description": "Native Blockstudio block.",
  "blockstudio": {
    "blockEditor": {
      "disableLoading": true
    }
  }
}

也可以通过 blockEditor/disableLoading 设置全局禁用区块加载:

PHP
add_filter('blockstudio/settings/block_editor/disable_loading', function() {
  return true;
});