Recevez des notifications en avant-première sur les prochains lancements de Intlayer
    Création:2024-08-11Dernière mise à jour:2025-06-29

    Documentation : Fonction getLocaleName dans intlayer

    Description

    La fonction getLocaleName renvoie le nom localisé d'une locale donnée (targetLocale) dans la locale d'affichage (displayLocale). Si aucune targetLocale n'est fournie, elle renvoie le nom de la displayLocale dans sa propre langue.

    Paramètres

    • displayLocale: Locales

      • Description : La locale dans laquelle le nom de la locale cible sera affiché.
      • Type : Enum ou chaîne de caractères représentant des locales valides.
    • targetLocale?: Locales

      • Description : La locale dont le nom doit être localisé.
      • Type : Optionnel. Enum ou chaîne de caractères représentant des locales valides.

    Retour

    • Type : string
    • Description : Le nom localisé de la targetLocale dans la displayLocale, ou le nom propre de la displayLocale si targetLocale n'est pas fourni. Si aucune traduction n'est trouvée, elle renvoie "Locale inconnue".

    Exemple d'utilisation

    typescript
    import { Locales, getLocaleName } from "intlayer";getLocaleName(Locales.ENGLISH); // Résultat : "English"getLocaleName(Locales.ENGLISH, Locales.FRENCH); // Résultat : "Anglais"getLocaleName(Locales.ENGLISH, Locales.ESPANOL); // Résultat : "Inglés"getLocaleName(Locales.ENGLISH, Locales.ENGLISH); // Résultat : "English"getLocaleName(Locales.FRENCH); // Résultat : "Français"getLocaleName(Locales.FRENCH, Locales.FRENCH); // Résultat : "Français"getLocaleName(Locales.FRENCH, Locales.ESPANOL); // Résultat : "Francés"getLocaleName(Locales.FRENCH, Locales.ENGLISH); // Résultat : "French"getLocaleName(Locales.CHINESE); // Résultat : "中文"getLocaleName(Locales.CHINESE, Locales.FRENCH); // Résultat : "Chinois"getLocaleName(Locales.CHINESE, Locales.ESPANOL); // Résultat : "Chino"getLocaleName(Locales.CHINESE, Locales.ENGLISH); // Résultat : "Chinese"getLocaleName("unknown-locale"); // Résultat : "Locale inconnue"

    Cas particuliers

    • Pas de targetLocale fourni :
      • La fonction retourne par défaut le nom propre du displayLocale.
    • Traductions manquantes :
      • Si localeNameTranslations ne contient pas d'entrée pour le targetLocale ou le displayLocale spécifique, la fonction revient au ownLocalesName ou retourne "Unknown locale".

    Historique de la documentation

    • 5.5.10 - 2025-06-29 : Historique initial
    Recevez des notifications en avant-première sur les prochains lancements de Intlayer