Documentazione: getLocaleName Funzione in intlayer
Descrizione:
La funzione getLocaleName restituisce il nome localizzato di una data locale (targetLocale) nella locale di visualizzazione (displayLocale). Se non viene fornita una targetLocale, restituisce il nome della displayLocale nella propria lingua.
Parametri:
displayLocale: Locales
- Descrizione: La locale in cui verrà visualizzato il nome della locale target.
- Tipo: Enum o stringa che rappresenta le locali valide.
targetLocale?: Locales
- Descrizione: La locale il cui nome deve essere localizzato.
- Tipo: Facoltativo. Enum o stringa che rappresenta le locali valide.
Restituisce:
- Tipo: string
- Descrizione: Il nome localizzato della targetLocale nella displayLocale, o il nome della displayLocale stessa se non è fornita una targetLocale. Se non viene trovata alcuna traduzione, restituisce "Unknown locale".
Esempio di Utilizzo:
typescript
import { Locales, getLocaleName } from "intlayer";getLocaleName(Locales.ENGLISH); // Output: "English"getLocaleName(Locales.ENGLISH, Locales.FRENCH); // Output: "Anglais"getLocaleName(Locales.ENGLISH, Locales.ESPANOL); // Output: "Inglés"getLocaleName(Locales.ENGLISH, Locales.ENGLISH); // Output: "English"getLocaleName(Locales.FRENCH); // Output: "Français"getLocaleName(Locales.FRENCH, Locales.FRENCH); // Output: "Français"getLocaleName(Locales.FRENCH, Locales.ESPANOL); // Output: "Francés"getLocaleName(Locales.FRENCH, Locales.ENGLISH); // Output: "French"getLocaleName(Locales.CHINESE); // Output: "中文"getLocaleName(Locales.CHINESE, Locales.FRENCH); // Output: "Chinois"getLocaleName(Locales.CHINESE, Locales.ESPANOL); // Output: "Chino"getLocaleName(Locales.CHINESE, Locales.ENGLISH); // Output: "Chinese"getLocaleName("unknown-locale"); // Output: "Unknown locale"
Casi Limite:
- Nessuna targetLocale fornita:
- La funzione restituisce per default il nome della displayLocale.
- Traduzioni mancanti:
- Se localeNameTranslations non contiene una voce per la targetLocale o la specifica displayLocale, la funzione torna al ownLocalesName o restituisce "Unknown locale".
Se hai un’idea per migliorare questa documentazione, non esitare a contribuire inviando una pull request su GitHub.
Collegamento GitHub alla documentazione