Logică condițională
Câmpurile pot fi afișate sau ascunse în funcție de condiții.
Operatori
Se pot folosi 8 operatori diferiți:
| Operator | Descriere |
|---|---|
== |
Valorile sunt egale |
!= |
Valorile nu sunt egale |
includes |
Valoarea este inclusă în valoarea de referință |
!includes |
Valoarea nu este inclusă în valoarea de referință |
empty |
Valoarea este goală |
!empty |
Valoarea nu este goală |
< |
Valoarea este mai mică decât valoarea de referință |
> |
Valoarea este mai mare decât valoarea de referință |
<= |
Valoarea este mai mică sau egală cu valoarea de referință |
>= |
Valoarea este mai mare sau egală cu valoarea de referință |
Condiții globale
În mod implicit, Blockstudio include 4 condiții globale: tipul articolului, ID-ul articolului, rolul utilizatorului și ID-ul utilizatorului.
{
"$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"
}
]
]
}
]
}
}
În exemplul de mai sus, atributul text va fi afișat în editor numai dacă ID-ul articolului este 1386 ȘI tipul articolului este post.
Rețineți că se folosește convenția camelCase pentru cheile de tip: postType, postId, userRole, userId.
Condiții OR
Pentru a crea condiții sau, mutați fiecare grup de condiții în propriul tablou:
{
"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"
}
]
]
}
]
}
}
Atributul text va fi afișat dacă (ID-ul articolului este 1386 ȘI tipul articolului este post) SAU (tipul articolului este jobs).
Condiții personalizate
Puteți adăuga condiții personalizate folosind filtrul blockstudio/blocks/conditions.
Filtrul rulează în PHP la încărcarea editorului și returnează o valoare pentru fiecare tip de condiție. Condițiile sunt evaluate în editor, care compară valoarea respectivă cu value condiției folosind operatorul.
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;
});
Returnați un șir nevid pentru fiecare stare. Un tip de condiție a cărui valoare este goală sau lipsește este omis, astfel că acel câmp rămâne vizibil.
{
"blockstudio": {
"attributes": [
{
"id": "message",
"type": "text",
"label": "My message",
"conditions": [
[
{
"type": "purchasedProduct",
"operator": "==",
"value": "yes"
}
]
]
}
]
}
}
Condiții pentru blocuri
Puteți seta condiții care depind de alte atribute. În loc să setați o cheie type, folosiți id-ul atributului pe care doriți să îl verificați:
{
"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
}
]
]
}
]
}
}
Puteți combina condițiile globale cu cele pentru blocuri, după cum este necesar.
Contextul repetitoarelor
În mod implicit, condițiile pentru atributele din repetitoare depind de atributele elementului repetat curent.
{
"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
}
]
]
}
]
}
]
}
}
Deoarece ID-urile atributelor sunt limitate la elementul repetat curent, atributul text din repetitor va fi afișat numai dacă comutatorul din interiorul repetitorului este setat la true.
Pentru a verifica valoarea comutatorului din afara repetitorului, adăugați "context": "main" la condiție:
{
"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"
}
]
]
}
]
}
]
}
}