Preglasitve
Blockstudio omogoča preglasitev blokov na zelo podrobni ravni. To je lahko uporabno za knjižnice blokov v skupni rabi, kadar želite spremeniti vedenje bloka, ne da bi morali ustvariti povsem nov blok.
block.json
Za začetek nastavite ime bloka, ki ga želite preglasiti, kot ključ name, ključ override pa nastavite na true.
{
"name": "blockstudio/my-block",
"title": "My overridden block title",
"blockstudio": {
"override": true
}
}
Ko je lastnost override nastavljena na true, se podatki iz novega block.json združijo s podatki iz izvirnega bloka. To pomeni, da lahko preglasite katero koli lastnost izvirnega bloka.
Atributi
Atribute lahko preglasite z id ali jih dodatno dodate. Predstavljajmo si na primer, da želimo preglasiti atribut width bloka in dodati 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"
}
]
}
}
Ko je najden atribut z enakim id, se podatki združijo z izvirnim atributom. Atributi, ki jih ni mogoče najti, se dodajo bloku.
Opozorilo
Pri preglasitvi atributov morate navesti
typeizvirnega atributa, tudi če ostane enak.
Kompleksne strukture
Pri preglasitvi atributov s kompleksnimi strukturami (ponavljalniki, skupine, zavihki itd.) morate navesti celotno strukturo atributa vse do elementa, ki ga želite preglasiti.
{
"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"
}
]
}
]
}
]
}
]
}
}
Sredstva
Datoteke sredstev bodo zamenjane, če se ime datoteke ujema. Če na primer v izvirnem bloku obstaja datoteka style.css, jo bo v preglasitvenem bloku zamenjala datoteka style.css. Datoteke z imeni, ki se ne ujemajo z imeni datotek izvirnega bloka, bodo dodane bloku.
Predloga za izris
Predloge za izris lahko preglasite tako, da navedete novo datoteko predloge: index.php, index.twig ali index.blade.php.
Bloki Twig
Predloge Twig lahko preglasite na podrobnejši ravni z uporabo funkcije bloki v Twig.
Predstavljajmo si naslednjo predlogo za izris namišljenega slikovnega bloka:
<h1>Images:</h1>
{% for image in a.images %}
<div class="content">
{% block image %}
<img src="{{ image.url }}" class="image" />
{% endblock %}
</div>
{% endfor %}
Namesto zamenjave celotne predloge lahko uporabimo funkcijo Twig extends za preglasitev določenih delov predloge, preostali deli pa ostanejo nespremenjeni.
{% extends 'index.twig' %}
{% block image %}
<figure>
<img src="{{ image.url }}" class="image" />
<figcaption>{{ image.caption }}</figcaption>
</figure>
{% endblock %}