Override
Blockstudio offre la possibilità di eseguire l’override dei blocchi a un livello molto dettagliato. Può essere utile per le librerie di blocchi condivise quando volete modificare il comportamento di un blocco senza doverne creare uno nuovo da zero.
block.json
Per iniziare, impostate il nome del blocco di cui volete eseguire l’override come chiave name e impostate la chiave override su true.
{
"name": "blockstudio/my-block",
"title": "My overridden block title",
"blockstudio": {
"override": true
}
}
Quando la proprietà override è impostata su true, i dati del nuovo block.json vengono uniti a quelli del blocco originale. In questo modo potete eseguire l’override di qualsiasi proprietà del blocco originale.
Attributi
Gli attributi possono essere sovrascritti tramite id oppure aggiunti. Per esempio, immaginiamo di voler sovrascrivere l’attributo width di un blocco e aggiungere un nuovo attributo 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"
}
]
}
}
Quando viene trovato un attributo con lo stesso id, i dati vengono uniti a quelli dell’attributo originale. Gli attributi non trovati vengono aggiunti al blocco.
Avviso
Quando sovrascrivete gli attributi, dovete fornire l’
typedell’attributo originale, anche se rimane invariato.
Strutture complesse
Quando sovrascrivete attributi con strutture complesse (ripetitori, gruppi, schede e così via), dovete fornire la struttura completa dell’attributo fino all’elemento di cui volete eseguire l’override.
{
"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"
}
]
}
]
}
]
}
]
}
}
Asset
I file degli asset vengono sostituiti quando il nome del file corrisponde. Per esempio, se nel blocco originale esiste un file style.css, verrà sostituito dal file style.css nel blocco che esegue l’override. I file con nomi che non corrispondono a quelli del blocco originale verranno aggiunti al blocco.
Template di rendering
È possibile eseguire l’override dei template di rendering fornendo un nuovo file di template: index.php, index.twig oppure index.blade.php.
Blocchi Twig
I template Twig possono essere sovrascritti in modo più dettagliato usando la funzionalità blocchi in Twig.
Immaginiamo il seguente template di rendering per un blocco immagine fittizio:
<h1>Images:</h1>
{% for image in a.images %}
<div class="content">
{% block image %}
<img src="{{ image.url }}" class="image" />
{% endblock %}
</div>
{% endfor %}
Invece di sostituire l’intero template, possiamo usare la funzionalità extends di Twig per sovrascriverne alcune parti mantenendo intatto il resto.
{% extends 'index.twig' %}
{% block image %}
<figure>
<img src="{{ image.url }}" class="image" />
<figcaption>{{ image.caption }}</figcaption>
</figure>
{% endblock %}