1. 前言
前端框架无数,其中几种热门的框架都有相匹配的国际化插件工具,如下:
vue + vue-i18n angular + angular-translate react + react-intl jquery + jquery.i18n.property
2. 国际化实现
2.1 安装插件
首先在项目中安装 vue-i18n 依赖包,这里使用NPM进行安装,如果没有科学上网请使用CNPM进行安装。
npm install vue-i18n --save-dev
2.2 引入 vue-i18n
将 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('./assets/lang/zh'), // 中文语言包 'en': require('./assets/lang/en') // 英文语言包 } }) /* eslint-disable no-new */ new Vue({ el: '#app', i18n, // 挂载到实例,一定得在这个位置,而不是comonents中 template: '<App/>', components: { App } });
上面的代码正式将 vue-i18n 引入 vue 项目中,创建一个 i18n 实例对象,方便全局调用。我们通过 this.$i18n.locale 来进行语言的切换。
2.3 新建语言包
新建两个js文件(或者josn文件)作为语言包
en.js 语言包中代码为:
module.exports = { message: { login: 'Login', Username: 'Username', Password: 'Password', Captcha: 'Captcha', Language: 'Language', zh: 'Chinese', en: 'English' }, nav:{ Home:'home', About:'about' } }
zh.js 语言包中代码为:
module.exports = { message: { login: '登录', Username: '用户名', Password: '密码', Captcha: '验证码', Language: '语言', zh: '中文', en: '英文' }, nav:{ Home:'主页', About:'关于' } }
只需要通过触发事件的形式,来控制 locale 的值,去调用对应的语言包就可以实现国际化。
2.4 vue-i18n 数据渲染的模板语法
// 1. vue组件模板的使用 <div>{{$t('message.zh')}}</div> // 2. vue组件模板数据绑定的使用 <input :placeholder="$t('message.zh')"/> // 3.vue组件data中赋值的使用 data:{ msg:this.$t('message.zh'); }
2.5 组件中实现
组件中触发事件切换 locale 的值,从而实现语言的切换
这里安装使用了 Element-ui
<template> <div class="about"> <div class="lang"> <el-radio-group v-model="language" size="mini"> <el-radio v-for="(item,index) in lang" :label="item.value" border :key="index"> {{item.label}} </el-radio> </el-radio-group> </div> <div>{{$t('message.zh')}}</div> <input :placeholder="$t('message.Username')"/> </div> </template> <script> 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}) } }, } </script>
注意: 由于 JavaScript 的限制,Vue 不能检测当前变动的数组,只渲染一次,如果数据不更新视图就不更新的组件,如果切换语言则需要更新一下数据才能切换组件内的多语言。
2.6 Element UI 组件库与 vue-i18n 的兼容问题
由于项目中使用了Element UI组件库,它里面内置的一些文字也是需要国际化,好在Element UI是有国际化的支持。
但是Element UI默认只兼容vue-i18n的5.x版本,而现在vue-i18n的版本已经到了8.x,Element UI官方文档中“国际化”一节中对此有具体说明。
下面将手动设置内容贴出来,更新下 main.js ,请注意变化的部分:
import Vue from 'vue' import App from './App.vue' import router from './router' import store from './store' import VueI18n from 'vue-i18n' // 引入vue-i18n import ElementUI from 'element-ui'; import 'element-ui/lib/theme-chalk/index.css'; import enLocale from 'element-ui/lib/locale/lang/en' //引入Element UI的英文包 import zhLocale from 'element-ui/lib/locale/lang/zh-CN' //引入Element UI的中文包 Vue.config.productionTip = false Vue.use(VueI18n); // 通过插件的形式挂载 Vue.use(ElementUI,{ i18n: (key, value) => i18n.t(key, value) }); /*---------使用语言包-----------*/ const i18n = new VueI18n({ locale: 'zh', // 语言标识 // this.$i18n.locale // 通过切换locale的值来实现语言切换 messages: { 'zh': Object.assign(require('./assets/lang/zh'),zhLocale), // 中文语言包 'en': Object.assign(require('./assets/lang/en'),enLocale) // 英文语言包 } }) new Vue({ router, store, i18n, // 挂载到实例,一定得在这个位置,而不是comonents中 render: h => h(App) }).$mount('#app')
2.6.1 路由与面包屑导航国际化的语法问题
router.js (路由配置文件):
const routes = [ { path: '/', name: 'nav.Home', component: Home }, { path: '/about', name: 'nav.About', // 直接点出语言包中对应的文字 component: () => import('../views/About.vue') } ]
Breadcrumb.vue
<div id="Breadcrumb"> <el-breadcrumb separator-class="el-icon-arrow-right"> <el-breadcrumb-item :to="{ path: '/' }">{{$t('nav.Home')}}</el-breadcrumb-item> <!-- 注意 {{$t(item.name)}} --> <el-breadcrumb-item v-for="(item,i) in $route.matched" :to="{ path: item.path}" :key="i"> {{$t(item.name)}} </el-breadcrumb-item> </el-breadcrumb> </div>