# i18n国际化模块 1.6.5
注意
- 由
2.4.1
起,z-paging
的i18n配置与uni-app
国际化方案对齐,具体参见国际化开发指南 (opens new window)
配置详情 2.4.1
- 通过
uni.getLocale()
获取当前设置的语言;通过uni.setLocale(locale)
设置当前语言;通过uni.onLocaleChange(callback)
监听应用语言切换。具体参见语言配置 (opens new window) - 如何新增语言支持?
z-paging
默认支持英文(en)
、中文简体(zh-Hans)
、中文繁体(zh-Hant)
,以下以添加日文为例:
在/z-paging/components/z-paging/i18n
目录中添加ja.json
文件(可复制zh-Hans.json
),在当前目录的index.js
文件中importja.json
。可通过uni.setLocale('ja')
切换至日文 - 语言地区代码必须遵循
BCP47
规范,所有BCP47
代码详见:点击查看 (opens new window)
配置详情(2.4.1之前) 2.4.1起废弃
- ① 导入
z-paging-i18n.js
:import zI18n from '@/uni_modules/z-paging/components/z-paging/js/z-paging-i18n'
- ② 全局设置语言:
zI18n.setLanguage('要设置的语言')
。支持简体中文(zh-cn)、繁体中文(zh-hant-cn)和英文(en),传null表示语言跟随系统(默认)。 - ③ 获取当前语言(非必须):
const language = zI18n.getLanguageName();
注意:getLanguageName()
方法中可以传一个参数(Boolean)用以约束当前获取的语言是否是在不跟随系统语言下获取到的,默认为true。