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.
{
"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.
{
"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.
{
"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:
<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.
{% extends 'index.twig' %}
{% block image %}
<figure>
<img src="{{ image.url }}" class="image" />
<figcaption>{{ image.caption }}</figcaption>
</figure>
{% endblock %}