Поле за блок
Типът поле 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" }
}
}
Съвместимост
Полето за блок работи както с обикновени блокове, така и с компонентни блокове. Компонентните блокове са подходящи, тъй като са създадени за програмно визуализиране.