区块字段
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" }
}
}
适用对象
区块字段适用于常规区块和 组件区块。组件区块很适合这种用途,因为它们专为程序化渲染而设计。