Към съдържанието

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

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 позволяват да вмъкнете блок, когато потребителят въведе определен текст и след това натисне клавиша Enter.

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

В примера по-горе блокът ще бъде вмъкнат, когато потребителят въведе три или повече тирета (-) и след това натисне Enter.

Префикс

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

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

В примера по-горе блокът ще бъде вмъкнат, когато потребителят въведе три въпросителни знака (?) и след това натисне Space.