Přejít k obsahu

Přepsání

Blockstudio umožňuje přepisovat bloky na velmi podrobné úrovni. To může být užitečné u sdílených knihoven bloků, když chcete změnit chování bloku, aniž byste museli vytvářet nový blok od začátku.

block.json

Začněte tím, že jako klíč name nastavíte název bloku, který chcete přepsat, a klíč override nastavíte na hodnotu true.

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

Když je vlastnost override nastavena na hodnotu true, data nového block.json se sloučí s daty původního bloku. Můžete tak přepsat kteroukoli vlastnost původního bloku.

Atributy

Atributy lze přepsat pomocí id nebo přidat další. Představme si například, že chceme přepsat atribut width bloku a přidat 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"
      }
    ]
  }
}

Pokud se najde atribut se stejným id, jeho data se sloučí s původním atributem. Atributy, které se nenajdou, se přidají do bloku.

Varování

Při přepisování atributů musíte zadat type původního atributu, i když zůstane stejné.

Složité struktury

Při přepisování atributů se složitými strukturami (opakovači, skupinami, kartami atd.) musíte uvést úplnou strukturu atributu až po položku, kterou chcete přepsat.

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

Assety

Soubory zdrojů se nahradí, pokud se shoduje název souboru. Pokud například v původním bloku existuje soubor style.css, nahradí jej soubor style.css v bloku s přepsáním. Soubory s názvy, které neodpovídají souborům původního bloku, se do bloku přidají.

Vykreslovací šablona

Vykreslovací šablony lze přepsat novým souborem šablony: index.php, index.twig nebo index.blade.php.

Bloky Twig

Šablony Twig lze přepisovat na podrobnější úrovni pomocí funkce bloků v Twig.

Představme si následující vykreslovací šablonu fiktivního bloku obrázku:

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

Místo nahrazení celé šablony můžeme použít funkci extends v Twig a přepsat jen určité části šablony, zatímco zbytek zůstane beze změny.

Twig
{% extends 'index.twig' %}

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