
# 변환

[블록 변환API](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-transforms/)을 사용하면 블록을 변환하는 방법을 정의할 수 있습니다. Blockstudio은 현재 세 가지 유형을 지원합니다.

- **블록 간 변환**: 한 블록을 다른 블록으로 변환
- **Enter**: 사용자가 텍스트를 입력하고 `Enter`을 누르면 블록 삽입
- **접두어**: 사용자가 텍스트를 입력하고 `Space`을 누르면 블록 삽입

## 블록 간 변환

블록 간 변환을 사용하면 한 블록을 다른 블록으로 변환할 수 있습니다.

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

새 블록으로 변환할 때 이전 블록의 속성이 새 블록에 전달됩니다. 위의 예에서는 `text` 속성이 새 블록에 전달됩니다. 모든 `InnerBlocks` 콘텐츠도 마찬가지로 전달됩니다.

변환 대상 블록과 원본 블록의 속성 유형은 같아야 합니다. 예를 들어 변환 대상 블록에 ID가 `text`이고 유형이 `number`인 속성이 있으면, 유형이 일치하지 않아 렌더링 오류가 발생하므로 변환 목록에 표시되지 않습니다.

두 블록의 속성 개수는 같지 않아도 됩니다.

## 입력

Enter 변환을 사용하면 사용자가 특정 콘텐츠를 입력한 뒤 `Enter` 키를 눌렀을 때 블록을 삽입할 수 있습니다.

```json title="block.json"
{
  "blockstudio": {
    "transforms": {
      "from": [
        {
          "type": "enter",
          "regExp": "/^-{3,}$/"
        }
      ]
    }
  }
}
```

위의 예에서는 대시(`-`)를 세 개 이상 입력한 뒤 `Enter`을 누르면 블록이 삽입됩니다.

## 접두어

접두어 변환을 사용하면 사용자가 특정 콘텐츠를 입력한 뒤 `Space` 키를 눌렀을 때 블록을 삽입할 수 있습니다.

```json title="block.json"
{
  "blockstudio": {
    "transforms": {
      "from": [
        {
          "type": "prefix",
          "regExp": "???"
        }
      ]
    }
  }
}
```

위의 예에서는 물음표(`?`)를 세 개 입력한 뒤 `Space`을 누르면 블록이 삽입됩니다.
