Nosacījumu loģika
Laukus var rādīt vai paslēpt atkarībā no nosacījumiem.
Operatori
Var izmantot 8 dažādus operatorus:
| Operators | Apraksts |
|---|---|
== |
Vērtības ir vienādas |
!= |
Vērtības nav vienādas |
includes |
Vērtība ir ietverta atsauces vērtībā |
!includes |
Vērtība nav ietverta atsauces vērtībā |
empty |
Vērtība ir tukša |
!empty |
Vērtība nav tukša |
< |
Vērtība ir mazāka par atsauces vērtību |
> |
Vērtība ir lielāka par atsauces vērtību |
<= |
Vērtība ir mazāka vai vienāda ar atsauces vērtību |
>= |
Vērtība ir lielāka vai vienāda ar atsauces vērtību |
Globālie nosacījumi
Pēc noklusējuma Blockstudio ir pieejami 4 globālie nosacījumi: ieraksta tips, ieraksta ID, lietotāja loma un lietotāja ID.
{
"$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"
}
]
]
}
]
}
}
Iepriekš minētajā piemērā teksta atribūts redaktora skatā tiek rādīts tikai tad, ja ieraksta ID ir 1386 UN ieraksta tips ir post.
Ņemiet vērā, ka tipa atslēgām tiek izmantota camelCase konvencija: postType, postId, userRole, userId.
VAI nosacījumi
Lai izveidotu VAI nosacījumus, ievietojiet katru nosacījumu grupu savā masīvā:
{
"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"
}
]
]
}
]
}
}
Teksta atribūts tiks rādīts, ja (ieraksta ID ir 1386 UN ieraksta tips ir post) VAI (ieraksta tips ir jobs).
Pielāgotie nosacījumi
Pielāgotus nosacījumus var pievienot, izmantojot filtru blockstudio/blocks/conditions.
Filtrs darbojas PHP, kad tiek ielādēts redaktors, un atgriež vienu vērtību katram nosacījuma tipam. Nosacījumi tiek izvērtēti redaktorā, kas, izmantojot operatoru, salīdzina šo vērtību ar nosacījuma value.
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;
});
Katrā stāvoklī atgrieziet virkni, kas nav tukša. Nosacījuma tips, kura vērtība ir tukša vai nav norādīta, tiek izlaists, tāpēc lauks paliek redzams.
{
"blockstudio": {
"attributes": [
{
"id": "message",
"type": "text",
"label": "My message",
"conditions": [
[
{
"type": "purchasedProduct",
"operator": "==",
"value": "yes"
}
]
]
}
]
}
}
Bloka nosacījumi
Varat iestatīt nosacījumus, kas ir atkarīgi no citiem atribūtiem. Atslēgas type vietā izmantojiet tā atribūta id, kuru vēlaties pārbaudīt:
{
"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
}
]
]
}
]
}
}
Pēc vajadzības varat apvienot globālos un bloka nosacījumus.
Atkārtotāja konteksts
Pēc noklusējuma atkārtotāju atribūtu nosacījumi ir atkarīgi no pašlaik atkārtotā elementa atribūtiem.
{
"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
}
]
]
}
]
}
]
}
}
Tā kā atribūtu ID ir piesaistīti pašreizējam atkārtotāja elementam, teksta atribūts atkārtotājā tiks rādīts tikai tad, ja pārslēgs atkārtotāja iekšpusē ir iestatīts uz true.
Lai pārbaudītu pārslēgu ārpus atkārtotāja, nosacījumam pievienojiet "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"
}
]
]
}
]
}
]
}
}