Utility FunctionsLocales
resolveAliasLocale
resolveAliasLocale 函数 API 参考
概览
当配置了自定义映射时,resolveAliasLocale 函数会将规范语言代码转换回其别名语言代码。该独立函数无需创建实例,即可提供与 GT 类方法相同的功能。
参考资料
参数
Prop
Type
返回值
string - 若存在映射,则返回别名语言代码,否则返回原始 locale
示例
import { resolveAliasLocale } from 'generaltranslation';
const customMapping = {
'simplified-chinese': { code: 'zh-CN', name: '简体中文' },
'traditional-chinese': { code: 'zh-TW', name: '繁体中文' }
};
// 将标准语言代码解析为别名
console.log(resolveAliasLocale('zh-CN', customMapping)); // 'simplified-chinese'
console.log(resolveAliasLocale('zh-TW', customMapping)); // 'traditional-chinese'
// 未映射的语言代码返回原始值
console.log(resolveAliasLocale('es-ES', customMapping)); // 'es-ES'备注
- 将规范的语言代码转换回更易读的别名
- 若无映射则返回原始语言
- 用于展示面向用户的语言名称至关重要
- 支持自定义语言映射
- 无状态函数——无副作用
下一步
- 使用 GT class 的方法
resolveAliasLocale - 通过
resolveCanonicalLocale转换为规范 locale
本指南如何?