Liigu sisu juurde

Plokiväli

block väljatüüp võimaldab viidata atribuudina teisele Blockstudio plokile. Viidatud ploki väljad laiendatakse tekstisiseselt, kasutades sama süsteemi idStructure ja overrides nagu kohandatud väljadel. Mallides tagastab väärtus renderdatud ploki väljundi.

Määratlus

JSON
{
  "blockstudio": {
    "attributes": [
      {
        "id": "card",
        "type": "block",
        "block": "mytheme/card",
        "idStructure": "card_{id}"
      }
    ]
  }
}

See laiendab viidatud ploki väljad tekstisiseselt. Kui mytheme/card-il on väljad heading ja content, saab hostplokk atribuudid card_heading ja card_content.

Kasutamine mallis

Mallides tagastab välja väärtus viidatud ploki renderdatud HTML-i:

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>

Tagastusvorming

Määrake atribuudiga returnFormat, mida välja väärtus tagastab:

Väärtus Kirjeldus
rendered (vaikimisi) Viidatud ploki renderdatud HTML-väljund
data Viidatud ploki atribuutide assotsiatiivne massiiv
both Objekt atribuudiga rendered (HTML) ja data (atribuudi väärtused)
JSON
{
  "id": "card",
  "type": "block",
  "block": "mytheme/card",
  "idStructure": "card_{id}",
  "returnFormat": "data"
}

Ülekirjutused

Kirjuta viidatud ploki üksikud väljaatribuudid üle samamoodi nagu kohandatud väljadel:

JSON
{
  "id": "card",
  "type": "block",
  "block": "mytheme/card",
  "idStructure": "card_{id}",
  "overrides": {
    "heading": { "default": "Welcome", "label": "Card Title" },
    "content": { "label": "Card Body" }
  }
}

Ühilduvus

Plokiväli töötab nii tavaliste plokkidega kui ka komponentplokkidega. Komponentplokid sobivad selleks hästi, kuna need on loodud programmiliseks renderdamiseks.