跳转到正文

代码字段资源

除了作为文件提供的静态样式和脚本外,Blockstudio 还支持通过代码字段生成动态资源区块。根据使用场景,这些资源可以限定在区块范围内。

基本用法

最基本的用法是在模板中手动渲染代码字段的内容。

PHP

PHP
<div useBlockProps>
  <h1>My block</h1>
</div>
<style><?php echo $attributes['css']; ?></style>

Twig

Twig
<div useBlockProps>
  <h1>My block</h1>
</div>
<style>{{ attributes.css }}</style>

作用域选择器

为避免与其他区块冲突,你可以在代码字段中使用 %selector% 变量,并在渲染模板中配合 useBlockProps 使用。

在代码字段中,%selector% 指向单个区块实例。在 CSS 和 SCSS 文件中,%selector% 则指向区块共享的作用域类。

示例

假设我们想在代码字段中定位上方示例里的 h1 标签。

CSS
%selector% h1 {
  color: red;
}

现在,Blockstudio 会执行三项操作:

  • 为该区块实例创建唯一 ID
  • 将 %selector% 替换为该唯一 ID
  • 将相同的选择器添加到带有 useBlockProps 标记的元素上

最终输出大致如下:

HTML
<div data-assets="c9abe0d95c2b">
  <h1>My block</h1>
</div>
<style>
  [data-assets='c9abe0d95c2b'] h1 {
    color: red;
  }
</style>

自动渲染

总是需要手动渲染 style 标签会很麻烦。为简化这一过程,你可以在代码字段中使用 asset 属性。

JSON
{
  "blockstudio": {
    "attributes": [
      {
        "type": "code",
        "id": "code",
        "label": "Custom CSS",
        "language": "css",
        "asset": true
      }
    ]
  }
}

这会自动为标记为 css 的代码块创建 style 标签,并将其移至文档的 head 中。对于将语言标记为 javascript 的字段,则会创建 script 标签,并将其放在 body 的底部。

在扩展中

在 扩展中使用代码字段时,无需使用 asset 属性。如果语言是 css 或 javascript,Blockstudio 会自动将代码字段内容渲染为资源。

示例

JSON
{
  "$schema": "https://blockstudio.dev/schema/extend",
  "name": "core/*",
  "blockstudio": {
    "extend": true,
    "attributes": [
      {
        "id": "customCss",
        "type": "code",
        "label": "Custom css",
        "language": "css"
      }
    ]
  }
}

无需额外配置。以上设置会在侧边栏中为每个 core/* 区块显示一个代码字段,并自动将其内容作为资源渲染到页面中。

SCSS

代码字段支持 SCSS 编译。将语言设为 scss,Blockstudio 会先通过 ScssPhp 编译该值,再将其渲染为 CSS。

JSON
{
  "blockstudio": {
    "attributes": [
      {
        "type": "code",
        "id": "styles",
        "label": "Styles",
        "language": "scss",
        "asset": true
      }
    ]
  }
}

SCSS 的变量、嵌套和混入等功能都可以正常使用:

Scss
%selector% {
  $primary: #3b82f6;

  h1 {
    color: $primary;
  }

  &:hover {
    background: lighten($primary, 40%);
  }
}

在编辑器中,SCSS 会实时在服务器端编译,因此你输入时就能看到结果。在前端,编译会在区块渲染期间进行。