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

Posted 2021-02-20 1156184981651a

引入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/