Tài liệu: Hàm getLocaleName trong intlayer

Mô tả

Hàm getLocaleName trả về tên địa phương hóa của một locale nhất định (targetLocale) trong locale hiển thị (displayLocale). Nếu không cung cấp targetLocale, hàm sẽ trả về tên của displayLocale bằng chính ngôn ngữ của nó.

Tham số

• displayLocale: Locales

  • Mô tả: Locale mà trong đó tên của locale đích sẽ được hiển thị.
  • Kiểu: Enum hoặc chuỗi đại diện cho các locale hợp lệ.

• targetLocale?: Locales

  • Mô tả: Locale mà tên của nó sẽ được địa phương hóa.
  • Kiểu: Tùy chọn. Enum hoặc chuỗi đại diện cho các locale hợp lệ.

Giá trị trả về

• Kiểu: string
• Mô tả: Tên đã được địa phương hóa của targetLocale trong displayLocale, hoặc tên của chính displayLocale nếu không cung cấp targetLocale. Nếu không tìm thấy bản dịch, nó trả về "Unknown locale".

Ví dụ sử dụng

import { Locales, getLocaleName } from "intlayer";

getLocaleName(Locales.ENGLISH); // Output: "English"
getLocaleName(Locales.ENGLISH, Locales.FRENCH); // Kết quả: "Anglais"
getLocaleName(Locales.ENGLISH, Locales.ESPANOL); // Kết quả: "Inglés"
getLocaleName(Locales.ENGLISH, Locales.ENGLISH); // Kết quả: "English"

getLocaleName(Locales.FRENCH); // Kết quả: "Français"
getLocaleName(Locales.FRENCH, Locales.FRENCH); // Kết quả: "Français"
getLocaleName(Locales.FRENCH, Locales.ESPANOL); // Kết quả: "Francés"
getLocaleName(Locales.FRENCH, Locales.ENGLISH); // Kết quả: "French"

getLocaleName(Locales.CHINESE); // Kết quả: "中文"
getLocaleName(Locales.CHINESE, Locales.FRENCH); // Kết quả: "Chinois"
getLocaleName(Locales.CHINESE, Locales.ESPANOL); // Kết quả: "Chino"
getLocaleName(Locales.CHINESE, Locales.ENGLISH); // Kết quả: "Chinese"

getLocaleName("unknown-locale"); // Kết quả: "Unknown locale"

Các trường hợp đặc biệt

• Không cung cấp targetLocale:
  • Hàm mặc định trả về tên của chính displayLocale.
• Thiếu bản dịch:
  • Nếu localeNameTranslations không chứa mục cho targetLocale hoặc displayLocale cụ thể, hàm sẽ sử dụng lại ownLocalesName hoặc trả về "Unknown locale".

Polyfills cho React Native và các môi trường cũ hơn

Hàm getLocaleName phụ thuộc vào API Intl.DisplayNames, không có sẵn trong React Native hoặc các môi trường JavaScript cũ hơn. Nếu bạn đang sử dụng getLocaleName trong các môi trường này, bạn cần thêm polyfills.

Nhập polyfills sớm trong ứng dụng của bạn, lý tưởng là trong tệp điểm vào của bạn (ví dụ: index.js, App.tsx hoặc main.tsx):

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

Để biết thêm chi tiết, xem tài liệu polyfills FormatJS.