Ga naar de inhoud

Blokveld

Met het veldtype block kun je naar een ander Blockstudio-blok verwijzen als attribuut. De velden van het blok waarnaar wordt verwezen, worden inline uitgebreid met hetzelfde systeem voor idStructure en overrides als bij aangepaste velden. In templates retourneert de waarde de gerenderde blokuitvoer.

Definitie

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

Hiermee worden de velden van het blok waarnaar wordt verwezen inline uitgebreid. Als mytheme/card velden heading en content heeft, krijgt het bovenliggende blok de attributen card_heading en card_content.

Gebruik in templates

In templates retourneert de veldwaarde de gerenderde HTML van het blok waarnaar wordt verwezen:

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>

Retourformaat

Bepaal met returnFormat wat de veldwaarde retourneert:

Waarde Beschrijving
rendered (standaard) De gerenderde uitvoer HTML van het blok waarnaar wordt verwezen
data Een associatieve array met de attribuutwaarden van het blok waarnaar wordt verwezen
both Een object met rendered (HTML) en data (attribuutwaarden)
JSON
{
  "id": "card",
  "type": "block",
  "block": "mytheme/card",
  "idStructure": "card_{id}",
  "returnFormat": "data"
}

Overschrijvingen

Overschrijf afzonderlijke veldeigenschappen van het blok waarnaar wordt verwezen, net als bij aangepaste velden:

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

Werkt met

Het blokveld werkt met zowel gewone blokken als componentblokken. Componentblokken zijn hiervoor een goede keuze, omdat ze bedoeld zijn om programmatisch te worden gerenderd.