GT ClassMethodsLocales
getLocaleEmoji
GT getLocaleEmoji 方法的 API 参考
概览
getLocaleEmoji 方法会基于 locale code 的所属区域，返回对应的旗帜或符号 emoji。
它为国家/地区返回合适的旗帜 emoji；对不包含特定区域的语言提供后备方案（fallback）；并可通过映射支持自定义 emoji。
const gt = new GT({
sourceLocale: 'en',
targetLocale: 'fr-CA'
});
const emoji = gt.getLocaleEmoji('fr-CA');
console.log(emoji); // "🇨🇦" (加拿大国旗)
const usEmoji = gt.getLocaleEmoji('en-US');
console.log(usEmoji); // "🇺🇸" (美国国旗)
const enEmoji = gt.getLocaleEmoji('en');
console.log(enEmoji); // "🇺🇸" (美国国旗)参考资料
参数
Prop
Type
参数说明
| 参数 | 描述 |
|---|---|
locale | 用于获取 emoji 的 BCP-47 语言代码。若未提供，则使用该实例的 targetLocale |
返回
string - 表示该 locale 的旗帜或符号表情：
- 对于包含地区的 locale，显示对应的国家/地区旗帜表情（例如：
🇺🇸、🇫🇷、🇯🇵） - 对于某些不含地区的语言，显示该语言的专属表情
- 对于无法识别的 locale，显示默认旗帜表情（
🏳️）
异常
Error- 当未提供 locale 且实例未配置targetLocale时
示例
const gt = new GT({
sourceLocale: 'en',
targetLocale: 'es'
});
// 获取目标语言的 emoji
console.log(gt.getLocaleEmoji()); // "🇪🇸" (使用 targetLocale 'es')
// 获取不同语言的 emoji
console.log(gt.getLocaleEmoji('en-US')); // "🇺🇸"
console.log(gt.getLocaleEmoji('fr-FR')); // "🇫🇷"
console.log(gt.getLocaleEmoji('de-DE')); // "🇩🇪"
console.log(gt.getLocaleEmoji('ja-JP')); // "🇯🇵"
console.log(gt.getLocaleEmoji('zh-CN')); // "🇨🇳"注意事项
- 在可用的情况下，根据 locale 的地区代码返回国旗 emoji
- 自定义映射的 emoji 优先于基于地区的选择
- 使用 Unicode 地区指示符生成国旗
- 对于无法识别或无效的 locale，默认使用
🏳️（白旗） - 兼容所有支持 Unicode emoji 的现代浏览器和操作系统
后续步骤
- 使用
getLocaleProperties获取 locale 属性 - 使用
getLocaleName获取 locale 名称 - 使用
isValidLocale验证 locales - 了解
CustomMapping类型
这份指南怎么样？