Vai al contenuto

Logica condizionale

I campi possono essere mostrati o nascosti in base a condizioni.

Operatori

Sono disponibili 8 operatori diversi:

Operatore Descrizione
== I valori sono uguali
!= I valori non sono uguali
includes Il valore è incluso nel valore di riferimento
!includes Il valore non è incluso nel valore di riferimento
empty Il valore è vuoto
!empty Il valore non è vuoto
< Il valore è minore del valore di riferimento
> Il valore è maggiore del valore di riferimento
<= Il valore è minore o uguale al valore di riferimento
>= Il valore è maggiore o uguale al valore di riferimento

Condizioni globali

Per impostazione predefinita, Blockstudio include 4 condizioni globali: tipo di contenuto, ID del contenuto, ruolo utente e ID utente.

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

Nell’esempio precedente, l’attributo text verrà mostrato nell’editor solo se l’ID del contenuto è 1386 E il tipo di contenuto è post.

Si noti che viene usata la convenzione camelCase per le chiavi type: postType, postId, userRole, userId.

Condizioni OR

Per creare condizioni or, spostate ogni gruppo di condizioni nel proprio array:

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

L’attributo text verrà mostrato se (l’ID del contenuto è 1386 E il tipo di contenuto è post) OPPURE (il tipo di contenuto è jobs).

Condizioni personalizzate

È possibile aggiungere condizioni personalizzate usando il filtro blockstudio/blocks/conditions. Il filtro viene eseguito in PHP al caricamento dell’editor e restituisce un valore per ogni tipo di condizione. Le condizioni vengono valutate nell’editor, che confronta quel valore con il value della condizione usando l’operatore.

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

Restituite una stringa non vuota per ogni stato. Un tipo di condizione il cui valore è vuoto o mancante viene ignorato, quindi il campo rimane visibile.

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

Condizioni del blocco

È possibile impostare condizioni che dipendono da altri attributi. Invece di impostare una chiave type, usate l’id dell’attributo rispetto al quale volete effettuare il controllo:

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

Potete combinare le condizioni globali con quelle del blocco secondo necessità.

Contesto del repeater

Per impostazione predefinita, le condizioni degli attributi all’interno dei repeater dipendono dagli attributi dell’elemento ripetuto corrente.

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

Poiché gli ID degli attributi sono circoscritti all’elemento corrente del repeater, l’attributo text al suo interno verrà mostrato solo se l’interruttore all’interno del repeater è impostato su true.

Per verificare l’interruttore esterno al repeater, aggiungete "context": "main" alla condizione:

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

Ricettario dei modelli di campo