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