Към съдържанието

Компоненти

Компонентите са блокове 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() никога не се извиква за компонентите