Liigu sisu juurde

Komponendid

Komponendid on Blockstudio plokid, mis läbivad kogu töövoo (atribuudid, mallid, varad, RPC, Tailwind), kuid ei ilmu WordPress redaktori ploki lisamise vaatesse. Need on mõeldud korduvkasutatavate UI elementide loomiseks, mida renderdatakse ainult programmiliselt.

block.json

Määrake objekti blockstudio atribuut component väärtuseks 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"
      }
    ]
  }
}

Renderdamine

Komponente saab renderdada kahel viisil:

String-renderdaja

Kasutage lehemallides või postituse sisus silte <bs:>:

HTML
<bs:my-theme-card title="My Card" description="Card content." />

PHP

Kasutage bs_render_block() või bs_block() malle PHP-s:

PHP
bs_render_block([
  'name' => 'my-theme/card',
  'attributes' => [
    'title' => 'My Card',
    'description' => 'Card content.',
  ],
]);

Toetatud võimalused

Komponendid toetavad kõiki Blockstudio funktsioone:

  • Atribuudid ja väljatüübid
  • Mallid PHP, Twig ja Blade
  • CSS/SCSS varad (laaditakse komponendi renderdamisel)
  • Tailwind CSS
  • Serverifunktsioonid (RPC)
  • Piiratud ulatusega stiilid

Mis ei kehti

Kuna komponente redaktoris ei kuvata:

  • Plokiredaktori eelvaade pole saadaval
  • Ploki lisamise vaate otsing neid ei leia
  • Komponentide puhul ei kutsuta kunagi välja funktsiooni registerBlockType()