Substituições
Blockstudio oferece a possibilidade de substituir blocos em um nível bem detalhado. Isso pode ser útil para bibliotecas de blocos compartilhadas quando você quer alterar o comportamento de um bloco sem ter que criar outro do zero.
block.json
Para começar, defina o nome do bloco que você quer substituir como a chave name e defina a chave override como true.
{
"name": "blockstudio/my-block",
"title": "My overridden block title",
"blockstudio": {
"override": true
}
}
Quando a propriedade override é definida como true, os dados do novo block.json são mesclados com os dados do bloco original. Isso permite substituir qualquer propriedade do bloco original.
Atributos
Os atributos podem ser substituídos por id ou adicionados. Por exemplo, imagine que queremos substituir o atributo width de um bloco e adicionar um novo atributo 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 um atributo com o mesmo id é encontrado, os dados são mesclados com os do atributo original. Atributos que não forem encontrados serão adicionados ao bloco.
Aviso
Ao substituir atributos, você precisa fornecer o
typedo atributo original, mesmo que ele permaneça igual.
Estruturas complexas
Ao substituir atributos com estruturas complexas (repetidores, grupos, abas etc.), você precisa fornecer a estrutura completa do atributo até o item que deve ser substituído.
{
"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"
}
]
}
]
}
]
}
]
}
}
Recursos
Os arquivos de recursos serão substituídos quando o nome do arquivo coincidir. Por exemplo, se houver um arquivo style.css no bloco original, ele será substituído pelo arquivo style.css no bloco de substituição. Arquivos com nomes diferentes dos do bloco original serão adicionados ao bloco.
Template de renderização
Os templates de renderização podem ser substituídos por um novo arquivo de template, seja index.php, index.twig ou index.blade.php.
Blocos Twig
Os templates Twig podem ser substituídos em um nível mais detalhado usando o recurso de substituição de blocos em Twig.
Imagine o seguinte template de renderização para um bloco de imagem fictício:
<h1>Images:</h1>
{% for image in a.images %}
<div class="content">
{% block image %}
<img src="{{ image.url }}" class="image" />
{% endblock %}
</div>
{% endfor %}
Em vez de substituir todo o template, podemos usar o recurso extends de Twig para substituir partes específicas do template e manter o restante intacto.
{% extends 'index.twig' %}
{% block image %}
<figure>
<img src="{{ image.url }}" class="image" />
<figcaption>{{ image.caption }}</figcaption>
</figure>
{% endblock %}