İçeriğe geç

Blok Alanı

block alan türü, başka bir Blockstudio bloğa öznitelik olarak başvurmanızı sağlar. Başvurulan bloğun alanları, özel alanlarla aynı idStructure ve overrides sistemi kullanılarak satır içinde genişletilir. Şablonlarda değer, oluşturulan blok çıktısını döndürür.

Tanım

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

Bu işlem, başvurulan bloğun alanlarını satır içinde genişletir. mytheme/card bloğunda heading ve content alanları varsa ana blok card_heading ve card_content özniteliklerini alır.

Şablonlarda Kullanım

Şablonlarda alan değeri, başvurulan bloğun oluşturulmuş HTML çıktısını döndürür:

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>

Döndürülen Biçim

returnFormat kullanarak alan değerinin ne döndüreceğini denetleyin:

Değer Açıklama
rendered (varsayılan) Başvurulan bloğun oluşturulmuş HTML çıktısı
data Başvurulan bloğun öznitelik değerlerini içeren ilişkisel dizi
both rendered (HTML) ve data (öznitelik değerleri) içeren nesne
JSON
{
  "id": "card",
  "type": "block",
  "block": "mytheme/card",
  "idStructure": "card_{id}",
  "returnFormat": "data"
}

Geçersiz Kılmalar

Başvurulan bloğun tek tek alan özelliklerini, özel alanlardaki gibi geçersiz kılın:

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

Birlikte Çalıştıkları

Blok alanı hem normal bloklarla hem de bileşen bloklarla çalışır. Bileşen bloklar programatik olarak oluşturulmak üzere tasarlandığından, bu kullanım için uygundur.