Pular para o conteúdo

Componentes

Componentes são blocos Blockstudio que passam pelo fluxo completo (atributos, templates, recursos, RPC, Tailwind), mas não aparecem no inseridor do editor WordPress. Foram projetados para criar peças reutilizáveis de UI que são renderizadas apenas programaticamente.

block.json

Defina a propriedade component como true no objeto blockstudio:

JSON
{
  "$schema": "https://blockstudio.dev/schema/block",
  "name": "my-theme/card",
  "title": "Card",
  "blockstudio": {
    "component": true,
    "attributes": [
      {
        "id": "title",
        "type": "text",
        "label": "Title"
      },
      {
        "id": "description",
        "type": "textarea",
        "label": "Description"
      }
    ]
  }
}

Renderização

Os componentes podem ser renderizados de duas maneiras:

Renderizador de strings

Use tags <bs:> nos templates de página ou no conteúdo do post:

HTML
<bs:my-theme-card title="My Card" description="Card content." />

PHP

Use bs_render_block() ou bs_block() em templates PHP:

PHP
bs_render_block([
  'name' => 'my-theme/card',
  'attributes' => [
    'title' => 'My Card',
    'description' => 'Card content.',
  ],
]);

Recursos disponíveis

Os componentes oferecem suporte a todos os recursos de Blockstudio:

  • Atributos e tipos de campo
  • Templates de PHP, Twig e Blade
  • Recursos de CSS/SCSS (carregados quando o componente é renderizado)
  • Tailwind CSS
  • Funções do servidor (RPC)
  • Estilos com escopo definido

O que não se aplica

Como os componentes nunca aparecem no editor:

  • A pré-visualização no editor de blocos não está disponível
  • A pesquisa do inseridor de blocos não os encontrará
  • registerBlockType() nunca é chamado para componentes