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