Komponentai
Komponentai yra Blockstudio blokai, pereinantys visą apdorojimo grandinę (atributai, šablonai, ištekliai, RPC, Tailwind), tačiau nerodomi WordPress redaktoriaus blokų įterpimo lange. Jie skirti kurti pakartotinai naudojamas UI dalis, kurios atvaizduojamos tik programiškai.
block.json
Objekte blockstudio nustatykite savybę component į 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"
}
]
}
}
Atvaizdavimas
Komponentus galima atvaizduoti dviem būdais:
Eilučių atvaizdavimo priemonė
Puslapių šablonuose arba įrašo turinyje naudokite <bs:> žymas:
HTML
<bs:my-theme-card title="My Card" description="Card content." />
PHP
Šablonuose PHP naudokite bs_render_block() arba bs_block():
PHP
bs_render_block([
'name' => 'my-theme/card',
'attributes' => [
'title' => 'My Card',
'description' => 'Card content.',
],
]);
Palaikomos funkcijos
Komponentai palaiko visas Blockstudio funkcijas:
- Atributai ir laukų tipai
- PHP, Twig ir Blade šablonai
- CSS/SCSS ištekliai (įkeliami atvaizduojant komponentą)
- Tailwind CSS
- Serverio funkcijos (RPC)
- Aprėpties stiliai
Kas netaikoma
Kadangi komponentai niekada nerodomi redaktoriuje:
- Blokų peržiūra redaktoriuje nepasiekiama
- Blokų įterpimo paieška jų neras
registerBlockType()komponentams niekada neiškviečiamas