Перейти до вмісту

Компоненти

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