Transformationen
Mit Blocktransformationen API kannst du festlegen, wie Blöcke umgewandelt werden. Blockstudio unterstützt derzeit drei verschiedene Typen:
- Block zu Block: einen Block in einen anderen umwandeln
- Eingabetaste: einen Block einfügen, wenn der Benutzer Text eingibt und
Enterdrückt - Präfix: einen Block einfügen, wenn der Benutzer Text eingibt und
Spacedrückt
Block zu Block
Mit Block-zu-Block-Transformationen kannst du einen Block in einen anderen umwandeln.
{
"$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"
}
]
}
}
Beim Umwandeln in den neuen Block werden die Attribute des alten Blocks an den neuen Block übergeben. Im obigen Beispiel wird das Attribut text an den neuen Block übergeben. Das gilt auch für alle Inhalte vom Typ InnerBlocks.
Wichtig ist, dass die Attributtypen des Zielblocks und des Ausgangsblocks übereinstimmen müssen. Hat der Zielblock beispielsweise ein Attribut mit der ID text, aber vom Typ number, erscheint es nicht in der Transformationsliste, da dies zu einem Typkonflikt und einem Darstellungsfehler führen würde.
Die Anzahl der Attribute muss bei den beiden Blöcken nicht übereinstimmen.
Eingabetaste
Mit Eingabetasten-Transformationen kannst du einen Block einfügen, wenn der Benutzer bestimmte Inhalte eingibt und anschließend die Taste Enter drückt.
{
"blockstudio": {
"transforms": {
"from": [
{
"type": "enter",
"regExp": "/^-{3,}$/"
}
]
}
}
}
Im obigen Beispiel wird der Block eingefügt, wenn der Benutzer drei oder mehr Bindestriche (-) eingibt und anschließend Enter drückt.
Präfix
Mit Präfix-Transformationen kannst du einen Block einfügen, wenn der Benutzer bestimmte Inhalte eingibt und anschließend die Taste Space drückt.
{
"blockstudio": {
"transforms": {
"from": [
{
"type": "prefix",
"regExp": "???"
}
]
}
}
}
Im obigen Beispiel wird der Block eingefügt, wenn der Benutzer drei Fragezeichen (?) eingibt und anschließend Space drückt.