Přejít k obsahu

Pole typu Block

Typ pole block umožňuje odkazovat atributem na jiný blok Blockstudio. Pole odkazovaného bloku se vloží přímo pomocí stejného systému idStructure a overrides jako u vlastních polí. V šablonách hodnota vrací vykreslený výstup bloku.

Definice

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

Tím se vloží pole odkazovaného bloku přímo. Pokud má mytheme/card pole heading a content, hostitelský blok získá atributy card_heading a card_content.

Použití v šabloně

V šablonách vrací hodnota pole vykreslený 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ávratové hodnoty

Nastavte, co bude hodnota pole vracet, pomocí returnFormat:

Hodnota Popis
rendered (výchozí) Vykreslený výstup HTML odkazovaného bloku
data Asociativní pole hodnot atributů odkazovaného bloku
both Objekt s rendered (HTML) a data (hodnoty atributů)
JSON
{
  "id": "card",
  "type": "block",
  "block": "mytheme/card",
  "idStructure": "card_{id}",
  "returnFormat": "data"
}

Přepisování hodnot

Přepište jednotlivé vlastnosti pole odkazovaného bloku stejně jako u vlastních polí:

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

Kompatibilita

Pole typu block funguje s běžnými bloky i bloky komponent. Bloky komponent jsou přirozenou volbou, protože jsou navrženy pro programové vykreslování.