Kolom Blok
Jenis kolom block memungkinkan Anda merujuk blok Blockstudio lain sebagai atribut.
Kolom blok yang dirujuk diperluas secara sebaris menggunakan sistem idStructure dan overrides yang sama seperti kolom khusus.
Di template, nilainya mengembalikan output blok yang telah dirender.
Definisi
{
"blockstudio": {
"attributes": [
{
"id": "card",
"type": "block",
"block": "mytheme/card",
"idStructure": "card_{id}"
}
]
}
}
Kolom blok yang dirujuk akan diperluas secara sebaris. Jika mytheme/card memiliki kolom heading dan content, blok host akan memperoleh atribut card_heading dan card_content.
Penggunaan Template
Di template, nilai kolom mengembalikan HTML hasil render dari blok yang dirujuk:
<div class="hero">
<h1>{{ a.title }}</h1>
{{ a.card }}
</div>
<div class="hero">
<h1><?php echo $a['title']; ?></h1>
<?php echo $a['card']; ?>
</div>
Format Nilai Kembalian
Atur nilai yang dikembalikan kolom menggunakan returnFormat:
| Nilai | Deskripsi |
|---|---|
rendered |
(default) Output HTML hasil render dari blok yang dirujuk |
data |
Array asosiatif berisi nilai atribut blok yang dirujuk |
both |
Objek dengan rendered (HTML) dan data (nilai atribut) |
{
"id": "card",
"type": "block",
"block": "mytheme/card",
"idStructure": "card_{id}",
"returnFormat": "data"
}
Penggantian
Ganti properti kolom satu per satu dari blok yang dirujuk, seperti halnya kolom khusus:
{
"id": "card",
"type": "block",
"block": "mytheme/card",
"idStructure": "card_{id}",
"overrides": {
"heading": { "default": "Welcome", "label": "Card Title" },
"content": { "label": "Card Body" }
}
}
Kompatibilitas
Kolom blok berfungsi dengan blok biasa maupun blok komponen. Blok komponen sangat cocok karena dirancang untuk rendering secara programatis.