Preskočiť na obsah

Komponenty

Komponenty sú bloky Blockstudio, ktoré prechádzajú celým procesom (atribúty, šablóny, zdroje, RPC, Tailwind), ale nezobrazujú sa v zozname blokov editora WordPress. Sú určené na tvorbu opakovane použiteľných prvkov UI, ktoré sa vykresľujú iba programovo.

block.json

V objekte blockstudio nastavte vlastnosť component na hodnotu 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"
      }
    ]
  }
}

Vykresľovanie

Komponenty možno vykresliť dvoma spôsobmi:

Vykresľovač reťazcov

V šablónach stránok alebo obsahu príspevkov používajte značky <bs:>:

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

PHP

V šablónach PHP používajte bs_render_block() alebo bs_block():

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

Čo funguje

Komponenty podporujú všetky funkcie Blockstudio:

  • Atribúty a typy polí
  • Šablóny PHP, Twig a Blade
  • Zdroje CSS/SCSS (načítajú sa pri vykreslení komponentu)
  • Tailwind CSS
  • Funkcie servera (RPC)
  • Štýly s obmedzeným rozsahom

Čo sa neuplatňuje

Keďže sa komponenty v editore nikdy nezobrazujú:

  • Ukážka bloku v editore nie je k dispozícii
  • Vyhľadávanie v zozname blokov ich nenájde
  • Pri komponentoch sa nikdy nevolá registerBlockType()