Μετασχηματισμοί
Το Block Transforms API σάς επιτρέπει να ορίζετε τρόπους μετατροπής των blocks. Το Blockstudio υποστηρίζει επί του παρόντος τρεις διαφορετικούς τύπους:
- block σε block: μετασχηματισμός ενός block σε άλλο block
- enter: εισαγωγή ενός block όταν ο χρήστης πληκτρολογήσει κείμενο και πατήσει
Enter - prefix: εισαγωγή ενός block όταν ο χρήστης πληκτρολογήσει κείμενο και πατήσει
Space
Block σε block
Οι μετασχηματισμοί block σε block επιτρέπουν τη μετατροπή ενός block σε άλλο block.
{
"$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"
}
]
}
}
Κατά τη μετατροπή στο νέο block, τα attributes του παλιού block μεταβιβάζονται στο νέο. Στο παραπάνω παράδειγμα, το attribute text μεταβιβάζεται στο νέο block. Το ίδιο ισχύει για όλο το περιεχόμενο InnerBlocks.
Είναι σημαντικό οι τύποι των attributes να είναι ίδιοι στο block προορισμού και στο block από το οποίο γίνεται η μετατροπή. Για παράδειγμα, αν το block προορισμού έχει ένα attribute με ID text αλλά τύπο number, δεν θα εμφανιστεί στη λίστα μετασχηματισμών, καθώς αυτό θα προκαλούσε ασυμφωνία τύπων και σφάλμα απόδοσης.
Δεν είναι απαραίτητο τα δύο blocks να έχουν τον ίδιο αριθμό attributes.
Είσοδος
Οι μετασχηματισμοί Enter επιτρέπουν την εισαγωγή ενός block όταν ο χρήστης πληκτρολογήσει συγκεκριμένο περιεχόμενο και έπειτα πατήσει το πλήκτρο Enter.
{
"blockstudio": {
"transforms": {
"from": [
{
"type": "enter",
"regExp": "/^-{3,}$/"
}
]
}
}
}
Στο παραπάνω παράδειγμα, το block θα εισαχθεί όταν ο χρήστης πληκτρολογήσει τρεις ή περισσότερες παύλες (-) και έπειτα πατήσει Enter.
Πρόθεμα
Οι μετασχηματισμοί Prefix επιτρέπουν την εισαγωγή ενός block όταν ο χρήστης πληκτρολογήσει συγκεκριμένο περιεχόμενο και έπειτα πατήσει το πλήκτρο Space.
{
"blockstudio": {
"transforms": {
"from": [
{
"type": "prefix",
"regExp": "???"
}
]
}
}
}
Στο παραπάνω παράδειγμα, το block θα εισαχθεί όταν ο χρήστης πληκτρολογήσει τρία ερωτηματικά (?) και έπειτα πατήσει Space.