Transformácie
Rozšírenie Transformácie blokov API vám umožňuje definovať spôsoby transformácie blokov. Blockstudio v súčasnosti podporuje tri rôzne typy:
- blok na blok: transformácia jedného bloku na iný
- Enter: vloženie bloku po zadaní textu a stlačení klávesu
Enter - predpona: vloženie bloku po zadaní textu a stlačení klávesu
Space
Blok na blok
Transformácie z bloku na blok umožňujú previesť jeden blok na iný.
{
"$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"
}
]
}
}
Pri transformácii na nový blok sa doň prenesú atribúty pôvodného bloku. V uvedenom príklade sa do nového bloku prenesie atribút text. To isté platí pre všetok obsah InnerBlocks.
Je dôležité, aby typy atribútov bloku, na ktorý sa transformuje, a bloku, z ktorého sa transformuje, boli rovnaké. Ak má napríklad cieľový blok atribút s ID text a typom number, v zozname transformácií sa nezobrazí, pretože by to spôsobilo nesúlad typov a chybu pri vykresľovaní.
Počet atribútov v oboch blokoch nemusí byť rovnaký.
Enter
Transformácie Enter umožňujú vložiť blok, keď používateľ napíše určitý obsah a potom stlačí kláves Enter.
{
"blockstudio": {
"transforms": {
"from": [
{
"type": "enter",
"regExp": "/^-{3,}$/"
}
]
}
}
}
V uvedenom príklade sa blok vloží, keď používateľ napíše tri alebo viac pomlčiek (-) a potom stlačí Enter.
Predpona
Transformácie predponou umožňujú vložiť blok, keď používateľ napíše určitý obsah a potom stlačí kláves Space.
{
"blockstudio": {
"transforms": {
"from": [
{
"type": "prefix",
"regExp": "???"
}
]
}
}
}
V uvedenom príklade sa blok vloží, keď používateľ napíše tri otázniky (?) a potom stlačí Space.