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

Условная логика

Поля можно показывать или скрывать в зависимости от условий.

Операторы

Можно использовать 8 различных операторов:

Оператор Описание
== Значения равны
!= Значения не равны
includes Значение входит в эталонное значение
!includes Значение не входит в эталонное значение
empty Значение пустое
!empty Значение не пустое
< Значение меньше эталонного значения
> Значение больше эталонного значения
<= Значение меньше или равно эталонному значению
>= Значение больше или равно эталонному значению

Глобальные условия

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

JSON
{
  "$schema": "https://blockstudio.dev/schema/block",
  "name": "blockstudio/native",
  "title": "Native Block",
  "blockstudio": {
    "attributes": [
      {
        "id": "message",
        "type": "text",
        "label": "My message",
        "conditions": [
          [
            {
              "type": "postId",
              "operator": "==",
              "value": "1386"
            },
            {
              "type": "postType",
              "operator": "==",
              "value": "post"
            }
          ]
        ]
      }
    ]
  }
}

В примере выше атрибут text будет отображаться в редакторе, только если ID записи — 1386 И тип записи — post.

Обратите внимание: для ключей типа используется соглашение camelCase: postType, postId, userRole, userId.

Условия ИЛИ

Чтобы создать условия или, поместите каждую группу условий в отдельный массив:

JSON
{
  "blockstudio": {
    "attributes": [
      {
        "id": "message",
        "type": "text",
        "label": "My message",
        "conditions": [
          [
            {
              "type": "postId",
              "operator": "==",
              "value": "1386"
            },
            {
              "type": "postType",
              "operator": "==",
              "value": "post"
            }
          ],
          [
            {
              "type": "postType",
              "operator": "==",
              "value": "jobs"
            }
          ]
        ]
      }
    ]
  }
}

Атрибут text будет отображаться, если (ID записи — 1386 И тип записи — post) ИЛИ (тип записи — jobs).

Пользовательские условия

Пользовательские условия можно добавить с помощью фильтра blockstudio/blocks/conditions. Фильтр выполняется в PHP при загрузке редактора и возвращает по одному значению для каждого типа условия. Условия вычисляются в редакторе: он сравнивает это значение со значением value условия с помощью оператора.

PHP
add_filter('blockstudio/blocks/conditions', function($conditions) {
  // Check if the current user purchased the product.
  $conditions['purchasedProduct'] = user_has_purchased(123) ? 'yes' : 'no';
  return $conditions;
});

Для каждого состояния возвращайте непустую строку. Если значение типа условия пустое или отсутствует, условие пропускается, поэтому поле останется видимым.

JSON
{
  "blockstudio": {
    "attributes": [
      {
        "id": "message",
        "type": "text",
        "label": "My message",
        "conditions": [
          [
            {
              "type": "purchasedProduct",
              "operator": "==",
              "value": "yes"
            }
          ]
        ]
      }
    ]
  }
}

Условия блока

Можно задать условия, зависящие от других атрибутов. Вместо ключа type используйте id атрибута, который нужно проверить:

JSON
{
  "blockstudio": {
    "attributes": [
      {
        "type": "toggle",
        "id": "copyButton",
        "label": "Copy Button"
      },
      {
        "type": "text",
        "id": "copyButtonText",
        "label": "Copy Button Text",
        "default": "Copy",
        "conditions": [
          [
            {
              "id": "copyButton",
              "operator": "==",
              "value": true
            }
          ]
        ]
      }
    ]
  }
}

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

Контекст повторителя

По умолчанию условия для атрибутов внутри повторителей зависят от атрибутов текущего повторяемого элемента.

JSON
{
  "blockstudio": {
    "attributes": [
      {
        "type": "toggle",
        "id": "toggle",
        "label": "Toggle"
      },
      {
        "type": "repeater",
        "id": "repeater",
        "label": "Repeater",
        "attributes": [
          {
            "type": "toggle",
            "id": "toggle",
            "label": "Toggle"
          },
          {
            "type": "text",
            "id": "text",
            "label": "Text",
            "conditions": [
              [
                {
                  "id": "toggle",
                  "operator": "==",
                  "value": true
                }
              ]
            ]
          }
        ]
      }
    ]
  }
}

Поскольку ID атрибутов относятся к текущему элементу повторителя, текстовый атрибут внутри повторителя будет отображаться, только если переключатель внутри повторителя установлен в true.

Чтобы проверить переключатель вне повторителя, добавьте "context": "main" в условие:

JSON
{
  "blockstudio": {
    "attributes": [
      {
        "type": "toggle",
        "id": "toggle",
        "label": "Toggle"
      },
      {
        "type": "repeater",
        "id": "repeater",
        "label": "Repeater",
        "attributes": [
          {
            "type": "text",
            "id": "text",
            "label": "Text",
            "conditions": [
              [
                {
                  "id": "toggle",
                  "operator": "==",
                  "value": true,
                  "context": "main"
                }
              ]
            ]
          }
        ]
      }
    ]
  }
}

Кулинарная книга шаблонов полей