Siirry sisältöön

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ä

JSON
{
  "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:

Twig
<div class="hero">
  <h1>{{ a.title }}</h1>
  {{ a.card }}
</div>
PHP
<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)
JSON
{
  "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ä:

JSON
{
  "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.