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