Zum Inhalt springen

Transformationen

Mit Blocktransformationen API kannst du festlegen, wie Blöcke umgewandelt werden. Blockstudio unterstützt derzeit drei verschiedene Typen:

  • Block zu Block: einen Block in einen anderen umwandeln
  • Eingabetaste: einen Block einfügen, wenn der Benutzer Text eingibt und Enter drückt
  • Präfix: einen Block einfügen, wenn der Benutzer Text eingibt und Space drückt

Block zu Block

Mit Block-zu-Block-Transformationen kannst du einen Block in einen anderen umwandeln.

JSON
{
  "$schema": "https://blockstudio.dev/schema/block",
  "name": "blockstudio/transforms",
  "title": "Native Transforms",
  "icon": "star-filled",
  "description": "Native Blockstudio Transforms.",
  "blockstudio": {
    "transforms": {
      "from": [
        {
          "type": "block",
          "blocks": [
            "blockstudio/transforms-2",
            "blockstudio/transforms-3"
          ]
        }
      ]
    },
    "attributes": [
      {
        "id": "text",
        "type": "text",
        "label": "Text"
      }
    ]
  }
}

Beim Umwandeln in den neuen Block werden die Attribute des alten Blocks an den neuen Block übergeben. Im obigen Beispiel wird das Attribut text an den neuen Block übergeben. Das gilt auch für alle Inhalte vom Typ InnerBlocks.

Wichtig ist, dass die Attributtypen des Zielblocks und des Ausgangsblocks übereinstimmen müssen. Hat der Zielblock beispielsweise ein Attribut mit der ID text, aber vom Typ number, erscheint es nicht in der Transformationsliste, da dies zu einem Typkonflikt und einem Darstellungsfehler führen würde.

Die Anzahl der Attribute muss bei den beiden Blöcken nicht übereinstimmen.

Eingabetaste

Mit Eingabetasten-Transformationen kannst du einen Block einfügen, wenn der Benutzer bestimmte Inhalte eingibt und anschließend die Taste Enter drückt.

JSON
{
  "blockstudio": {
    "transforms": {
      "from": [
        {
          "type": "enter",
          "regExp": "/^-{3,}$/"
        }
      ]
    }
  }
}

Im obigen Beispiel wird der Block eingefügt, wenn der Benutzer drei oder mehr Bindestriche (-) eingibt und anschließend Enter drückt.

Präfix

Mit Präfix-Transformationen kannst du einen Block einfügen, wenn der Benutzer bestimmte Inhalte eingibt und anschließend die Taste Space drückt.

JSON
{
  "blockstudio": {
    "transforms": {
      "from": [
        {
          "type": "prefix",
          "regExp": "???"
        }
      ]
    }
  }
}

Im obigen Beispiel wird der Block eingefügt, wenn der Benutzer drei Fragezeichen (?) eingibt und anschließend Space drückt.