Treci la conținut

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.

JSON
{
  "$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:

JSON
{
  "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.

PHP
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.

JSON
{
  "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:

JSON
{
  "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.

JSON
{
  "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:

JSON
{
  "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"
                }
              ]
            ]
          }
        ]
      }
    ]
  }
}

Rețetarul modelelor de câmpuri