Zum Inhalt springen

Komponenten

Komponenten sind Blockstudio-Blöcke, die die gesamte Pipeline durchlaufen (Attribute, Templates, Assets, RPC, Tailwind), aber nicht in der Einfügeauswahl des WordPress-Editors erscheinen. Sie eignen sich zum Erstellen wiederverwendbarer UI-Elemente, die nur programmatisch gerendert werden.

block.json

Setze die Eigenschaft component im Objekt blockstudio auf true:

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

Komponenten lassen sich auf zwei Arten rendern:

String-Renderer

Verwende <bs:>-Tags in Seitentemplates oder Beitragsinhalten:

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

PHP

Verwende bs_render_block() oder bs_block() in PHP-Templates:

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

Unterstützte Funktionen

Komponenten unterstützen alle Blockstudio-Funktionen:

  • Attribute und Feldtypen
  • PHP-, Twig- und Blade-Templates
  • CSS-/SCSS-Assets (werden geladen, wenn die Komponente gerendert wird)
  • Tailwind CSS
  • Serverfunktionen (RPC)
  • Geltungsbereichsbezogene Styles

Nicht zutreffend

Da Komponenten nie im Editor erscheinen:

  • Eine Vorschau im Block-Editor ist nicht verfügbar
  • Bei der Suche in der Block-Einfügeauswahl werden sie nicht gefunden
  • registerBlockType() wird für Komponenten nie aufgerufen