Lógica condicional
Os campos podem ser exibidos ou ocultados dependendo das condições.
Operadores
Há 8 operadores diferentes que podem ser usados:
| Operador | Descrição |
|---|---|
== |
Os valores são iguais |
!= |
Os valores são diferentes |
includes |
O valor está incluído no valor de referência |
!includes |
O valor não está incluído no valor de referência |
empty |
O valor está vazio |
!empty |
O valor não está vazio |
< |
O valor é menor que o valor de referência |
> |
O valor é maior que o valor de referência |
<= |
O valor é menor ou igual ao valor de referência |
>= |
O valor é maior ou igual ao valor de referência |
Condições globais
Por padrão, Blockstudio inclui 4 condições globais: tipo de post, ID do post, função do usuário e ID do usuário.
{
"$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"
}
]
]
}
]
}
}
No exemplo acima, o atributo text só será exibido no editor se o ID do post for 1386 E o tipo do post for post.
Observe que a convenção camelCase é usada nas chaves de tipo: postType, postId, userRole, userId.
Condições OR
Para criar condições or, coloque cada grupo de condições em seu próprio 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"
}
]
]
}
]
}
}
O atributo text será exibido se (o ID do post for 1386 E o tipo do post for post) OU (o tipo do post for jobs).
Condições personalizadas
É possível adicionar condições personalizadas usando o filtro blockstudio/blocks/conditions.
O filtro é executado em PHP quando o editor é carregado e retorna um valor por tipo de
condição. As condições são avaliadas no editor, que compara esse valor com o
value da condição usando o 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;
});
Retorne uma string não vazia para cada estado. Um tipo de condição cujo valor esteja vazio ou ausente é ignorado, então o campo permanecerá visível.
{
"blockstudio": {
"attributes": [
{
"id": "message",
"type": "text",
"label": "My message",
"conditions": [
[
{
"type": "purchasedProduct",
"operator": "==",
"value": "yes"
}
]
]
}
]
}
}
Condições de bloco
Você pode definir condições que dependam de outros atributos. Em vez de definir uma chave type, use o id do atributo que deseja verificar:
{
"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
}
]
]
}
]
}
}
Você pode combinar condições globais com condições de bloco conforme necessário.
Contexto do repetidor
Por padrão, as condições dos atributos dentro de repetidores dependem dos atributos do elemento repetido no momento.
{
"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 os IDs dos atributos são definidos no escopo do elemento atual do repetidor, o atributo text dentro do repetidor só será exibido se o toggle dentro do repetidor estiver definido como true.
Para verificar o toggle fora do repetidor, adicione "context": "main" à condição:
{
"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"
}
]
]
}
]
}
]
}
}