Appearance
多语言
qin.getLocale()
获取当前设置的语言
平台差异说明
| App | H5 | 微信小程序 | 支付宝小程序 | 百度小程序 | 抖音小程序、飞书小程序 | QQ小程序 | 快手小程序 | 京东小程序 |
|---|---|---|---|---|---|---|---|---|
| √ | √ | √ | √ | √ | √ | √ | √ | √ |
如果当前应用设置过语言，会获取到之前设置的语言，未设置时会返回根据系统语言类型自动选择的语言。
qin.setLocale(locale)
设置当前语言
平台差异说明
| App | H5 | 微信小程序 | 支付宝小程序 | 百度小程序 | 抖音小程序、飞书小程序 | QQ小程序 | 快手小程序 | 京东小程序 |
|---|---|---|---|---|---|---|---|---|
| √ | √ | √ | √ | √ | √ | √ | √ | √ |
仅可设置为框架内置语言与自定义扩展的语言，遵循 BCP47 规范。
参数说明
| 参数名 | 类型 | 必填 |
|---|---|---|
| locale | String | 是 |
qin.onLocaleChange(callback)
用于监听应用语言切换
平台差异说明
| App | H5 | 微信小程序 | 支付宝小程序 | 百度小程序 | 抖音小程序、飞书小程序 | QQ小程序 | 快手小程序 | 京东小程序 |
|---|---|---|---|---|---|---|---|---|
| √ | √ | √ | √ | √ | √ | √ | √ | √ |
参数说明
| 参数名 | 类型 | 必填 |
|---|---|---|
| callback | Function<OnLocaleChangeCallbackResult> | 是 |
OnLocaleChangeCallbackResult 的属性值
| 参数名 | 类型 | 说明 |
|---|---|---|
| locale | String | 当前语言 |
注意事项
- 框架内置如下语言，如需自定义内容或增加其他语言参考：
- 英语 en
- 中文简体 zh-Hans
- 繁体 zh-Hant
- 在 manifest.json -> locale 可以配置应用的默认语言
- 在小程序平台仅影响用户业务层（vue-i18n）的语言配置，不能影响小程序原生组件和接口的语言