Blockfält
Fälttypen block gör att du kan använda ett annat Blockstudio-block som
attribut. Det refererade blockets fält expanderas direkt med samma
system för idStructure och overrides som anpassade fält.
I mallar returnerar värdet blockets renderade utdata.
Definition
{
"blockstudio": {
"attributes": [
{
"id": "card",
"type": "block",
"block": "mytheme/card",
"idStructure": "card_{id}"
}
]
}
}
Detta expanderar det refererade blockets fält direkt. Om mytheme/card har
fälten heading och content får värdblocket attributen card_heading och
card_content.
Användning i mallar
I mallar returnerar fältvärdet det renderade HTML från det refererade blocket:
<div class="hero">
<h1>{{ a.title }}</h1>
{{ a.card }}
</div>
<div class="hero">
<h1><?php echo $a['title']; ?></h1>
<?php echo $a['card']; ?>
</div>
Returformat
Styr vad fältvärdet returnerar med returnFormat:
| Värde | Beskrivning |
|---|---|
rendered |
(standard) Det renderade HTML-utdata som det refererade blocket ger |
data |
En associativ array med det refererade blockets attributvärden |
both |
Ett objekt med rendered (HTML) och data (attributvärden) |
{
"id": "card",
"type": "block",
"block": "mytheme/card",
"idStructure": "card_{id}",
"returnFormat": "data"
}
Åsidosättningar
Åsidosätt enskilda fältegenskaper från det refererade blocket, precis som för anpassade fält:
{
"id": "card",
"type": "block",
"block": "mytheme/card",
"idStructure": "card_{id}",
"overrides": {
"heading": { "default": "Welcome", "label": "Card Title" },
"content": { "label": "Card Body" }
}
}
Fungerar med
Blockfält fungerar med både vanliga block och komponentblock. Komponentblock passar bra eftersom de är utformade för programmatisk rendering.