Перейти к содержимому

Компоненты

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