Tilsidesættelser
Blockstudio giver mulighed for at tilsidesætte blokke på et meget detaljeret niveau. Det kan være nyttigt for delte blokbiblioteker, når du vil ændre en bloks adfærd uden at skulle oprette en helt ny blok.
block.json
Kom i gang ved at angive navnet på den blok, du vil tilsidesætte, som nøglen name og sætte nøglen override til true.
{
"name": "blockstudio/my-block",
"title": "My overridden block title",
"blockstudio": {
"override": true
}
}
Når egenskaben override er sat til true, flettes dataene fra den nye block.json med dataene fra den oprindelige blok. Det betyder, at du kan tilsidesætte enhver egenskab i den oprindelige blok.
Attributter
Attributter kan enten tilsidesættes med id eller tilføjes. Lad os f.eks. forestille os, at vi vil tilsidesætte en bloks attribut width og tilføje en ny attribut 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"
}
]
}
}
Når der findes en attribut med samme id, flettes dataene med den oprindelige attribut. Attributter, der ikke findes, føjes til blokken.
Advarsel
Når du tilsidesætter attributter, skal du angive
typefor den oprindelige attribut, selvom den forbliver den samme.
Komplekse strukturer
Når du tilsidesætter attributter med komplekse strukturer (gentagelsesfelter, grupper, faner osv.), skal du angive hele attributstrukturen frem til det element, der skal tilsidesættes.
{
"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"
}
]
}
]
}
]
}
]
}
}
Ressourcer
Aktivfiler erstattes, når filnavnet stemmer overens. Hvis der f.eks. findes en style.css-fil i den oprindelige blok, erstattes den af filen style.css i den tilsidesættende blok. Filer med navne, der ikke stemmer overens med den oprindelige blok, føjes til blokken.
Gengivelsesskabelon
Gengivelsesskabeloner kan tilsidesættes ved at angive en ny skabelonfil: enten index.php, index.twig eller index.blade.php.
Twig-blokke
Twig-skabeloner kan tilsidesættes på et mere detaljeret niveau ved hjælp af blokfunktionen i Twig.
Lad os forestille os følgende gengivelsesskabelon for en fiktiv billedblok:
<h1>Images:</h1>
{% for image in a.images %}
<div class="content">
{% block image %}
<img src="{{ image.url }}" class="image" />
{% endblock %}
</div>
{% endfor %}
I stedet for at erstatte hele skabelonen kan vi bruge funktionen extends i Twig til at tilsidesætte bestemte dele af skabelonen, mens resten bevares.
{% extends 'index.twig' %}
{% block image %}
<figure>
<img src="{{ image.url }}" class="image" />
<figcaption>{{ image.caption }}</figcaption>
</figure>
{% endblock %}