欢迎您访问程序员文章站本站旨在为大家提供分享程序员计算机编程知识!
您现在的位置是: 首页  >  IT编程

vue使用i18n实现国际化的方法详解

程序员文章站 2024-01-17 14:44:22
一、前言 在4k广告机中需要实现多语言切换,这时候接触到国际化,前端框架无数,其中几种热门的框架都有相匹配的国际化插件工具。比如: vue +&n...

一、前言

在4k广告机中需要实现多语言切换,这时候接触到国际化,前端框架无数,其中几种热门的框架都有相匹配的国际化插件工具。比如:

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

在4k广告机项目中使用的前端框架为vue,故而我们将使用vue-i18n这个插件进行国际化功能的实现。

二、最终实现效果

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文件)作为语言包。

vue使用i18n实现国际化的方法详解

其中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>

七、至此,国际化的坑算是踩完了。

总结

以上就是这篇文章的全部内容了,希望本文的内容对大家的学习或者工作具有一定的参考学习价值,谢谢大家对的支持。