GT ClassMethodsLocales

resolveAliasLocale

GT resolveAliasLocale 方法的 API 参考

概述

当配置了自定义映射时,resolveAliasLocale 方法会将规范的语言代码解析回其原始别名语言代码。 这是 resolveCanonicalLocale 的逆向操作。


参考资料

参数

Prop

Type

参数说明

参数说明
locale将其解析回别名所用的规范语言代码
customMapping可选的自定义映射,用于覆盖该实例的默认映射

返回

string - 若存在映射,则返回别名语言代码;否则返回原始语言代码

异常

  • Error - 当未提供 locale 且未配置目标 locale 时抛出

示例

const gt = new GT({
  sourceLocale: 'en',
  customMapping: {
    'cn': { code: 'zh', name: '普通话' },
  }
});

// 将标准语言代码解析回别名
const alias = gt.resolveAliasLocale('zh');
console.log(alias); // "cn"

// 未映射的语言代码返回原值
const unchanged = gt.resolveAliasLocale('es');
console.log(unchanged); // "es"

注意事项

  • 若存在自定义映射,则返回原始的别名语言代码
  • 若未找到映射,则原样返回输入的语言代码

后续步骤

这份指南怎么样?

resolveAliasLocale