# 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。