Perrašymai
Blockstudio suteikia galimybę itin tiksliai perrašyti blokus. Tai gali būti naudinga bendrinamoms blokų bibliotekoms, kai norite pakeisti bloko veikimą nekurdami naujo bloko nuo pradžių.
block.json
Norėdami pradėti, nustatykite perrašomo bloko pavadinimą kaip raktą name, o raktą override nustatykite į true.
{
"name": "blockstudio/my-block",
"title": "My overridden block title",
"blockstudio": {
"override": true
}
}
Kai ypatybė override nustatyta į true, naujojo block.json duomenys sujungiami su pradinio bloko duomenimis. Tai reiškia, kad galite perrašyti bet kurią pradinio bloko ypatybę.
Atributai
Atributus galima perrašyti naudojant id arba papildomai pridėti. Pavyzdžiui, įsivaizduokime, kad norime perrašyti bloko atributą width ir pridėti naują 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"
}
]
}
}
Radus atributą su tokiu pačiu id, jo duomenys sujungiami su pradinio atributo duomenimis. Nerasti atributai pridedami prie bloko.
Įspėjimas
Perrašydami atributus, turite nurodyti pradinio atributo
type, net jei jis nesikeičia.
Sudėtingos struktūros
Perrašydami sudėtingų struktūrų atributus (pasikartojančių laukų, grupių, skirtukų ir kt.), turite pateikti visą atributo struktūrą iki elemento, kurį reikia perrašyti.
{
"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"
}
]
}
]
}
]
}
]
}
}
Ištekliai
Išteklių failai bus pakeisti, kai sutaps failo pavadinimas. Pavyzdžiui, jei pradiniame bloke yra failas style.css, jį pakeis perrašančio bloko failas style.css. Failai, kurių pavadinimai nesutampa su pradinio bloko failais, bus pridėti prie bloko.
Atvaizdavimo šablonas
Atvaizdavimo šablonus galima perrašyti pateikiant naują šablono failą: index.php, index.twig arba index.blade.php.
Twig blokai
Twig šablonus galima perrašyti dar tiksliau, naudojant funkciją blokų iš Twig.
Įsivaizduokime tokį išgalvoto vaizdo bloko atvaizdavimo šabloną:
<h1>Images:</h1>
{% for image in a.images %}
<div class="content">
{% block image %}
<img src="{{ image.url }}" class="image" />
{% endblock %}
</div>
{% endfor %}
Užuot pakeitę visą šabloną, galime naudoti Twig funkciją extends, kad perrašytume tam tikras šablono dalis, o likusias paliktume nepakeistas.
{% extends 'index.twig' %}
{% block image %}
<figure>
<img src="{{ image.url }}" class="image" />
<figcaption>{{ image.caption }}</figcaption>
</figure>
{% endblock %}