Hoppa till innehåll

Blockfält

Fälttypen block gör att du kan använda ett annat Blockstudio-block som attribut. Det refererade blockets fält expanderas direkt med samma system för idStructure och overrides som anpassade fält. I mallar returnerar värdet blockets renderade utdata.

Definition

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

Detta expanderar det refererade blockets fält direkt. Om mytheme/card har fälten heading och content får värdblocket attributen card_heading och card_content.

Användning i mallar

I mallar returnerar fältvärdet det renderade HTML från det refererade blocket:

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>

Returformat

Styr vad fältvärdet returnerar med returnFormat:

Värde Beskrivning
rendered (standard) Det renderade HTML-utdata som det refererade blocket ger
data En associativ array med det refererade blockets attributvärden
both Ett objekt med rendered (HTML) och data (attributvärden)
JSON
{
  "id": "card",
  "type": "block",
  "block": "mytheme/card",
  "idStructure": "card_{id}",
  "returnFormat": "data"
}

Åsidosättningar

Åsidosätt enskilda fältegenskaper från det refererade blocket, precis som för anpassade fält:

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

Fungerar med

Blockfält fungerar med både vanliga block och komponentblock. Komponentblock passar bra eftersom de är utformade för programmatisk rendering.