Ugrás a tartalomhoz

Feltételes logika

A mezők feltételektől függően megjeleníthetők vagy elrejthetők.

Operátorok

8 különböző operátor használható:

Operátor Leírás
== Az értékek egyenlők
!= Az értékek nem egyenlők
includes Az érték szerepel a referenciaértékben
!includes Az érték nem szerepel a referenciaértékben
empty Az érték üres
!empty Az érték nem üres
< Az érték kisebb a referenciaértéknél
> Az érték nagyobb a referenciaértéknél
<= Az érték kisebb vagy egyenlő a referenciaértéknél
>= Az érték nagyobb vagy egyenlő a referenciaértéknél

Globális feltételek

Alapértelmezés szerint a Blockstudio 4 globális feltételt tartalmaz: bejegyzéstípus, bejegyzésazonosító, felhasználói szerepkör és felhasználói azonosító.

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

A fenti példában a text attribútum csak akkor jelenik meg a szerkesztőben, ha a bejegyzésazonosító 1386 ÉS a bejegyzés típusa post.

Vegye figyelembe, hogy a camelCase konvenciót használjuk a típus kulcsaihoz: postType, postId, userRole, userId.

VAGY feltételek

Vagy feltételek létrehozásához helyezze az egyes feltételcsoportokat a saját tömbjükbe:

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

A text attribútum akkor jelenik meg, ha (a bejegyzésazonosító 1386 ÉS a bejegyzés típusa post) VAGY (a bejegyzés típusa jobs).

Egyéni feltételek

Egyéni feltételek a blockstudio/blocks/conditions szűrővel adhatók hozzá. A szűrő az PHP fut le a szerkesztő betöltésekor, és minden feltételtípushoz egy értéket ad vissza. A feltételek kiértékelése a szerkesztőben történik, amely az operátor segítségével összehasonlítja ezt az értéket a feltétel value értékével.

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

Minden állapothoz nem üres karakterláncot adjon vissza. Az üres vagy hiányzó értékű feltételtípus kimarad, ezért a mező látható marad.

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

Blokkszintű feltételek

Beállíthat olyan feltételeket, amelyek más attribútumoktól függenek. A type kulcs beállítása helyett használja annak az attribútumnak az id értékét, amelyet ellenőrizni szeretne:

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

Szükség szerint kombinálhatja a globális és a blokkszintű feltételeket.

Ismétlőelem kontextusa

Alapértelmezés szerint az ismétlőkben lévő attribútumok feltételei az éppen ismétlődő elem attribútumaitól függenek.

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

Mivel az attribútumazonosítók az aktuális ismétlőelemhez tartoznak, az ismétlőn belüli text attribútum csak akkor jelenik meg, ha az ismétlőn belüli kapcsoló true értékre van állítva.

Ha az ismétlőn kívüli kapcsolót szeretné ellenőrizni, adja hozzá a "context": "main" értéket a feltételhez:

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

Mezőminták szakácskönyve