Komponenty
Komponenty sú bloky Blockstudio, ktoré prechádzajú celým procesom (atribúty, šablóny, zdroje, RPC, Tailwind), ale nezobrazujú sa v zozname blokov editora WordPress. Sú určené na tvorbu opakovane použiteľných prvkov UI, ktoré sa vykresľujú iba programovo.
block.json
V objekte blockstudio nastavte vlastnosť component na hodnotu true:
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"
}
]
}
}
Vykresľovanie
Komponenty možno vykresliť dvoma spôsobmi:
Vykresľovač reťazcov
V šablónach stránok alebo obsahu príspevkov používajte značky <bs:>:
HTML
<bs:my-theme-card title="My Card" description="Card content." />
PHP
V šablónach PHP používajte bs_render_block() alebo bs_block():
PHP
bs_render_block([
'name' => 'my-theme/card',
'attributes' => [
'title' => 'My Card',
'description' => 'Card content.',
],
]);
Čo funguje
Komponenty podporujú všetky funkcie Blockstudio:
- Atribúty a typy polí
- Šablóny PHP, Twig a Blade
- Zdroje CSS/SCSS (načítajú sa pri vykreslení komponentu)
- Tailwind CSS
- Funkcie servera (RPC)
- Štýly s obmedzeným rozsahom
Čo sa neuplatňuje
Keďže sa komponenty v editore nikdy nezobrazujú:
- Ukážka bloku v editore nie je k dispozícii
- Vyhľadávanie v zozname blokov ich nenájde
- Pri komponentoch sa nikdy nevolá
registerBlockType()