Recursos do campo de código
Além de estilos e scripts estáticos em arquivos, Blockstudio também oferece blocos de recursos dinâmicos por meio do campo de código. Conforme o caso de uso, eles podem ser limitados ao bloco.
Uso básico
No nível mais básico, você pode renderizar manualmente o conteúdo do campo de código no seu modelo.
PHP
<div useBlockProps>
<h1>My block</h1>
</div>
<style><?php echo $attributes['css']; ?></style>
Twig
<div useBlockProps>
<h1>My block</h1>
</div>
<style>{{ attributes.css }}</style>
Seletor com escopo
Para evitar conflitos com outros blocos, você pode usar a variável %selector% dentro do campo de código junto com useBlockProps no seu modelo de renderização.
Nos campos de código, %selector% aponta para a instância individual do bloco. Nos arquivos CSS e SCSS, %selector% aponta para a classe com escopo compartilhada do bloco.
Exemplo
Imagine que queremos selecionar a tag h1 do exemplo acima no nosso campo de código.
%selector% h1 {
color: red;
}
Agora, Blockstudio fará três coisas:
- Criar um ID exclusivo para essa instância do bloco
- Substituir
%selector%pelo ID exclusivo - Adicionar o mesmo seletor ao elemento marcado com
useBlockProps
A saída final será algo assim:
<div data-assets="c9abe0d95c2b">
<h1>My block</h1>
</div>
<style>
[data-assets='c9abe0d95c2b'] h1 {
color: red;
}
</style>
Renderização automática
Ter que renderizar manualmente a tag de estilo pode ser trabalhoso. Para facilitar esse processo, você pode usar o atributo asset dentro do campo de código.
{
"blockstudio": {
"attributes": [
{
"type": "code",
"id": "code",
"label": "Custom CSS",
"language": "css",
"asset": true
}
]
}
}
Isso criará automaticamente tags style para blocos de código marcados como css e as moverá para o cabeçalho do documento. Para campos marcados com javascript como linguagem, serão criadas tags script, que serão colocadas no fim do corpo.
Em extensões
Ao usar campos de código dentro de extensões, o atributo asset não é necessário. Blockstudio renderizará automaticamente o conteúdo do campo de código como um recurso se a linguagem for css ou javascript.
Exemplo
{
"$schema": "https://blockstudio.dev/schema/extend",
"name": "core/*",
"blockstudio": {
"extend": true,
"attributes": [
{
"id": "customCss",
"type": "code",
"label": "Custom css",
"language": "css"
}
]
}
}
Não é necessária nenhuma configuração adicional. O exemplo acima exibirá um campo de código para cada bloco core/* na barra lateral e renderizará automaticamente o conteúdo como um recurso na página.
SCSS
Os campos de código são compatíveis com a compilação SCSS. Defina a linguagem como scss e Blockstudio compilará o valor por meio de ScssPhp antes de renderizá-lo como CSS.
{
"blockstudio": {
"attributes": [
{
"type": "code",
"id": "styles",
"label": "Styles",
"language": "scss",
"asset": true
}
]
}
}
Recursos de SCSS como variáveis, aninhamento e mixins funcionam:
%selector% {
$primary: #3b82f6;
h1 {
color: $primary;
}
&:hover {
background: lighten($primary, 40%);
}
}
No editor, SCSS é compilado no servidor em tempo real, para que você veja o resultado enquanto digita. No frontend, a compilação ocorre durante a renderização do bloco.