Компоненты
Компоненты — это блоки 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()