Zum Inhalt springen

Bedingte Logik

Felder lassen sich abhängig von Bedingungen ein- oder ausblenden.

Operatoren

Es gibt 8 verschiedene Operatoren, die du verwenden kannst:

Operator Beschreibung
== Werte sind gleich
!= Werte sind nicht gleich
includes Wert ist im Referenzwert enthalten
!includes Wert ist nicht im Referenzwert enthalten
empty Wert ist leer
!empty Wert ist nicht leer
< Wert ist kleiner als der Referenzwert
> Wert ist größer als der Referenzwert
<= Wert ist kleiner oder gleich dem Referenzwert
>= Wert ist größer oder gleich dem Referenzwert

Globale Bedingungen

Standardmäßig bringt Blockstudio 4 globale Bedingungen mit: Beitragstyp, Beitrags-ID, Benutzerrolle und Benutzer-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"
            }
          ]
        ]
      }
    ]
  }
}

Im obigen Beispiel wird das Textattribut im Editor nur angezeigt, wenn die Beitrags-ID 1386 ist UND der Beitragstyp post ist.

Beachte, dass für die Typ-Schlüssel die Konvention camelCase verwendet wird: postType, postId, userRole, userId.

ODER-Bedingungen

Um ODER-Bedingungen zu erstellen, verschiebe jede Bedingungsgruppe in ein eigenes Array:

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

Das Textattribut wird angezeigt, wenn (Beitrags-ID 1386 ist UND Beitragstyp post ist) ODER (Beitragstyp jobs ist).

Benutzerdefinierte Bedingungen

Benutzerdefinierte Bedingungen können mit dem Filter blockstudio/blocks/conditions hinzugefügt werden. Der Filter wird in PHP ausgeführt, wenn der Editor geladen wird, und gibt für jeden Bedingungstyp einen Wert zurück. Die Bedingungen werden im Editor ausgewertet, der diesen Wert mithilfe des Operators mit dem value der Bedingung vergleicht.

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

Gib für jeden Status eine nicht leere Zeichenfolge zurück. Ein Bedingungstyp, dessen Wert leer ist oder fehlt, wird übersprungen, sodass das Feld sichtbar bleibt.

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

Blockbedingungen

Du kannst Bedingungen festlegen, die von anderen Attributen abhängen. Verwende statt eines type-Schlüssels die id des Attributs, auf das du verweisen möchtest:

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

Du kannst globale Bedingungen nach Bedarf mit Blockbedingungen kombinieren.

Repeater-Kontext

Standardmäßig hängen Bedingungen für Attribute in Repeatern von den Attributen des aktuell wiederholten Elements ab.

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

Da Attribut-IDs auf das aktuelle Repeater-Element beschränkt sind, wird das Textattribut im Repeater nur angezeigt, wenn der Schalter im Repeater auf true gesetzt ist.

Um den Schalter außerhalb des Repeaters heranzuziehen, füge "context": "main" zur Bedingung hinzu:

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

Field Patterns Cookbook