Към съдържанието

Поле за блок

Типът поле 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" }
  }
}

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

Полето за блок работи както с обикновени блокове, така и с компонентни блокове. Компонентните блокове са подходящи, тъй като са създадени за програмно визуализиране.