Utility FunctionsLocales
getLocaleEmoji
独立函数 getLocaleEmoji 的 API 参考
概述
独立的 getLocaleEmoji 函数无需 GT class 实例即可为某个语言代码返回对应的旗帜或符号 emoji。
它会根据该 locale 的地区返回相应的国家/地区旗帜 emoji，并支持自定义的 emoji 映射。
import { getLocaleEmoji } from 'generaltranslation';
const emoji = getLocaleEmoji('fr-CA');
console.log(emoji); // "🇨🇦"（加拿大旗）
const usEmoji = getLocaleEmoji('en-US');
console.log(usEmoji); // "🇺🇸"（美国旗）参考资料
参数
Prop
Type
参数说明
| 参数 | 描述 |
|---|---|
locale | 用于获取相应 emoji 的 BCP-47 语言代码 |
customMapping | 可选的自定义映射，用于覆盖语言代码与 emoji 的默认映射 |
返回值
string - 表示 locale 的旗帜或符号表情：
- 对于带有地区的 locales，使用对应国家/地区旗帜表情（例如：
🇺🇸、🇫🇷、🇯🇵） - 若在映射中定义了自定义表情，则使用该自定义表情
- 对于无法识别的 locales，使用默认旗帜表情（
🏳️）
示例
基础表情符号获取
import { getLocaleEmoji } from 'generaltranslation';
// 常见国家/地区旗帜
console.log(getLocaleEmoji('en-US')); // "🇺🇸"
console.log(getLocaleEmoji('fr-FR')); // "🇫🇷"
console.log(getLocaleEmoji('de-DE')); // "🇩🇪"
console.log(getLocaleEmoji('ja-JP')); // "🇯🇵"
console.log(getLocaleEmoji('zh-CN')); // "🇨🇳"
// 多语言国家/地区
console.log(getLocaleEmoji('en-CA')); // "🇨🇦"
console.log(getLocaleEmoji('fr-CA')); // "🇨🇦"
console.log(getLocaleEmoji('de-CH')); // "🇨🇭"
console.log(getLocaleEmoji('fr-CH')); // "🇨🇭"说明
- 通过 Unicode 区域指示符返回国旗 emoji
- 自定义映射的 emoji 优先于按地区自动选择
- 支持全部 ISO 3166-1 alpha-2 地区代码，覆盖更全面
后续步骤
- 使用 GT class 方法
getLocaleEmoji - 通过
getLocaleProperties获取 locale 属性 - 通过
getLocaleName获取 locale 名称 - 使用
isValidLocale验证 locales
这份指南怎么样？