Gå til indhold

Komponenter

Komponenter er Blockstudio-blokke, der gennemgår hele processen (attributter, skabeloner, aktiver, RPC, Tailwind), men ikke vises i WordPress-editorens indsætter. De er udviklet til at bygge genanvendelige UI-elementer, som kun gengives programmatisk.

block.json

Sæt egenskaben component til true i objektet 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"
      }
    ]
  }
}

Gengivelse

Komponenter kan gengives på to måder:

Strenggengiver

Brug <bs:>-tags i sideskabeloner eller indlægsindhold:

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

PHP

Brug bs_render_block() eller bs_block() i PHP-skabeloner:

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

Det, der fungerer

Komponenter understøtter alle funktioner i Blockstudio:

  • Attributter og felttyper
  • Skabelonerne PHP, Twig og Blade
  • Aktiverne CSS/SCSS (indlæses, når komponenten gengives)
  • Tailwind CSS
  • Serverfunktioner (RPC)
  • Afgrænsede typografier

Det, der ikke gælder

Da komponenter aldrig vises i editoren:

  • Forhåndsvisning i blokeditoren er ikke tilgængelig
  • De findes ikke via søgning i blokindsætteren
  • registerBlockType() kaldes aldrig for komponenter