Transformări
Pluginul Transformări de blocuri API vă permite să definiți modalități de transformare a blocurilor. Blockstudio acceptă în prezent trei tipuri diferite:
- bloc în bloc: transformă un bloc în alt bloc
- enter: inserează un bloc când utilizatorul introduce text și apasă tasta
Enter - prefix: inserează un bloc când utilizatorul introduce text și apasă tasta
Space
Transformare bloc în bloc
Transformările de bloc în bloc vă permit să transformați un bloc în alt bloc.
{
"$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"
}
]
}
}
La transformarea în noul bloc, atributele blocului vechi sunt transmise celui nou. În exemplul de mai sus, atributul text va fi transmis noului bloc. Același lucru este valabil pentru tot conținutul InnerBlocks.
Este important de reținut că tipurile atributelor trebuie să fie aceleași pentru blocul sursă și cel țintă. De exemplu, dacă blocul țintă are un atribut cu ID-ul text, dar de tipul number, acesta nu va apărea în lista de transformări, deoarece ar provoca o nepotrivire de tip și o eroare de randare.
Numărul atributelor dintre cele două blocuri nu trebuie să fie același.
Enter
Transformările Enter vă permit să inserați un bloc când utilizatorul introduce anumit conținut și apoi apasă tasta Enter.
{
"blockstudio": {
"transforms": {
"from": [
{
"type": "enter",
"regExp": "/^-{3,}$/"
}
]
}
}
}
În exemplul de mai sus, blocul va fi inserat când utilizatorul introduce trei sau mai multe cratime (-) și apoi apasă Enter.
Prefix
Transformările Prefix vă permit să inserați un bloc când utilizatorul introduce anumit conținut și apoi apasă tasta Space.
{
"blockstudio": {
"transforms": {
"from": [
{
"type": "prefix",
"regExp": "???"
}
]
}
}
}
În exemplul de mai sus, blocul va fi inserat când utilizatorul introduce trei semne de întrebare (?) și apoi apasă Space.