Ga naar de inhoud

Componenten

Componenten zijn Blockstudio-blokken die de volledige pijplijn doorlopen (attributen, sjablonen, assets, RPC, Tailwind), maar niet verschijnen in de blokkiezer van de WordPress-editor. Ze zijn bedoeld om herbruikbare UI-onderdelen te bouwen die alleen programmatisch worden weergegeven.

block.json

Stel de eigenschap component in op true in het object 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"
      }
    ]
  }
}

Renderen

Componenten kunnen op twee manieren worden weergegeven:

Stringrenderer

Gebruik <bs:>-tags in paginasjablonen of berichtinhoud:

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

PHP

Gebruik bs_render_block() of bs_block() in PHP-sjablonen:

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

Wat werkt

Componenten ondersteunen alle functies van Blockstudio:

  • Attributen en veldtypen
  • Sjablonen van PHP, Twig en Blade
  • Assets van CSS/SCSS (geladen wanneer de component wordt weergegeven)
  • Tailwind CSS
  • Serverfuncties (RPC)
  • Stijlen met een beperkte scope

Wat niet van toepassing is

Omdat componenten nooit in de editor verschijnen:

  • Is een voorbeeldweergave in de blokeditor niet beschikbaar
  • Vindt zoeken in de blokkiezer ze niet
  • Wordt registerBlockType() nooit aangeroepen voor componenten