Перейти до вмісту

Перетворення

Модуль Перетворення блоків 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.

Важливо: типи атрибутів блоку, на який виконується перетворення, і блоку, з якого воно виконується, мають збігатися. Наприклад, якщо блок, на який виконується перетворення, має атрибут з ID text, але типом number, він не з’явиться у списку перетворень, оскільки це призвело б до невідповідності типів і помилки рендерингу.

Кількість атрибутів у двох блоках може відрізнятися.

Введення

Перетворення під час введення дають змогу вставити блок, коли користувач вводить певний текст, а потім натискає клавішу Enter.

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

У наведеному вище прикладі блок буде вставлено, коли користувач введе три або більше дефісів (-), а потім натисне Enter.

Префікс

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

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

У наведеному вище прикладі блок буде вставлено, коли користувач введе три знаки питання (?), а потім натисне Space.