Zum Inhalt springen

Blockfeld

Mit dem Feldtyp block kannst du in einem Attribut auf einen anderen Blockstudio-Block verweisen. Die Felder des referenzierten Blocks werden inline mit demselben System für idStructure und overrides wie bei benutzerdefinierten Feldern erweitert. In Vorlagen gibt der Wert die gerenderte Blockausgabe zurück.

Definition

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

Dadurch werden die Felder des referenzierten Blocks inline erweitert. Wenn mytheme/card über die Felder heading und content verfügt, erhält der übergeordnete Block die Attribute card_heading und card_content.

Verwendung in Vorlagen

In Vorlagen gibt der Feldwert die gerenderte Ausgabe von HTML des referenzierten Blocks zurück:

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>

Rückgabeformat

Mit returnFormat steuerst du, was der Feldwert zurückgibt:

Wert Beschreibung
rendered (Standard) Gerenderte HTML-Ausgabe des referenzierten Blocks
data Ein assoziatives Array mit den Attributwerten des referenzierten Blocks
both Ein Objekt mit rendered (HTML) und data (Attributwerte)
JSON
{
  "id": "card",
  "type": "block",
  "block": "mytheme/card",
  "idStructure": "card_{id}",
  "returnFormat": "data"
}

Überschreibungen

Überschreibe einzelne Feldeigenschaften des referenzierten Blocks wie bei benutzerdefinierten Feldern:

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

Funktioniert mit

Das Blockfeld funktioniert sowohl mit regulären Blöcken als auch mit Komponentenblöcken. Komponentenblöcke eignen sich besonders gut, da sie für die programmatische Darstellung entwickelt wurden.