vue-i18n 仓库地址:https://github.com/kazupon/vue-i18n

兼容性:

支持 Vue.js 2.x 以上版本

 

安装方法:(此处只演示 npm)

npm install vue-i18n

 

使用方法:

1、在 main.js 中引入 vue-i18n (前提是要先引入 vue)

import VueI18n from \'vue-i18n\'

Vue.use(VueI18n)

 

2、准备本地的翻译信息

const messages = {
    zh: {
      message: {
        hello: \'好好学习,天天向上!\'
      }
    },
    en: {
      message: {
        hello: \'good good study, day day up!\'
      }
    }
}

 

3、创建带有选项的 VueI18n 实例

const i18n = new VueI18n({
    locale: \'en\', // 语言标识
    messages
})

 

4、把 i18n 挂载到 vue 根实例上

const app = new Vue({
    router,
    i18n,
    ...App
}).$mount(\'#app\')

 

5、在 HTML 模板中使用

<div id="app">
    <h1 style="font-size: 16px; text-align: center;">{{ $t("message.hello") }}</h1>
  </div>

 

查看运行效果:

我们刚才选定的语言标识是 “en” 英语,现在改成 “zh” 中文,并查看效果

const i18n = new VueI18n({
    locale: \'zh\', // 语言标识
    messages
})

这样就可以轻松实现国际化了,实际开发中,页面内容肯定是很多的,我们可以把对应语言的信息保存为不同的 json对象

const i18n = new VueI18n({
    locale: \'en\',  // 语言标识
    messages: {
        \'zh\': require(\'./common/lang/zh\'),
        \'en\': require(\'./common/lang/en\')
    }
})

zh.js

// 注意:一定是 exports,不是 export,否则会报错,报错信息是下列的中的内容不是 string
module.exports = {
    message: {
        title: \'运动品牌\'
    },
    placeholder: {
        enter: \'请输入您喜欢的品牌\'
    },
    brands: {
        nike: \'耐克\',
        adi: \'阿迪达斯\',
        nb: \'新百伦\',
        ln: \'李宁\'
    }
}

en.js

module.exports = {
    message: {
        title: \'Sport Brands\'
    },
    placeholder: {
        enter: \'Please type in your favorite brand\'
    },
    brands: {
        nike: \'Nike\',
        adi: \'Adidas\',
        nb: \'New Banlance\',
        ln: \'LI Ning\'
    }
}

接下来,在HTML 模板中使用,要特别注意在 js 中的国际化写法

// HTML
<div id="app">
    <div style="margin: 20px;">
      <h1>{{$t("message.title")}}</h1>
      <input style="width: 300px;" class="form-control" :placeholder="$t(\'placeholder.enter\')">
      <ul>
        <li v-for="brand in brands">{{brand}}</li>
      </ul>
    </div>
</div>

// JS
data () {
    return {
      brands: [this.$t(\'brands.nike\'), this.$t(\'brands.adi\'), this.$t(\'brands.nb\'), this.$t(\'brands.ln\')]
    }
 },

查看编译效果:

现在换成英文的:

在上面的操作中,我们都是通过手动修改 locale 的属性值来切换语言,实际上,更希望浏览器自动识别,这里可以借助于 cookie

1、新建一个 cookie.js 文件,用于读取cookie

function getCookie(name,defaultValue) {
  var arr, reg = new RegExp("(^| )" + name + "=([^;]*)(;|$)");
  if (arr = document.cookie.match(reg))
    return unescape(arr[2]);
  else
    return defaultValue;
}

export {
  getCookie
}

2、在 main.js 中引入这个js,并通过 PLAY_LANG 属性来获取浏览器的语言

const i18n = new VueI18n({
    locale: getCookie(\'PLAY_LANG\',\'zh\'),    // 语言标识
    messages: {
        \'zh\': require(\'./common/lang/zh\'),
        \'en\': require(\'./common/lang/en\')
    }
})

这里需要注意两个极易出错的地方:

(1)、将 $t() 写成了 $()

(2)、json 中在同一个对象里有同名属性

 

vue-i18n 提供了一个全局配置参数叫 “locale”,通过改变 locale 的值可以实现不同语种的切换

下面的案例借用了 Element UI 的弹窗样式,上面的步骤不再赘述,直接上核心代码

// template
<h2>{{$t(\'test\')}}</h2>
<button type="button" class="btn btn-success" @click="changeLocale">中文/EN</button>        
// js方法
changeLocale () {
    this.$confirm(this.$t(\'layer.toggle\'), this.$t(\'layer.tips\'), {
        confirmButtonText: this.$t(\'button.ok\'),
        cancelButtonText: this.$t(\'button.cancel\'),
        type: \'warning\'
        }).then(() => {
           let locale = this.$i18n.locale
           locale === \'zh\' ? this.$i18n.locale = \'en\' : this.$i18n.locale = \'zh\'
        }).catch(() => {
              this.$message({
                  type: \'info\',
                  })      
        })
},

效果:

在配合 Element-UI 一起使用时,会有2个问题:

(1)、页面刷新后,通过按钮切换的语言还原成了最初的语言,无法保存

(2)、框架内部自带的提示文字无法更改,比如像时间选择框内部中的提示文字

关于第一个问题,可以在初始化VueI18n实例时,通过 localStorage 来为 locale 对象赋值

const i18n = new VueI18n({
  locale: localStorage.getItem(\'locale\') || \'zh\',
  messages 
})

在切换语言的时候可以缓存不同的语言选项,并且可以长期保存,不会因为刷新网页而改变locale 的属性值

<div class="lang">
        <el-dropdown>
          <i class="iconfont icon-language4"></i>
          <el-dropdown-menu slot="dropdown">
            <el-dropdown-item @click.native="toggleLang(\'zh\')" :disabled="$i18n.locale == \'zh\'">中文</el-dropdown-item>
            <el-dropdown-item @click.native="toggleLang(\'en\')" :disabled="$i18n.locale == \'en\'">English</el-dropdown-item>
          </el-dropdown-menu>
        </el-dropdown>
      </div>
toggleLang(lang) {
      if(lang == \'zh\'){
        localStorage.setItem(\'locale\', \'zh\')
        this.$i18n.locale = localStorage.getItem(\'locale\')
        this.$message({
          message: \'切换为中文!\',
          type: \'success\'
        })
      } else if (lang == \'en\') {
        localStorage.setItem(\'locale\', \'en\')
        this.$i18n.locale = localStorage.getItem(\'locale\')
        this.$message({
          message: \'Switch to English!\',
          type: \'success\'
      })
}

关于第二个问题,更改Element 组件内部语言,这里还涉及到 手动处理 vue-i18n@6.x 兼容性问题。官网已经做了详细介绍,这里依葫芦画瓢跟着实现一下

i18n.js

import Vue from \'vue\'
import VueI18n from \'vue-i18n\'
import locale from \'element-ui/lib/locale\';
import zh from \'./langs/zh\'
import en from \'./langs/en\'
import enLocale from \'element-ui/lib/locale/lang/en\'
import zhLocale from \'element-ui/lib/locale/lang/zh-CN\'


Vue.use(VueI18n)

const messages = {
  en: Object.assign(en, enLocale),
  zh: Object.assign(zh, zhLocale)
}

console.log(messages.zh)

const i18n = new VueI18n({
  locale: localStorage.getItem(\'locale\') || \'zh\',
  messages 
})


locale.i18n((key, value) => i18n.t(key, value)) //为了实现element插件的多语言切换

export default i18n

按照如上把国际化文件都整合到一起,避免main.js 中大段引入相关代码。main.js 中与 i18n 相关的就只剩两行代码

import i18n from \'./i18n/i18n\'           // 1行

window.app = new Vue({
  el: \'#app\',
  router,
  store,
  i18n,                                 // 2行
  components: { App },
  template: \'<App/>\'
})

效果如下:

以上demo地址:https://github.com/frwupeng517/element-admin/tree/master/src/i18n

版权声明:本文为rogerwu原创文章,遵循 CC 4.0 BY-SA 版权协议,转载请附上原文出处链接和本声明。
本文链接:https://www.cnblogs.com/rogerwu/p/7744476.html