Hoppa till innehåll

Komponenter

Komponenter är Blockstudio-block som går igenom hela flödet (attribut, mallar, resurser, RPC, Tailwind) men inte visas i blockväljaren i WordPress-redigeraren. De är utformade för att skapa återanvändbara UI-delar som bara renderas programmatiskt.

block.json

Ange egenskapen component till 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"
      }
    ]
  }
}

Rendering

Komponenter kan renderas på två sätt:

Strängrenderare

Använd <bs:>-taggar i sidmallar eller inläggsinnehåll:

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

PHP

Använd bs_render_block() eller bs_block() i PHP-mallar:

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

Funktioner som stöds

Komponenter stöder alla Blockstudio-funktioner:

  • Attribut och fälttyper
  • Mallar för PHP, Twig och Blade
  • CSS-/SCSS-resurser (laddas när komponenten renderas)
  • Tailwind CSS
  • Serverfunktioner (RPC)
  • Avgränsade stilar

Funktioner som inte stöds

Eftersom komponenter aldrig visas i redigeraren gäller följande:

  • Förhandsgranskning i blockredigeraren är inte tillgänglig
  • Sökning i blockväljaren hittar dem inte
  • registerBlockType() anropas aldrig för komponenter