Transformaciones
Block Transforms API permite definir cómo transformar unos bloques en otros. Blockstudio admite actualmente tres tipos distintos:
- de bloque a bloque: transformar un bloque en otro
- al pulsar Intro: insertar un bloque cuando el usuario escriba texto y pulse
Enter - prefijo: insertar un bloque cuando el usuario escriba texto y pulse
Space
De bloque a bloque
Las transformaciones de bloque a bloque permiten transformar un bloque en otro.
{
"$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"
}
]
}
}
Al transformarse en el nuevo bloque, se le pasarán los atributos del bloque anterior. En el ejemplo anterior, se pasará al nuevo bloque el atributo text. Lo mismo se aplica a todo el contenido de InnerBlocks.
Es importante tener en cuenta que los tipos de atributo deben coincidir en los bloques de origen y de destino de la transformación. Por ejemplo, si el bloque de destino tiene un atributo con el ID text, pero de tipo number, no aparecerá en la lista de transformaciones, ya que provocaría una incompatibilidad de tipos y un error de representación.
Los dos bloques no tienen que tener el mismo número de atributos.
Al pulsar Intro
Las transformaciones al pulsar Intro permiten insertar un bloque cuando el usuario escribe determinado contenido y luego pulsa la tecla Enter.
{
"blockstudio": {
"transforms": {
"from": [
{
"type": "enter",
"regExp": "/^-{3,}$/"
}
]
}
}
}
En el ejemplo anterior, el bloque se insertará cuando el usuario escriba tres guiones o más (-) y luego pulse Enter.
Prefijo
Las transformaciones de prefijo permiten insertar un bloque cuando el usuario escribe determinado contenido y luego pulsa la tecla Space.
{
"blockstudio": {
"transforms": {
"from": [
{
"type": "prefix",
"regExp": "???"
}
]
}
}
}
En el ejemplo anterior, el bloque se insertará cuando el usuario escriba tres signos de interrogación (?) y luego pulse Space.