Преобразувания
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 позволяват да вмъкнете блок, когато потребителят въведе определен текст и след това натисне клавиша Enter.
{
"blockstudio": {
"transforms": {
"from": [
{
"type": "enter",
"regExp": "/^-{3,}$/"
}
]
}
}
}
В примера по-горе блокът ще бъде вмъкнат, когато потребителят въведе три или повече тирета (-) и след това натисне Enter.
Префикс
Преобразуванията с префикс позволяват да вмъкнете блок, когато потребителят въведе определен текст и след това натисне клавиша Space.
{
"blockstudio": {
"transforms": {
"from": [
{
"type": "prefix",
"regExp": "???"
}
]
}
}
}
В примера по-горе блокът ще бъде вмъкнат, когато потребителят въведе три въпросителни знака (?) и след това натисне Space.