Vue项目中的多语言切换支持

多语言支持

vue项目中的多语言支持使用的是vue-i18n 参考文档

目标

1.实现elementUI中英文切换功能，感受中文切换的效果
2.自定义内容多语言配置

一、安装依赖包

npm i vue-i18n@8.22.2

二、 ElementUI多语言配置

Element：参考文档
新建src/lang/index.js
示例代码

// 进行多语言支持配置
import Vue from 'vue' // 引入Vue
import VueI18n from 'vue-i18n' // 引入国际化的插件包
import locale from 'element-ui/lib/locale'
import elementEN from 'element-ui/lib/locale/lang/en' // 引入elementui的英文包
import elementZH from 'element-ui/lib/locale/lang/zh-CN' // 引入elementui的中文包
Vue.use(VueI18n) // 全局注册国际化包

// 创建国际化插件的实例
const i18n = new VueI18n({
  // 指定语言类型 zh表示中文  en表示英文
  locale: 'zh',
  // 将elementUI语言包加入到插件语言数据里
  messages: {
    // 英文环境下的语言数据
    en: {
      ...elementEN
    },
    // 中文环境下的语言数据
    zh: {
      ...elementZH
    }
  }
})
// 配置elementUI 语言转换关系
locale.i18n((key, value) => i18n.t(key, value))

export default i18n

三、挂载 i18n的插件

在main.js中挂载 i18n的插件

// 省略其他...
import i18n from '@/lang'
// 加入到根实例配置项中
new Vue({
  el: '#app',
  router,
  store,
  i18n,
  render: h => h(App)
})

四、自定义内容多语言配置

引入自定义中英文及其他多语言配置

|- src
			|-lang
						|-index.js
						|-en.js # 自定义语言包
						|-zh.js # 自定义语言包

自定义语言包示例代码

export default {
navbar: {
    search: 'search',
    logOut: 'Log Out',
    dashboard: 'Dashboard',
    github: 'Github',
    screenfull: 'screenfull',
    theme: 'theme',
    lang: 'i18n',
    error: 'error log'
  },
  ... // 各种分模块内需要匹配的自定义内容
}

配置src/lang/index.js

import Vue from 'vue'
import VueI18n from 'vue-i18n'
import elementEN from 'element-ui/lib/locale/lang/en'
import elementZH from 'element-ui/lib/locale/lang/zh-CN'
// 引入自定义中文包
+ import customZH from './zh' 
// 引入自定义英文包
+ import customEN from './en' 

Vue.use(VueI18n)

// 创建国际化插件的实例
export default new VueI18n({
  // 指定语言类型
  locale: 'zh',
  messages: {
    en: {
      ...elementEN, // 将elementui的英文语言包引入
+     ...customEN   // 将自定义英文包加入
    },
    zh: {
      ...elementZH, // 将elementui的中文语言包引入
+     ...customZH   // 将自定义中文包加入
    }
  }
})

此时在组件页面内也可以直接使用
视图代码：{{ $t('xx.xxxx')}} // 例如：{{$t('navbar.search')}} 利用插值表达式直接渲染到页面
当我们引入VueI18n语言插件之后，每个组件实例都拥有了一个$t方法，这个方法可以帮助我们进行语言转换，可以根据当前的语言类型，使用传入
的key去寻找当前key对应的文本
自动切换：this.$i18n.locale = 'zh'  // 在某个事件回调函数里赋值使用，相当于this.$router

五、实现动态切换中英文-封装组件

效果图

新建src/components/Lang/index.vue

<template>
  <el-dropdown trigger="click" @command="handleCommand">
    <div>
      <!-- icon-class="language" 需要在src\icons\svg\下有一个名为language.svg的文件。 -->
      <svg-icon style="color:#fff;font-size:20px" icon-class="language" />
    </div>
    <el-dropdown-menu slot="dropdown">
      <el-dropdown-item command="zh" :disabled="'zh'=== $i18n.locale ">中文</el-dropdown-item>
      <el-dropdown-item command="en" :disabled="'en'=== $i18n.locale ">en</el-dropdown-item>
    </el-dropdown-menu>
  </el-dropdown>
</template>

<script>
export default {
  methods: {
    handleCommand(lang) {
      this.$i18n.locale = lang // 设置给本地的i18n插件
      this.$message.success('切换多语言成功')
    }
  }
}
</script>

全局注册

在component/index.js中进行全局组件注册

import Lang from './Lang'
export default {
  // 插件的初始化, 插件给你提供的全局的功能, 都可以在这里配置
  install(Vue) {
    // 进行组件的全局注册
    Vue.component('Lang', Lang)
  }
}

在main.js中进行全局组件挂载

import Vue from 'vue'
import components from '@/component'
Vue.use(components)

六、使用组件

在需要引入此全局组件的内部使用

<!-- 语言包 -->
<lang />