Preskočiť na obsah

Podmienená logika

Polia možno zobrazovať alebo skrývať podľa podmienok.

Operátory

Možno použiť 8 rôznych operátorov:

Operátor Opis
== Hodnoty sú rovnaké
!= Hodnoty nie sú rovnaké
includes Hodnota je zahrnutá v referenčnej hodnote
!includes Hodnota nie je zahrnutá v referenčnej hodnote
empty Hodnota je prázdna
!empty Hodnota nie je prázdna
< Hodnota je menšia ako referenčná hodnota
> Hodnota je väčšia ako referenčná hodnota
<= Hodnota je menšia alebo rovná referenčnej hodnote
>= Hodnota je väčšia alebo rovná referenčnej hodnote

Globálne podmienky

Predvolene obsahuje Blockstudio 4 globálne podmienky: typ príspevku, ID príspevku, rola používateľa a ID používateľa.

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

V príklade vyššie sa atribút text zobrazí v editore iba vtedy, ak ID príspevku je 1386 A ZÁROVEŇ typ príspevku je post.

V konvencii camelCase sa používajú kľúče typu: postType, postId, userRole, userId.

Podmienky ALEBO

Ak chcete vytvoriť podmienky alebo, presuňte každú skupinu podmienok do vlastného poľa:

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

Atribút text sa zobrazí, ak (ID príspevku je 1386 A ZÁROVEŇ typ príspevku je post) ALEBO (typ príspevku je jobs).

Vlastné podmienky

Vlastné podmienky možno pridať pomocou filtra blockstudio/blocks/conditions. Filter sa spustí v PHP pri načítaní editora a vráti jednu hodnotu pre každý typ podmienky. Podmienky sa vyhodnocujú v editore, ktorý túto hodnotu porovnáva s value podmienky pomocou operátora.

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;
});

Pre každý stav vráťte neprázdny reťazec. Typ podmienky s prázdnou alebo chýbajúcou hodnotou sa preskočí, takže pole zostane viditeľné.

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

Podmienky bloku

Môžete nastaviť podmienky závislé od iných atribútov. Namiesto nastavenia kľúča type použite id atribútu, ktorý chcete kontrolovať:

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

Globálne podmienky môžete podľa potreby kombinovať s podmienkami bloku.

Kontext opakovača

Predvolene závisia podmienky pre atribúty v opakovačoch od atribútov aktuálne opakovaného prvku.

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

Keďže ID atribútov sú obmedzené na aktuálny prvok opakovača, atribút text v opakovači sa zobrazí iba vtedy, keď je prepínač v opakovači nastavený na true.

Ak chcete podmienku kontrolovať podľa prepínača mimo opakovača, pridajte do nej "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"
                }
              ]
            ]
          }
        ]
      }
    ]
  }
}

Kuchárka vzorov polí