Pāriet uz saturu

Atribūtu reģistrēšana

Atribūti ir definēti jūsu faila block.json masīvā blockstudio.attributes.

Pamatpiemērs

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

Atribūtu rekvizīti

Visiem atribūtiem ir šādi rekvizīti:

Rekvizīts Tips Apraksts
id string Atribūta unikālais identifikators
type string Lauka tips (text, textarea, select u.c.)
label string Redaktorā redzamā etiķete
default mixed Atribūta noklusējuma vērtība
help string Palīdzības teksts, kas tiek rādīts kā paskaidre blakus etiķetei
position string Lauka atrašanās vieta: inspector (pēc noklusējuma) vai toolbar
conditions array Nosacījuma loģika lauka rādīšanai vai paslēpšanai

Pozīcija

Pēc noklusējuma visi lauki tiek rādīti bloka inspektorā (sānjoslā). To var mainīt ar rekvizītu 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" }
        ]
      }
    ]
  }
}

Noklusējuma vērtības

Iestatiet noklusējuma vērtības, izmantojot rekvizītu default:

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

Palīdzības teksts

Pievienojiet palīdzības tekstu, lai sniegtu norādes lietotājiem:

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

Piekļuve atribūtiem

Veidnē atribūti ir pieejami, izmantojot saīsinājumu $a (vai $attributes):

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

Vai arī Twig:

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

Lauku paraugu rokasgrāmata