Pereiti prie turinio

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