Componenti
I componenti sono blocchi Blockstudio che seguono l’intera pipeline (attributi, template, risorse, RPC, Tailwind), ma non compaiono nell’inseritore dell’editor WordPress. Sono pensati per creare elementi UI riutilizzabili, renderizzati solo a livello di codice.
block.json
Impostate la proprietà component su true nell’oggetto 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"
}
]
}
}
Rendering
I componenti possono essere renderizzati in due modi:
Renderer di stringhe
Usate tag <bs:> nei template delle pagine o nel contenuto degli articoli:
HTML
<bs:my-theme-card title="My Card" description="Card content." />
PHP
Usate bs_render_block() o bs_block() nei template PHP:
PHP
bs_render_block([
'name' => 'my-theme/card',
'attributes' => [
'title' => 'My Card',
'description' => 'Card content.',
],
]);
Funzionalità supportate
I componenti supportano tutte le funzionalità Blockstudio:
- Attributi e tipi di campo
- Template PHP, Twig e Blade
- Risorse CSS/SCSS (caricate quando il componente viene renderizzato)
- Tailwind CSS
- Funzioni server (RPC)
- Stili circoscritti
Funzionalità non applicabili
Poiché i componenti non compaiono mai nell’editor:
- L’anteprima nell’editor dei blocchi non è disponibile
- La ricerca nell’inseritore dei blocchi non li trova
- Per i componenti
registerBlockType()non viene mai chiamato