Поле блока
Тип поля block позволяет ссылаться на другой блок Blockstudio как на атрибут. Поля указанного блока разворачиваются непосредственно в строке с помощью той же системы idStructure и overrides, что и пользовательские поля.
В шаблонах значение возвращает отрендеренный результат блока.
Определение
{
"blockstudio": {
"attributes": [
{
"id": "card",
"type": "block",
"block": "mytheme/card",
"idStructure": "card_{id}"
}
]
}
}
Поля указанного блока разворачиваются непосредственно в строке. Если у mytheme/card есть поля heading и content, в родительский блок добавляются атрибуты card_heading и card_content.
Использование в шаблоне
В шаблонах значение поля возвращает отрендеренный результат HTML указанного блока:
<div class="hero">
<h1>{{ a.title }}</h1>
{{ a.card }}
</div>
<div class="hero">
<h1><?php echo $a['title']; ?></h1>
<?php echo $a['card']; ?>
</div>
Формат возвращаемого значения
Задайте формат возвращаемого значения поля с помощью returnFormat:
| Значение | Описание |
|---|---|
rendered |
(по умолчанию) Отрендеренный вывод HTML указанного блока |
data |
Ассоциативный массив значений атрибутов указанного блока |
both |
Объект с rendered (HTML) и data (значениями атрибутов) |
{
"id": "card",
"type": "block",
"block": "mytheme/card",
"idStructure": "card_{id}",
"returnFormat": "data"
}
Переопределение значений
Переопределяйте отдельные свойства поля указанного блока так же, как для пользовательских полей:
{
"id": "card",
"type": "block",
"block": "mytheme/card",
"idStructure": "card_{id}",
"overrides": {
"heading": { "default": "Welcome", "label": "Card Title" },
"content": { "label": "Card Body" }
}
}
Совместимость
Поле блока работает как с обычными блоками, так и с блоками-компонентами. Блоки-компоненты подходят для этого, поскольку рассчитаны на программный рендеринг.