Teisendused
Plokkide teisendused API võimaldab määrata, kuidas plokke teisendada. Blockstudio toetab praegu kolme tüüpi:
- plokist plokiks: teisenda plokk teiseks plokiks
- sisestusklahv: lisa plokk, kui kasutaja sisestab teksti ja vajutab klahvi
Enter - eesliide: lisa plokk, kui kasutaja sisestab teksti ja vajutab klahvi
Space
Plokist plokiks
Plokist plokiks teisendused võimaldavad teisendada ühe ploki teiseks plokiks.
{
"$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"
}
]
}
}
Uude plokki teisendamisel kantakse vana ploki atribuudid uude plokki üle. Ülaltoodud näites kantakse uude plokki üle atribuut text. Sama kehtib kogu InnerBlocks sisu kohta.
Oluline on märkida, et teisendatava lähteploki ja sihtploki atribuutide tüübid peavad ühtima. Näiteks kui sihtploki atribuudil on ID text, kuid tüüp number, siis seda teisendusloendis ei kuvata, sest see põhjustaks tüübikonflikti ja renderdamisvea.
Kahe ploki atribuutide arv ei pea olema sama.
Sisestusklahv
Sisestusklahvi teisendused võimaldavad lisada ploki, kui kasutaja sisestab kindla teksti ja vajutab seejärel klahvi Enter.
{
"blockstudio": {
"transforms": {
"from": [
{
"type": "enter",
"regExp": "/^-{3,}$/"
}
]
}
}
}
Ülaltoodud näites lisatakse plokk, kui kasutaja sisestab kolm või enam sidekriipsu (-) ja vajutab seejärel klahvi Enter.
Eesliide
Eesliite teisendused võimaldavad lisada ploki, kui kasutaja sisestab kindla teksti ja vajutab seejärel klahvi Space.
{
"blockstudio": {
"transforms": {
"from": [
{
"type": "prefix",
"regExp": "???"
}
]
}
}
}
Ülaltoodud näites lisatakse plokk, kui kasutaja sisestab kolm küsimärki (?) ja vajutab seejärel klahvi Space.