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