Ga naar de inhoud

Voorwaardelijke logica

Velden kunnen worden getoond of verborgen op basis van voorwaarden.

Operatoren

Er zijn 8 verschillende operatoren die je kunt gebruiken:

Operator Beschrijving
== Waarden zijn gelijk
!= Waarden zijn niet gelijk
includes Waarde is opgenomen in de referentiewaarde
!includes Waarde is niet opgenomen in de referentiewaarde
empty Waarde is leeg
!empty Waarde is niet leeg
< Waarde is kleiner dan de referentiewaarde
> Waarde is groter dan de referentiewaarde
<= Waarde is kleiner dan of gelijk aan de referentiewaarde
>= Waarde is groter dan of gelijk aan de referentiewaarde

Globale voorwaarden

Standaard heeft Blockstudio 4 globale voorwaarden: berichttype, bericht-ID, gebruikersrol en gebruikers-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"
            }
          ]
        ]
      }
    ]
  }
}

In het bovenstaande voorbeeld wordt het tekstkenmerk alleen in de editor weergegeven als het bericht-ID 1386 is EN het berichttype post is.

Let op: de camelCase-conventie wordt gebruikt voor de type keys: postType, postId, userRole, userId.

OF-voorwaarden

Verplaats elke voorwaardengroep naar een eigen array om of-voorwaarden te maken:

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

Het tekstkenmerk wordt weergegeven als (bericht-ID 1386 is EN berichttype post is) OF (berichttype jobs is).

Aangepaste voorwaarden

Aangepaste voorwaarden kunnen worden toegevoegd met het filter blockstudio/blocks/conditions. Het filter wordt uitgevoerd in PHP wanneer de editor wordt geladen en retourneert één waarde per voorwaardetype. Voorwaarden worden geëvalueerd in de editor, die die waarde vergelijkt met de value van de voorwaarde met behulp van de operator.

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

Retourneer voor elke status een niet-lege tekenreeks. Een voorwaardetype waarvan de waarde leeg is of ontbreekt, wordt overgeslagen, waardoor het veld zichtbaar blijft.

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

Blokvoorwaarden

Je kunt voorwaarden instellen die afhangen van andere kenmerken. Gebruik in plaats van een type-key de id van het kenmerk waarmee je wilt vergelijken:

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

Je kunt globale voorwaarden naar behoefte combineren met blokvoorwaarden.

Repeatercontext

Standaard zijn voorwaarden voor kenmerken binnen repeaters afhankelijk van de kenmerken van het momenteel herhaalde element.

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

Omdat kenmerk-ID’s binnen het huidige repeater-element zijn afgebakend, wordt het tekstkenmerk in de repeater alleen weergegeven als de schakelaar in de repeater op true staat.

Voeg "context": "main" toe aan de voorwaarde om te controleren op de schakelaar buiten de repeater:

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

Kookboek met veldpatronen