Перетворення
Модуль Перетворення блоків API дає змогу визначати способи перетворення блоків. Наразі Blockstudio підтримує три типи:
- блок на блок: перетворити один блок на інший
- введення: вставити блок, коли користувач вводить текст і натискає
Enter - префікс: вставити блок, коли користувач вводить текст і натискає
Space
Блок на блок
Перетворення «блок на блок» дає змогу перетворити один блок на інший.
{
"$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.
{
"blockstudio": {
"transforms": {
"from": [
{
"type": "enter",
"regExp": "/^-{3,}$/"
}
]
}
}
}
У наведеному вище прикладі блок буде вставлено, коли користувач введе три або більше дефісів (-), а потім натисне Enter.
Префікс
Перетворення за префіксом дають змогу вставити блок, коли користувач вводить певний текст, а потім натискає клавішу Space.
{
"blockstudio": {
"transforms": {
"from": [
{
"type": "prefix",
"regExp": "???"
}
]
}
}
}
У наведеному вище прикладі блок буде вставлено, коли користувач введе три знаки питання (?), а потім натисне Space.