Komponenty
Komponenty jsou bloky Blockstudio, které procházejí celým zpracováním (atributy, šablony, zdroje, RPC, Tailwind), ale nezobrazují se v nabídce vkládání editoru WordPress. Jsou určené k tvorbě opakovaně použitelných částí UI, které se vykreslují pouze programově.
block.json
V objektu blockstudio nastavte vlastnost component na 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"
}
]
}
}
Vykreslování
Komponenty lze vykreslit dvěma způsoby:
Vykreslování řetězce
V šablonách stránek nebo obsahu příspěvků použijte značky <bs:>:
HTML
<bs:my-theme-card title="My Card" description="Card content." />
PHP
V šablonách PHP použijte bs_render_block() nebo bs_block():
PHP
bs_render_block([
'name' => 'my-theme/card',
'attributes' => [
'title' => 'My Card',
'description' => 'Card content.',
],
]);
Co funguje
Komponenty podporují všechny funkce Blockstudio:
- Atributy a typy polí
- Šablony PHP, Twig a Blade
- Zdroje CSS/SCSS (načítají se při vykreslení komponenty)
- Tailwind CSS
- Serverové funkce (RPC)
- Styly omezené na komponentu
Co neplatí
Protože se komponenty v editoru nikdy nezobrazují:
- Náhled v editoru bloků není k dispozici
- Vyhledávání v nabídce vkládání bloky nenajde
- U komponent se nikdy nevolá
registerBlockType()