Preoblikovanja
Preoblikovanja blokovAPI omogočajo določanje načinov preoblikovanja blokov. Blockstudio trenutno podpira tri različne vrste:
- blok v blok: preoblikujte en blok v drugega
- enter: vstavite blok, ko uporabnik vnese besedilo in pritisne
Enter - predpona: vstavite blok, ko uporabnik vnese besedilo in pritisne
Space
Preoblikovanje bloka v blok
Preoblikovanja iz bloka v blok omogočajo pretvorbo enega bloka v drugega.
{
"$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 preoblikovanju v novi blok se atributi starega bloka prenesejo v novi blok. V zgornjem primeru se v novi blok prenese atribut text. Enako velja za vso vsebino InnerBlocks.
Pomembno je, da so vrste atributov v bloku, v katerega preoblikujete, enake vrstam atributov v izvornem bloku. Če ima na primer ciljni blok atribut z ID-jem text, vendar vrste number, atribut ne bo prikazan na seznamu preoblikovanj, ker bi to povzročilo neujemanje vrst in napako pri izrisu.
Število atributov v obeh blokih je lahko različno.
Enter
Preoblikovanja ob pritisku tipke Enter omogočajo vstavljanje bloka, ko uporabnik vnese določeno vsebino in nato pritisne tipko Enter.
{
"blockstudio": {
"transforms": {
"from": [
{
"type": "enter",
"regExp": "/^-{3,}$/"
}
]
}
}
}
V zgornjem primeru se blok vstavi, ko uporabnik vnese tri ali več pomišljajev (-) in nato pritisne Enter.
Predpona
Preoblikovanja s predpono omogočajo vstavljanje bloka, ko uporabnik vnese določeno vsebino in nato pritisne tipko Space.
{
"blockstudio": {
"transforms": {
"from": [
{
"type": "prefix",
"regExp": "???"
}
]
}
}
}
V zgornjem primeru se blok vstavi, ko uporabnik vnese tri vprašaje (?) in nato pritisne Space.