التحويلات
تتيح لك تحويلات الكتل API تحديد طرق تحويل الكتل. يدعم Blockstudio حاليًا ثلاثة أنواع مختلفة:
- من كتلة إلى كتلة: تحويل كتلة إلى كتلة أخرى
- الإدخال: إدراج كتلة عندما يُدخل المستخدم نصًا ويضغط على
Enter - البادئة: إدراج كتلة عندما يُدخل المستخدم نصًا ويضغط على
Space
من كتلة إلى كتلة
تتيح تحويلات الكتل تحويل كتلة إلى كتلة أخرى.
{
"$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"
}
]
}
}
عند التحويل إلى الكتلة الجديدة، تُمرر سمات الكتلة القديمة إليها. في المثال أعلاه، ستُمرر السمة text إلى الكتلة الجديدة. وينطبق الأمر نفسه على كل المحتوى InnerBlocks.
من المهم ملاحظة أن أنواع السمات يجب أن تكون متماثلة في الكتلة المراد التحويل إليها والكتلة المراد التحويل منها. على سبيل المثال، إذا كانت للكتلة المراد التحويل إليها سمة بالمعرّف text لكن نوعها number، فلن تظهر في قائمة التحويل، لأن ذلك سيؤدي إلى عدم تطابق الأنواع وخطأ في العرض.
ليس من الضروري أن يتساوى عدد السمات في الكتلتين.
الإدخال
تتيح تحويلات الإدخال إدراج كتلة عندما يكتب المستخدم محتوى معينًا ثم يضغط على مفتاح Enter.
{
"blockstudio": {
"transforms": {
"from": [
{
"type": "enter",
"regExp": "/^-{3,}$/"
}
]
}
}
}
في المثال أعلاه، ستُدرج الكتلة عندما يكتب المستخدم ثلاث شرطات أو أكثر (-) ثم يضغط على Enter.
البادئة
تتيح تحويلات البادئة إدراج كتلة عندما يكتب المستخدم محتوى معينًا ثم يضغط على مفتاح Space.
{
"blockstudio": {
"transforms": {
"from": [
{
"type": "prefix",
"regExp": "???"
}
]
}
}
}
في المثال أعلاه، ستُدرج الكتلة عندما يكتب المستخدم ثلاث علامات استفهام (?) ثم يضغط على Space.