Siirry sisältöön

Ehdollinen logiikka

Kenttiä voidaan näyttää tai piilottaa ehtojen perusteella.

Operaattorit

Käytettävissä on 8 eri operaattoria:

Operaattori Kuvaus
== Arvot ovat samat
!= Arvot eivät ole samat
includes Arvo sisältyy viitearvoon
!includes Arvo ei sisälly viitearvoon
empty Arvo on tyhjä
!empty Arvo ei ole tyhjä
< Arvo on pienempi kuin viitearvo
> Arvo on suurempi kuin viitearvo
<= Arvo on pienempi tai yhtä suuri kuin viitearvo
>= Arvo on suurempi tai yhtä suuri kuin viitearvo

Globaalit ehdot

Oletuksena Blockstudio sisältää 4 globaalia ehtoa: sisältötyyppi, sisältötunnus, käyttäjärooli ja käyttäjätunnus.

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

Yllä olevassa esimerkissä tekstimäärite näkyy editorissa vain, jos sisältötunnus on 1386 JA sisältötyyppi on post.

Huomaa, että tyyppiavaimissa käytetään camelCase-käytäntöä: postType, postId, userRole, userId.

TAI-ehdot

Luo tai-ehtoja siirtämällä kukin ehtoryhmä omaan taulukkoonsa:

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

Tekstimäärite näkyy, jos (sisältötunnus on 1386 JA sisältötyyppi on post) TAI (sisältötyyppi on jobs).

Mukautetut ehdot

Mukautettuja ehtoja voi lisätä suodattimella blockstudio/blocks/conditions. Suodatin suoritetaan kohteessa PHP editorin latautuessa, ja se palauttaa yhden arvon kutakin ehtotyyppiä kohti. Ehdot arvioidaan editorissa, joka vertaa tätä arvoa ehdon value-arvoon operaattorin avulla.

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

Palauta jokaiselle tilalle muu kuin tyhjä merkkijono. Ehtotyyppi, jonka arvo on tyhjä tai puuttuu, ohitetaan, joten kenttä jää näkyviin.

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

Lohkoehdot

Voit määrittää ehtoja, jotka riippuvat muista määritteistä. Aseta type-avaimen sijaan sen määritteen id, jonka arvoa haluat tarkistaa:

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

Voit yhdistää globaaleja ehtoja lohkoehtoihin tarpeen mukaan.

Toistimen konteksti

Oletuksena toistimien sisällä olevien määritteiden ehdot riippuvat parhaillaan toistettavan elementin määritteistä.

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

Koska määritteiden tunnukset rajoittuvat nykyiseen toistinelementtiin, toistimen sisällä oleva tekstimäärite näkyy vain, jos toistimen sisäinen kytkin on asetettu arvoon true.

Jos haluat tarkistaa toistimen ulkopuolisen kytkimen arvon, lisää ehtoosi "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"
                }
              ]
            ]
          }
        ]
      }
    ]
  }
}

Kenttämallien keittokirja