Plokiväli
block väljatüüp võimaldab viidata atribuudina teisele Blockstudio plokile.
Viidatud ploki väljad laiendatakse tekstisiseselt, kasutades sama süsteemi idStructure ja overrides nagu kohandatud väljadel.
Mallides tagastab väärtus renderdatud ploki väljundi.
Määratlus
{
"blockstudio": {
"attributes": [
{
"id": "card",
"type": "block",
"block": "mytheme/card",
"idStructure": "card_{id}"
}
]
}
}
See laiendab viidatud ploki väljad tekstisiseselt. Kui mytheme/card-il on väljad heading ja content, saab hostplokk atribuudid card_heading ja card_content.
Kasutamine mallis
Mallides tagastab välja väärtus viidatud ploki renderdatud HTML-i:
<div class="hero">
<h1>{{ a.title }}</h1>
{{ a.card }}
</div>
<div class="hero">
<h1><?php echo $a['title']; ?></h1>
<?php echo $a['card']; ?>
</div>
Tagastusvorming
Määrake atribuudiga returnFormat, mida välja väärtus tagastab:
| Väärtus | Kirjeldus |
|---|---|
rendered |
(vaikimisi) Viidatud ploki renderdatud HTML-väljund |
data |
Viidatud ploki atribuutide assotsiatiivne massiiv |
both |
Objekt atribuudiga rendered (HTML) ja data (atribuudi väärtused) |
{
"id": "card",
"type": "block",
"block": "mytheme/card",
"idStructure": "card_{id}",
"returnFormat": "data"
}
Ülekirjutused
Kirjuta viidatud ploki üksikud väljaatribuudid üle samamoodi nagu kohandatud väljadel:
{
"id": "card",
"type": "block",
"block": "mytheme/card",
"idStructure": "card_{id}",
"overrides": {
"heading": { "default": "Welcome", "label": "Card Title" },
"content": { "label": "Card Body" }
}
}
Ühilduvus
Plokiväli töötab nii tavaliste plokkidega kui ka komponentplokkidega. Komponentplokid sobivad selleks hästi, kuna need on loodud programmiliseks renderdamiseks.