Átalakítások
A Blokkátalakítások API lehetővé teszi a blokkok átalakítási módjainak meghatározását. A Blockstudio jelenleg három típust támogat:
- blokkról blokkra: egy blokk átalakítása egy másik blokká
- enter: blokk beszúrása, amikor a felhasználó szöveget ír be, majd megnyomja a
Enterbillentyűt - előtag: blokk beszúrása, amikor a felhasználó szöveget ír be, majd megnyomja a
Spacebillentyűt
Blokkról blokkra
A blokkról blokkra történő átalakítás lehetővé teszi egy blokk másik blokká alakítását.
{
"$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"
}
]
}
}
Az új blokkra való átalakításkor a régi blokk attribútumai átkerülnek az új blokkba. A fenti példában a text attribútum kerül át az új blokkba. Ugyanez érvényes minden InnerBlocks tartalomra.
Fontos, hogy az átalakítás cél- és forrásblokkjának attribútumtípusai megegyezzenek. Például, ha a célblokkban van egy text azonosítójú, de number típusú attribútum, az nem jelenik meg az átalakítási listában, mert típuseltérést és megjelenítési hibát okozna.
A két blokk attribútumainak száma nem kell, hogy megegyezzen.
Enter
Az Enter-átalakítások lehetővé teszik blokk beszúrását, amikor a felhasználó bizonyos tartalmat ír be, majd megnyomja a Enter billentyűt.
{
"blockstudio": {
"transforms": {
"from": [
{
"type": "enter",
"regExp": "/^-{3,}$/"
}
]
}
}
}
A fenti példában a blokk akkor kerül beszúrásra, amikor a felhasználó három vagy több kötőjelet (-) ír be, majd megnyomja a Enter billentyűt.
Előtag
Az előtag-átalakítások lehetővé teszik blokk beszúrását, amikor a felhasználó bizonyos tartalmat ír be, majd megnyomja a Space billentyűt.
{
"blockstudio": {
"transforms": {
"from": [
{
"type": "prefix",
"regExp": "???"
}
]
}
}
}
A fenti példában a blokk akkor kerül beszúrásra, amikor a felhasználó három kérdőjelet (?) ír be, majd megnyomja a Space billentyűt.