Bloka lauks
block lauka tips ļauj atsaukties uz citu Blockstudio bloku kā atribūtu. Atsauktā bloka lauki tiek iekļauti, izmantojot to pašu idStructure un overrides sistēmu, ko pielāgotie lauki.
Veidnēs vērtība atgriež renderēto bloka izvadi.
Definīcija
{
"blockstudio": {
"attributes": [
{
"id": "card",
"type": "block",
"block": "mytheme/card",
"idStructure": "card_{id}"
}
]
}
}
Tādējādi atsauktā bloka lauki tiek iekļauti. Ja mytheme/card ir lauki heading un content, resursdatora bloks saņem atribūtus card_heading un card_content.
Izmantošana veidnēs
Veidnēs lauka vērtība atgriež atsauktā bloka renderēto 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>
Atgriežamais formāts
Nosakiet, ko lauka vērtība atgriež, izmantojot returnFormat:
| Vērtība | Apraksts |
|---|---|
rendered |
(noklusējums) Atsauktā bloka renderētā HTML izvade |
data |
Asociatīvs masīvs ar atsauktā bloka atribūtu vērtībām |
both |
Objekts ar rendered (HTML) un data (atribūtu vērtībām) |
{
"id": "card",
"type": "block",
"block": "mytheme/card",
"idStructure": "card_{id}",
"returnFormat": "data"
}
Pārrakstīšana
Pārrakstiet atsevišķu lauku rekvizītus no atsauktā bloka tāpat kā pielāgotiem laukiem:
{
"id": "card",
"type": "block",
"block": "mytheme/card",
"idStructure": "card_{id}",
"overrides": {
"heading": { "default": "Welcome", "label": "Card Title" },
"content": { "label": "Card Body" }
}
}
Darbojas ar
Bloka lauks darbojas gan ar parastajiem blokiem, gan ar komponentu blokiem. Komponentu bloki ir piemēroti šim nolūkam, jo tie ir paredzēti programmatiskai renderēšanai.