#نظرة عامة على توسيعات الكتل

في NocoBase 2.0، تم تبسيط آلية توسيع الكتل بشكل كبير. يحتاج المطورون فقط إلى وراثة الفئة الأساسية المناسبة FlowModel وتطبيق طرق الواجهة ذات الصلة (خاصةً طريقة renderComponent()) لتخصيص الكتل بسرعة.

#فئات الكتل

تصنف NocoBase الكتل إلى ثلاثة أنواع، تُعرض في مجموعات ضمن واجهة الإعدادات:

• كتل البيانات (Data blocks): الكتل التي ترث من DataBlockModel أو CollectionBlockModel.
• كتل التصفية (Filter blocks): الكتل التي ترث من FilterBlockModel.
• كتل أخرى (Other blocks): الكتل التي ترث مباشرة من BlockModel.

يتم تحديد المجموعة التي تنتمي إليها الكتلة بواسطة الفئة الأساسية المقابلة. يعتمد منطق التصنيف على علاقات الوراثة ولا يتطلب أي إعدادات إضافية.

#شرح الفئات الأساسية

يوفر النظام أربع فئات أساسية للتوسيع:

#BlockModel

نموذج الكتلة الأساسي، وهو الفئة الأساسية الأكثر عمومية للكتل.

• مناسب للكتل التي تعتمد على العرض فقط ولا تعتمد على البيانات.
• يُصنف ضمن مجموعة الكتل الأخرى (Other blocks).
• ينطبق على السيناريوهات المخصصة.

#DataBlockModel

نموذج كتلة البيانات (غير مرتبط بجدول بيانات)، موجه للكتل ذات مصادر البيانات المخصصة.

• لا يرتبط مباشرة بجدول بيانات، ويمكن تخصيص منطق جلب البيانات.
• يُصنف ضمن مجموعة كتل البيانات (Data blocks).
• ينطبق على: استدعاء واجهات برمجة التطبيقات الخارجية (APIs)، معالجة البيانات المخصصة، الرسوم البيانية الإحصائية، وغيرها من السيناريوهات.

#CollectionBlockModel

نموذج كتلة المجموعة (Collection Block Model)، للكتل التي تحتاج إلى الارتباط بجدول بيانات.

• فئة أساسية لنموذج يتطلب الارتباط بجدول بيانات.
• يُصنف ضمن مجموعة كتل البيانات (Data blocks).
• ينطبق على: القوائم، النماذج، لوحات كانبان، وغيرها من الكتل التي تعتمد بشكل واضح على جدول بيانات محدد.

#FilterBlockModel

نموذج كتلة التصفية (Filter Block Model)، يُستخدم لبناء كتل شروط التصفية.

• فئة أساسية لنموذج يُستخدم لبناء شروط التصفية.
• يُصنف ضمن مجموعة كتل التصفية (Filter blocks).
• يعمل عادةً بالتزامن مع كتل البيانات.

#كيفية اختيار الفئة الأساسية

عند اختيار الفئة الأساسية، يمكنك اتباع المبادئ التالية:

• تحتاج إلى الارتباط بجدول بيانات معين: اختر CollectionBlockModel كأولوية.
• مصدر بيانات مخصص: اختر DataBlockModel.
• لإعداد شروط التصفية والعمل بالتزامن مع كتل البيانات: اختر FilterBlockModel.
• غير متأكد من كيفية التصنيف: اختر BlockModel.

#بدء سريع

يتطلب إنشاء كتلة مخصصة ثلاث خطوات فقط:

1. وراثة الفئة الأساسية المناسبة (مثل BlockModel).
2. تطبيق طريقة renderComponent() لإرجاع مكون React.
3. تسجيل نموذج الكتلة في الإضافة.

للحصول على أمثلة مفصلة، يرجى الرجوع إلى كتابة إضافة كتلة.