Przejdź do treści

Nadpisywanie

Blockstudio umożliwia nadpisywanie bloków z dużą szczegółowością. Przydaje się to w przypadku współdzielonych bibliotek bloków, gdy chcesz zmienić działanie bloku bez tworzenia go od podstaw.

block.json

Aby rozpocząć, ustaw nazwę bloku, który chcesz nadpisać, jako klucz name i ustaw klucz override na true.

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

Gdy właściwość override ma wartość true, dane z nowego block.json zostaną scalone z danymi oryginalnego bloku. Oznacza to, że możesz nadpisać dowolną właściwość oryginalnego bloku.

Atrybuty

Atrybuty można nadpisywać za pomocą id lub dodawać. Załóżmy na przykład, że chcemy nadpisać atrybut width bloku i dodać nowy atrybut 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"
      }
    ]
  }
}

Gdy zostanie znaleziony atrybut o tej samej id, jego dane zostaną scalone z oryginalnym atrybutem. Atrybuty, których nie znaleziono, zostaną dodane do bloku.

Ostrzeżenie

Podczas nadpisywania atrybutów musisz podać type oryginalnego atrybutu, nawet jeśli pozostaje bez zmian.

Złożone struktury

Podczas nadpisywania atrybutów o złożonej strukturze (pola powtarzalne, grupy, karty itp.) musisz podać pełną strukturę atrybutu aż do elementu, który ma zostać nadpisany.

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"
                  }
                ]
              }
            ]
          }
        ]
      }
    ]
  }
}

Zasoby

Pliki zasobów zostaną zastąpione, jeśli ich nazwy są zgodne. Na przykład, jeśli w oryginalnym bloku istnieje plik style.css, zostanie zastąpiony plikiem style.css z bloku nadpisującego. Pliki o nazwach niepasujących do oryginalnego bloku zostaną dodane do bloku.

Szablon renderowania

Szablony renderowania można nadpisać, dostarczając nowy plik szablonu: index.php, index.twig lub index.blade.php.

Bloki Twig

Szablony Twig można nadpisywać z większą szczegółowością za pomocą funkcji bloków w Twig.

Załóżmy, że mamy następujący szablon renderowania fikcyjnego bloku obrazu:

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

Zamiast zastępować cały szablon, możemy użyć funkcji Twig extends, aby nadpisać wybrane części szablonu i zachować pozostałe bez zmian.

Twig
{% extends 'index.twig' %}

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