Перейти к содержимому

Вариации

Вариации блоков API позволяют регистрировать пользовательские вариации для существующих блоков.

Представим блок, у которого может быть два разных варианта в зависимости от значения простого поля выбора.

JSON
{
  "$schema": "https://blockstudio.dev/schema/block",
  "name": "blockstudio/variations",
  "title": "Native Variation",
  "description": "Native Blockstudio Variation block.",
  "icon": "star-filled",
  "variations": [
    {
      "name": "variation-2",
      "title": "Native Variation 2",
      "description": "Native Blockstudio Variation block 2.",
      "attributes": {
        "select": {
          "value": "variation-2"
        }
      }
    }
  ],
  "blockstudio": {
    "attributes": [
      {
        "id": "select",
        "type": "select",
        "label": "Select",
        "options": [
          {
            "value": "variation-1",
            "label": "Variation 1"
          },
          {
            "value": "variation-2",
            "label": "Variation 2"
          }
        ],
        "default": {
          "value": "variation-1"
        }
      }
    ]
  }
}

Приведенный выше код создаст три блока во вставщике: основной блок и две вариации.

Скрытие атрибутов

Атрибуты автоматически выводят соответствующее поле на боковой панели. Поскольку блоки-вариации зависят от определенных значений атрибутов, эти поля, возможно, стоит скрыть с боковой панели. Для этого используйте параметр hidden.

JSON
{
  "blockstudio": {
    "attributes": [
      {
        "id": "select",
        "type": "select",
        "label": "Select",
        "hidden": true,
        "options": [
          {
            "value": "variation-1",
            "label": "Variation 1"
          },
          {
            "value": "variation-2",
            "label": "Variation 2"
          }
        ]
      }
    ]
  }
}