Transformações
O recurso Transformações de blocos API 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.
{
"$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.
{
"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.
{
"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.