Pāriet uz saturu

Aizstāšana

Blockstudio nodrošina iespēju aizstāt blokus ļoti detalizētā līmenī. Tas var noderēt koplietojamām bloku bibliotēkām, ja vēlaties mainīt bloka darbību, neveidojot pilnīgi jaunu bloku.

block.json

Lai sāktu, iestatiet tā bloka nosaukumu, kuru vēlaties aizstāt, kā atslēgu name un iestatiet atslēgu override uz true.

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

Ja īpašība override ir iestatīta uz true, jaunā block.json dati tiek sapludināti ar sākotnējā bloka datiem. Tas nozīmē, ka varat aizstāt jebkuru sākotnējā bloka īpašību.

Atribūti

Atribūtus var aizstāt ar id vai pievienot papildus. Piemēram, pieņemsim, ka vēlamies aizstāt bloka atribūtu width un pievienot jaunu atribūtu 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"
      }
    ]
  }
}

Ja tiek atrasts atribūts ar tādu pašu id, tā dati tiek sapludināti ar sākotnējā atribūta datiem. Blokam tiek pievienoti atribūti, kas nav atrasti.

Brīdinājums

Aizstājot atribūtus, jānorāda sākotnējā atribūta type, pat ja tas paliek nemainīgs.

Sarežģītas struktūras

Aizstājot atribūtus ar sarežģītām struktūrām (atkārtotāji, grupas, cilnes u. c.), jānorāda pilna atribūta struktūra līdz vienumam, kuru vēlaties aizstāt.

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

Līdzekļi

Resursu faili tiks aizstāti, ja to failu nosaukumi sakritīs. Piemēram, ja sākotnējā blokā ir fails style.css, to aizstās fails style.css aizstājošajā blokā. Blokam tiks pievienoti faili, kuru nosaukumi nesakrīt ar sākotnējā bloka failu nosaukumiem.

Renderēšanas veidne

Renderēšanas veidnes var aizstāt, norādot jaunu veidnes failu, piemēram, index.php, index.twig vai index.blade.php.

Twig bloki

Twig veidnes var aizstāt detalizētākā līmenī, izmantojot bloku funkciju Twig.

Pieņemsim, ka mums ir šāda izdomāta attēla bloka renderēšanas veidne:

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

Tā vietā, lai aizstātu visu veidni, varam izmantot Twig funkciju extends, lai aizstātu noteiktas veidnes daļas, pārējo saglabājot nemainītu.

Twig
{% extends 'index.twig' %}

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