幾種熱門的框架相匹配的國際化插件工具。如下:
vue + vue-i18n
angular + angular-translate
react + react-intl
jquery + jquery.i18n.property
一、國際化的實現
1、首先在自己的項目中安裝 vue-i18n依賴包。這里使用NPM進行安裝,如果沒有科學上網請使用CNPM進行安裝。
npm install vue-i18n --save-dev
2、將i18n引入vue實例中,在項目中實現調用API和模板語法。現在在main.js中引入 vue-i18n。
import VueI18n from 'vue-i18n' //引入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', // 語言標識
//this.$i18n.locale // 通過切換locale的值來實現語言切換
messages: {
'zh': require('./common/lang/zh'), // 中文語言包
'en': require('./common/lang/en') // 英文語言包
}
})
/* eslint-disable no-new */
new Vue({
el: '#app',
i18n, //掛載到實例,一定得在這個位置,而不是comonents中
template: '<App/>',
components: {
App
}
});
上面的代碼正式將 vue-i18n 引入 vue 項目中,創建一個 i18n 實例對象,方便全局調用。我們通過 this.$i18n.locale 來進行語言的切換。
3、接下來我們就需要新建兩個js文件(或者josn文件)作為語言包。
image.png
其中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 的值,去調用對應的語言包就可以實現國際化啦。
4、組件中觸發事件切換 locale 的值,從而實現語言的切換。template代碼:
<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代碼:
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})
/**
this.lang: [{
label: this.$t('message.zh'), //如果不使用Vue.set,也可以使用更新數據的方法
value: 0
}, {
label: this.$t('message.en'),
value: 1
}]
**/
}
},
}
注意:由于 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是有國際化的支持。下面將手動設置內容貼出來:
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),
}
});
可以將element-ui國際化與i18n合并來寫
import Vue from 'vue'
import VueI18n from 'vue-i18n'
import Cookies from 'js-cookie'
import elementEnLocale from 'element-ui/lib/locale/lang/en' // element-ui lang
import elementZhLocale from 'element-ui/lib/locale/lang/zh-CN'// element-ui lang
import enLocale from './en'
import zhLocale from './zh'
Vue.use(VueI18n)
//合并
const messages = {
en: {
...enLocale,
...elementEnLocale
},
zh: {
...zhLocale,
...elementZhLocale
}
}
//獲取cookie中存儲的語言,用來直接設置i18n語言
export function getLanguage() {
const chooseLanguage = Cookies.get('backend_lang') === 'zh-CN' ? 'zh' : 'en'
if (chooseLanguage) return chooseLanguage
// if has not choose language
const language = (navigator.language || navigator.browserLanguage).toLowerCase()
const locales = Object.keys(messages)
for (const locale of locales) {
if (language.indexOf(locale) > -1) {
return locale
}
}
return 'en'
}
const i18n = new VueI18n({
// set locale
// options: en | zh | es
locale: getLanguage(), // 默認語言
// set locale messages
messages
})
export default i18n
main.js中
Vue.use(ElementUI, {
i18n: (key, value) => i18n.t(key, value)
})//重點:為了實現element插件的多語言切換
//然后掛載在vue實例上
new Vue({
el: '#app',
router,
store,
i18n,
render: h => h(App)
})
四、路由名稱國際化
router.js(路由配置文件)
{
path: 'pending',
name: 'Pending',
component: () =>
import ('@/views/demand/pending'),
meta: {
title: 'route.pendingEnquiry',
roles: [2]
}