Treci la conținut

Componente

Componentele sunt blocuri Blockstudio care parcurg întregul flux (atribute, șabloane, resurse, RPC, Tailwind), dar nu apar în inseratorul editorului WordPress. Sunt concepute pentru a crea elemente UI reutilizabile, randate doar programatic.

block.json

Setați proprietatea component la true în obiectul 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"
      }
    ]
  }
}

Redare

Componentele pot fi randate în două moduri:

Randare ca șir

Folosiți etichete <bs:> în șabloanele paginilor sau în conținutul articolelor:

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

PHP

Folosiți bs_render_block() sau bs_block() în șabloanele PHP:

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

Ce funcționează

Componentele acceptă toate funcțiile Blockstudio:

  • Atribute și tipuri de câmpuri
  • Șabloane PHP, Twig și Blade
  • Resurse CSS/SCSS (încărcate când componenta este randată)
  • Tailwind CSS
  • Funcții de server (RPC)
  • Stiluri cu domeniu de aplicare limitat

Ce nu se aplică

Deoarece componentele nu apar niciodată în editor:

  • Previzualizarea din editorul de blocuri nu este disponibilă
  • Căutarea în inseratorul de blocuri nu le va găsi
  • registerBlockType() nu este apelat niciodată pentru componente