Liigu sisu juurde

Atribuutide registreerimine

Atribuudid määratletakse teie block.json-faili massiivis blockstudio.attributes.

Põhinäide

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

Atribuudi omadused

Kõigil atribuutidel on järgmised omadused:

Atribuut Tüüp Kirjeldus
id string Atribuudi kordumatu tunnus
type string Välja tüüp (text, textarea, select jne)
label string Redaktoris kuvatav silt
default mixed Atribuudi vaikeväärtus
help string Sildi kõrval kohtspikrina kuvatav abitekst
position string Välja asukoht: inspector (vaikimisi) või toolbar
conditions array Tingimusloogika välja kuvamiseks või peitmiseks

Asukoht

Vaikimisi kuvatakse kõik väljad ploki inspektoris (külgribal). Seda saab muuta omadusega position:

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

Vaikeväärtused

Määrake vaikeväärtused omadusega default:

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

Abitekst

Lisage kasutajate juhendamiseks abitekst:

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

Atribuutidele juurdepääs

Mallifailis pääseb atribuutidele ligi lühikirjapildi $a (või $attributes) kaudu:

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

Või kohas Twig:

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

Väljade mustrite retseptikogu