跳转到正文

资源

Blockstudio 为你的区块提供零配置资源处理管线。将 CSS、SCSS 或 JavaScript 文件放在区块旁边,它们就会自动编译、压缩并加入队列。

  • 注册资源:文件命名约定和加入队列的行为
  • 处理:SCSS 编译、ES 模块导入和压缩
  • 代码字段:通过代码字段类型进行内联代码编辑

检查区块资源

bs_block_assets('theme/card') 会返回已注册 Blockstudio 区块中发现的前端和编辑器画布资源。在区块注册后、init 或更高版本上调用它。未知区块、非 Blockstudio 区块以及没有资源的区块都会返回 []。此辅助函数不会渲染区块、加入队列或触发编译。

PHP
$assets = bs_block_assets('theme/card');

// Each entry has this shape:
[
  'type' => 'style',
  'handle' => 'blockstudio-theme-card-style-css',
  'url' => '/wp-content/blockstudio/cache/.../style-123.css?ver=123',
  'inline' => false,
  'scope' => ['frontend', 'editor'],
  'html' => '<link ...>',
];
  • type 对 CSS 而言是 style,对 JavaScript 而言是 module。Blockstudio 基于文件的 JavaScript 资源使用 ES 模块,包括内联脚本。
  • handle 是 Blockstudio 的渲染器和 blockstudio/assets/disable 筛选器使用的稳定资源标识符。它不必加入 WordPress 队列。
  • url 是现有已编译资源解析后的 URL(含其版本),若没有已编译文件,则为源 URL。对于内联资源,它是 null。
  • inline 用于区分内联 <style>/<script> 输出与外部文件。
  • scope 列出资源适用的上下文:共享文件适用于 frontend 和 editor,视图或编辑器文件则只适用于其中一个。
  • html 包含常规资源渲染器生成的可直接使用的标签。内联内容、作用域限定的 CSS、UI 样式层以及渲染时的禁用筛选器,处理方式都与普通区块输出相同。

缺失、空、已禁用和未编译的 SCSS 文件会被省略。排除由 WordPress 加入队列的管理后台和区块编辑器父文档资源。列表仅包含该区块自身发现的文件,并非依赖项闭包:嵌套区块、代码字段值、由 WordPress 加入队列的句柄、模块 CSS 导入、Tailwind 以及共享的 UI/交互运行时,都可能依赖渲染后的内容。使用 Render::document() 获取完整且自包含的预览。使用 bs_block_fields() 检查已注册的字段定义。