Transformasi
Block Transforms API memungkinkan Anda menentukan cara mengubah blok. Blockstudio saat ini mendukung tiga jenis:
- blok ke blok: ubah satu blok menjadi blok lain
- enter: sisipkan blok saat pengguna mengetik teks lalu menekan
Enter - awalan: sisipkan blok saat pengguna mengetik teks lalu menekan
Space
Blok ke Blok
Transformasi blok ke blok memungkinkan Anda mengubah satu blok menjadi blok lain.
{
"$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"
}
]
}
}
Saat diubah menjadi blok baru, atribut blok lama akan diteruskan ke blok baru. Dalam contoh di atas, atribut text akan diteruskan ke blok baru. Hal yang sama berlaku untuk semua konten InnerBlocks.
Perlu diperhatikan bahwa jenis atribut pada blok tujuan dan blok asal harus sama. Misalnya, jika blok tujuan memiliki atribut dengan ID text tetapi jenisnya number, atribut tersebut tidak akan muncul dalam daftar transformasi karena dapat menyebabkan ketidakcocokan jenis dan kesalahan perenderan.
Jumlah atribut pada kedua blok tidak harus sama.
Enter
Transformasi Enter memungkinkan Anda menyisipkan blok saat pengguna mengetik konten tertentu, lalu menekan tombol Enter.
{
"blockstudio": {
"transforms": {
"from": [
{
"type": "enter",
"regExp": "/^-{3,}$/"
}
]
}
}
}
Dalam contoh di atas, blok akan disisipkan saat pengguna mengetik tiga tanda hubung atau lebih (-), lalu menekan Enter.
Awalan
Transformasi awalan memungkinkan Anda menyisipkan blok saat pengguna mengetik konten tertentu, lalu menekan tombol Space.
{
"blockstudio": {
"transforms": {
"from": [
{
"type": "prefix",
"regExp": "???"
}
]
}
}
}
Dalam contoh di atas, blok akan disisipkan saat pengguna mengetik tiga tanda tanya (?), lalu menekan Space.