Podmienená logika
Polia možno zobrazovať alebo skrývať podľa podmienok.
Operátory
Možno použiť 8 rôznych operátorov:
| Operátor | Opis |
|---|---|
== |
Hodnoty sú rovnaké |
!= |
Hodnoty nie sú rovnaké |
includes |
Hodnota je zahrnutá v referenčnej hodnote |
!includes |
Hodnota nie je zahrnutá v referenčnej hodnote |
empty |
Hodnota je prázdna |
!empty |
Hodnota nie je prázdna |
< |
Hodnota je menšia ako referenčná hodnota |
> |
Hodnota je väčšia ako referenčná hodnota |
<= |
Hodnota je menšia alebo rovná referenčnej hodnote |
>= |
Hodnota je väčšia alebo rovná referenčnej hodnote |
Globálne podmienky
Predvolene obsahuje Blockstudio 4 globálne podmienky: typ príspevku, ID príspevku, rola používateľa a ID používateľa.
{
"$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"
}
]
]
}
]
}
}
V príklade vyššie sa atribút text zobrazí v editore iba vtedy, ak ID príspevku je 1386 A ZÁROVEŇ typ príspevku je post.
V konvencii camelCase sa používajú kľúče typu: postType, postId, userRole, userId.
Podmienky ALEBO
Ak chcete vytvoriť podmienky alebo, presuňte každú skupinu podmienok do vlastného poľa:
{
"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"
}
]
]
}
]
}
}
Atribút text sa zobrazí, ak (ID príspevku je 1386 A ZÁROVEŇ typ príspevku je post) ALEBO (typ príspevku je jobs).
Vlastné podmienky
Vlastné podmienky možno pridať pomocou filtra blockstudio/blocks/conditions.
Filter sa spustí v PHP pri načítaní editora a vráti jednu hodnotu pre každý typ
podmienky. Podmienky sa vyhodnocujú v editore, ktorý túto hodnotu porovnáva s
value podmienky pomocou operátora.
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;
});
Pre každý stav vráťte neprázdny reťazec. Typ podmienky s prázdnou alebo chýbajúcou hodnotou sa preskočí, takže pole zostane viditeľné.
{
"blockstudio": {
"attributes": [
{
"id": "message",
"type": "text",
"label": "My message",
"conditions": [
[
{
"type": "purchasedProduct",
"operator": "==",
"value": "yes"
}
]
]
}
]
}
}
Podmienky bloku
Môžete nastaviť podmienky závislé od iných atribútov. Namiesto nastavenia kľúča type použite id atribútu, ktorý chcete kontrolovať:
{
"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
}
]
]
}
]
}
}
Globálne podmienky môžete podľa potreby kombinovať s podmienkami bloku.
Kontext opakovača
Predvolene závisia podmienky pre atribúty v opakovačoch od atribútov aktuálne opakovaného prvku.
{
"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
}
]
]
}
]
}
]
}
}
Keďže ID atribútov sú obmedzené na aktuálny prvok opakovača, atribút text v opakovači sa zobrazí iba vtedy, keď je prepínač v opakovači nastavený na true.
Ak chcete podmienku kontrolovať podľa prepínača mimo opakovača, pridajte do nej "context": "main":
{
"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"
}
]
]
}
]
}
]
}
}