Preskoči na vsebino

Preglasitve

Blockstudio omogoča preglasitev blokov na zelo podrobni ravni. To je lahko uporabno za knjižnice blokov v skupni rabi, kadar želite spremeniti vedenje bloka, ne da bi morali ustvariti povsem nov blok.

block.json

Za začetek nastavite ime bloka, ki ga želite preglasiti, kot ključ name, ključ override pa nastavite na true.

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

Ko je lastnost override nastavljena na true, se podatki iz novega block.json združijo s podatki iz izvirnega bloka. To pomeni, da lahko preglasite katero koli lastnost izvirnega bloka.

Atributi

Atribute lahko preglasite z id ali jih dodatno dodate. Predstavljajmo si na primer, da želimo preglasiti atribut width bloka in dodati nov atribut 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"
      }
    ]
  }
}

Ko je najden atribut z enakim id, se podatki združijo z izvirnim atributom. Atributi, ki jih ni mogoče najti, se dodajo bloku.

Opozorilo

Pri preglasitvi atributov morate navesti type izvirnega atributa, tudi če ostane enak.

Kompleksne strukture

Pri preglasitvi atributov s kompleksnimi strukturami (ponavljalniki, skupine, zavihki itd.) morate navesti celotno strukturo atributa vse do elementa, ki ga želite preglasiti.

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

Sredstva

Datoteke sredstev bodo zamenjane, če se ime datoteke ujema. Če na primer v izvirnem bloku obstaja datoteka style.css, jo bo v preglasitvenem bloku zamenjala datoteka style.css. Datoteke z imeni, ki se ne ujemajo z imeni datotek izvirnega bloka, bodo dodane bloku.

Predloga za izris

Predloge za izris lahko preglasite tako, da navedete novo datoteko predloge: index.php, index.twig ali index.blade.php.

Bloki Twig

Predloge Twig lahko preglasite na podrobnejši ravni z uporabo funkcije bloki v Twig.

Predstavljajmo si naslednjo predlogo za izris namišljenega slikovnega bloka:

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

Namesto zamenjave celotne predloge lahko uporabimo funkcijo Twig extends za preglasitev določenih delov predloge, preostali deli pa ostanejo nespremenjeni.

Twig
{% extends 'index.twig' %}

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