Saltar al contenido

Lógica condicional

Los campos se pueden mostrar u ocultar según ciertas condiciones.

Operadores

Se pueden usar 8 operadores diferentes:

Operador Descripción
== Los valores son iguales
!= Los valores no son iguales
includes El valor está incluido en el valor de referencia
!includes El valor no está incluido en el valor de referencia
empty El valor está vacío
!empty El valor no está vacío
< El valor es menor que el valor de referencia
> El valor es mayor que el valor de referencia
<= El valor es menor o igual que el valor de referencia
>= El valor es mayor o igual que el valor de referencia

Condiciones globales

Por defecto, Blockstudio incluye 4 condiciones globales: tipo de contenido, ID del contenido, perfil de usuario e ID de usuario.

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

En el ejemplo anterior, el atributo text solo aparecerá en el editor si el ID del contenido es 1386 Y el tipo de contenido es post.

Ten en cuenta que se usa la convención camelCase para las claves de tipo: postType, postId, userRole, userId.

Condiciones OR

Para crear condiciones o, coloca cada grupo de condiciones en su propio 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"
            }
          ]
        ]
      }
    ]
  }
}

El atributo text aparecerá si (el ID del contenido es 1386 Y el tipo de contenido es post) O (el tipo de contenido es jobs).

Condiciones personalizadas

Se pueden añadir condiciones personalizadas mediante el filtro blockstudio/blocks/conditions. El filtro se ejecuta en PHP cuando se carga el editor y devuelve un valor por cada tipo de condición. Las condiciones se evalúan en el editor, que compara ese valor con el value de la condición mediante el operador.

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

Devuelva una cadena no vacía para cada estado. Se omite cualquier tipo de condición cuyo valor esté vacío o no exista, por lo que el campo permanecería visible.

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

Condiciones del bloque

Puedes establecer condiciones que dependan de otros atributos. En lugar de establecer una clave type, usa el id del atributo que quieres comprobar:

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

Puedes combinar condiciones globales y condiciones del bloque según sea necesario.

Contexto de repetidor

Por defecto, las condiciones de los atributos dentro de repetidores dependen de los atributos del elemento que se está repitiendo.

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

Como los ID de los atributos se limitan al elemento actual del repetidor, el atributo text dentro del repetidor solo aparecerá si el conmutador dentro del repetidor está establecido en true.

Para comprobar el conmutador que está fuera del repetidor, añade "context": "main" a la condición:

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

Recetario de patrones de campos