Преобразования
Функция Преобразования блоков 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.
Важно отметить, что типы атрибутов исходного и целевого блоков должны совпадать. Например, если у целевого блока есть атрибут с идентификатором text, но типом number, он не появится в списке преобразований, поскольку это приведет к несовпадению типов и ошибке отображения.
Количество атрибутов в двух блоках может различаться.
Ввод
Преобразования при вводе позволяют вставлять блок, когда пользователь вводит определенный текст и нажимает клавишу Enter.
{
"blockstudio": {
"transforms": {
"from": [
{
"type": "enter",
"regExp": "/^-{3,}$/"
}
]
}
}
}
В примере выше блок будет вставлен, когда пользователь введет три или более дефиса (-), а затем нажмет Enter.
Префикс
Преобразования по префиксу позволяют вставлять блок, когда пользователь вводит определенный текст и нажимает клавишу Space.
{
"blockstudio": {
"transforms": {
"from": [
{
"type": "prefix",
"regExp": "???"
}
]
}
}
}
В примере выше блок будет вставлен, когда пользователь введет три вопросительных знака (?), а затем нажмет Space.