Preskoči na vsebino

Pogojna logika

Polja lahko prikažete ali skrijete glede na pogoje.

Operatorji

Na voljo je 8 različnih operatorjev:

Operator Opis
== Vrednosti sta enaki
!= Vrednosti nista enaki
includes Vrednost je vključena v referenčno vrednost
!includes Vrednost ni vključena v referenčno vrednost
empty Vrednost je prazna
!empty Vrednost ni prazna
< Vrednost je manjša od referenčne vrednosti
> Vrednost je večja od referenčne vrednosti
<= Vrednost je manjša ali enaka referenčni vrednosti
>= Vrednost je večja ali enaka referenčni vrednosti

Globalni pogoji

Privzeto Blockstudio vključuje 4 globalne pogoje: vrsto objave, ID objave, uporabniško vlogo in uporabniški ID.

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

V zgornjem primeru se bo atribut text v urejevalniku prikazal samo, če je ID objave 1386 IN je vrsta objave post.

Upoštevajte, da se za ključe vrste uporablja konvencija camelCase: postType, postId, userRole, userId.

Pogoji OR

Če želite ustvariti pogoje or, premaknite vsako skupino pogojev v svojo matriko:

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

Atribut text se bo prikazal, če (je ID objave 1386 IN je vrsta objave post) ALI (je vrsta objave jobs).

Pogoji po meri

Pogoje po meri lahko dodate s filtrom blockstudio/blocks/conditions. Filter se zažene v PHP ob nalaganju urejevalnika in vrne eno vrednost za vsako vrsto pogoja. Pogoji se ovrednotijo v urejevalniku, ki to vrednost primerja z value pogoja z uporabo operatorja.

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;
});

Za vsako stanje vrnite neprazen niz. Vrsta pogoja s prazno ali manjkajočo vrednostjo je preskočena, zato polje ostane vidno.

JSON
{
  "blockstudio": {
    "attributes": [
      {
        "id": "message",
        "type": "text",
        "label": "My message",
        "conditions": [
          [
            {
              "type": "purchasedProduct",
              "operator": "==",
              "value": "yes"
            }
          ]
        ]
      }
    ]
  }
}

Pogoji bloka

Nastavite lahko pogoje, ki so odvisni od drugih atributov. Namesto ključa type uporabite id atributa, ki ga želite preveriti:

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
            }
          ]
        ]
      }
    ]
  }
}

Globalne pogoje lahko po potrebi kombinirate s pogoji bloka.

Kontekst ponavljalnika

Privzeto so pogoji za atribute znotraj ponavljalnikov odvisni od atributov trenutno ponovljenega elementa.

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
                }
              ]
            ]
          }
        ]
      }
    ]
  }
}

Ker so ID-ji atributov omejeni na trenutni element ponavljalnika, se bo atribut text znotraj ponavljalnika prikazal samo, če je preklopni gumb znotraj ponavljalnika nastavljen na true.

Če želite preveriti preklopni gumb zunaj ponavljalnika, pogoju dodajte "context": "main":

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

Kuharica vzorcev polj