Blokkmező
A block mezőtípus lehetővé teszi, hogy egy másik Blockstudio blokkra attribútumként hivatkozzon. A hivatkozott blokk mezői ugyanazzal a idStructure és overrides rendszerrel bomlanak ki inline, mint az egyéni mezők esetében.
A sablonokban az érték a renderelt blokktartalmat adja vissza.
Definíció
{
"blockstudio": {
"attributes": [
{
"id": "card",
"type": "block",
"block": "mytheme/card",
"idStructure": "card_{id}"
}
]
}
}
Ez inline módon bontja ki a hivatkozott blokk mezőit. Ha a mytheme/card blokknak vannak heading és content mezői, a befogadó blokk megkapja a card_heading és card_content attribútumokat.
Használat sablonban
A sablonokban a mező értéke a hivatkozott blokk renderelt HTML tartalmát adja vissza:
<div class="hero">
<h1>{{ a.title }}</h1>
{{ a.card }}
</div>
<div class="hero">
<h1><?php echo $a['title']; ?></h1>
<?php echo $a['card']; ?>
</div>
Visszatérési formátum
A mező által visszaadott érték a returnFormat segítségével szabályozható:
| Érték | Leírás |
|---|---|
rendered |
(alapértelmezett) A hivatkozott blokk renderelt HTML kimenete |
data |
A hivatkozott blokk attribútumértékeit tartalmazó asszociatív tömb |
both |
Objektum, amelynek rendered (HTML) és data (attribútumértékek) tulajdonságai vannak |
{
"id": "card",
"type": "block",
"block": "mytheme/card",
"idStructure": "card_{id}",
"returnFormat": "data"
}
Felülbírálások
A hivatkozott blokk egyes mezőtulajdonságait ugyanúgy felülbírálhatja, mint az egyéni mezőknél:
{
"id": "card",
"type": "block",
"block": "mytheme/card",
"idStructure": "card_{id}",
"overrides": {
"heading": { "default": "Welcome", "label": "Card Title" },
"content": { "label": "Card Body" }
}
}
Kompatibilitás
A blokkmező hagyományos blokkokkal és komponensblokkokkal is működik. A komponensblokkok természetes választást jelentenek, mivel programozott renderelésre készültek.