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

Переопределения

Blockstudio позволяет переопределять блоки на очень детальном уровне. Это может быть полезно для общих библиотек блоков, если нужно изменить поведение блока, не создавая его заново.

block.json

Чтобы начать, задайте имя переопределяемого блока в качестве ключа name, а ключу override присвойте значение true.

JSON
{
  "name": "blockstudio/my-block",
  "title": "My overridden block title",
  "blockstudio": {
    "override": true
  }
}

Если свойству override присвоено значение true, данные нового block.json будут объединены с данными исходного блока. Это позволяет переопределить любое свойство исходного блока.

Атрибуты

Атрибуты можно переопределять с помощью id или добавлять отдельно. Например, представим, что мы хотим переопределить атрибут width блока и добавить новый атрибут height.

JSON
{
  "name": "blockstudio/my-block",
  "title": "My overridden block title",
  "blockstudio": {
    "override": true,
    "attributes": [
      {
        "id": "width",
        "type": "number",
        "default": 280,
        "label": "Override width"
      },
      {
        "id": "height",
        "type": "number",
        "default": 280,
        "label": "New height"
      }
    ]
  }
}

Если найден атрибут с таким же id, его данные объединяются с исходным атрибутом. Атрибуты, которые не найдены, добавляются к блоку.

Предупреждение

При переопределении атрибутов необходимо указать type исходного атрибута, даже если оно не меняется.

Сложные структуры

При переопределении атрибутов со сложной структурой (повторителей, групп, вкладок и т. д.) необходимо указать полную структуру атрибута вплоть до элемента, который требуется переопределить.

JSON
{
  "name": "blockstudio/my-block",
  "blockstudio": {
    "override": true,
    "attributes": [
      {
        "id": "tabs",
        "type": "tabs",
        "tabs": [
          {
            "id": "tab1",
            "attributes": [
              {
                "key": "group1",
                "type": "group",
                "title": "Group",
                "attributes": [
                  {
                    "id": "text",
                    "type": "text",
                    "label": "Override text"
                  }
                ]
              }
            ]
          },
          {
            "id": "tab2",
            "title": "Override tab",
            "attributes": [
              {
                "id": "group",
                "type": "group",
                "title": "Group ID",
                "attributes": [
                  {
                    "id": "text",
                    "type": "text",
                    "label": "Override text"
                  }
                ]
              }
            ]
          }
        ]
      }
    ]
  }
}

Ресурсы

Файлы ресурсов заменяются, если их имена совпадают. Например, если в исходном блоке есть файл style.css, он будет заменен файлом style.css переопределяющего блока. Файлы с именами, не совпадающими с именами файлов исходного блока, будут добавлены к блоку.

Шаблон рендеринга

Шаблоны рендеринга можно переопределить, предоставив новый файл шаблона: index.php, index.twig или index.blade.php.

Блоки Twig

Шаблоны Twig можно переопределять на более детальном уровне с помощью функции переопределения блоков в Twig.

Представим следующий шаблон рендеринга для вымышленного блока изображения:

Twig
<h1>Images:</h1>
{% for image in a.images %}
  <div class="content">
    {% block image %}
      <img src="{{ image.url }}" class="image" />
    {% endblock %}
  </div>
{% endfor %}

Вместо полной замены шаблона можно воспользоваться функцией Twigextends, чтобы переопределить отдельные части шаблона и сохранить остальное без изменений.

Twig
{% extends 'index.twig' %}

{% block image %}
  <figure>
    <img src="{{ image.url }}" class="image" />
    <figcaption>{{ image.caption }}</figcaption>
  </figure>
{% endblock %}