转换
区块转换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,就会插入区块。