跳转到正文

转换

区块转换API可让你定义转换区块的方式。Blockstudio目前支持三种类型:

  • 区块转区块:将一个区块转换为另一个区块
  • 回车键:用户输入文本并按下 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 键时插入区块。

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

在上面的示例中,用户输入三个或更多连字符(-)后按下 Enter,就会插入区块。

前缀

前缀转换可在用户输入特定内容后按下 Space 键时插入区块。

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

在上面的示例中,用户输入三个问号(?)后按下 Space,就会插入区块。