문서: intlayer의 getLocaleName 함수

설명

getLocaleName 함수는 주어진 로케일(targetLocale)의 현지화된 이름을 표시 로케일(displayLocale)로 반환합니다. targetLocale이 제공되지 않으면, displayLocale의 이름을 해당 로케일의 언어로 반환합니다.

매개변수

• displayLocale: Locales

  • 설명: 대상 로케일의 이름이 표시될 로케일입니다.
  • 타입: 유효한 로케일을 나타내는 열거형 또는 문자열입니다.

• targetLocale?: Locales

  • 설명: 이름이 현지화될 로케일입니다.
  • 타입: 선택 사항이며, 유효한 로케일을 나타내는 열거형 또는 문자열입니다.

반환값

• 타입: string
• 설명: targetLocale가 제공되면 displayLocale에서 현지화된 targetLocale의 이름을 반환하며, 제공되지 않으면 displayLocale 자신의 이름을 반환합니다. 번역을 찾을 수 없으면 "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"); // 출력: "알 수 없는 로케일"

예외 상황

• targetLocale가 제공되지 않은 경우:
• 함수는 기본적으로 displayLocale 자신의 이름을 반환합니다.
• 번역 누락:
  • localeNameTranslations에 targetLocale 또는 특정 displayLocale에 대한 항목이 없으면, 함수는 ownLocalesName을 사용하거나 "Unknown locale"을 반환합니다.

React Native 및 구형 환경용 Polyfills

getLocaleName 함수는 Intl.DisplayNames API에 의존하며, 이 API는 React Native나 구형 JavaScript 환경에서는 사용할 수 없습니다. 이러한 환경에서 getLocaleName을 사용하는 경우 polyfills를 추가해야 합니다.

애플리케이션 초기에 polyfills를 가져오세요. 가능하면 진입점 파일(예: index.js, App.tsx, 또는 main.tsx)에서 수행하세요:

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

자세한 내용은 FormatJS polyfills 문서를 참조하세요.