Перейти к содержимому

Преобразования

Функция Преобразования блоков API позволяет задавать способы преобразования блоков. Сейчас Blockstudio поддерживает три типа:

  • блок в блок: преобразовать один блок в другой
  • ввод: вставить блок, когда пользователь вводит текст и нажимает Enter
  • префикс: вставить блок, когда пользователь вводит текст и нажимает Space

Из блока в блок

Преобразования из блока в блок позволяют преобразовать один блок в другой.

JSON
{
  "$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.

JSON
{
  "blockstudio": {
    "transforms": {
      "from": [
        {
          "type": "enter",
          "regExp": "/^-{3,}$/"
        }
      ]
    }
  }
}

В примере выше блок будет вставлен, когда пользователь введет три или более дефиса (-), а затем нажмет Enter.

Префикс

Преобразования по префиксу позволяют вставлять блок, когда пользователь вводит определенный текст и нажимает клавишу Space.

JSON
{
  "blockstudio": {
    "transforms": {
      "from": [
        {
          "type": "prefix",
          "regExp": "???"
        }
      ]
    }
  }
}

В примере выше блок будет вставлен, когда пользователь введет три вопросительных знака (?), а затем нажмет Space.