Nadpisywanie
Blockstudio umożliwia nadpisywanie bloków z dużą szczegółowością. Przydaje się to w przypadku współdzielonych bibliotek bloków, gdy chcesz zmienić działanie bloku bez tworzenia go od podstaw.
block.json
Aby rozpocząć, ustaw nazwę bloku, który chcesz nadpisać, jako klucz name i ustaw klucz override na true.
{
"name": "blockstudio/my-block",
"title": "My overridden block title",
"blockstudio": {
"override": true
}
}
Gdy właściwość override ma wartość true, dane z nowego block.json zostaną scalone z danymi oryginalnego bloku. Oznacza to, że możesz nadpisać dowolną właściwość oryginalnego bloku.
Atrybuty
Atrybuty można nadpisywać za pomocą id lub dodawać. Załóżmy na przykład, że chcemy nadpisać atrybut width bloku i dodać nowy atrybut 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"
}
]
}
}
Gdy zostanie znaleziony atrybut o tej samej id, jego dane zostaną scalone z oryginalnym atrybutem. Atrybuty, których nie znaleziono, zostaną dodane do bloku.
Ostrzeżenie
Podczas nadpisywania atrybutów musisz podać
typeoryginalnego atrybutu, nawet jeśli pozostaje bez zmian.
Złożone struktury
Podczas nadpisywania atrybutów o złożonej strukturze (pola powtarzalne, grupy, karty itp.) musisz podać pełną strukturę atrybutu aż do elementu, który ma zostać nadpisany.
{
"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"
}
]
}
]
}
]
}
]
}
}
Zasoby
Pliki zasobów zostaną zastąpione, jeśli ich nazwy są zgodne. Na przykład, jeśli w oryginalnym bloku istnieje plik style.css, zostanie zastąpiony plikiem style.css z bloku nadpisującego. Pliki o nazwach niepasujących do oryginalnego bloku zostaną dodane do bloku.
Szablon renderowania
Szablony renderowania można nadpisać, dostarczając nowy plik szablonu: index.php, index.twig lub index.blade.php.
Bloki Twig
Szablony Twig można nadpisywać z większą szczegółowością za pomocą funkcji bloków w Twig.
Załóżmy, że mamy następujący szablon renderowania fikcyjnego bloku obrazu:
<h1>Images:</h1>
{% for image in a.images %}
<div class="content">
{% block image %}
<img src="{{ image.url }}" class="image" />
{% endblock %}
</div>
{% endfor %}
Zamiast zastępować cały szablon, możemy użyć funkcji Twig extends, aby nadpisać wybrane części szablonu i zachować pozostałe bez zmian.
{% extends 'index.twig' %}
{% block image %}
<figure>
<img src="{{ image.url }}" class="image" />
<figcaption>{{ image.caption }}</figcaption>
</figure>
{% endblock %}