Skip to content

setupI18n 初始化国际化

function setupI18n(): void

注册 7 种语言包(zh-cn / zh-tw / en / ms / ar / th / vi),并根据浏览器 navigator.language 自动选择最匹配的语言。@mingto/tools 入口模块在被 import 时会自动调用一次该函数。

注意: 业务侧无需手动调用此函数;@mingto/tools 入口模块被 import 时会自动执行一次。本文档用于说明语言检测规则。

参数

该函数不需要传入参数。

返回值

返回值说明类型
result无返回值void

示例

自动检测规则

浏览器 navigator.language选中语言
zh-cn / zhzh-cn
zh-tw / zh-hkzh-tw
en*en
ms*ms
ar*ar
th*th
vi*vi
其它 / 非浏览器环境zh-cn

行为示例

typescript
// 业务侧只需要引入 @mingto/tools,setupI18n() 即被自动调用
import { i18n } from '@mingto/tools'

console.log(i18n.getLocale()) // 例如 'zh-cn' / 'en'

注意事项

  • 入口模块加载时会自动调用一次 setupI18n();该函数未对外公开导出,重复触发入口模块不会重复注册语言包。
  • 仅在浏览器环境(typeof navigator !== 'undefined')下会尝试自动检测语言。
  • navigator.language 命中失败时回落到默认语言 zh-cn
  • 当前支持 7 种语言,语言包主要覆盖音频权限相关的错误消息。