Поле блока
Тип поля 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" }
}
}
Сумісність
Поле блока працює зі звичайними блоками та блоками-компонентами. Блоки-компоненти добре підходять для цього, оскільки створені для програмного рендерингу.