Pular para o conteúdo

Transformações

O recurso Transformações de blocos API permite definir formas de transformar blocos. Atualmente, Blockstudio oferece três tipos diferentes:

  • bloco para bloco: transforma um bloco em outro
  • enter: insere um bloco quando o usuário digita um texto e pressiona Enter
  • prefixo: insere um bloco quando o usuário digita um texto e pressiona Space

Bloco para bloco

As transformações de bloco para bloco permitem transformar um bloco em outro.

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

Ao transformar para o novo bloco, os atributos do bloco antigo serão passados ao novo bloco. No exemplo acima, o atributo text será passado ao novo bloco. O mesmo vale para todo o conteúdo InnerBlocks.

É importante observar que os tipos de atributo precisam ser iguais nos blocos de origem e destino da transformação. Por exemplo, se o bloco de destino tiver um atributo com o ID text, mas do tipo number, ele não aparecerá na lista de transformações, pois isso causaria incompatibilidade de tipos e um erro de renderização.

Os dois blocos não precisam ter o mesmo número de atributos.

Enter

As transformações Enter permitem inserir um bloco quando o usuário digita determinado conteúdo e pressiona a tecla Enter.

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

No exemplo acima, o bloco será inserido quando o usuário digitar três ou mais hífens (-) e pressionar Enter.

Prefixo

As transformações por prefixo permitem inserir um bloco quando o usuário digita determinado conteúdo e pressiona a tecla Space.

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

No exemplo acima, o bloco será inserido quando o usuário digitar três pontos de interrogação (?) e pressionar Space.