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