Ugrás a tartalomhoz

Felülbírálások

A Blockstudio lehetővé teszi a blokkok rendkívül részletes szintű felülbírálását. Ez hasznos lehet megosztott blokk-könyvtárak esetén, ha egy blokk viselkedését új blokk létrehozása nélkül szeretné megváltoztatni.

block.json

Kezdésként állítsa a felülbírálni kívánt blokk nevét a name kulcs értékeként, a override kulcs értékét pedig állítsa erre: true.

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

Ha a override tulajdonság értéke true, az új block.json adatai összeolvadnak az eredeti blokk adataival. Ez azt jelenti, hogy az eredeti blokk bármely tulajdonságát felülbírálhatja.

Attribútumok

Az attribútumokat a id segítségével felül lehet bírálni, vagy új attribútumokként is hozzá lehet adni. Tegyük fel például, hogy felül szeretnénk bírálni egy blokk width attribútumát, és hozzáadnánk egy új height attribútumot.

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

Ha a rendszer azonos id attribútumot talál, az adatok összeolvadnak az eredeti attribútummal. A meg nem talált attribútumok hozzáadódnak a blokkhoz.

Figyelmeztetés

Attribútumok felülbírálásakor meg kell adnia az eredeti attribútum type értékét akkor is, ha az változatlan marad.

Összetett struktúrák

Összetett struktúrájú attribútumok (ismétlők, csoportok, lapfülek stb.) felülbírálásakor az attribútum teljes struktúráját meg kell adnia egészen a felülbírálandó elemig.

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

Erőforrások

Az eszközfájlok akkor cserélődnek le, ha a fájlnév egyezik. Ha például az eredeti blokkban van egy style.css fájl, azt a felülbíráló blokkban lévő style.css fájl váltja fel. Az eredeti blokk fájlneveivel nem egyező fájlok hozzáadódnak a blokkhoz.

Renderelési sablon

A renderelési sablonok új sablonfájl megadásával bírálhatók felül, például index.php, index.twig vagy index.blade.php.

Twig blokkok

A Twig sablonok részletesebb szinten, a Twig blokkok funkciójával bírálhatók felül.

Tegyük fel, hogy egy képblokkhoz a következő képzeletbeli renderelési sablont használjuk:

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

A teljes sablon lecserélése helyett a Twig extends funkciójával felülbírálhatjuk a sablon egyes részeit, miközben a többi változatlan marad.

Twig
{% extends 'index.twig' %}

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