vue项目国际化 vue-i18n 使用

目的

项目需要支持多语言，我们需要提取出项目中使用的静态文本，使用语言包进行管理， 当切换语言设置的时候，可以自动切换整个项目的文字显示。

发现Vue项目中有对应的组件vue-i18n，而且对项目的代码修改不大，于是就使用了这个组件去修改项目中的代码。

安装

// script 引入
<script src="https://unpkg.com/vue/dist/vue.js"></script>
<script src="https://unpkg.com/vue-i18n/dist/vue-i18n.js"></script>


// npm 安装
npm install vue-i18n

// yarn 安装
yarn add vue-i18n
复制代码

一般一个项目中使用都是通过安装包的方式去运行的，script引入的较少。

使用

项目中配置i18n

import VueI18n from 'vue-i18n'
Vue.use(VueI18n)

const i18n = new VueI18n({
    local: 'cn', // 设置语言 
    messages // 语言包
})

new Vue({
    el: '#app',
    ...
    i18n
})

// messages 大概的使用格式
{
    cn: {
        name: '名字'
    },
    us: {
        name： 'Name'
    }
}
复制代码

使用i18n

简单使用

// html 需要使用 {{}} 将 name包装起来
{{$t('name')}}

// js
$t('name')

可传入变量

// 命名传入参数
// messages:
{
    cn: {
        name: '名字：{name}'
    },
    us: {
        name: 'Name: {name}'
    }
}

$t('name', {name: 'Jack'}) // Name：Jack


// 列表传入参数
// messages: 
{
    cn: {
        name: '名字：{0}{1}'
    },
    us: {
        name: 'Name: {0}{1}'
    }
}

// array
$t('name', ['Jack', 'Job'])
// object
$t('name', {'0':'Jack', '1': 'Job'])

v-t 可以用于变量的引用，类似于$t

v-t 指令

// 官网的列子
new Vue({
  i18n: new VueI18n({
    locale: 'en',
    messages: {
      en: { hello: 'hi {name}!' },
      ja: { hello: 'こんにちは、{name}！' }
    }
  }),
  computed: {
    nickName () { return 'kazupon' }
  },
  data: { path: 'hello' }
}).$mount('#object-syntax')


<div id="object-syntax">
  <!-- literal -->
  <p v-t="{ path: 'hello', locale: 'ja', args: { name: 'kazupon' } }"></p>
  <!-- data biniding via data -->
  <p v-t="{ path: path, args: { name: nickName } }"></p>
</div>

<div id="object-syntax">
  <p>こんにちは、kazupon！</p>
  <p>hi kazupon!</p>
</div>
复制代码

$t 与 v-t 对比

• $t 是方法调用，v-t 是一个指令
• v-t 性能比$t更好，有自定义指令的缓存
• $t 使用更灵活，使用方法更简单

还有一些其他的用法，具体的请参考官方文档。。