Bloko laukas
block lauko tipas leidžia nurodyti kitą Blockstudio bloką kaip atributą. Nurodyto bloko laukai išplečiami tiesiogiai pagal tą pačią idStructure ir overrides sistemą kaip pasirinktiniai laukai.
Šablonuose reikšmė grąžina atvaizduotą bloko išvestį.
Apibrėžimas
{
"blockstudio": {
"attributes": [
{
"id": "card",
"type": "block",
"block": "mytheme/card",
"idStructure": "card_{id}"
}
]
}
}
Taip nurodyto bloko laukai išplečiami tiesiogiai. Jei mytheme/card yra heading ir content laukai, pagrindinis blokas gauna atributus card_heading ir card_content.
Naudojimas šablonuose
Šablonuose lauko reikšmė grąžina atvaizduotą nurodyto bloko HTML:
<div class="hero">
<h1>{{ a.title }}</h1>
{{ a.card }}
</div>
<div class="hero">
<h1><?php echo $a['title']; ?></h1>
<?php echo $a['card']; ?>
</div>
Grąžinamas formatas
Nustatykite, ką grąžina lauko reikšmė, naudodami returnFormat:
| Reikšmė | Aprašymas |
|---|---|
rendered |
(numatytoji) Atvaizduota nurodyto bloko HTML išvestis |
data |
Asociatyvusis masyvas su nurodyto bloko atributų reikšmėmis |
both |
Objektas su rendered (HTML) ir data (atributų reikšmės) |
{
"id": "card",
"type": "block",
"block": "mytheme/card",
"idStructure": "card_{id}",
"returnFormat": "data"
}
Pakeitimai
Pakeiskite atskirų laukų savybes nurodytame bloke, kaip ir pasirinktiniuose laukuose:
{
"id": "card",
"type": "block",
"block": "mytheme/card",
"idStructure": "card_{id}",
"overrides": {
"heading": { "default": "Welcome", "label": "Card Title" },
"content": { "label": "Card Body" }
}
}
Suderinamumas
Bloko laukas veikia ir su įprastais blokais, ir su komponentų blokais. Komponentų blokai yra tinkamas pasirinkimas, nes jie skirti programiniam atvaizdavimui.