Aizstāšana
Blockstudio nodrošina iespēju aizstāt blokus ļoti detalizētā līmenī. Tas var noderēt koplietojamām bloku bibliotēkām, ja vēlaties mainīt bloka darbību, neveidojot pilnīgi jaunu bloku.
block.json
Lai sāktu, iestatiet tā bloka nosaukumu, kuru vēlaties aizstāt, kā atslēgu name un iestatiet atslēgu override uz true.
{
"name": "blockstudio/my-block",
"title": "My overridden block title",
"blockstudio": {
"override": true
}
}
Ja īpašība override ir iestatīta uz true, jaunā block.json dati tiek sapludināti ar sākotnējā bloka datiem. Tas nozīmē, ka varat aizstāt jebkuru sākotnējā bloka īpašību.
Atribūti
Atribūtus var aizstāt ar id vai pievienot papildus. Piemēram, pieņemsim, ka vēlamies aizstāt bloka atribūtu width un pievienot jaunu atribūtu 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"
}
]
}
}
Ja tiek atrasts atribūts ar tādu pašu id, tā dati tiek sapludināti ar sākotnējā atribūta datiem. Blokam tiek pievienoti atribūti, kas nav atrasti.
Brīdinājums
Aizstājot atribūtus, jānorāda sākotnējā atribūta
type, pat ja tas paliek nemainīgs.
Sarežģītas struktūras
Aizstājot atribūtus ar sarežģītām struktūrām (atkārtotāji, grupas, cilnes u. c.), jānorāda pilna atribūta struktūra līdz vienumam, kuru vēlaties aizstāt.
{
"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"
}
]
}
]
}
]
}
]
}
}
Līdzekļi
Resursu faili tiks aizstāti, ja to failu nosaukumi sakritīs. Piemēram, ja sākotnējā blokā ir fails style.css, to aizstās fails style.css aizstājošajā blokā. Blokam tiks pievienoti faili, kuru nosaukumi nesakrīt ar sākotnējā bloka failu nosaukumiem.
Renderēšanas veidne
Renderēšanas veidnes var aizstāt, norādot jaunu veidnes failu, piemēram, index.php, index.twig vai index.blade.php.
Twig bloki
Twig veidnes var aizstāt detalizētākā līmenī, izmantojot bloku funkciju Twig.
Pieņemsim, ka mums ir šāda izdomāta attēla bloka renderēšanas veidne:
<h1>Images:</h1>
{% for image in a.images %}
<div class="content">
{% block image %}
<img src="{{ image.url }}" class="image" />
{% endblock %}
</div>
{% endfor %}
Tā vietā, lai aizstātu visu veidni, varam izmantot Twig funkciju extends, lai aizstātu noteiktas veidnes daļas, pārējo saglabājot nemainītu.
{% extends 'index.twig' %}
{% block image %}
<figure>
<img src="{{ image.url }}" class="image" />
<figcaption>{{ image.caption }}</figcaption>
</figure>
{% endblock %}