Lewati ke konten

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