Przekształcenia
Przekształcenia blokówAPI umożliwiają określenie sposobów przekształcania bloków. Blockstudio obsługuje obecnie trzy typy:
- blok w blok: przekształć jeden blok w inny
- enter: wstaw blok, gdy użytkownik wpisze tekst i naciśnie
Enter - prefiks: wstaw blok, gdy użytkownik wpisze tekst i naciśnie
Space
Blok w blok
Przekształcenia blok w blok pozwalają przekształcić jeden blok w inny.
{
"$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"
}
]
}
}
Podczas przekształcania w nowy blok atrybuty starego bloku zostaną przekazane do nowego bloku. W powyższym przykładzie atrybut text zostanie przekazany do nowego bloku. To samo dotyczy całej zawartości InnerBlocks.
Należy pamiętać, że typy atrybutów bloku źródłowego i docelowego muszą być takie same. Na przykład jeśli blok docelowy ma atrybut o ID text, ale typie number, nie pojawi się on na liście przekształceń, ponieważ spowodowałoby to niezgodność typów i błąd renderowania.
Liczba atrybutów w obu blokach nie musi być taka sama.
Enter
Przekształcenia Enter pozwalają wstawić blok, gdy użytkownik wpisze określoną treść, a następnie naciśnie klawisz Enter.
{
"blockstudio": {
"transforms": {
"from": [
{
"type": "enter",
"regExp": "/^-{3,}$/"
}
]
}
}
}
W powyższym przykładzie blok zostanie wstawiony, gdy użytkownik wpisze co najmniej trzy łączniki (-), a następnie naciśnie Enter.
Prefiks
Przekształcenia prefiksowe pozwalają wstawić blok, gdy użytkownik wpisze określoną treść, a następnie naciśnie klawisz Space.
{
"blockstudio": {
"transforms": {
"from": [
{
"type": "prefix",
"regExp": "???"
}
]
}
}
}
W powyższym przykładzie blok zostanie wstawiony, gdy użytkownik wpisze trzy znaki zapytania (?), a następnie naciśnie Space.