一、前言
在4k广告机中需要实现多语言切换,这时候接触到国际化,前端框架无数,其中几种热门的框架都有相匹配的国际化插件工具。比如:
二、最终实现效果
三、国际化的实现
1、首先在自己的项目中安装 vue-i18n依赖包。这里使用NPM进行安装,如果没有科学上网请使用CNPM进行安装。
npm install vue-i18n --save-dev
2、将i18n引入vue实例中,在项目中实现调用API和模板语法。现在在main.js中引入 vue-i18n。
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39
| import VueI18n from 'vue-i18n'
Vue.use(VueI18n);
const i18n = new VueI18n({ locale: 'CN', messages : { en: { message: { hello: 'hello world' } }, cn: { message: { hello: '你好、世界' } } } })
const i18n = new VueI18n({ locale: 'zh', messages: { 'zh': require('./common/lang/zh'), 'en': require('./common/lang/en') } })
new Vue({ el: '#app', i18n, template: '<App/>', components: { App } });
|
上面的代码正式将 vue-i18n 引入 vue 项目中,创建一个 i18n 实例对象,方便全局调用。我们通过 this.$i18n.locale
来进行语言的切换。
3、接下来我们就需要新建两个js文件(或者josn文件)作为语言包。
其中en.js语言包中代码为:
1 2 3 4 5 6 7 8 9 10 11
| module.exports = { message: { login: 'Login', Username: 'Username', Password: 'Password', Captcha: 'Captcha', Language: 'Language', zh: 'Chinese', en: 'English' } }
|
其中zh.js语言包中代码为:
1 2 3 4 5 6 7 8 9 10 11
| module.exports = { message: { login: '登录', Username: '用户名', Password: '密码', Captcha: '验证码', Language: '语言', zh: '中文', en: '英文' } }
|
最后我们只需要通过触发事件的形式,来控制 locale 的值,去调用对应的语言包就可以实现国际化啦。
4、组件中触发事件切换 locale 的值,从而实现语言的切换。template代码:
1 2 3 4 5
| <div class="lang"> <el-radio-group v-model="language" size="mini"> <el-radio v-for="item of lang" :label="item.value" border>{{item.label}}</el-radio> </el-radio-group> </div>
|
scrpit代码:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35
| import Vue from 'vue'
export default { mounted() { this.$i18n.locale === 'zh' ? this.language = 0 : this.language = 1 }, data() { return { language: 0, lang: [{ label: this.$t('message.zh'), value: 0 }, { label: this.$t('message.en'), value: 1 }], } }, watch: { language: function (val) { val === 0 ? this.$i18n.locale = 'zh' : this.$i18n.locale = 'en'; Vue.set(this.lang, 0, {label: this.$t('message.zh'), value: 0}); Vue.set(this.lang, 1, {label: this.$t('message.en'), value: 1})
} }, }
|
注意:由于 JavaScript 的限制,Vue 不能检测当前变动的数组,只渲染一次,如果数据不更新视图就不更新的组件,如果切换语言则需要更新一下数据才能切换组件内的多语言。
四、vue-i18n 数据渲染的模板语法
模板语法暂时分为三种:
1 2 3 4 5 6 7 8 9 10
| //vue组件模板的使用 <div>{{$t('message.zh')}}</div>
//vue组件模板数据绑定的使用 <input :placeholder="$t('message.zh')"></input>
//vue组件data中赋值的使用 data:{ msg:this.$t('message.zh'); }
|
五、Element UI组件库与vue-i18n的兼容问题
由于项目中使用了Element UI组件库,它里面内置的一些文字也是需要国际化,好在Element UI是有国际化的支持。但是Element UI默认只兼容vue-i18n的5.x版本,而现在vue-i18n的版本已经到了7.x,Element UI官方文档中“国际化”一节中对此有具体说明。下面将手动设置内容贴出来:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18
| import Vue from 'vue' import ElementUI from 'element-ui' import VueI18n from 'vue-i18n' import enLocale from 'element-ui/lib/locale/lang/en' import zhLocale from 'element-ui/lib/locale/lang/zh-CN'
Vue.use(VueI18n); Vue.use(ElementUI, { i18n: (key, value) => i18n.t(key, value) });
const i18n = new VueI18n({ locale: 'zh', messages: { zh: Object.assign(require('@/components/common/lang/zh'), zhLocale), en: Object.assign(require('@/components/common/lang/en'), enLocale), } });
|
注意:关于导入多个语言包时遇到的问题,我是在Element UI 国际化文档中发现的解决办法。
六、路由与面包屑导航国际化的语法问题
在对面包屑导航进行国际化时不知道如何进行。在网上翻阅了一些资料,得到如下代码,完美解决问题:
router.js(路由配置文件)
1 2 3 4 5
| { path: '/index', name: 'nav.Home', component: (resolve) => require(['@/components/index'], resolve) }
|
Breadcrumb.vue(面包屑导航组件)
1 2 3 4 5 6 7
| <div id="Breadcrumb"> <el-breadcrumb separator-class="el-icon-arrow-right"> <el-breadcrumb-item :to="{ path: '/index' }">{{$t('nav.Home')}}</el-breadcrumb-item> /*注意{{$t(item.name)}}*/ <el-breadcrumb-item v-for="item in $route.matched" :to="{ path: item.path}">{{$t(item.name)}}</el-breadcrumb-item> </el-breadcrumb> </div>
|
七、至此,国际化的坑算是踩完了。