Pular para o conteúdo

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

PHP
<div useBlockProps>
  <h1>My block</h1>
</div>
<style><?php echo $attributes['css']; ?></style>

Twig

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.

CSS
%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:

HTML
<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.

JSON
{
  "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

JSON
{
  "$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.

JSON
{
  "blockstudio": {
    "attributes": [
      {
        "type": "code",
        "id": "styles",
        "label": "Styles",
        "language": "scss",
        "asset": true
      }
    ]
  }
}

Recursos de SCSS como variáveis, aninhamento e mixins funcionam:

Scss
%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.