Pereiti prie turinio

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.

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

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ą:

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

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.

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

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.

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

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

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

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

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

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

Laukų šablonų receptų rinkinys