Ugrás a tartalomhoz

Blokkmező

A block mezőtípus lehetővé teszi, hogy egy másik Blockstudio blokkra attribútumként hivatkozzon. A hivatkozott blokk mezői ugyanazzal a idStructure és overrides rendszerrel bomlanak ki inline, mint az egyéni mezők esetében. A sablonokban az érték a renderelt blokktartalmat adja vissza.

Definíció

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

Ez inline módon bontja ki a hivatkozott blokk mezőit. Ha a mytheme/card blokknak vannak heading és content mezői, a befogadó blokk megkapja a card_heading és card_content attribútumokat.

Használat sablonban

A sablonokban a mező értéke a hivatkozott blokk renderelt HTML tartalmát adja vissza:

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>

Visszatérési formátum

A mező által visszaadott érték a returnFormat segítségével szabályozható:

Érték Leírás
rendered (alapértelmezett) A hivatkozott blokk renderelt HTML kimenete
data A hivatkozott blokk attribútumértékeit tartalmazó asszociatív tömb
both Objektum, amelynek rendered (HTML) és data (attribútumértékek) tulajdonságai vannak
JSON
{
  "id": "card",
  "type": "block",
  "block": "mytheme/card",
  "idStructure": "card_{id}",
  "returnFormat": "data"
}

Felülbírálások

A hivatkozott blokk egyes mezőtulajdonságait ugyanúgy felülbírálhatja, mint az egyéni mezőknél:

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

Kompatibilitás

A blokkmező hagyományos blokkokkal és komponensblokkokkal is működik. A komponensblokkok természetes választást jelentenek, mivel programozott renderelésre készültek.