Vai al contenuto

Componenti

I componenti sono blocchi Blockstudio che seguono l’intera pipeline (attributi, template, risorse, RPC, Tailwind), ma non compaiono nell’inseritore dell’editor WordPress. Sono pensati per creare elementi UI riutilizzabili, renderizzati solo a livello di codice.

block.json

Impostate la proprietà component su true nell’oggetto 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"
      }
    ]
  }
}

Rendering

I componenti possono essere renderizzati in due modi:

Renderer di stringhe

Usate tag <bs:> nei template delle pagine o nel contenuto degli articoli:

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

PHP

Usate bs_render_block() o bs_block() nei template PHP:

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

Funzionalità supportate

I componenti supportano tutte le funzionalità Blockstudio:

  • Attributi e tipi di campo
  • Template PHP, Twig e Blade
  • Risorse CSS/SCSS (caricate quando il componente viene renderizzato)
  • Tailwind CSS
  • Funzioni server (RPC)
  • Stili circoscritti

Funzionalità non applicabili

Poiché i componenti non compaiono mai nell’editor:

  • L’anteprima nell’editor dei blocchi non è disponibile
  • La ricerca nell’inseritore dei blocchi non li trova
  • Per i componenti registerBlockType() non viene mai chiamato