본문으로 건너뛰기

변환

블록 변환API을 사용하면 블록을 변환하는 방법을 정의할 수 있습니다. Blockstudio은 현재 세 가지 유형을 지원합니다.

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

블록 간 변환

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

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
{
  "blockstudio": {
    "transforms": {
      "from": [
        {
          "type": "enter",
          "regExp": "/^-{3,}$/"
        }
      ]
    }
  }
}

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

접두어

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

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

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