Lewati ke konten

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

JSON
{
  "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:

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>

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)
JSON
{
  "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:

JSON
{
  "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.