Overschrijvingen
Blockstudio maakt het mogelijk blokken zeer gedetailleerd te overschrijven. Dit kan handig zijn voor gedeelde blokbibliotheken wanneer je het gedrag van een blok wilt wijzigen zonder helemaal een nieuw blok te hoeven maken.
block.json
Geef om te beginnen de naam van het blok dat je wilt overschrijven op als sleutel name en stel de sleutel override in op true.
{
"name": "blockstudio/my-block",
"title": "My overridden block title",
"blockstudio": {
"override": true
}
}
Wanneer de eigenschap override is ingesteld op true, worden de gegevens van de nieuwe block.json samengevoegd met de gegevens van het oorspronkelijke blok. Zo kun je elke eigenschap van het oorspronkelijke blok overschrijven.
Attributen
Attributen kunnen worden overschreven door id of daarnaast worden toegevoegd. Stel bijvoorbeeld dat we het width-attribuut van een blok willen overschrijven en een nieuw height-attribuut willen toevoegen.
{
"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"
}
]
}
}
Wanneer een attribuut met dezelfde id wordt gevonden, worden de gegevens samengevoegd met het oorspronkelijke attribuut. Attributen die niet worden gevonden, worden aan het blok toegevoegd.
Waarschuwing
Bij het overschrijven van attributen moet je de
typevan het oorspronkelijke attribuut opgeven, zelfs als die ongewijzigd blijft.
Complexe structuren
Bij het overschrijven van attributen met complexe structuren (repeaters, groepen, tabbladen enzovoort) moet je de volledige structuur van het attribuut opgeven tot aan het item dat moet worden overschreven.
{
"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"
}
]
}
]
}
]
}
]
}
}
Assets
Assetbestanden worden vervangen wanneer de bestandsnaam overeenkomt. Als er bijvoorbeeld een style.css-bestand in het oorspronkelijke blok bestaat, wordt dit vervangen door het style.css-bestand in het overschrijvende blok. Bestanden met namen die niet overeenkomen met die van het oorspronkelijke blok, worden aan het blok toegevoegd.
Renderingsjabloon
Renderingsjablonen kunnen worden overschreven door een nieuw sjabloonbestand op te geven: index.php, index.twig of index.blade.php.
Twig-blokken
Twig-templates kunnen tot in detail worden overschreven met de functie blok in Twig.
Stel dat we de volgende renderingsjabloon voor een fictief afbeeldingsblok hebben:
<h1>Images:</h1>
{% for image in a.images %}
<div class="content">
{% block image %}
<img src="{{ image.url }}" class="image" />
{% endblock %}
</div>
{% endfor %}
In plaats van de hele template te vervangen, kunnen we de functie extends van Twig gebruiken om bepaalde delen van de template te overschrijven en de rest intact te laten.
{% extends 'index.twig' %}
{% block image %}
<figure>
<img src="{{ image.url }}" class="image" />
<figcaption>{{ image.caption }}</figcaption>
</figure>
{% endblock %}