# uni.getLocale()

获取当前设置的语言

平台差异说明

App H5 微信小程序 支付宝小程序 百度小程序 字节跳动小程序、飞书小程序 QQ小程序 快手小程序 华为快应用 360小程序 京东小程序
3.2.5+ 3.2.5+ 3.4.14+ 3.4.14+ 3.4.14+ 3.4.14+ 3.4.14+ 3.4.14+ 3.4.14+ 3.4.14+ 3.4.14+

如果当前应用设置过语言,会获取到之前设置的语言,未设置时会返回根据系统语言类型自动选择的语言。

# uni.setLocale(locale)

设置当前语言

平台差异说明

App H5 微信小程序 支付宝小程序 百度小程序 字节跳动小程序、飞书小程序 QQ小程序 快手小程序 华为快应用 360小程序 京东小程序
3.2.5+ 3.2.5+ 3.4.14+ 3.4.14+ 3.4.14+ 3.4.14+ 3.4.14+ 3.4.14+ 3.4.14+ 3.4.14+ 3.4.14+

仅可设置为框架内置语言与自定义扩展的语言,遵循 BCP47 规范。

参数说明

参数名 类型 必填
locale String

# uni.onLocaleChange(callback)

用于监听应用语言切换

平台差异说明

App H5 微信小程序 支付宝小程序 百度小程序 字节跳动小程序、飞书小程序 QQ小程序 快手小程序 华为快应用 360小程序 京东小程序
3.2.7+ 3.2.7+ 3.4.14+ 3.4.14+ 3.4.14+ 3.4.14+ 3.4.14+ 3.4.14+ 3.4.14+ 3.4.14+ 3.4.14+

callback返回参数说明

参数名 类型 说明
locale String 当前语言

# 注意事项

  • 组件和接口显示会根据设置的语言环境自动切换,未支持的系统语言环境会显示为英文。
  • App-Android、App-iOS 平台修改系统语言后会重启应用。
  • App-Android 平台设置新的语言后会自动重启应用。
  • 框架内置如下语言,如需自定义内容或增加其他语言参考:自定义国际化内容 (opens new window)
    • 英语 en
    • 中文简体 zh-Hans
    • 繁体 zh-Hant
    • 法语 fr
    • 西班牙语 es
  • manifest.json -> locale 可以配置应用的默认语言。
  • 仅 3.1.5 - 3.2.4 版本会自动使用 vue-i18n 内配置的语言。