Posez votre question et obtenez un résumé du document en referencant cette page et le Provider AI de votre choix
Ce document n'est pas à jour, la version de base a été mise à jour le 23 août 2025.
Aller à la doc anglaiseHistorique des versions
- "Ajout de polyfills pour React Native et les environnements plus anciens"v7.5.018/12/2025
- "Historique initial"v5.5.1029/06/2025
Le contenu de cette page a été traduit à l'aide d'une IA.
Voir la dernière version du contenu original en anglaisSi vous avez une idée d’amélioration pour améliorer cette documentation, n’hésitez pas à contribuer en submitant une pull request sur GitHub.
Lien GitHub de la documentationCopier le Markdown du doc dans le presse-papiers
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
targetLocaledans ladisplayLocale, ou le nom propre de ladisplayLocalesitargetLocalen'est pas fourni. Si aucune traduction n'est trouvée, elle renvoie"Locale inconnue".
Exemple d'utilisation
Copier le code dans le presse-papiers
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
targetLocalefourni :- La fonction retourne par défaut le nom propre du
displayLocale.
- La fonction retourne par défaut le nom propre du
- Traductions manquantes :
- Si
localeNameTranslationsne contient pas d'entrée pour letargetLocaleou ledisplayLocalespécifique, la fonction revient auownLocalesNameou retourne"Unknown locale".
- Si
Polyfills pour React Native et les environnements plus anciens
La fonction getLocaleName dépend de l'API Intl.DisplayNames, qui n'est pas disponible dans React Native ou les environnements JavaScript plus anciens. Si vous utilisez getLocaleName dans ces environnements, vous devez ajouter des polyfills.
Importez les polyfills tôt dans votre application, idéalement dans votre fichier d'entrée (par exemple, index.js, App.tsx, ou main.tsx) :
Copier le code dans le presse-papiers
import "intl";import "@formatjs/intl-locale/polyfill";import "@formatjs/intl-displaynames/polyfill";Pour plus de détails, consultez la documentation des polyfills FormatJS.