Lohkokenttä
block-kenttätyypillä voit viitata toiseen Blockstudio-lohkoon attribuuttina. Viitatun lohkon kentät laajennetaan suoraan käyttämällä samaa idStructure– ja overrides-järjestelmää kuin mukautetuissa kentissä.
Mallipohjissa arvo palauttaa renderöidyn lohkosisällön.
Määritelmä
{
"blockstudio": {
"attributes": [
{
"id": "card",
"type": "block",
"block": "mytheme/card",
"idStructure": "card_{id}"
}
]
}
}
Tämä laajentaa viitatun lohkon kentät suoraan. Jos mytheme/card sisältää heading– ja content-kentät, isäntälohko saa card_heading– ja card_content-attribuutit.
Käyttö mallipohjassa
Mallipohjissa kentän arvo palauttaa viitatun lohkon renderöidyn HTML-tulosteen:
<div class="hero">
<h1>{{ a.title }}</h1>
{{ a.card }}
</div>
<div class="hero">
<h1><?php echo $a['title']; ?></h1>
<?php echo $a['card']; ?>
</div>
Palautusmuoto
Määritä kentän palauttama arvo asetuksella returnFormat:
| Arvo | Kuvaus |
|---|---|
rendered |
(oletus) Viitatun lohkon renderöity HTML-tuloste |
data |
Assosiatiivinen taulukko viitatun lohkon attribuuttiarvoista |
both |
Olio, jossa ovat rendered (HTML) ja data (attribuuttiarvot) |
{
"id": "card",
"type": "block",
"block": "mytheme/card",
"idStructure": "card_{id}",
"returnFormat": "data"
}
Ylikirjoitukset
Ylikirjoita viitatun lohkon yksittäisiä kenttäominaisuuksia samaan tapaan kuin mukautetuissa kentissä:
{
"id": "card",
"type": "block",
"block": "mytheme/card",
"idStructure": "card_{id}",
"overrides": {
"heading": { "default": "Welcome", "label": "Card Title" },
"content": { "label": "Card Body" }
}
}
Yhteensopivuus
Lohkokenttä toimii sekä tavallisten lohkojen että komponenttilohkojen kanssa. Komponenttilohkot sopivat tähän luontevasti, koska ne on suunniteltu ohjelmalliseen renderöintiin.