Přejít k obsahu

Komponenty

Komponenty jsou bloky Blockstudio, které procházejí celým zpracováním (atributy, šablony, zdroje, RPC, Tailwind), ale nezobrazují se v nabídce vkládání editoru WordPress. Jsou určené k tvorbě opakovaně použitelných částí UI, které se vykreslují pouze programově.

block.json

V objektu blockstudio nastavte vlastnost component na true:

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"
      }
    ]
  }
}

Vykreslování

Komponenty lze vykreslit dvěma způsoby:

Vykreslování řetězce

V šablonách stránek nebo obsahu příspěvků použijte značky <bs:>:

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

PHP

V šablonách PHP použijte bs_render_block() nebo bs_block():

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

Co funguje

Komponenty podporují všechny funkce Blockstudio:

  • Atributy a typy polí
  • Šablony PHP, Twig a Blade
  • Zdroje CSS/SCSS (načítají se při vykreslení komponenty)
  • Tailwind CSS
  • Serverové funkce (RPC)
  • Styly omezené na komponentu

Co neplatí

Protože se komponenty v editoru nikdy nezobrazují:

  • Náhled v editoru bloků není k dispozici
  • Vyhledávání v nabídce vkládání bloky nenajde
  • U komponent se nikdy nevolá registerBlockType()