Komponenter
Komponenter er Blockstudio-blokke, der gennemgår hele processen (attributter, skabeloner, aktiver, RPC, Tailwind), men ikke vises i WordPress-editorens indsætter. De er udviklet til at bygge genanvendelige UI-elementer, som kun gengives programmatisk.
block.json
Sæt egenskaben component til 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"
}
]
}
}
Gengivelse
Komponenter kan gengives på to måder:
Strenggengiver
Brug <bs:>-tags i sideskabeloner eller indlægsindhold:
HTML
<bs:my-theme-card title="My Card" description="Card content." />
PHP
Brug bs_render_block() eller bs_block() i PHP-skabeloner:
PHP
bs_render_block([
'name' => 'my-theme/card',
'attributes' => [
'title' => 'My Card',
'description' => 'Card content.',
],
]);
Det, der fungerer
Komponenter understøtter alle funktioner i Blockstudio:
- Attributter og felttyper
- Skabelonerne PHP, Twig og Blade
- Aktiverne CSS/SCSS (indlæses, når komponenten gengives)
- Tailwind CSS
- Serverfunktioner (RPC)
- Afgrænsede typografier
Det, der ikke gælder
Da komponenter aldrig vises i editoren:
- Forhåndsvisning i blokeditoren er ikke tilgængelig
- De findes ikke via søgning i blokindsætteren
registerBlockType()kaldes aldrig for komponenter