التوثيق: دالة getLocaleName في intlayer

الوصف

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

المعاملات

• displayLocale: Locales

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

• targetLocale?: Locales

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

القيم المرجعة

• النوع: string
• الوصف: الاسم المعرب لـ targetLocale في displayLocale، أو اسم displayLocale نفسه إذا لم يتم توفير targetLocale. إذا لم يتم العثور على ترجمة، فإنه يعيد "Unknown locale".

مثال على الاستخدام

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"); // الناتج: "Unknown locale"

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

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

Polyfills لـ React Native والبيئات الأقدم

تعتمد دالة getLocaleName على واجهة برمجة التطبيقات Intl.DisplayNames، والتي غير متاحة في React Native أو بيئات JavaScript الأقدم. إذا كنت تستخدم getLocaleName في هذه البيئات، فأنت بحاجة إلى إضافة polyfills.

قم باستيراد polyfills في وقت مبكر في تطبيقك، ويفضل في ملف نقطة الدخول الخاص بك (على سبيل المثال، index.js، App.tsx، أو main.tsx):

import "intl";import "@formatjs/intl-locale/polyfill";import "@formatjs/intl-displaynames/polyfill";

لمزيد من التفاصيل، راجع توثيق polyfills الخاص بـ FormatJS.