Komponenty
Komponenty to bloki Blockstudio, które przechodzą przez cały proces (atrybuty, szablony, zasoby, RPC, Tailwind), ale nie pojawiają się w inserterze edytora WordPress. Służą do tworzenia wielokrotnego użytku elementów UI renderowanych wyłącznie programowo.
block.json
Ustaw właściwość component na true w obiekcie 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"
}
]
}
}
Renderowanie
Komponenty można renderować na dwa sposoby:
Renderer ciągów znaków
Używaj znaczników <bs:> w szablonach stron lub treści wpisów:
HTML
<bs:my-theme-card title="My Card" description="Card content." />
PHP
W szablonach PHP używaj bs_render_block() lub bs_block():
PHP
bs_render_block([
'name' => 'my-theme/card',
'attributes' => [
'title' => 'My Card',
'description' => 'Card content.',
],
]);
Obsługiwane funkcje
Komponenty obsługują wszystkie funkcje Blockstudio:
- Atrybuty i typy pól
- Szablony PHP, Twig i Blade
- Zasoby CSS/SCSS (ładowane podczas renderowania komponentu)
- Tailwind CSS
- Funkcje serwera (RPC)
- Style o ograniczonym zakresie
Funkcje nieobsługiwane
Komponenty nigdy nie pojawiają się w edytorze, dlatego:
- Podgląd w edytorze bloków jest niedostępny
- Wyszukiwanie w inserterze bloków ich nie znajdzie
- Dla komponentów nigdy nie jest wywoływane
registerBlockType()