Ugrás a tartalomhoz

Attribútumok regisztrálása

Az attribútumokat a(z) blockstudio.attributes tömbben, a(z) block.json fájlban kell definiálni.

Egyszerű példa

JSON
{
  "name": "my-theme/my-block",
  "title": "My Block",
  "blockstudio": {
    "attributes": [
      {
        "id": "title",
        "type": "text",
        "label": "Title"
      },
      {
        "id": "content",
        "type": "textarea",
        "label": "Content"
      }
    ]
  }
}

Attribútumtulajdonságok

Minden attribútum a következő tulajdonságokkal rendelkezik:

Tulajdonság Típus Leírás
id string Az attribútum egyedi azonosítója
type string A mező típusa (text, textarea, select stb.)
label string A szerkesztőben megjelenő címke
default mixed Az attribútum alapértelmezett értéke
help string A címke melletti elemleírásban megjelenő súgószöveg
position string A mező megjelenési helye: inspector (alapértelmezett) vagy toolbar
conditions array Feltételes logika a mező megjelenítéséhez vagy elrejtéséhez

Elhelyezkedés

Alapértelmezés szerint minden mező megjelenik a blokkellenőrben (oldalsávon). Ezt a(z) position tulajdonsággal módosíthatja:

JSON
{
  "blockstudio": {
    "attributes": [
      {
        "id": "alignment",
        "type": "select",
        "label": "Alignment",
        "position": "toolbar",
        "options": [
          { "value": "left", "label": "Left" },
          { "value": "center", "label": "Center" },
          { "value": "right", "label": "Right" }
        ]
      }
    ]
  }
}

Alapértelmezett értékek

Az alapértelmezett értékeket a(z) default tulajdonsággal állíthatja be:

JSON
{
  "blockstudio": {
    "attributes": [
      {
        "id": "title",
        "type": "text",
        "label": "Title",
        "default": "Hello World"
      },
      {
        "id": "showBorder",
        "type": "toggle",
        "label": "Show Border",
        "default": true
      }
    ]
  }
}

Súgószöveg

Adjon meg súgószöveget a felhasználók útmutatásához:

JSON
{
  "blockstudio": {
    "attributes": [
      {
        "id": "apiKey",
        "type": "text",
        "label": "API Key",
        "help": "Enter your API key from the settings page"
      }
    ]
  }
}

Attribútumok elérése

A sablonban az attribútumok a(z) $a rövidítéssel (vagy a(z) $attributes használatával) érhetők el:

PHP
<h1><?php echo $a['title']; ?></h1>
<p><?php echo $a['content']; ?></p>

Vagy a(z) Twig fájlban:

Twig
<h1>{{ a.title }}</h1>
<p>{{ a.content }}</p>

Mezőminták szakácskönyve