Sąlyginė logika
Laukai gali būti rodomi arba slepiami atsižvelgiant į sąlygas.
Operatoriai
Galima naudoti 8 skirtingus operatorius:
| Operatorius | Aprašymas |
|---|---|
== |
Reikšmės yra lygios |
!= |
Reikšmės nėra lygios |
includes |
Reikšmė įtraukta į palyginamąją reikšmę |
!includes |
Reikšmė neįtraukta į palyginamąją reikšmę |
empty |
Reikšmė tuščia |
!empty |
Reikšmė netuščia |
< |
Reikšmė mažesnė už palyginamąją reikšmę |
> |
Reikšmė didesnė už palyginamąją reikšmę |
<= |
Reikšmė mažesnė arba lygi palyginamajai reikšmei |
>= |
Reikšmė didesnė arba lygi palyginamajai reikšmei |
Globalios sąlygos
Pagal numatytuosius nustatymus Blockstudio turi 4 globalias sąlygas: įrašo tipą, įrašo ID, naudotojo vaidmenį ir naudotojo 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"
}
]
]
}
]
}
}
Aukščiau pateiktame pavyzdyje teksto atributas bus rodomas redaktoriuje tik tada, jei įrašo ID yra 1386 IR įrašo tipas yra post.
Atkreipkite dėmesį, kad tipų raktams taikoma camelCase konvencija: postType, postId, userRole, userId.
ARBA sąlygos
Norėdami sukurti arba sąlygas, perkelkite kiekvieną sąlygų grupę į atskirą masyvą:
{
"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"
}
]
]
}
]
}
}
Teksto atributas bus rodomas, jei (įrašo ID yra 1386 IR įrašo tipas yra post) ARBA (įrašo tipas yra jobs).
Tinkintos sąlygos
Pasirinktines sąlygas galima pridėti naudojant filtrą blockstudio/blocks/conditions.
Filtras vykdomas PHP įkeliant redaktorių ir grąžina po vieną reikšmę kiekvienam sąlygos tipui. Sąlygos įvertinamos redaktoriuje, kuris pagal operatorių palygina šią reikšmę su sąlygos 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;
});
Grąžinkite netuščią eilutę kiekvienai būsenai. Jei sąlygos tipo reikšmė tuščia arba jos nėra, sąlyga praleidžiama, todėl laukas lieka matomas.
{
"blockstudio": {
"attributes": [
{
"id": "message",
"type": "text",
"label": "My message",
"conditions": [
[
{
"type": "purchasedProduct",
"operator": "==",
"value": "yes"
}
]
]
}
]
}
}
Bloko sąlygos
Galite nustatyti sąlygas, kurios priklauso nuo kitų atributų. Užuot nustatę type raktą, naudokite atributo, kurį norite patikrinti, id:
{
"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
}
]
]
}
]
}
}
Prireikus galite derinti globalias sąlygas su bloko sąlygomis.
Repeater kontekstas
Pagal numatytuosius nustatymus kartotuvų atributų sąlygos priklauso nuo šiuo metu kartojamo elemento atributų.
{
"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
}
]
]
}
]
}
]
}
}
Kadangi atributų ID galioja tik dabartiniame kartotuvo elemente, kartotuvo teksto atributas bus rodomas tik tada, jei kartotuvo viduje esantis perjungiklis nustatytas į true.
Norėdami tikrinti kartotuvo išorėje esantį perjungiklį, prie sąlygos pridėkite "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"
}
]
]
}
]
}
]
}
}