Przejdź do treści

Komponenty

Komponenty to bloki Blockstudio, które przechodzą przez cały proces (atrybuty, szablony, zasoby, RPC, Tailwind), ale nie pojawiają się w inserterze edytora WordPress. Służą do tworzenia wielokrotnego użytku elementów UI renderowanych wyłącznie programowo.

block.json

Ustaw właściwość component na true w obiekcie 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"
      }
    ]
  }
}

Renderowanie

Komponenty można renderować na dwa sposoby:

Renderer ciągów znaków

Używaj znaczników <bs:> w szablonach stron lub treści wpisów:

HTML
<bs:my-theme-card title="My Card" description="Card content." />

PHP

W szablonach PHP używaj bs_render_block() lub bs_block():

PHP
bs_render_block([
  'name' => 'my-theme/card',
  'attributes' => [
    'title' => 'My Card',
    'description' => 'Card content.',
  ],
]);

Obsługiwane funkcje

Komponenty obsługują wszystkie funkcje Blockstudio:

  • Atrybuty i typy pól
  • Szablony PHP, Twig i Blade
  • Zasoby CSS/SCSS (ładowane podczas renderowania komponentu)
  • Tailwind CSS
  • Funkcje serwera (RPC)
  • Style o ograniczonym zakresie

Funkcje nieobsługiwane

Komponenty nigdy nie pojawiają się w edytorze, dlatego:

  • Podgląd w edytorze bloków jest niedostępny
  • Wyszukiwanie w inserterze bloków ich nie znajdzie
  • Dla komponentów nigdy nie jest wywoływane registerBlockType()