【Vuejs】1043- Vuejs 项目前端多语言方案

2023-10-12 10:30

本文主要是介绍【Vuejs】1043- Vuejs 项目前端多语言方案,希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!

作者:Paian   http://mobilesite.github.io

前端的国际化是一个比较常见的需求。但网上关于这一方面的直接可用的方案却不多。最近刚做了一版基于Vue.js的多语言实现,在此简单作一小结。

一、通常有哪些内容需要处理

总的来说,一个Web应用中,需要做多语言切换的内容常见的包括如下方面:

1、模板中的内容,如Vue.js的<template>标签中的文字内容

2、JS代码中的文字内容

3、图片中的文案内容

4、页面title

5、第三方组件中的文案(比如,我的项目中用到了Vux的组件)

6、后端接口中需要展示到前端的数据内容

7、后端接口返回的错误提示

二、基本思路

1、首先,需要确定以什么样的方式来获取到当前应该展示何种语言

我采用的是用URL传递?lang=en或者?lang=zh-CN这样的传递参数的形式。这样做的好处在于可以通过链接指定用哪种语言。但是,只依赖于地址栏参数也是不方便的。比如,在页面跳转的时候,这个地址栏参数可能就丢失了。这会导致你在页面跳转之后就不知道该用哪种语言展示了。而理想的的方式应该是,进入某个页面的时候带有这个参数(这个时候就获取到该使用何种语言了),等再跳转到其它页面的时候就不必再带这个lang参数了,因为此时你已经知道该用哪种语言了。所以,应该在一进入第一个页面的时候就把这个参数存下来,比如,存在localstorage中,存在vuex的state中。

这里,就引出来一个语言判断的优先级问题。

因为地址栏里可能有lang参数,localstorage中可能也有相关的存储字段(因为上次访问过本应用),你可能还想设置默认的降级语言,等等。其优先级应该如何处理呢?

正确的优先级应该是:

先看地址栏参数中有没有;

再看localstorage中有没有;

然后再通过navigator.language获取浏览器默认语言,看是否是你的应用所支持的语言,若是,则采用之;

最后才是使用回退语言(例如,比较通用的英语)。

当然,你可以根据你的需求来做一些简化。

2、其次,采用什么工具来解决语言转换和打包的问题?

(1)i18n相关工具的选择——由谁来提供多语言转换函数(通常是$t)?

目前国际化通用方式多数基于i18n,我们也无需再去造轮子了。但就i18n的具体使用上,有很多不同的NPM模块。比如vuex-i18n、vue-i18n、simplest-i18n等。因为多数复杂一点的项目都会上vuex,所以复杂一点的项目选择vuex-i18n会比vue-i18n更方便。

而simplest-i18n这个很小众的模块,其实也有它的好处。它支持下面这样的写法:

在模板中:

<span>$t('真实姓名', 'Real Name')</span>

或者在JS中:

this.$t('真实姓名', 'Real Name')

即将语言写在一起,$t函数的每一个参数都是一种语言,一目了然,还是比较方便阅读的。对小项目来说,不失为一种选择。

其基本使用如下:

t.js文件:

import i18n from 'simplest-i18n';
import getLang from '../../getLang';const t = i18n({locale: getLang.lang, // 当前语言locales: getLang.langs // 支持的语言列表
});
export default t;

然后在应用的入口文件中对Vue.js进行扩展:

import t from './t';
Vue.$t = Vue.prototype.$t = t;

这样就把$t这个方法挂载到了Vue.js的全局。Vue实例中也可以通过this.$t访问到,使用上还是非常简单的。

但是,对于大项目来说,把语言包都写在代码里面,对维护并不友好。而且,靠它也解决不了我所用到的Vux组件的多语言化的问题。

所以最终,我选择了vuex-i18n作为基础。

(2)组织和处理语言包的工具——语言包怎么组织,怎么打包处理?

对于这个问题,我首先需要解决Vux第三方组件的多语言化问题。

首先,在语言包的组织方面,比较常见的是写成JSON配置文件。不过,我最终采用了Yaml这种格式,它支持将多语言字段写在一起。比如:

config.yml

confirm:zh-CN: 确认en: confirm

而不是像下面那样将一个字段的多语言拆成几处,比如:

confirm: 确认
confirm: confirm

这样带来的好处就是,可以方便地对照一个字段的不同语言版本,而且要修改或删除某一个字段时,也可以在一处完成,无需切换。况且,Yaml文件的语法也更加简单明了,省去了JSON文件必须写双引号、不可以出现注释等诸多麻烦。

其次,在语言包的打包方面,我找到了vux-loader。它可以和现有的webpack配置结合,不仅能完成Vux组件多语言配置的打包,还允许在自定义的Vue组件中使用<i18n>标签。比如,在自定义组件中我可以这么写:

<i18n>
confirm:zh-CN: 确认en: confirm
<i18n>

打包时,vux-loader会将<i18n>标签中的多语言配置信息导出至我们所配置的一个Yaml文件中,而把<i18n>标签从我们的自定义组件中移除。

那么,对于Yaml文件如何处理呢?可以用json-loader和yaml-loader。它们可以将Yaml文件转换成我们所需要的json格式,方便在JS函数中使用,就像这样:

const componentsLocales = require('json-loader!yaml-loader!../../locales/components.yml'); // 这就得到了一个语言包的json格式

3、如何通知后端接口返回何种语言的数据?

因为涉及到许多接口都要通知后端采用哪种语言,所以,我选择了使用header头的方式。在axios的interceptor中给请求统一添加了header头:Accept-Language, 并把这个值的内容设置成前端所获得应使用的语言(如,zh-CN 或 en 等)。这样,就集中在一处把这个问题处理掉了。

三、具体实践中的一些细节

1、获取当前应该采用何种语言的getLang模块的实现

import { getQueryObj } from '../utils/url';
import { setItem, getItem } from '../utils/storage';const langs = ['zh-CN', 'en']; // 支持哪些语言
const defaultLang = 'en'; // 默认语言,暂时并没有对外抛出function getLang() {let queries = getQueryObj();let storeLang = getItem('lang');let rawLang;let flag = false;if (queries && queries['lang']) {rawLang = queries['lang'];setItem('lang', rawLang);} else {rawLang = storeLang || navigator.language;}langs.map(item => {if (item === rawLang) {flag = true;}});return flag ? rawLang : defaultLang;
}const lang = getLang(langs, defaultLang);export default {lang, // 获取到当前语言langs // 所支持的语言列表
}

2、Vux组件的多语言包的配置

可以从Vux的官方github中找到src/locales/all.yml拷贝过来(同一目录下的src/locales/zh-CN.ymlsrc/locales/en.yml分别是其中文部分和英文部分),根据你自己的需要略作修改即可。

然后在你的应用的应用的入口文件中引入:

const vuxLocales = require('json-loader!yaml-loader!../../locales/all.yml');

3、vux-loader的配置

webpack.dev.conf.js中:

resolve(vuxLoader.merge(devWebpackConfig, {plugins_dir: ['vux-ui',{name: 'i18n',vuxStaticReplace: false,staticReplace: false,extractToFiles: 'src/locales/components.yml',localeList: ['en','zh-CN']}]
}))

webpack.prod.conf.js中:

resolve(vuxLoader.merge(buildWebpackConfig, {plugins_dir: ['vux-ui',{name: 'i18n',vuxStaticReplace: false,staticReplace: false,extractToFiles: 'src/locales/components.yml',localeList: ['en','zh-CN']}]
}))

其中的localeList: ['en','zh-CN']就是指定你的应用支持哪几种语言。

extractToFiles: 'src/locales/components.yml'就是指定你的自定义组件中所用到的那些<i18n>标签中的语言包信息,应该导出到哪个Yaml文件中。也就是说,你在各个自定义组件中使用的<i18n>标签中的语言包信息都会被vux-loader集中抽取到这个文件中。

然后在应用的入口文件中引入这个语言包文件:

const componentsLocales = require('json-loader!yaml-loader!../../locales/components.yml');

4、自定义组件内外文案的多语言化

(1)对于自定义组件内部的文案的多语言化信息,写在组件的<i18n>标签中即可。同时,为了避免不同的自定义组件中多语言字段的命名冲突,在每个字段的名字前面加上以组件名-式的前缀。

(2)对于页面的标题、一些错误提示等文案,它们是出现在组件之外的,因此不适合写在组件的<i18n>标签中,所以我们单独新建一个global.yml来存放这些全局性的多语言信息。这些内容直接写在global.yml中即可,并且,为了表面与其它的语言包字段相冲突,我们在每个字段的前面加上global-前缀。

然后在应用的入口文件中引入这个语言包文件:

const componentsLocales = require('json-loader!yaml-loader!../../locales/global.yml');

5、vuex-i18n的实现

在src/store/index.js文件中:

import VuexI18n from 'vuex-i18n';

export default new Vuex.Store中增加:

    i18n: VuexI18n.store

在应用的入口文件中:

import VuexI18n from 'vuex-i18n';
import getLang from '../../getLang';Vue.use(VuexI18n.plugin, store);const vuxLocales = require('json-loader!yaml-loader!../../locales/all.yml');
const componentsLocales = require('json-loader!yaml-loader!../../locales/components.yml');const finalLocales = {'en': Object.assign(vuxLocales['en'], componentsLocales['en']),'zh-CN': Object.assign(vuxLocales['zh-CN'], componentsLocales['zh-CN'])
}for (let i in finalLocales) {Vue.i18n.add(i, finalLocales[i])
}Vue.i18n.set(globalVars.lang);

6、图片的多语言化

对于图片中的文案信息,多语言化主要有这么两种方式:一是根据不同的语言展示不同的图片;二是尽将文字从图片背景中分离出来,采用文字层加背景图片层的方式,这样文字层就可以作为普通文本来实现多语言化了。都比较简单,不再赘述。

7、在当前页面通过按钮切换当前语言后,如何更新当前页面的内容?

如果你的应用并不需要在页面内部切换语言版本,那么直接通过URL中传入不同的lang参数就可以了,并不涉及到此问题。

第一种方式:刷新页面

<button @click="changeLang('zh-CN')">中文</button>
<button @click="changeLang('en')">英文</button>
changeLang(lang){location.href = this.$utils.url.replaceParam(this.$router.history.current.path, 'lang', lang);
},

第二种方式:watch当前页data中lang字段的变化,通过v-if局部刷新某些相关组件:

data(){return {lang: this.$i18n.locale()}
}changeLang(lang){this.$i18n.set(lang);this.lang = this.$i18n.locale();
},watch: {lang(newVal, oldVal) {if(newVal === oldVal) {return;}// 在这里通过改变某个标志位 结合 v-if 来触发某个局部组件的重新渲染}
}

第三种方式:结合vuex派发全局的语言状态,接收到状态变化时进行更新,或者自己简单地改写vuex-i18n的实现。这种方式相对复杂一些。

具体根据自己的业务需求选择。

8、Yaml中特殊字符的转义

对于一些包含特殊字符的yaml键值,比如[、]等,需要进行转义。转的方式是给键值加上单引号引起来。

如果你的语言包信息中有单引号,则必须连续使用两个单引号转义。例如:

str: 'labor''s day'

(文本完)

1. JavaScript 重温系列(22篇全)
2. ECMAScript 重温系列(10篇全)
3. JavaScript设计模式 重温系列(9篇全)4. 正则 / 框架 / 算法等 重温系列(16篇全)5. Webpack4 入门(上)|| Webpack4 入门(下)6. MobX 入门(上) ||  MobX 入门(下)7. 120+篇原创系列汇总回复“加群”与大佬们一起交流学习~点击“阅读原文”查看 130+ 篇原创文章

这篇关于【Vuejs】1043- Vuejs 项目前端多语言方案的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!



http://www.chinasem.cn/article/195231

相关文章

Java进行文件格式校验的方案详解

《Java进行文件格式校验的方案详解》这篇文章主要为大家详细介绍了Java中进行文件格式校验的相关方案,文中的示例代码讲解详细,感兴趣的小伙伴可以跟随小编一起学习一下... 目录一、背景异常现象原因排查用户的无心之过二、解决方案Magandroidic Number判断主流检测库对比Tika的使用区分zip

一文教你如何将maven项目转成web项目

《一文教你如何将maven项目转成web项目》在软件开发过程中,有时我们需要将一个普通的Maven项目转换为Web项目,以便能够部署到Web容器中运行,本文将详细介绍如何通过简单的步骤完成这一转换过程... 目录准备工作步骤一:修改​​pom.XML​​1.1 添加​​packaging​​标签1.2 添加

tomcat多实例部署的项目实践

《tomcat多实例部署的项目实践》Tomcat多实例是指在一台设备上运行多个Tomcat服务,这些Tomcat相互独立,本文主要介绍了tomcat多实例部署的项目实践,具有一定的参考价值,感兴趣的可... 目录1.创建项目目录,测试文China编程件2js.创建实例的安装目录3.准备实例的配置文件4.编辑实例的

Vue中组件之间传值的六种方式(完整版)

《Vue中组件之间传值的六种方式(完整版)》组件是vue.js最强大的功能之一,而组件实例的作用域是相互独立的,这就意味着不同组件之间的数据无法相互引用,针对不同的使用场景,如何选择行之有效的通信方式... 目录前言方法一、props/$emit1.父组件向子组件传值2.子组件向父组件传值(通过事件形式)方

css中的 vertical-align与line-height作用详解

《css中的vertical-align与line-height作用详解》:本文主要介绍了CSS中的`vertical-align`和`line-height`属性,包括它们的作用、适用元素、属性值、常见使用场景、常见问题及解决方案,详细内容请阅读本文,希望能对你有所帮助... 目录vertical-ali

springboot集成Deepseek4j的项目实践

《springboot集成Deepseek4j的项目实践》本文主要介绍了springboot集成Deepseek4j的项目实践,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价... 目录Deepseek4j快速开始Maven 依js赖基础配置基础使用示例1. 流式返回示例2. 进阶

IDEA中Git版本回退的两种实现方案

《IDEA中Git版本回退的两种实现方案》作为开发者,代码版本回退是日常高频操作,IntelliJIDEA集成了强大的Git工具链,但面对reset和revert两种核心回退方案,许多开发者仍存在选择... 目录一、版本回退前置知识二、Reset方案:整体改写历史1、IDEA图形化操作(推荐)1.1、查看提

C语言中的数据类型强制转换

《C语言中的数据类型强制转换》:本文主要介绍C语言中的数据类型强制转换方式,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教... 目录C语言数据类型强制转换自动转换强制转换类型总结C语言数据类型强制转换强制类型转换:是通过类型转换运算来实现的,主要的数据类型转换分为自动转换

利用Go语言开发文件操作工具轻松处理所有文件

《利用Go语言开发文件操作工具轻松处理所有文件》在后端开发中,文件操作是一个非常常见但又容易出错的场景,本文小编要向大家介绍一个强大的Go语言文件操作工具库,它能帮你轻松处理各种文件操作场景... 目录为什么需要这个工具?核心功能详解1. 文件/目录存javascript在性检查2. 批量创建目录3. 文件

C语言实现两个变量值交换的三种方式

《C语言实现两个变量值交换的三种方式》两个变量值的交换是编程中最常见的问题之一,以下将介绍三种变量的交换方式,其中第一种方式是最常用也是最实用的,后两种方式一般只在特殊限制下使用,需要的朋友可以参考下... 目录1.使用临时变量(推荐)2.相加和相减的方式(值较大时可能丢失数据)3.按位异或运算1.使用临时