Siirry sisältöön

Komponentit

Komponentit ovat Blockstudio-lohkoja, jotka käyvät läpi koko käsittelyketjun (attribuutit, mallit, resurssit, RPC, Tailwind), mutta eivät näy WordPress-editorin lohkojen lisäysvalikossa. Niiden avulla rakennetaan uudelleenkäytettäviä UI-osia, jotka renderöidään vain ohjelmallisesti.

block.json

Aseta blockstudio-objektin component-ominaisuuden arvoksi 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"
      }
    ]
  }
}

Renderöinti

Komponentteja voi renderöidä kahdella tavalla:

Merkkijonomuotoilija

Käytä sivumalleissa tai julkaisujen sisällössä <bs:>-tunnisteita:

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

PHP

Käytä bs_render_block()– tai bs_block()-merkintää PHP-malleissa:

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

Tuetut ominaisuudet

Komponentit tukevat kaikkia Blockstudio-ominaisuuksia:

  • Attribuutit ja kenttätyypit
  • PHP-, Twig- ja Blade-mallit
  • CSS- ja SCSS-resurssit (ladataan komponentin renderöinnin yhteydessä)
  • Tailwind CSS
  • Palvelinfunktiot (RPC)
  • Rajatut tyylit

Ei koske seuraavia

Koska komponentit eivät koskaan näy editorissa:

  • Lohkoeditorin esikatselu ei ole käytettävissä
  • Lohkojen lisäysvalikon haku ei löydä niitä
  • registerBlockType()-toimintoa ei koskaan kutsuta komponenteille