Preskočiť na obsah

Pole bloku

Typ poľa block umožňuje odkazovať na iný blok Blockstudio ako na atribút. Polia odkazovaného bloku sa vložia priamo pomocou rovnakého systému idStructure a overrides ako pri vlastných poliach. V šablónach hodnota vráti vykreslený výstup bloku.

Definícia

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

Tým sa polia odkazovaného bloku vložia priamo. Ak má mytheme/card polia heading a content, hostiteľský blok získa atribúty card_heading a card_content.

Použitie v šablóne

V šablónach hodnota poľa vráti vykreslený obsah HTML odkazovaného bloku:

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>

Formát návratovej hodnoty

Pomocou returnFormat určte, akú hodnotu má pole vrátiť:

Hodnota Opis
rendered (predvolené) Vykreslený výstup HTML odkazovaného bloku
data Asociatívne pole hodnôt atribútov odkazovaného bloku
both Objekt s hodnotami rendered (HTML) a data (hodnoty atribútov)
JSON
{
  "id": "card",
  "type": "block",
  "block": "mytheme/card",
  "idStructure": "card_{id}",
  "returnFormat": "data"
}

Prepísanie hodnôt

Prepíšte jednotlivé vlastnosti polí odkazovaného bloku rovnako ako pri vlastných poliach:

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

Kompatibilita

Pole bloku funguje s bežnými blokmi aj s komponentovými blokmi. Komponentové bloky sú vhodné na tento účel, pretože sú navrhnuté na programové vykresľovanie.