Polje bloka
Vrsta polja block vam omogoča, da se kot atribut sklicujete na drug blok Blockstudio.
Polja bloka, na katerega se sklicujete, so razširjena v vrstici z istim
sistemom idStructure in overrides kot polja po meri.
V predlogah vrednost vrne izrisani izhod bloka.
Opredelitev
{
"blockstudio": {
"attributes": [
{
"id": "card",
"type": "block",
"block": "mytheme/card",
"idStructure": "card_{id}"
}
]
}
}
S tem se polja bloka, na katerega se sklicujete, razširijo v vrstici. Če ima mytheme/card polji heading in content, gostiteljski blok dobi atributa card_heading in card_content.
Uporaba v predlogah
V predlogah vrednost polja vrne izrisani HTML bloka, na katerega se sklicujete:
<div class="hero">
<h1>{{ a.title }}</h1>
{{ a.card }}
</div>
<div class="hero">
<h1><?php echo $a['title']; ?></h1>
<?php echo $a['card']; ?>
</div>
Oblika vrnjene vrednosti
Z nastavitvijo returnFormat določite, kaj vrne vrednost polja:
| Vrednost | Opis |
|---|---|
rendered |
(privzeto) Izrisani izhod bloka HTML, na katerega se sklicujete |
data |
Asociativno polje vrednosti atributov bloka, na katerega se sklicujete |
both |
Objekt z vrednostjo rendered (HTML) in data (vrednosti atributov) |
{
"id": "card",
"type": "block",
"block": "mytheme/card",
"idStructure": "card_{id}",
"returnFormat": "data"
}
Preglasitve
Preglasite posamezne lastnosti polja iz bloka, na katerega se sklicujete, enako kot pri poljih po meri:
{
"id": "card",
"type": "block",
"block": "mytheme/card",
"idStructure": "card_{id}",
"overrides": {
"heading": { "default": "Welcome", "label": "Card Title" },
"content": { "label": "Card Body" }
}
}
Združljivost
Polje bloka deluje z navadnimi bloki in bloki komponent. Bloki komponent so naravna izbira, saj so zasnovani za programsko izrisovanje.