Към съдържанието

Регистриране на атрибути

Атрибутите се дефинират в масива blockstudio.attributes във файла block.json.

Основен пример

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

Свойства на атрибутите

Всички атрибути споделят следните свойства:

Свойство Тип Описание
id string Уникален идентификатор на атрибута
type string Тип на полето (текст, текстова област, списък за избор и др.)
label string Етикет, показван в редактора
default mixed Стойност по подразбиране на атрибута
help string Помощен текст, показван като подсказка до етикета
position string Къде се показва полето: inspector (по подразбиране) или toolbar
conditions array Условна логика за показване или скриване на полето

Позиция

По подразбиране всички полета се показват в инспектора на блока (страничната лента). Можете да промените това чрез свойството 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" }
        ]
      }
    ]
  }
}

Стойности по подразбиране

Задавайте стойности по подразбиране чрез свойството default:

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

Помощен текст

Добавете помощен текст, който да насочва потребителите:

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

Достъп до атрибутите

В шаблона атрибутите са достъпни чрез съкратения запис $a (или $attributes):

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

Или в Twig:

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

Наръчник с примери за полета