
# Transformações

O recurso [Transformações de blocos API](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-transforms/) 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 title="block.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 title="block.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 title="block.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`.
