第一步:
首先在自己的项目中安装 vue-i18n依赖包。这里使用NPM进行安装(也可使用CNPM进行安装),安装方法如下:
npm install vue-i18n --save-dev
第二步:
将i18n引入vue实例中,在项目中实现调用API和模板语法。现在在main.js中引入 vue-i18n。如下:
import Vue from 'vue'
import ElementUI from 'element-ui'
import 'element-ui/lib/theme-chalk/index.css'
import App from './App'
import router from './router'
import VueI18n from 'vue-i18n' //引入vue-i18n
Vue.use(ElementUI);
Vue.use(VueI18n); //通过插件的形式挂载
Vue.config.productionTip = false;
/*---------使用语言包-----------*/
const i18n = new VueI18n({
locale: 'zh-CN', // 语言标识
//this.$i18n.locale // 通过切换locale的值来实现语言切换
messages: {
'zh-CN': require('./common/lang/zh'), // 中文语言包
'en-US': require('./common/lang/en') // 英文语言包
}
});
/* eslint-disable no-new */
new Vue({
el: '#app',
i18n, //挂载到实例,一定得在这个位置,而不是comonents中
router,
components: { App },
template: '<App/>'
})
上面的代码正式将 vue-i18n 引入 vue 项目中,创建一个 i18n 实例对象,方便全局调用。我们通过 this.$i18n.locale
来进行语言的切换。
第三步:
接下来我们就需要新建两个js文件(或者josn文件)作为语言包。
其中en.js语言包中代码为:
module.exports = {
message: {
login: 'Login',
Username: 'Username',
Password: 'Password',
Captcha: 'Captcha',
Language: 'Language',
zh: 'Chinese',
en: 'English'
}
}
其中zh.js语言包中代码为:
module.exports = {
message: {
login: '登录',
Username: '用户名',
Password: '密码',
Captcha: '验证码',
Language: '语言',
zh: '中文',
en: '英文'
}
}
最后我们只需要通过触发事件的形式,来控制 locale 的值,去调用对应的语言包就可以实现国际化啦。
第四步:
组件中触发事件切换 locale 的值,从而实现语言的切换。template代码如下:
<div class="lang">
<div class="change-lang" @click="changeLangEvent()">{{changeLang}}</div>
<ul>
<li>{{$t('message.login')}}</li>
<li>{{$t('message.Username')}}</li>
<li>{{$t('message.Password')}}</li>
<li>{{$t('message.Captcha')}}</li>
<li>{{$t('message.Language')}}</li>
<li>{{$t('message.zh')}}</li>
<li>{{$t('message.en')}}</li>
</ul>
</div>
scrpit代码如下:
data () {
return {
lang: 'zh-CN',
changeLang: '切换English',
}
},
methods: {
changeLangEvent() {
if (this.changeLang == '切换English') {
this.changeLang = '切换中文';
} else {
this.changeLang = '切换English';
}
if (this.lang === 'zh-CN') {
this.lang = 'en-US';
this.$i18n.locale = this.lang;
} else {
this.lang = 'zh-CN';
this.$i18n.locale = this.lang;
}
},
},
注意:由于 JavaScript 的限制,Vue 不能检测当前变动的数组,只渲染一次,如果数据不更新视图就不更新的组件,如果切换语言则需要更新一下数据才能切换组件内的多语言。
第五步:
vue-i18n数据渲染的模板语法,模板语法暂时分为三种:
//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官方文档中“国际化”一节中对此有具体说明。下面将手动设置内容贴出来:
import Vue from 'vue'
import ElementUI from 'element-ui'
import VueI18n from 'vue-i18n'
import enLocale from 'element-ui/lib/locale/lang/en' //引入Element UI的英文包
import zhLocale from 'element-ui/lib/locale/lang/zh-CN' //引入Element UI的中文包
Vue.use(VueI18n);
Vue.use(ElementUI, {
i18n: (key, value) => i18n.t(key, value)
}); //兼容i18n 7.x版本设置
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),
}
});
本文参考:https://www.jianshu.com/p/4b96919e3622