locale.md 1.7 KB
Newer Older
Q
qiang 已提交
1 2 3 4 5 6
### uni.getLocale()

获取当前设置的语言

**平台差异说明**

Q
qiang 已提交
7
|App|H5|微信小程序|支付宝小程序|百度小程序|字节跳动小程序、飞书小程序|QQ小程序|快手小程序|华为快应用|360小程序|
Q
qiang 已提交
8 9 10
|:-:|:-:|:-:|:-:|:-:|:-:|:-:|:-:|:-:|:-:|
|3.2.5+|3.2.5+|x|x|x|x|x|x|x|x|

Q
qiang014 已提交
11
如果当前应用设置过语言,会获取到之前设置的语言,未设置时会返回根据系统语言类型自动选择的语言。
Q
qiang 已提交
12 13 14 15 16 17 18

### uni.setLocale(locale)

设置当前语言

**平台差异说明**

Q
qiang 已提交
19
|App|H5|微信小程序|支付宝小程序|百度小程序|字节跳动小程序、飞书小程序|QQ小程序|快手小程序|华为快应用|360小程序|
Q
qiang 已提交
20 21 22
|:-:|:-:|:-:|:-:|:-:|:-:|:-:|:-:|:-:|:-:|
|3.2.5+|3.2.5+|x|x|x|x|x|x|x|x|

Q
qiang014 已提交
23
仅可设置为框架内置的语言类型。
Q
qiang014 已提交
24

Q
qiang 已提交
25 26 27 28 29 30
**参数说明**

|参数名|类型|必填|
|:-|:-|:-|
|locale|String|是|

Q
qiang 已提交
31 32
### uni.onLocaleChange(callback)

Anne_LXM's avatar
Anne_LXM 已提交
33
用于监听应用语言切换
Q
qiang 已提交
34 35 36

**平台差异说明**

Q
qiang 已提交
37
|App|H5|微信小程序|支付宝小程序|百度小程序|字节跳动小程序、飞书小程序|QQ小程序|快手小程序|华为快应用|360小程序|
Q
qiang 已提交
38 39 40 41 42 43 44 45 46
|:-:|:-:|:-:|:-:|:-:|:-:|:-:|:-:|:-:|:-:|
|3.2.7+|3.2.7+|x|x|x|x|x|x|x|x|

**callback返回参数说明**

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

Q
qiang 已提交
47 48 49
#### 提示

* 组件和接口显示会根据设置的语言环境自动切换,未支持的系统语言环境会显示为英文。
Q
qiang014 已提交
50
* App-Android 平台设置新的语言后会自动重启应用。
Q
qiang 已提交
51 52 53 54 55 56 57 58
* 框架内置如下语言:
  * 英语 en
  * 中文简体 zh-Hans
  * 繁体 zh-Hant
  * 法语 fr
  * 西班牙语 es
*[manifest.json](/collocation/manifest) -> locale 可以配置应用的默认语言。
* 仅 3.1.5 - 3.2.4 版本会自动使用 vue-i18n 内配置的语言。