循序漸進VUE+Element 前端應用開發(9）- 界面語言國際化的處理

循序漸進VUE+Element 前端應用開發(9）— 界面語言國際化的處理

2020 年 6 月 9 日
筆記
循序漸進VUE+Element

我們開發的系統，一般可以不用考慮語言國際化的問題，大多數系統一般是給本國人使用的，而且直接使用中文開發界面會更加迅速一些，不過框架最好能夠支持國際化的處理，以便在需要的時候，可以花點時間來實現多語言切換的處理，使系統具有更廣泛的受眾用戶。VUE+Element 前端應用實現國際化的處理還是非常方便的，一般在Main.js函數裏面引入語言文件，然後在界面上進行一定的處理，把對應的鍵值轉換為對應語言的語義即可。本篇隨筆介紹在VUE+Element 前端應用中如何實現在界面快速的支持多語言國際化的處理邏輯代碼。

1、main入口函數支持

Element 組件內部默認使用中文，若希望使用其他語言，則需要進行多語言設置。以英文為例，在 main.js 中：

// 完整引入 Element
import Vue from 'vue'
import ElementUI from 'element-ui'
import locale from 'element-ui/lib/locale/lang/en'

Vue.use(ElementUI, { locale })

由於我們現在是需要處理多語言的切換，那麼，我們在src下面的一個目錄裏面創建一個lang目錄，在其中裏面編輯zh.js和en.js分別代表中英文語言對照信息，index.js文件則為引入這兩個文件的處理關係。

在index.js裏面，需要設置一個函數，用來獲取Cookie裏面存儲的語言，如果沒有找到，以瀏覽器國際化語言為準，如下代碼所示。

export function getLanguage() {
  const chooseLanguage = Cookies.get('language')
  if (chooseLanguage) return chooseLanguage

  // 如果沒有選擇語言，那麼使用瀏覽器語言
  const language = (navigator.language || navigator.browserLanguage).toLowerCase()
  const locales = Object.keys(messages)
  for (const locale of locales) {
    if (language.indexOf(locale) > -1) {
      return locale
    }
  }
  return 'en'
}

其中代碼行

const locales = Object.keys(messages)

是獲取message對象裏面的鍵，如下所示。

import Vue from 'vue'
import VueI18n from 'vue-i18n'
import Cookies from 'js-cookie'
import elementEnLocale from 'element-ui/lib/locale/lang/en' // element-ui lang
import elementZhLocale from 'element-ui/lib/locale/lang/zh-CN'// element-ui lang
import enLocale from './en'
import zhLocale from './zh'

Vue.use(VueI18n)

// 定義對應語言鍵，展開對應的鍵值對應表
const messages = {
  en: {
    ...enLocale,
    ...elementEnLocale
  },
  zh: {
    ...zhLocale,
    ...elementZhLocale
  }
}

其中message就是一個兩個語言（en/zh）字典下的對照表，包含各自對應鍵值下的內容。

然後整個index.js文件就是公布對應的多語言處理接口和屬性。

const i18n = new VueI18n({
  locale: getLanguage(),
  messages
})

export default i18n

然後在main.js函數裏面處理國際化的處理即可

Vue.use(ElementUI, {
  size: Cookies.get('size') || 'medium', // set element-ui default size
  i18n: (key, value) => i18n.t(key, value) })

new Vue({
  el: '#app',
  router,
  store,
  i18n,
  render: h => h(App)
})

有了這些準備，那麼我們在界面上就可以調用對應的鍵來獲取對應語言的語義了，

2、界面處理實現

首先，我們編輯一下對應國際化的鍵值內容，例如中文參照如下所示。

例如對應登錄界面上，界面效果如下所示。

或者

其中裏面的文本內容，我們都是以國際化處理內容。

如登陸表單裏面的代碼如下所示。

        <el-form ref="loginForm" :model="loginForm" :rules="rules" class="loginForm">
          <el-form-item prop="username" class="login-item">
            <el-input
              v-model="loginForm.username"
              class="area"
              type="text"
              :placeholder="$t('login.username')"
              prefix-icon="el-icon-user-solid"
              @keyup.enter.native="submitForm('loginForm')"
            />
          </el-form-item>
          <el-form-item prop="password" class="login-item">
            <el-input
              v-model="loginForm.password"
              class="area"
              type="password"
              :placeholder="$t('login.password')"
              prefix-icon="el-icon-lock"
              @keyup.enter.native="submitForm('loginForm')"
            />
          </el-form-item>

          <el-form-item>
            <el-button :loading="loading" type="primary" class="submit_btn" @click="submitForm('loginForm')">{{ $t('login.logIn') }}</el-button>
          </el-form-item>
          <div class="tiparea">
            <span style="margin-right:20px;">{{ $t('login.username') }} : admin</span>
            <span> {{ $t('login.password') }} : {{ $t('login.any') }}</span>
          </div>
        </el-form>

我們多處採用了類似 $t(‘login.username’) 的函數處理方式來動態獲取對應語言的內容即可，其中$t(）函數裏面就是對應的語義解析的鍵參數，對應我們lang/zh.js裏面或者lang/en.js裏面的內容即可。

其中多語言切換的時候，單擊圖標就可以切換為其他語言內容了。

切換英文後界面如下所示

同樣，其他地方，如果需要切換多語言的國際化處理，也可以使用$t的轉義方式，在頂部導航欄裏面，我們可以設置得到多語言支持的界面。

中文界面提示如下所示。

這部分的實現代碼是在組件模塊裏面，一樣可以實現國際化的處理的。

  <template v-if="device!=='mobile'">
    <search id="header-search" class="right-menu-item" />
    <error-log class="errLog-container right-menu-item hover-effect" />
    <el-tooltip :content="$t('navbar.fullscreen')" effect="dark" placement="bottom">
      <screenfull id="screenfull" class="right-menu-item hover-effect" />
    </el-tooltip>
    <el-tooltip :content="$t('navbar.size')" effect="dark" placement="bottom">
      <size-select id="size-select" class="right-menu-item hover-effect" />
    </el-tooltip>
    <el-tooltip :content="$t('navbar.language')" effect="dark" placement="bottom">
      <lang-select class="right-menu-item hover-effect" />
    </el-tooltip>
  </template>