Vue中 实现国际化

1,329 阅读3分钟

这是我参与更文挑战的第 19 天,活动详情查看:更文挑战

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>