Pole typu Block
Typ pole block umožňuje odkazovat atributem na jiný blok Blockstudio.
Pole odkazovaného bloku se vloží přímo pomocí stejného systému idStructure a overrides jako u vlastních polí.
V šablonách hodnota vrací vykreslený výstup bloku.
Definice
JSON
{
"blockstudio": {
"attributes": [
{
"id": "card",
"type": "block",
"block": "mytheme/card",
"idStructure": "card_{id}"
}
]
}
}
Tím se vloží pole odkazovaného bloku přímo. Pokud má mytheme/card pole heading a content, hostitelský blok získá atributy card_heading a card_content.
Použití v šabloně
V šablonách vrací hodnota pole vykreslený HTML odkazovaného bloku:
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>
Formát návratové hodnoty
Nastavte, co bude hodnota pole vracet, pomocí returnFormat:
| Hodnota | Popis |
|---|---|
rendered |
(výchozí) Vykreslený výstup HTML odkazovaného bloku |
data |
Asociativní pole hodnot atributů odkazovaného bloku |
both |
Objekt s rendered (HTML) a data (hodnoty atributů) |
JSON
{
"id": "card",
"type": "block",
"block": "mytheme/card",
"idStructure": "card_{id}",
"returnFormat": "data"
}
Přepisování hodnot
Přepište jednotlivé vlastnosti pole odkazovaného bloku stejně jako u vlastních polí:
JSON
{
"id": "card",
"type": "block",
"block": "mytheme/card",
"idStructure": "card_{id}",
"overrides": {
"heading": { "default": "Welcome", "label": "Card Title" },
"content": { "label": "Card Body" }
}
}
Kompatibilita
Pole typu block funguje s běžnými bloky i bloky komponent. Bloky komponent jsou přirozenou volbou, protože jsou navrženy pro programové vykreslování.