Vai al contenuto

Trasformazioni

Le Trasformazioni dei blocchi API consentono di definire come trasformare i blocchi. Blockstudio supporta attualmente tre tipi diversi:

  • da blocco a blocco: trasforma un blocco in un altro blocco
  • invio: inserisce un blocco quando l’utente digita del testo e preme Enter
  • prefisso: inserisce un blocco quando l’utente digita del testo e preme Space

Da blocco a blocco

Le trasformazioni da blocco a blocco consentono di trasformare un blocco in un altro.

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

Quando si trasforma un blocco in un nuovo blocco, gli attributi di quello originale vengono trasferiti al nuovo blocco. Nell’esempio precedente, l’attributo text viene trasferito al nuovo blocco. Lo stesso vale per tutti i contenuti InnerBlocks.

È importante notare che i tipi degli attributi devono essere uguali nel blocco di destinazione e in quello di origine. Per esempio, se il blocco di destinazione ha un attributo con ID text ma di tipo number, non apparirà nell’elenco delle trasformazioni, perché causerebbe un’incompatibilità di tipo e un errore di rendering.

Il numero di attributi dei due blocchi non deve necessariamente essere uguale.

Invio

Le trasformazioni con Invio consentono di inserire un blocco quando l’utente digita determinati contenuti e poi preme il tasto Enter.

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

Nell’esempio precedente, il blocco verrà inserito quando l’utente digita tre o più trattini (-) e poi preme Enter.

Prefisso

Le trasformazioni con prefisso consentono di inserire un blocco quando l’utente digita determinati contenuti e poi preme il tasto Space.

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

Nell’esempio precedente, il blocco verrà inserito quando l’utente digita tre punti interrogativi (?) e poi preme Space.