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