التعداد / التعدد

كيف يعمل التعداد

في Intlayer، يتم تحقيق التعداد من خلال دالة enu، التي تربط مفاتيح معينة بمحتواها المقابل. يمكن أن تمثل هذه المفاتيح قيمًا عددية، أو نطاقات، أو معرفات مخصصة. عند استخدامها مع React Intlayer أو Next Intlayer، يتم اختيار المحتوى المناسب تلقائيًا بناءً على لغة التطبيق والقواعد المحددة.

إعداد التعداد

لإعداد التعداد في مشروع Intlayer الخاص بك، تحتاج إلى إنشاء وحدة محتوى تتضمن تعريفات التعداد. إليك مثال على تعداد بسيط لعدد السيارات:

import { enu, type DeclarationContent } from "intlayer";

const carEnumeration = {
  key: "car_count",
  content: {
    numberOfCar: enu({
      "<-1": "أقل من سيارة واحدة ناقص",
      "-1": "سيارة واحدة ناقص",
      "0": "لا توجد سيارات",
      "1": "سيارة واحدة",
      ">5": "بعض السيارات",
      ">19": "الكثير من السيارات",
    }),
  },
} satisfies DeclarationContent;

export default carEnumeration;

في هذا المثال، تقوم enu بربط ظروف مختلفة بمحتوى محدد. عند استخدامها في مكون React، يمكن لـ Intlayer اختيار المحتوى المناسب تلقائيًا بناءً على المتغير المعطى.

استخدام التعداد مع React Intlayer

لاستخدام التعداد في مكون React، يمكنك الاستفادة من خطاف useIntlayer من حزمة react-intlayer. يسترجع هذا الخطاف المحتوى الصحيح بناءً على المعرف المحدد. إليك مثال عن كيفية استخدامه:

import { useIntlayer } from "react-intlayer";

const CarComponent = () => {
  const content = useIntlayer("car_count");

  return (
    <div>
      <p>{content.numberOfCar(0)}</p> {/* الناتج: لا توجد سيارات */}
      <p>{content.numberOfCar(6)}</p> {/* الناتج: بعض السيارات */}
      <p>{content.numberOfCar(20)}</p> {/* الناتج: بعض السيارات */}
    </div>
  );
};

export default CarComponent;

في هذا المثال، يقوم المكون بضبط مخرجاته ديناميكيًا بناءً على عدد السيارات. يتم اختيار المحتوى الصحيح تلقائيًا، بناءً على النطاق المحدد.

ملاحظات هامة

• ترتيب الإعلان مهم جدًا في تعدادات Intlayer. أول إعلان صالح هو الذي سيتم اختياره.
• إذا كانت هناك ظروف متعددة تنطبق، تأكد من ترتيبها بشكل صحيح لتجنب السلوك غير المتوقع.

أفضل الممارسات للتعداد

لضمان أن تعمل تعداداتك كما هو متوقع، اتبع أفضل الممارسات التالية:

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

موارد إضافية

للحصول على مزيد من المعلومات التفصيلية حول التكوين والاستخدام، راجع الموارد التالية:

• توثيق Intlayer CLI
• توثيق React Intlayer
• توثيق Next Intlayer

توفر هذه الموارد رؤى إضافية حول إعداد واستخدام Intlayer في بيئات مختلفة ومع أطر عمل متنوعة.