Appearance
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 / zh | zh-cn |
zh-tw / zh-hk | zh-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 种语言,语言包主要覆盖音频权限相关的错误消息。