资源
Blockstudio 为你的区块提供零配置资源处理管线。将 CSS、SCSS 或 JavaScript 文件放在区块旁边,它们就会自动编译、压缩并加入队列。
检查区块资源
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() 检查已注册的字段定义。