Pereiti prie turinio

Perrašymai

Blockstudio suteikia galimybę itin tiksliai perrašyti blokus. Tai gali būti naudinga bendrinamoms blokų bibliotekoms, kai norite pakeisti bloko veikimą nekurdami naujo bloko nuo pradžių.

block.json

Norėdami pradėti, nustatykite perrašomo bloko pavadinimą kaip raktą name, o raktą override nustatykite į true.

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

Kai ypatybė override nustatyta į true, naujojo block.json duomenys sujungiami su pradinio bloko duomenimis. Tai reiškia, kad galite perrašyti bet kurią pradinio bloko ypatybę.

Atributai

Atributus galima perrašyti naudojant id arba papildomai pridėti. Pavyzdžiui, įsivaizduokime, kad norime perrašyti bloko atributą width ir pridėti naują 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"
      }
    ]
  }
}

Radus atributą su tokiu pačiu id, jo duomenys sujungiami su pradinio atributo duomenimis. Nerasti atributai pridedami prie bloko.

Įspėjimas

Perrašydami atributus, turite nurodyti pradinio atributo type, net jei jis nesikeičia.

Sudėtingos struktūros

Perrašydami sudėtingų struktūrų atributus (pasikartojančių laukų, grupių, skirtukų ir kt.), turite pateikti visą atributo struktūrą iki elemento, kurį reikia perrašyti.

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

Ištekliai

Išteklių failai bus pakeisti, kai sutaps failo pavadinimas. Pavyzdžiui, jei pradiniame bloke yra failas style.css, jį pakeis perrašančio bloko failas style.css. Failai, kurių pavadinimai nesutampa su pradinio bloko failais, bus pridėti prie bloko.

Atvaizdavimo šablonas

Atvaizdavimo šablonus galima perrašyti pateikiant naują šablono failą: index.php, index.twig arba index.blade.php.

Twig blokai

Twig šablonus galima perrašyti dar tiksliau, naudojant funkciją blokų iš Twig.

Įsivaizduokime tokį išgalvoto vaizdo bloko atvaizdavimo šabloną:

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

Užuot pakeitę visą šabloną, galime naudoti Twig funkciją extends, kad perrašytume tam tikras šablono dalis, o likusias paliktume nepakeistas.

Twig
{% extends 'index.twig' %}

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