vue新项目多语言国际化支持详细流程

239 阅读2分钟

vue项目中的多语言支持使用的是 vue-i18n 参考:kazupon.github.io/vue-i18n/zh…

流程:

1.安装国际化的包 npm i vue-i18n@8.22.2

vue-i18n现在有了新版本,对应的api有些不兼容,请还是使用8.22.2这个版本!

  1. ElementUI多语言配置

2.1创建一个组件

// 进行多语言支持配置
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' // 引入饿了么的英文包
import elementZH from 'element-ui/lib/locale/lang/zh-CN' // 引入饿了么的中文包
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

2.2 在main.js中挂载i18n的插件

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

3.自定义内容多语言配置 3.1在组件中 引入自定义语言包(自己准备)

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, // 将饿了么的英文语言包引入
+     ...customEN   // 将自定义英文包加入
    },
    zh: {
      ...elementZH, // 将饿了么的中文语言包引入
+     ...customZH   // 将自定义中文包加入
    }
  }
})

3.2就可以进行title替换操作了

准备两套翻译文案
在en.js和zh.js中分别设置companyName,写上对应语言的title 在title所在的位置进行替换

 {{ $t('navbar.companyName') }}

3.3手动切换查看效果

export default new VueI18n({
  // 切换这里试试 en
  locale: 'zh'
  ...
})

4.封装多语言组件

<template>
  <el-dropdown trigger="click" @command="changeLanguage">
    <div>
      <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: {
    changeLanguage(lang) {
      this.$i18n.locale = lang // 设置给本地的i18n插件
      this.$message.success('切换多语言成功')
    }
  }
}
</script>

注意:icon-class="language" 需要自己准备图标

5.全局注册

在自己设置的全局注册组件中进行全局注册

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

6.最后使用组件就可以了