Перейти к содержимому

Поле блока

Тип поля block позволяет ссылаться на другой блок Blockstudio как на атрибут. Поля указанного блока разворачиваются непосредственно в строке с помощью той же системы idStructure и overrides, что и пользовательские поля. В шаблонах значение возвращает отрендеренный результат блока.

Определение

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

Поля указанного блока разворачиваются непосредственно в строке. Если у mytheme/card есть поля heading и content, в родительский блок добавляются атрибуты card_heading и card_content.

Использование в шаблоне

В шаблонах значение поля возвращает отрендеренный результат HTML указанного блока:

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>

Формат возвращаемого значения

Задайте формат возвращаемого значения поля с помощью returnFormat:

Значение Описание
rendered (по умолчанию) Отрендеренный вывод HTML указанного блока
data Ассоциативный массив значений атрибутов указанного блока
both Объект с rendered (HTML) и data (значениями атрибутов)
JSON
{
  "id": "card",
  "type": "block",
  "block": "mytheme/card",
  "idStructure": "card_{id}",
  "returnFormat": "data"
}

Переопределение значений

Переопределяйте отдельные свойства поля указанного блока так же, как для пользовательских полей:

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

Совместимость

Поле блока работает как с обычными блоками, так и с блоками-компонентами. Блоки-компоненты подходят для этого, поскольку рассчитаны на программный рендеринг.