Campo de bloco
O tipo de campo block permite referenciar outro bloco Blockstudio como
atributo. Os campos do bloco referenciado são expandidos em linha usando o mesmo
sistema idStructure e overrides dos campos personalizados.
Nos modelos, o valor retorna a saída renderizada do bloco.
Definição
{
"blockstudio": {
"attributes": [
{
"id": "card",
"type": "block",
"block": "mytheme/card",
"idStructure": "card_{id}"
}
]
}
}
Isso expande em linha os campos do bloco referenciado. Se mytheme/card tiver
campos heading e content, o bloco anfitrião receberá os atributos card_heading e
card_content.
Uso em modelos
Nos modelos, o valor do campo retorna o HTML renderizado do bloco referenciado:
<div class="hero">
<h1>{{ a.title }}</h1>
{{ a.card }}
</div>
<div class="hero">
<h1><?php echo $a['title']; ?></h1>
<?php echo $a['card']; ?>
</div>
Formato de retorno
Controle o que o valor do campo retorna usando returnFormat:
| Valor | Descrição |
|---|---|
rendered |
(padrão) A saída HTML renderizada do bloco referenciado |
data |
Um array associativo dos valores dos atributos do bloco referenciado |
both |
Um objeto com rendered (HTML) e data (valores dos atributos) |
{
"id": "card",
"type": "block",
"block": "mytheme/card",
"idStructure": "card_{id}",
"returnFormat": "data"
}
Substituições
Substitua propriedades individuais do campo do bloco referenciado, assim como nos campos personalizados:
{
"id": "card",
"type": "block",
"block": "mytheme/card",
"idStructure": "card_{id}",
"overrides": {
"heading": { "default": "Welcome", "label": "Card Title" },
"content": { "label": "Card Body" }
}
}
Compatibilidade
O campo de bloco funciona tanto com blocos comuns quanto com blocos de componentes. Os blocos de componentes são uma escolha natural, pois foram projetados para renderização programática.