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

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

Полетата могат да се показват или скриват в зависимост от условията.

Оператори

Могат да се използват 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-тата на атрибутите са ограничени до текущия елемент на повторителя, атрибутът text в повторителя ще се показва само ако превключвателят вътре в повторителя е зададен на 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"
                }
              ]
            ]
          }
        ]
      }
    ]
  }
}

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