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
{
"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:
<div class="hero">
<h1>{{ a.title }}</h1>
{{ a.card }}
</div>
<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) |
{
"id": "card",
"type": "block",
"block": "mytheme/card",
"idStructure": "card_{id}",
"returnFormat": "data"
}
Überschreibungen
Überschreibe einzelne Feldeigenschaften des referenzierten Blocks wie bei benutzerdefinierten Feldern:
{
"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.