Componente
Componentele sunt blocuri Blockstudio care parcurg întregul flux (atribute, șabloane, resurse, RPC, Tailwind), dar nu apar în inseratorul editorului WordPress. Sunt concepute pentru a crea elemente UI reutilizabile, randate doar programatic.
block.json
Setați proprietatea component la true în obiectul 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"
}
]
}
}
Redare
Componentele pot fi randate în două moduri:
Randare ca șir
Folosiți etichete <bs:> în șabloanele paginilor sau în conținutul articolelor:
HTML
<bs:my-theme-card title="My Card" description="Card content." />
PHP
Folosiți bs_render_block() sau bs_block() în șabloanele PHP:
PHP
bs_render_block([
'name' => 'my-theme/card',
'attributes' => [
'title' => 'My Card',
'description' => 'Card content.',
],
]);
Ce funcționează
Componentele acceptă toate funcțiile Blockstudio:
- Atribute și tipuri de câmpuri
- Șabloane PHP, Twig și Blade
- Resurse CSS/SCSS (încărcate când componenta este randată)
- Tailwind CSS
- Funcții de server (RPC)
- Stiluri cu domeniu de aplicare limitat
Ce nu se aplică
Deoarece componentele nu apar niciodată în editor:
- Previzualizarea din editorul de blocuri nu este disponibilă
- Căutarea în inseratorul de blocuri nu le va găsi
registerBlockType()nu este apelat niciodată pentru componente