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.
{
"$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:
{
"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.
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.
{
"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:
{
"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.
{
"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:
{
"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"
}
]
]
}
]
}
]
}
}