跳转到正文

区块字段

block 字段类型可以将另一个 Blockstudio 区块作为属性引用。被引用区块的字段会使用与 自定义字段相同的 idStructure 和 overrides 系统以内联方式展开。 在模板中,该值会返回渲染后的区块输出。

定义

JSON
{
  "blockstudio": {
    "attributes": [
      {
        "id": "card",
        "type": "block",
        "block": "mytheme/card",
        "idStructure": "card_{id}"
      }
    ]
  }
}

这会以内联方式展开被引用区块的字段。如果 mytheme/card 有 heading 和 content 字段,宿主区块就会获得 card_heading 和 card_content 属性。

模板用法

在模板中,字段值会返回被引用区块渲染后的 HTML:

Twig
<div class="hero">
  <h1>{{ a.title }}</h1>
  {{ a.card }}
</div>
PHP
<div class="hero">
  <h1><?php echo $a['title']; ?></h1>
  <?php echo $a['card']; ?>
</div>

返回格式

使用 returnFormat 控制字段值的返回内容:

值 说明
rendered (默认)被引用区块渲染后的 HTML 输出
data 包含被引用区块属性值的关联数组
both 包含 rendered(HTML)和 data(属性值)的对象
JSON
{
  "id": "card",
  "type": "block",
  "block": "mytheme/card",
  "idStructure": "card_{id}",
  "returnFormat": "data"
}

覆盖设置

像自定义字段一样,覆盖被引用区块的单个字段属性:

JSON
{
  "id": "card",
  "type": "block",
  "block": "mytheme/card",
  "idStructure": "card_{id}",
  "overrides": {
    "heading": { "default": "Welcome", "label": "Card Title" },
    "content": { "label": "Card Body" }
  }
}

适用对象

区块字段适用于常规区块和 组件区块。组件区块很适合这种用途,因为它们专为程序化渲染而设计。