Ga naar de inhoud

Transformaties

Met Bloktransformaties API kun je manieren definiëren om blokken te transformeren. Blockstudio ondersteunt momenteel drie verschillende typen:

  • blok naar blok: een blok omzetten in een ander blok
  • enter: een blok invoegen wanneer de gebruiker tekst invoert en op Enter drukt
  • voorvoegsel: een blok invoegen wanneer de gebruiker tekst invoert en op Space drukt

Blok naar blok

Met blok-naar-bloktransformaties kunt u een blok omzetten in een ander blok.

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

Bij het omzetten naar het nieuwe blok worden de attributen van het oude blok aan het nieuwe blok doorgegeven. In het bovenstaande voorbeeld wordt het attribuut text doorgegeven aan het nieuwe blok. Hetzelfde geldt voor alle inhoud van InnerBlocks.

De attribuuttypen moeten hetzelfde zijn voor het blok waarnaar wordt omgezet en het blok waarvan wordt omgezet. Als het blok waarnaar wordt omgezet bijvoorbeeld een attribuut met ID text maar type number heeft, verschijnt het niet in de transformatielijst. Dit zou namelijk een typeconflict en een renderfout veroorzaken.

Het aantal attributen hoeft voor de twee blokken niet gelijk te zijn.

Enter

Met Enter-transformaties kunt u een blok invoegen wanneer de gebruiker bepaalde inhoud typt en vervolgens op de toets Enter drukt.

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

In het bovenstaande voorbeeld wordt het blok ingevoegd wanneer de gebruiker drie of meer streepjes (-) typt en vervolgens op Enter drukt.

Voorvoegsel

Met voorvoegseltransformaties kunt u een blok invoegen wanneer de gebruiker bepaalde inhoud typt en vervolgens op de toets Space drukt.

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

In het bovenstaande voorbeeld wordt het blok ingevoegd wanneer de gebruiker drie vraagtekens (?) typt en vervolgens op Space drukt.