vue项目支持多语言(vue-i18n)

引入vue-i18n

vue-i18n 是一个vue插件,主要作用就是让项目支持国际化多语言。首先我们引入这个插件:

import Vue from 'vue'

import Vue18n from 'vue-i18n'

Vue.use(Vuei18n);

vue插件的使用方法,通过全局方法Vue.use()使用插件。

插件通常会为Vue添加全局功能。插件的范围没有限制-一般有下面几种:添加全局方法或者属性;添加全局资源;指令/过滤器/过渡等;通过全局mixin方法添加一些组件选项;添加Vue实例方法,通过把它们添加到Vue.prototype上实现。

Vue.js的插件应当有一个公开方法install,通过代码可以更直观的看出插件提供的功能:

//1 添加全局方法或者属性
Vue.myGlobalMethod=function(){}

//2 添加全局资源
Vue.directive('my-directive',{

bind(el,binding,vnode,oldVnode){}

});

//3 注入组件
Vue.mixin({

created(){}

});

//4 添加实例发方法
Vue.prototype.$myMethods=function(methodOptions){}

使用vue-i18n

<div id="app">{{$t("message.hello")}}</div>

import Vue from 'vue'
import VueI18n from 'vue-i18n'
const messages={   en:{message:{hello:'hello world'}},   cn:{message:{hello:'您好世界'}} }; const i18n=new VueI18n({   locale:'en',   messages:messages }); new Vue({i18n}).$mount("#app");

//output

<div id="app">hello world</div>

可以看到,我们再实例化Vue的时候,将i18n当作一个options传了进去。之后我们就可以在vue的组件里使用i18n了,使用方法主要是两种:

1 在组件的template中,使用$t()方法

2 在组件的script中,使用this.$i18n.$t()

添加locales文件夹

messages是一个包含了多语言的对象,它就像哦我们的字典。可以新建一个locales文件夹,存放作于跟我们语言相关的代码。目前包含三个文件:index.js en.js cn.js

en.js 和cn.js是我们的语言包,是一个json形式。

index.js

import Vue form 'vue'
import VueI18n from 'vue-i18n'
import EN from './en.js'
import CN from './cn.js'
const DEFAULT_LANG='cn'; const LOCALE_KEY='localeLanguage'; const locales={   en:EN,   cn:CN }; const i18n=new VueI18n({   locale:DEFAULT_LANG,   messages:locales });
export const setup
=(lang)=>{   if(lang==undefiend){     lang=window.getStorage(LOCALE_KEY)     if(locales[lang]==undefined){lang=DEFAULT_LANG}   }   window.localstorage.setItem(LOCALE_KEY,lang);   Object.keys(locales).forEach(function(lang){   document.body.classList.remove(`lang-${lang}`);   });   document.body.classList.add(`lang-${lang}`);   document.body.setAttribute('lang',lang);   i18n.locale=lange;   Vue.config.lang=lang;  } setup(); export default I18n;

我们对外提供一个setup的方法,给使用者修改当前使用语种的能力。同时,我们在setup里还做了三件事:

将当前语种存在localStorage中,保存用户的使用习惯;给body添加语种相关的class,因为不同语言可能导致排版出现差异,我们还需要配置,将当前语种存在

Vue的全局配置中,以便未来可能的使用。

最后在main.js中引入这个index.js就可以了

import Vue from ‘vue’
import App from './app.vue'
import router from './router'
import store from './store'
...
import i18n from '@/locales'

new Vue({router,store,i18n,render:h=>h(App)}).$mount('#app');

vue实例外的js代码中的额文本怎么替换?
vue实例中我们可以使用this.$i18n.t,这里的this是vue的实例,那项目中的很多js代码在vue的实例之外。最简单的方法就是咋需要

使用的地方手动直接import i18n

这样在vue实例中使用this.$i18n.t,如果不是就先import ,使用i18n.t,这样显然复杂了。

为了解决这个问题,最直接的办法就是把i18n直接挂载在window下,变成全局变量。我们就不需要import了,直接使用i18n.t就可以了;

在main.js:

import Vue from 'vue'

import App from './app.vue'
import store from './store'
import router from './router'
...
import i18n from '@crm/locales'
...

window.i18n = i18n

new Vue({
  i18n,
  router,
  store,
  render: h => h(App),
}).$mount('#app')

然而我们将组件中的import i18n全去掉,并将this.$i18n.t改成i18n.t.项目跑起来之后就报错了:i18n is not defined

显然是组件在调用i18n的时候,i18n还没有挂载到window上,所以执行顺序出了问题:

//假设webpack的入口文件是```main.js```
 
//main.js
import moduleA from 'moduleA'
console.log(1)
 
import moduleB from 'moduleB'
console.log(2)
 
//moduleA.js
console.log(3)
 
//moduleB.js
console.log(4)
 
//最终在浏览器中打印出的数字顺序是: 
3
4
1
2

跟ES6 module的机制有关系。import命令具有提升效果,会提升到整个模块的头部,首先执行,这种行为的本质是,import命令是编译阶段执行的,在代码运行之前。

这样我们就找到之前报错的原因了,我们先import app router这些视图,然后import i18n并挂载在window,所有组件的script中的代码都先执行,而此时i18n挂载到

window的代码还没有执行。import中的script代码执行完之后才到main.js中其他的js代码,我们首先将window.i18n=i18n移到locales/index中,然后调整main.js中的import的顺序:

//locales/index
...
setup()
window.i18n = i18n

export default i18n

//main.js
import Vue from 'vue'

import i18n from '@crm/locales'
import App from './app.vue'
import store from './store'
import router from './router'
...

 

 

参考:http://www.totozhan.com/

上一篇:vue-i18n 多语言开发


下一篇:Element-UI