Компоненти
Компонентите са блокове Blockstudio, които преминават през целия процес (атрибути, шаблони, ресурси, RPC, Tailwind), но не се показват в списъка с блокове на редактора WordPress. Те са предназначени за създаване на многократно използваеми елементи UI, които се визуализират само програмно.
block.json
Задайте свойството component на true в обекта 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"
}
]
}
}
Визуализиране
Компонентите могат да се визуализират по два начина:
Визуализатор на низове
Използвайте тагове <bs:> в шаблоните на страниците или съдържанието на публикациите:
HTML
<bs:my-theme-card title="My Card" description="Card content." />
PHP
Използвайте bs_render_block() или bs_block() в шаблоните PHP:
PHP
bs_render_block([
'name' => 'my-theme/card',
'attributes' => [
'title' => 'My Card',
'description' => 'Card content.',
],
]);
Поддържани възможности
Компонентите поддържат всички възможности на Blockstudio:
- Атрибути и типове полета
- Шаблони PHP, Twig и Blade
- Ресурси CSS/SCSS (зареждат се при визуализиране на компонента)
- Tailwind CSS
- Сървърни функции (RPC)
- Стилове с ограничен обхват
Неприложими възможности
Тъй като компонентите никога не се показват в редактора:
- Не е наличен преглед в редактора на блокове
- Търсенето в списъка с блокове няма да ги открие
registerBlockType()никога не се извиква за компонентите