组件库中使用 vue-i18n 国际化的案例详解

import Vue from 'vue'
import VueI18n from 'vue-i18n'
Vue.use(VueI18n)
// 准备翻译的语言环境信息
const messages = {
  en: {
    message: {
      hello: 'hello world'
    }
  },
  ja: {
    message: {
      hello: 'こんにちは、世界'
    }
  }
}
// 通过选项创建 VueI18n 实例
const i18n = new VueI18n({
  locale: 'ja', // 设置地区
  messages, // 设置地区信息
})
// 通过 `i18n` 选项创建 Vue 实例
new Vue({ i18n }).$mount('#app')

<template>  
  <div id="app">
    <p>{{ $t("message.hello") }}</p>
  </div>
</template>
复制代码

const components = {}; // 具体封装的组件这里不做赘述
const install = function (Vue, options = {}) {
  Object.keys(components).forEach((key) => {
    Vue.component(key, components[key]);
  });
};
/* istanbul ignore if */
if (typeof window !== 'undefined' && window.Vue) {
  install(window.Vue);
}
export default {
  version,
  install,
  ...components
};

import Vue from 'vue';
import VueI18n from 'vue-i18n';
Vue.use(VueI18n)
// 配置从文件读取
const req = require.context('./lang', false, /.js$/)
const modules = req.keys().map(k => {
  let name = k.match(/./(.+).js/)[1]
  return {
    name: name,
    webLocale: req(k).default,
    elementLocale: require(`element-ui/lib/locale/lang/${name}`).default // 加入 element 的 i18n
  }
})
// 注册 i18n
let i18n = new VueI18n({
  locale: 'zh-CN',
  messages: getMessages(),
})
// 对外暴露的合并配置项的方法
export function i18nLocale(config, lang = 'zh-CN') {
  i18n = new VueI18n({
    locale: lang,
    messages: getMessages(config),
  })
  return i18n;
}
// 合并方法
function getMessages(config = []) {
  return modules.reduce((sum, item) => {
    let conf = config.find(m => m.locale === item.name) || {};
    let locale = conf.locale || item.name;
    sum[locale] = {
      ...item.elementLocale, // element 的语言配置
      ...item.webLocale, // 组件库的语言配置
      ...conf.message, // 页面的语言配置
    }
    return sum;
  }, {})
}
export default i18n;

import i18n, { vueI18nLocale } from './locale';
import element from 'element-ui';
const components = {}; // 具体封装的组件这里不做赘述
// 传入一个 options ，为了将 element 的国际化合并方法传入组件库
// 经实验，element 的国际化合并在页面触发有效，在组件库中触发无效，故此操作
const install = function (Vue, options = {}) {
  Object.keys(components).forEach((key) => {
    Vue.component(key, components[key]);
  });
  // 在页面使用组件库，进行 Vue.use 的时候注册，能保证相同的 Vue 实例
  // 这句是关键！不能使用 Vue.prototype.$i18n = i18n; 会报错，报错原因是与 vue-i18n 内部的变量重名，故这里使用 $i18n_ 代替，但这不影响页面使用 $i18n
  Object.defineProperty(Vue.prototype, '$i18n_', {
    get() {
      // 此 this 为页面 vue 实例，若页面配置了国际化，则使用页面的实例，否则用组件库的国际化
      return this.$i18n || i18n;
    },
    configurable: true
  });
  // 在此注册 element，并将页面传入的国际化合并方法，继续传入到 element
  Vue.use(element, {
    i18n: options.i18n || ((key, value) => i18n.t(key, value))
  });
};
/* istanbul ignore if */
if (typeof window !== 'undefined' && window.Vue) {
  install(window.Vue);
}
export default {
  version,
  vueI18nLocale, // 导出合并语言配置项的方法
  install,
  ...components
};

<div v-bind="$i18n_.t('textPart.textNum')"></div>

import Vue from 'vue';
import web from '../src/index'; // 组件库，无需再引用 element
// 页面的国际化配置，同样需要新建对应的语言文件
const req = require.context('./lang', false, /.js$/);
const localeConfig = req.keys().map((k) => {
  let name = k.match(/./(.+).js/)[1];
  return {
    locale: name, // 需要与组件库的语言类型一一对应
    message: req(k).default
  };
});
// 使用组件库暴露的合并配置项方法，获得新的 i18n 实例
// 该 i18n 包含了组件库的 i18n 和 页面的 i18n 
const i18n = web.i18nLocale(localeConfig, 'zh-CN');
// 注册组件库的同时，传入 element 的国际化合并方法
// 此时，该 i18n 包含了 element、组件库、页面 的 i18n
Vue.use(web, {
  i18n: (key, value) => i18n.t(key, value)
});
export default new Vue({
  el: '#app',
  router,
  i18n, // 将 i18n 注册到页面 vue 实例
  components: { App },
  template: '<App/>'
});

<template>
  <div>
    <!-- 两种写法返回值相同 -->
    <div v-bind="$t('textPart.textNum')"></div>
    <div v-bind="$i18n.t('textPart.textNum')"></div>
    <div @click="changeI18n">切换语言</div>
  </div>
</template>
<script>
  export default {
    data() {
      return {};
    },
    methods: {
      changeI18n() {
        // 这里的 this.$i18n 包含了 element、组件库、页面 的 i18n
        // 然后这里还有一个 this.$i18n_ ，是单独组件库的 i18n
        this.$i18n.locale = 'en';
      }
    }
  };