إنشاء التعدادات Enums باستخدام Kawkab

Enums هي طريقة رائعة لتنظيم القيم الثابتة والمحددة مسبقًا في تطبيقك بطريقة مرتبة وقابلة للتوسع. في هذا الدليل، سنتعرف على كيفية إنشاء واستخدام Enums باستخدام إطار العمل Kawkab.

إنشاء Enum جديد باستخدام Kawkab

لإنشاء Enum جديد باستخدام Kawkab، قم بتشغيل الأمر التالي في سطر الأوامر:

npm run kawkab enum:make <name> [module]

تفاصيل المعلمات:

• <name>: اسم الـ Enum الذي ترغب في إنشائه (على سبيل المثال UserType).
• [module]: اسم الموديول الذي يحتوي على الـ Enum (اختياري، الافتراضي هو main).

مثال على كيفية تنفيذ الأمر:

npm run kawkab enum:make UserType

بعد تنفيذ الأمر، سيتم إنشاء Enum باسم UserType في الموديول main.

ماذا يحدث بعد تشغيل الأمر؟

• سيتم إنشاء ملف Enum باسم 'UserType' بنجاح.
• يمكنك الآن استخدام الـ Enum في تطبيقك عن طريق استيراده واستخدامه كما في المثال التالي.

كيفية استخدام Enum في التطبيق

بمجرد إنشاء الـ Enum، يمكنك استيراده واستخدامه في أي جزء من التطبيق.

استيراد الـ Enum:

لاستيراد الـ Enum الذي تم إنشاؤه، استخدم الكود التالي في ملفك:

import { UserType, UserTypeEnum } from "../enums/UserType";

محتوى ملف الـ Enum:

سيحتوي ملف الـ Enum UserType على القيم التالية:

import { BaseEnum as Enum } from "kawkab";
 
export enum UserTypeEnum {
    Administrator = 0,       // مشرف
    Moderator = 1,          // مشرف فرعي
    Subscriber = 2,         // مشترك
    SuperAdministrator = 3, // مشرف رئيسي
    // يمكنك إضافة القيم الأخرى هنا
}
 
Enum.set(UserTypeEnum);
 
export class UserType extends Enum<typeof UserTypeEnum> {}

استخدام الـ Enum في التطبيق:

يمكنك استخدام الـ Enum بعدة طرق كما في المثال التالي:

الطريقة الأولى: الوصول إلى القيم باستخدام الـ Enum

console.log(UserTypeEnum.Administrator);  // سيطبع 0
console.log(UserTypeEnum.Moderator);     // سيطبع 1

الطريقة الثانية: استخدام طريقة get للوصول إلى القيم

console.log(UserType.get('Administrator'));  // سيطبع 0
console.log(UserType.get('Subscriber'));    // سيطبع 2

ملاحظات إضافية

• استخدام Enum مع فئات أخرى: يمكنك استخدام الـ Enum في أي مكان في التطبيق حيث تحتاج إلى تمثيل القيم الثابتة. يمكن أن تكون هذه القيم تمثل أنواع المستخدمين، أو الحالة الخاصة بشيء معين.
• مرونة: يمكن إضافة المزيد من القيم بسهولة داخل الـ Enum في أي وقت.
• إعادة التسمية: إذا كنت بحاجة إلى إعادة تسمية القيم في الـ Enum، يمكنك تعديلها بشكل مباشر داخل الملف.

الخاتمة

إن استخدام Enums في Kawkab يساعد على تنظيم القيم الثابتة في تطبيقك بطريقة أكثر وضوحًا وقوة. بفضل Kawkab، يمكنك إنشاء واستخدام Enums بطريقة مرنة ومبسطة داخل مشروعك. استمتع بتطوير تطبيقاتك بشكل أكثر كفاءة وتنظيمًا!