Aller au contenu

Logique conditionnelle

Les champs peuvent être affichés ou masqués selon certaines conditions.

Opérateurs

Il existe 8 opérateurs différents que vous pouvez utiliser :

Opérateur Description
== Les valeurs sont égales
!= Les valeurs ne sont pas égales
includes La valeur est incluse dans la valeur de référence
!includes La valeur n’est pas incluse dans la valeur de référence
empty La valeur est vide
!empty La valeur n’est pas vide
< La valeur est inférieure à la valeur de référence
> La valeur est supérieure à la valeur de référence
<= La valeur est inférieure ou égale à la valeur de référence
>= La valeur est supérieure ou égale à la valeur de référence

Conditions globales

Par défaut, Blockstudio est fourni avec 4 conditions globales : le type d’article, l’ID de l’article, le rôle de l’utilisateur et l’ID de l’utilisateur.

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

Dans l’exemple ci-dessus, l’attribut text ne s’affichera dans l’éditeur que si l’ID de l’article est 1386 ET que le type d’article est post.

Notez que la convention camelCase est utilisée pour les clés de type : postType, postId, userRole, userId.

Conditions OR

Pour créer des conditions ou, placez chaque groupe de conditions dans son propre tableau :

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’attribut text s’affichera si (l’ID de l’article est 1386 ET le type d’article est post) OU (le type d’article est jobs).

Conditions personnalisées

Des conditions personnalisées peuvent être ajoutées à l’aide du filtre blockstudio/blocks/conditions. Le filtre s’exécute dans PHP au chargement de l’éditeur et renvoie une valeur par type de condition. Les conditions sont évaluées dans l’éditeur, qui compare cette valeur à value de la condition à l’aide de l’opérateur.

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

Renvoyez une chaîne non vide pour chaque état. Un type de condition dont la valeur est vide ou absente est ignoré, le champ resterait donc visible.

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

Conditions des blocs

Vous pouvez définir des conditions qui dépendent d’autres attributs. Au lieu de définir une clé type, utilisez l’id de l’attribut à vérifier :

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

Vous pouvez combiner les conditions globales et celles des blocs selon vos besoins.

Contexte des répéteurs

Par défaut, les conditions des attributs à l’intérieur des répéteurs dépendent des attributs de l’élément répété actuel.

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

Comme les ID des attributs sont propres à l’élément répété actuel, l’attribut text à l’intérieur du répéteur ne s’affichera que si l’option toggle à l’intérieur du répéteur est activée.

Pour vérifier l’option toggle située à l’extérieur du répéteur, ajoutez "context": "main" à la condition :

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

Recueil de motifs de champs