Przejdź do treści

Pole bloku

Typ pola block pozwala wskazać inny blok Blockstudio jako atrybut. Pola wskazanego bloku są rozwijane w tekście za pomocą tego samego systemu idStructure i overrides co pola niestandardowe. W szablonach wartość zwraca wyrenderowany wynik bloku.

Definicja

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

Pola wskazanego bloku są rozwijane w tekście. Jeśli mytheme/card zawiera pola heading i content, blok nadrzędny otrzyma atrybuty card_heading i card_content.

Użycie w szablonie

W szablonach wartość pola zwraca wyrenderowaną zawartość HTML wskazanego 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>

Format zwracanej wartości

Za pomocą returnFormat określ, co zwraca wartość pola:

Wartość Opis
rendered (domyślnie) Wyrenderowany wynik HTML wskazanego bloku
data Tablica asocjacyjna wartości atrybutów wskazanego bloku
both Obiekt zawierający rendered (HTML) i data (wartości atrybutów)
JSON
{
  "id": "card",
  "type": "block",
  "block": "mytheme/card",
  "idStructure": "card_{id}",
  "returnFormat": "data"
}

Nadpisywanie

Nadpisuj pojedyncze właściwości pola wskazanego bloku, tak jak w przypadku pól niestandardowych:

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

Zgodność

Pole bloku działa zarówno ze zwykłymi blokami, jak i blokami komponentów. Bloki komponentów sprawdzają się tu naturalnie, ponieważ są przeznaczone do renderowania programowego.