Ugrás a tartalomhoz

Komponensek

A komponensek Blockstudio blokkok, amelyek végigmennek a teljes folyamaton (attribútumok, sablonok, eszközök, RPC, Tailwind), de nem jelennek meg a WordPress szerkesztő beszúrójában. Újrafelhasználható UI elemek készítésére szolgálnak, amelyeket csak programozottan jelenít meg.

block.json

Állítsa a component tulajdonságot true értékre a blockstudio objektumban:

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"
      }
    ]
  }
}

Renderelés

A komponenseket kétféleképpen jelenítheti meg:

Karakterlánc-megjelenítő

Használjon <bs:> címkéket az oldalsablonokban vagy a bejegyzések tartalmában:

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

PHP

Használja a bs_render_block() vagy a bs_block() elemet a PHP sablonokban:

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

Támogatott funkciók

A komponensek az összes Blockstudio funkciót támogatják:

  • Attribútumok és mezőtípusok
  • PHP, Twig és Blade sablonok
  • CSS/SCSS eszközök (a komponens megjelenítésekor töltődnek be)
  • Tailwind CSS
  • Szerverfüggvények (RPC)
  • Hatókörhöz kötött stílusok

Nem alkalmazható funkciók

Mivel a komponensek soha nem jelennek meg a szerkesztőben:

  • A blokkszerkesztő előnézete nem érhető el
  • A blokkbeszúró keresője nem találja meg őket
  • A komponenseknél soha nem fut le a registerBlockType()