Перейти до вмісту

Перевизначення

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 %}

Замість заміни всього шаблону можна скористатися функцією Twig extends, щоб перевизначити окремі частини шаблону, залишивши решту без змін.

Twig
{% extends 'index.twig' %}

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