Gå til indhold

Betinget logik

Felter kan vises eller skjules afhængigt af betingelser.

Operatorer

Der er 8 forskellige operatorer, du kan bruge:

Operator Beskrivelse
== Værdierne er ens
!= Værdierne er ikke ens
includes Værdien er inkluderet i referenceværdien
!includes Værdien er ikke inkluderet i referenceværdien
empty Værdien er tom
!empty Værdien er ikke tom
< Værdien er mindre end referenceværdien
> Værdien er større end referenceværdien
<= Værdien er mindre end eller lig med referenceværdien
>= Værdien er større end eller lig med referenceværdien

Globale betingelser

Som standard leveres Blockstudio med 4 globale betingelser: indholdstype, indlægs-ID, brugerrolle og bruger-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"
            }
          ]
        ]
      }
    ]
  }
}

I eksemplet ovenfor vises tekstattributten kun i editoren, hvis indlægs-ID’et er 1386 OG indholdstypen er post.

Bemærk, at konventionen camelCase bruges til typenøglerne: postType, postId, userRole, userId.

ELLER-betingelser

Hvis du vil oprette eller-betingelser, skal du flytte hver betingelsesgruppe til sit eget 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"
            }
          ]
        ]
      }
    ]
  }
}

Tekstattributten vises, hvis (indlægs-ID’et er 1386 OG indholdstypen er post) ELLER (indholdstypen er jobs).

Brugerdefinerede betingelser

Brugerdefinerede betingelser kan tilføjes med filteret blockstudio/blocks/conditions. Filteret køres i PHP, når editoren indlæses, og returnerer én værdi pr. betingelsestype. Betingelser evalueres i editoren, som sammenligner værdien med value for betingelsen ved hjælp af operatoren.

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

Returnér en ikke-tom streng for hver tilstand. En betingelsestype, hvis værdi er tom eller mangler, springes over, så feltet forbliver synligt.

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

Blokbetingelser

Du kan angive betingelser, der afhænger af andre attributter. I stedet for at angive en type-nøgle skal du bruge id‘et på den attribut, du vil kontrollere:

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 kan kombinere globale betingelser med blokbetingelser efter behov.

Repeater-kontekst

Som standard afhænger betingelser for attributter i repeatere af attributterne for det aktuelt gentagne element.

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-ID’er er afgrænset til det aktuelle repeater-element, vises tekstattributten i repeateren kun, hvis til/fra-knappen i repeateren er slået til.

Hvis du vil kontrollere til/fra-knappen uden for repeateren, skal du føje "context": "main" til betingelsen:

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