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