Feltételes logika
A mezők feltételektől függően megjeleníthetők vagy elrejthetők.
Operátorok
8 különböző operátor használható:
| Operátor | Leírás |
|---|---|
== |
Az értékek egyenlők |
!= |
Az értékek nem egyenlők |
includes |
Az érték szerepel a referenciaértékben |
!includes |
Az érték nem szerepel a referenciaértékben |
empty |
Az érték üres |
!empty |
Az érték nem üres |
< |
Az érték kisebb a referenciaértéknél |
> |
Az érték nagyobb a referenciaértéknél |
<= |
Az érték kisebb vagy egyenlő a referenciaértéknél |
>= |
Az érték nagyobb vagy egyenlő a referenciaértéknél |
Globális feltételek
Alapértelmezés szerint a Blockstudio 4 globális feltételt tartalmaz: bejegyzéstípus, bejegyzésazonosító, felhasználói szerepkör és felhasználói azonosító.
{
"$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"
}
]
]
}
]
}
}
A fenti példában a text attribútum csak akkor jelenik meg a szerkesztőben, ha a bejegyzésazonosító 1386 ÉS a bejegyzés típusa post.
Vegye figyelembe, hogy a camelCase konvenciót használjuk a típus kulcsaihoz: postType, postId, userRole, userId.
VAGY feltételek
Vagy feltételek létrehozásához helyezze az egyes feltételcsoportokat a saját tömbjükbe:
{
"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"
}
]
]
}
]
}
}
A text attribútum akkor jelenik meg, ha (a bejegyzésazonosító 1386 ÉS a bejegyzés típusa post) VAGY (a bejegyzés típusa jobs).
Egyéni feltételek
Egyéni feltételek a blockstudio/blocks/conditions szűrővel adhatók hozzá.
A szűrő az PHP fut le a szerkesztő betöltésekor, és minden feltételtípushoz egy értéket ad vissza. A feltételek kiértékelése a szerkesztőben történik, amely az operátor segítségével összehasonlítja ezt az értéket a feltétel value értékével.
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;
});
Minden állapothoz nem üres karakterláncot adjon vissza. Az üres vagy hiányzó értékű feltételtípus kimarad, ezért a mező látható marad.
{
"blockstudio": {
"attributes": [
{
"id": "message",
"type": "text",
"label": "My message",
"conditions": [
[
{
"type": "purchasedProduct",
"operator": "==",
"value": "yes"
}
]
]
}
]
}
}
Blokkszintű feltételek
Beállíthat olyan feltételeket, amelyek más attribútumoktól függenek. A type kulcs beállítása helyett használja annak az attribútumnak az id értékét, amelyet ellenőrizni szeretne:
{
"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
}
]
]
}
]
}
}
Szükség szerint kombinálhatja a globális és a blokkszintű feltételeket.
Ismétlőelem kontextusa
Alapértelmezés szerint az ismétlőkben lévő attribútumok feltételei az éppen ismétlődő elem attribútumaitól függenek.
{
"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
}
]
]
}
]
}
]
}
}
Mivel az attribútumazonosítók az aktuális ismétlőelemhez tartoznak, az ismétlőn belüli text attribútum csak akkor jelenik meg, ha az ismétlőn belüli kapcsoló true értékre van állítva.
Ha az ismétlőn kívüli kapcsolót szeretné ellenőrizni, adja hozzá a "context": "main" értéket a feltételhez:
{
"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"
}
]
]
}
]
}
]
}
}