Treci la conținut

Suprascrieri

Blockstudio include posibilitatea de a suprascrie blocuri la un nivel foarte granular. Acest lucru poate fi util pentru bibliotecile de blocuri partajate, când doriți să schimbați comportamentul unui bloc fără a crea unul nou de la zero.

block.json

Pentru a începe, setați numele blocului pe care doriți să-l suprascrieți drept cheia name și setați cheia override la true.

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

Când proprietatea override este setată la true, datele din noul block.json sunt îmbinate cu datele blocului original. Astfel, puteți suprascrie orice proprietate a blocului original.

Atribute

Atributele pot fi suprascrise prin id sau pot fi adăugate în plus. De exemplu, să presupunem că dorim să suprascriem atributul width al unui bloc și să adăugăm un atribut height nou.

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

Când este găsit un atribut cu același id, datele vor fi îmbinate cu atributul original. Atributele care nu sunt găsite vor fi adăugate blocului.

Avertisment

Când suprascrieți atribute, trebuie să furnizați type atributului original, chiar dacă rămâne neschimbat.

Structuri complexe

Când suprascrieți atribute cu structuri complexe (repetitoare, grupuri, file etc.), trebuie să furnizați structura completă a atributului până la elementul care trebuie suprascris.

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

Resurse

Fișierele cu resurse sunt înlocuite când numele fișierului corespunde. De exemplu, dacă există un fișier style.css în blocul original, acesta va fi înlocuit cu fișierul style.css din blocul care îl suprascrie. Fișierele cu nume care nu corespund celor din blocul original vor fi adăugate blocului.

Șablonul de randare

Șabloanele de randare pot fi suprascrise furnizând un nou fișier de șablon: index.php, index.twig sau index.blade.php.

Blocuri Twig

Șabloanele Twig pot fi suprascrise la un nivel mai granular folosind funcționalitatea bloc din Twig.

Să presupunem că avem următorul șablon de randare pentru un bloc fictiv de imagine:

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

În loc să înlocuim întregul șablon, putem folosi funcționalitatea extends din Twig pentru a suprascrie anumite părți ale șablonului, păstrând restul neschimbat.

Twig
{% extends 'index.twig' %}

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