Komponen
Komponen adalah blok Blockstudio yang melalui seluruh alur pemrosesan (atribut, templat, aset, RPC, Tailwind), tetapi tidak muncul di inserter editor WordPress. Komponen dirancang untuk membangun bagian UI yang dapat digunakan kembali dan hanya dirender secara terprogram.
block.json
Atur properti component ke true di objek 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
Komponen dapat dirender dengan dua cara:
Perender String
Gunakan tag <bs:> di templat halaman atau konten pos:
HTML
<bs:my-theme-card title="My Card" description="Card content." />
PHP
Gunakan bs_render_block() atau bs_block() di templat PHP:
PHP
bs_render_block([
'name' => 'my-theme/card',
'attributes' => [
'title' => 'My Card',
'description' => 'Card content.',
],
]);
Fitur yang Didukung
Komponen mendukung semua fitur Blockstudio:
- Atribut dan jenis field
- Templat PHP, Twig, dan Blade
- Aset CSS/SCSS (dimuat saat komponen dirender)
- Tailwind CSS
- Fungsi server (RPC)
- Gaya dengan cakupan khusus
Fitur yang Tidak Berlaku
Karena komponen tidak pernah muncul di editor:
- Pratinjau editor blok tidak tersedia
- Pencarian inserter blok tidak akan menemukannya
registerBlockType()tidak pernah dipanggil untuk komponen