Pole bloku
Typ poľa block umožňuje odkazovať na iný blok Blockstudio ako na atribút. Polia odkazovaného bloku sa vložia priamo pomocou rovnakého systému idStructure a overrides ako pri vlastných poliach.
V šablónach hodnota vráti vykreslený výstup bloku.
Definícia
{
"blockstudio": {
"attributes": [
{
"id": "card",
"type": "block",
"block": "mytheme/card",
"idStructure": "card_{id}"
}
]
}
}
Tým sa polia odkazovaného bloku vložia priamo. Ak má mytheme/card polia heading a content, hostiteľský blok získa atribúty card_heading a card_content.
Použitie v šablóne
V šablónach hodnota poľa vráti vykreslený obsah HTML odkazovaného bloku:
<div class="hero">
<h1>{{ a.title }}</h1>
{{ a.card }}
</div>
<div class="hero">
<h1><?php echo $a['title']; ?></h1>
<?php echo $a['card']; ?>
</div>
Formát návratovej hodnoty
Pomocou returnFormat určte, akú hodnotu má pole vrátiť:
| Hodnota | Opis |
|---|---|
rendered |
(predvolené) Vykreslený výstup HTML odkazovaného bloku |
data |
Asociatívne pole hodnôt atribútov odkazovaného bloku |
both |
Objekt s hodnotami rendered (HTML) a data (hodnoty atribútov) |
{
"id": "card",
"type": "block",
"block": "mytheme/card",
"idStructure": "card_{id}",
"returnFormat": "data"
}
Prepísanie hodnôt
Prepíšte jednotlivé vlastnosti polí odkazovaného bloku rovnako ako pri vlastných poliach:
{
"id": "card",
"type": "block",
"block": "mytheme/card",
"idStructure": "card_{id}",
"overrides": {
"heading": { "default": "Welcome", "label": "Card Title" },
"content": { "label": "Card Body" }
}
}
Kompatibilita
Pole bloku funguje s bežnými blokmi aj s komponentovými blokmi. Komponentové bloky sú vhodné na tento účel, pretože sú navrhnuté na programové vykresľovanie.