vue中如何使用i18n實現國際化

gorkys發表於2019-09-04
Vue

一、前言

在4k廣告機中需要實現多語言切換，這時候接觸到國際化，前端框架無數，其中幾種熱門的框架都有相匹配的國際化外掛工具。比如：

  • vue + vue-i18n
  • angular + angular-translate
  • react + react-intl
  • jquery + jquery.i18n.property

在4K廣告機專案中使用的前端框架為Vue，故而我們將使用vue-i18n這個外掛進行國際化功能的實現。

二、最終實現效果

登入介面

三、國際化的實現

1、首先在自己的專案中安裝 vue-i18n依賴包。這裡使用NPM進行安裝，如果沒有科學上網請使用CNPM進行安裝。

npm install vue-i18n --save-dev

2、將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('./common/lang/zh'),   // 中文語言包
     'en': require('./common/lang/en')    // 英文語言包
   }
})

/* eslint-disable no-new */
new Vue({
 el: '#app',
 i18n,        //掛載到例項，一定得在這個位置，而不是comonents中
 template: '<App/>',
 components: {
   App
 }
});
複製程式碼

上面的程式碼正式將 vue-i18n 引入 vue 專案中，建立一個 i18n 例項物件，方便全域性呼叫。我們通過 this.$i18n.locale 來進行語言的切換。

3、接下來我們就需要新建兩個js檔案（或者josn檔案）作為語言包。

目錄

其中en.js語言包中程式碼為：

module.exports = {
 message: {
   login: 'Login',
   Username: 'Username',
   Password: 'Password',
   Captcha: 'Captcha',
   Language: 'Language',
   zh: 'Chinese',
   en: 'English'
 }
}
複製程式碼

其中zh.js語言包中程式碼為：

module.exports = {
  message: {
    login: '登入',
    Username: '使用者名稱',
    Password: '密碼',
    Captcha: '驗證碼',
    Language: '語言',
    zh: '中文',
    en: '英文'
  }
}
複製程式碼

最後我們只需要通過觸發事件的形式，來控制 locale 的值，去呼叫對應的語言包就可以實現國際化啦。

4、元件中觸發事件切換 locale 的值，從而實現語言的切換。template程式碼：

<div class="lang">
    <el-radio-group v-model="language" size="mini">
        <el-radio v-for="item of lang" :label="item.value" border>{{item.label}}</el-radio>
    </el-radio-group>
</div>
複製程式碼

scrpit程式碼：

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})
        /**
        this.lang: [{
          label: this.$t('message.zh'),       //如果不使用Vue.set，也可以使用更新資料的方法
          value: 0
        }, {
          label: this.$t('message.en'),
          value: 1
        }]
        **/
      }
    },
  }
複製程式碼

注意：由於 JavaScript 的限制，Vue 不能檢測當前變動的陣列，只渲染一次，如果資料不更新檢視就不更新的元件，如果切換語言則需要更新一下資料才能切換元件內的多語言。

四、vue-i18n 資料渲染的模板語法

模板語法暫時分為三種：

//vue元件模板的使用
<div>{{$t('message.zh')}}</div>

//vue元件模板資料繫結的使用
<input :placeholder="$t('message.zh')"></input>

//vue元件data中賦值的使用
data:{
   msg:this.$t('message.zh');
}
複製程式碼

五、Element UI元件庫與vue-i18n的相容問題

由於專案中使用了Element UI元件庫，它裡面內建的一些文字也是需要國際化，好在Element UI是有國際化的支援。但是Element UI預設只相容vue-i18n的5.x版本，而現在vue-i18n的版本已經到了7.x，Element UI官方文件中“國際化”一節中對此有具體說明。下面將手動設定內容貼出來：

import Vue from 'vue'
import ElementUI from 'element-ui'
import VueI18n from 'vue-i18n'
import enLocale from 'element-ui/lib/locale/lang/en'        //引入Element UI的英文包
import zhLocale from 'element-ui/lib/locale/lang/zh-CN'     //引入Element UI的中文包

Vue.use(VueI18n);
Vue.use(ElementUI, {
  i18n: (key, value) => i18n.t(key, value)
}); //相容i18n 7.x版本設定

const i18n = new VueI18n({
  locale: 'zh', // 語言標識
  messages: {
    zh: Object.assign(require('@/components/common/lang/zh'), zhLocale),  //這裡需要注意一下，是如何匯入多個語言包的
    en: Object.assign(require('@/components/common/lang/en'), enLocale),
  }
});
複製程式碼

注意：關於匯入多個語言包時遇到的問題，我是在Element UI 國際化文件中發現的解決辦法。

六、路由與麵包屑導航國際化的語法問題

在對面包屑導航進行國際化時不知道如何進行。在網上翻閱了一些資料，得到如下程式碼，完美解決問題：

router.js(路由配置檔案)

{
  path: '/index',
  name: 'nav.Home',       //直接點出對應的文字
  component: (resolve) => require(['@/components/index'], resolve)
}
複製程式碼

Breadcrumb.vue(麵包屑導航元件)

<div id="Breadcrumb">
   <el-breadcrumb separator-class="el-icon-arrow-right">
     <el-breadcrumb-item :to="{ path: '/index' }">{{$t('nav.Home')}}</el-breadcrumb-item>
       /*注意{{$t(item.name)}}*/
     <el-breadcrumb-item v-for="item in $route.matched" :to="{ path: item.path}">{{$t(item.name)}}</el-breadcrumb-item>
   </el-breadcrumb>
 </div>
複製程式碼

七、至此，國際化的坑算是踩完了。

相關文章