Komponentit
Komponentit ovat Blockstudio-lohkoja, jotka käyvät läpi koko käsittelyketjun (attribuutit, mallit, resurssit, RPC, Tailwind), mutta eivät näy WordPress-editorin lohkojen lisäysvalikossa. Niiden avulla rakennetaan uudelleenkäytettäviä UI-osia, jotka renderöidään vain ohjelmallisesti.
block.json
Aseta blockstudio-objektin component-ominaisuuden arvoksi 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"
}
]
}
}
Renderöinti
Komponentteja voi renderöidä kahdella tavalla:
Merkkijonomuotoilija
Käytä sivumalleissa tai julkaisujen sisällössä <bs:>-tunnisteita:
HTML
<bs:my-theme-card title="My Card" description="Card content." />
PHP
Käytä bs_render_block()– tai bs_block()-merkintää PHP-malleissa:
PHP
bs_render_block([
'name' => 'my-theme/card',
'attributes' => [
'title' => 'My Card',
'description' => 'Card content.',
],
]);
Tuetut ominaisuudet
Komponentit tukevat kaikkia Blockstudio-ominaisuuksia:
- Attribuutit ja kenttätyypit
- PHP-, Twig- ja Blade-mallit
- CSS- ja SCSS-resurssit (ladataan komponentin renderöinnin yhteydessä)
- Tailwind CSS
- Palvelinfunktiot (RPC)
- Rajatut tyylit
Ei koske seuraavia
Koska komponentit eivät koskaan näy editorissa:
- Lohkoeditorin esikatselu ei ole käytettävissä
- Lohkojen lisäysvalikon haku ei löydä niitä
registerBlockType()-toimintoa ei koskaan kutsuta komponenteille