GT ClassMethodsLocales
getLocaleEmoji
GT getLocaleEmoji 方法的 API 参考
概览
getLocaleEmoji 方法会根据语言代码对应的地区，返回该地区的 emoji 旗帜或符号。
它会为国家和地区返回合适的旗帜 emoji，对于没有特定地区的语言提供回退方案，并可通过映射支持自定义 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 的表情符号旗帜或符号：
- 对于带区域的 locales，返回对应国家/地区的旗帜 emoji（例如：
🇺🇸、🇫🇷、🇯🇵） - 对于部分无区域的语言，返回该语言的专属 emoji
- 对于无法识别的 locales，返回默认旗帜 emoji（
🏳️）
抛出
Error- 如果未提供 locale，且该实例未配置targetLocale
示例
const gt = new GT({
sourceLocale: 'en',
targetLocale: 'es'
});
// 获取目标语言（targetLocale）的 emoji
console.log(gt.getLocaleEmoji()); // "🇪🇸"（使用 targetLocale 'es'）
// 获取不同语言区域（locale）的 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类型
本指南如何?