وثائق: وظيفة getLocaleName في intlayer

    الوصف

    وظيفة getLocaleName تُرجع الاسم المحلي للغة معينة (targetLocale) في لغة العرض (displayLocale). إذا لم يتم توفير targetLocale، فإنها تُرجع اسم displayLocale بلغته الخاصة.

    المعاملات

    • displayLocale: Locales

      • الوصف: اللغة التي سيتم عرض اسم اللغة المستهدفة بها.
      • النوع: Enum أو سلسلة نصية تمثل لغات صالحة.

    • targetLocale?: Locales

      • الوصف: اللغة التي سيتم توطين اسمها.
      • النوع: اختياري. Enum أو سلسلة نصية تمثل لغات صالحة.

    القيم المُعادة

    • النوع: string
    • الوصف: الاسم المحلي لـ targetLocale في displayLocale، أو اسم displayLocale الخاص إذا لم يتم توفير targetLocale. إذا لم يتم العثور على ترجمة، فإنها تُرجع "لغة غير معروفة".

    أمثلة الاستخدام

    typescript
    import { Locales, getLocaleName } from "intlayer";getLocaleName(Locales.ENGLISH); // الناتج: "English"getLocaleName(Locales.ENGLISH, Locales.FRENCH); // الناتج: "Anglais"getLocaleName(Locales.ENGLISH, Locales.ESPANOL); // الناتج: "Inglés"getLocaleName(Locales.ENGLISH, Locales.ENGLISH); // الناتج: "English"getLocaleName(Locales.FRENCH); // الناتج: "Français"getLocaleName(Locales.FRENCH, Locales.FRENCH); // الناتج: "Français"getLocaleName(Locales.FRENCH, Locales.ESPANOL); // الناتج: "Francés"getLocaleName(Locales.FRENCH, Locales.ENGLISH); // الناتج: "French"getLocaleName(Locales.CHINESE); // الناتج: "中文"getLocaleName(Locales.CHINESE, Locales.FRENCH); // الناتج: "Chinois"getLocaleName(Locales.CHINESE, Locales.ESPANOL); // الناتج: "Chino"getLocaleName(Locales.CHINESE, Locales.ENGLISH); // الناتج: "Chinese"getLocaleName("unknown-locale"); // الناتج: "لغة غير معروفة"

    الحالات الخاصة

    • عدم توفير targetLocale:
      • تقوم الوظيفة افتراضيًا بإرجاع اسم displayLocale الخاص.
    • الترجمات المفقودة:
      • إذا لم يحتوي localeNameTranslations على إدخال لـ targetLocale أو displayLocale المحدد، فإن الوظيفة تعود إلى ownLocalesName أو تُرجع "لغة غير معروفة".

    إذا كان لديك فكرة لتحسين هذه الوثيقة، فلا تتردد في المساهمة من خلال تقديم طلب سحب على GitHub.

    رابط GitHub للتوثيق
    getLocaleLanggetLocalizedUrl