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