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' ...
参考:https://segmentfault.com/a/1190000015008808