GT ClassMethodsLocales
getRegionProperties
GT getRegionProperties 方法的 API 参考
概览
getRegionProperties 方法用于获取区域代码的详细信息，包括其本地化名称和对应的国旗 emoji。
它为构建国际化用户界面提供了一种便捷方式，用于获取特定区域的显示信息。
const gt = new GT({
sourceLocale: 'en-US',
targetLocale: 'fr-FR'
});
// 获取区域属性
const usProps = gt.getRegionProperties('US');
console.log(usProps);
// { code: 'US', name: 'United States', emoji: '🇺🇸' }
const frProps = gt.getRegionProperties('FR');
console.log(frProps);
// { code: 'FR', name: 'France', emoji: '🇫🇷' }
// 从当前区域设置自动检测
const currentRegion = gt.getRegionProperties(); // 使用 targetLocale 的区域
console.log(currentRegion);
// { code: 'FR', name: 'France', emoji: '🇫🇷' }参考资料
参数
Prop
Type
参数说明
| 参数 | 说明 |
|---|---|
region | ISO 3166-1 alpha-2 或 UN M.49 区域代码。若未提供，则使用该实例目标 locale 的区域 |
customMapping | 可选的自定义区域映射，用于覆盖默认的区域名称和 emoji |
返回值
{ code: string; name: string; emoji: string } - 包含以下字段的对象：
code: 输入的区域代码name: 目标 locale 语言中的本地化区域名称emoji: 对应的 emoji 旗帜或符号
示例
基本地区信息
const gt = new GT({
sourceLocale: 'en-US',
targetLocale: 'en-US'
});
// 常见地区代码
console.log(gt.getRegionProperties('US')); // { code: 'US', name: '美国', emoji: '🇺🇸' }
console.log(gt.getRegionProperties('GB')); // { code: 'GB', name: '英国', emoji: '🇬🇧' }
console.log(gt.getRegionProperties('DE')); // { code: 'DE', name: '德国', emoji: '🇩🇪' }
console.log(gt.getRegionProperties('JP')); // { code: 'JP', name: '日本', emoji: '🇯🇵' }说明
- 使用
Intl.DisplayNamesAPI 获取本地化的区域名称 - 支持 ISO 3166-1 alpha-2 和 UN M.49 区域代码
- 自定义映射会覆盖默认名称和 emoji
- 如未提供参数，将根据目标 locale 自动检测区域
- 若显示名称解析失败，将退回使用区域代码作为名称
下一步
- 使用
getLocaleProperties获取完整的 locale 属性 - 使用
getLocaleEmoji获取 locale 的 emoji
这份指南怎么样？