Pāriet uz saturu

Nosacījumu loģika

Laukus var rādīt vai paslēpt atkarībā no nosacījumiem.

Operatori

Var izmantot 8 dažādus operatorus:

Operators Apraksts
== Vērtības ir vienādas
!= Vērtības nav vienādas
includes Vērtība ir ietverta atsauces vērtībā
!includes Vērtība nav ietverta atsauces vērtībā
empty Vērtība ir tukša
!empty Vērtība nav tukša
< Vērtība ir mazāka par atsauces vērtību
> Vērtība ir lielāka par atsauces vērtību
<= Vērtība ir mazāka vai vienāda ar atsauces vērtību
>= Vērtība ir lielāka vai vienāda ar atsauces vērtību

Globālie nosacījumi

Pēc noklusējuma Blockstudio ir pieejami 4 globālie nosacījumi: ieraksta tips, ieraksta ID, lietotāja loma un lietotāja 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"
            }
          ]
        ]
      }
    ]
  }
}

Iepriekš minētajā piemērā teksta atribūts redaktora skatā tiek rādīts tikai tad, ja ieraksta ID ir 1386 UN ieraksta tips ir post.

Ņemiet vērā, ka tipa atslēgām tiek izmantota camelCase konvencija: postType, postId, userRole, userId.

VAI nosacījumi

Lai izveidotu VAI nosacījumus, ievietojiet katru nosacījumu grupu savā masīvā:

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"
            }
          ]
        ]
      }
    ]
  }
}

Teksta atribūts tiks rādīts, ja (ieraksta ID ir 1386 UN ieraksta tips ir post) VAI (ieraksta tips ir jobs).

Pielāgotie nosacījumi

Pielāgotus nosacījumus var pievienot, izmantojot filtru blockstudio/blocks/conditions. Filtrs darbojas PHP, kad tiek ielādēts redaktors, un atgriež vienu vērtību katram nosacījuma tipam. Nosacījumi tiek izvērtēti redaktorā, kas, izmantojot operatoru, salīdzina šo vērtību ar nosacījuma 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;
});

Katrā stāvoklī atgrieziet virkni, kas nav tukša. Nosacījuma tips, kura vērtība ir tukša vai nav norādīta, tiek izlaists, tāpēc lauks paliek redzams.

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

Bloka nosacījumi

Varat iestatīt nosacījumus, kas ir atkarīgi no citiem atribūtiem. Atslēgas type vietā izmantojiet tā atribūta id, kuru vēlaties pārbaudīt:

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
            }
          ]
        ]
      }
    ]
  }
}

Pēc vajadzības varat apvienot globālos un bloka nosacījumus.

Atkārtotāja konteksts

Pēc noklusējuma atkārtotāju atribūtu nosacījumi ir atkarīgi no pašlaik atkārtotā elementa atribūtiem.

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
                }
              ]
            ]
          }
        ]
      }
    ]
  }
}

Tā kā atribūtu ID ir piesaistīti pašreizējam atkārtotāja elementam, teksta atribūts atkārtotājā tiks rādīts tikai tad, ja pārslēgs atkārtotāja iekšpusē ir iestatīts uz true.

Lai pārbaudītu pārslēgu ārpus atkārtotāja, nosacījumam pievienojiet "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"
                }
              ]
            ]
          }
        ]
      }
    ]
  }
}

Lauku paraugu rokasgrāmata