k8凯发官网摘要:本文主要介绍了web前端开发技术学习-Vue.js 项目前端多语言方案,通过具体的内容向大家展现,希望对大家前端Vue.js开发的学习有所帮助。
本文主要介绍了web前端开发技术学习-Vue.js 项目前端多语言方案,通过具体的内容向大家展现,希望对大家前端Vue.js开发的学习有所帮助。
前端的国际化是一个比较常见的需求。但网上关于这一方面的直接可用的方案却不多。最近刚做了一版基于Vue.js的多语言实现,在此简单作一小结。
我采用的是用URL传递 ?lang=en 或者 ?lang=zh-CN 这样的传递参数的形式。这样做的好处在于可以通过链接指定用哪种语言。但是,只依赖于地址栏参数也是不方便的。比如,在页面跳转的时候,这个地址栏参数可能就丢失了。这会导致你在页面跳转之后就不知道该用哪种语言展示了。而理想的的方式应该是,进入某个页面的时候带有这个参数(这个时候就获取到该使用何种语言了),等再跳转到其它页面的时候就不必再带这个 lang 参数了,因为此时你已经知道该用哪种语言了。所以,应该在一进入第一个页面的时候就把这个参数存下来,比如,存在localstorage中,存在vuex的state中。
因为地址栏里可能有 lang 参数,localstorage中可能也有相关的存储字段(因为上次访问过本应用),你可能还想设置默认的降级语言,等等。其优先级应该如何处理呢?
然后再通过guage 获取浏览器默认语言,看是否是你的应用所支持的语言,若是,则采用之;
(1)i18n相关工具的选择——由谁来提供多语言转换函数(通常是$t)?
目前国际化通用方式多数基于i18n,我们也无需再去造轮子了。但就i18n的具体使用上,有很多不同的NPM模块。比如vuex-i18n、vue-i18n、simplest-i18n等。因为多数复杂一点的项目都会上vuex,所以复杂一点的项目选择vuex-i18n会比vue-i18n更方便。
而simplest-i18n这个很小众的模块,其实也有它的好处。它支持下面这样的写法:
即将语言写在一起,$t函数的每一个参数都是一种语言,一目了然,还是比较方便阅读的。对小项目来说,不失为一种选择。
这样就把 $t 这个方法挂载到了Vue.js的全局。Vue实例中也可以通过 this.$t 访问到,使用上还是非常简单的。
但是,对于大项目来说,把语言包都写在代码里面,对维护并不友好。而且,靠它也解决不了我所用到的Vux组件的多语言化的问题。
首先,在语言包的组织方面,比较常见的是写成JSON配置文件。不过,我最终采用了Yaml这种格式,它支持将多语言字段写在一起。比如:
这样带来的好处就是,可以方便地对照一个字段的不同语言版本,而且要修改或删除某一个字段时,也可以在一处完成,无需切换。况且,Yaml文件的语法也更加简单明了,省去了JSON文件必须写双引号、不可以出现注释等诸多麻烦。
其次,在语言包的打包方面,我找到了vux-loader。它可以和现有的webpack配置结合,不仅能完成Vux组件多语言配置的打包,还允许在自定义的Vue组件中使用 i18n 标签。比如,在自定义组件中我可以这么写:
打包时,vux-loader会将 i18n 标签中的多语言配置信息导出至我们所配置的一个Yaml文件中,而把 i18n 标签从我们的自定义组件中移除。
那么,对于Yaml文件如何处理呢?可以用json-loader和yaml-loader。它们可以将Yaml文件转换成我们所需要的json格式,方便在JS函数中使用,就像这样:
因为涉及到许多接口都要通知后端采用哪种语言,所以,我选择了使用header头的方式。在axios的interceptor中给请求统一添加了header头: Accept-Language , 并把这个值的内容设置成前端所获得应使用的语言(如,zh-CN 或 en 等)。这样,就集中在一处把这个问题处理掉了。
(1)对于自定义组件内部的文案的多语言化信息,写在组件的 i18n 标签中即可。同时,为了避免不同的自定义组件中多语言字段的命名冲突,在每个字段的名字前面加上以组件名-式的前缀。
(2)对于页面的标题、一些错误提示等文案,它们是出现在组件之外的,因此不适合写在组件的 i18n 标签中,所以我们单独新建一个 global.yml 来存放这些全局性的多语言信息。这些内容直接写在 global.yml 中即可,并且,为了表面与其它的语言包字段相冲突,我们在每个字段的前面加上 global- 前缀。
对于图片中的文案信息,多语言化主要有这么两种方式:一是根据不同的语言展示不同的图片;二是尽将文字从图片背景中分离出来,采用文字层加背景图片层的方式,这样文字层就可以作为普通文本来实现多语言化了。都比较简单,不再赘述。
如果你的应用并不需要在页面内部切换语言版本,那么直接通过URL中传入不同的 lang 参数就可以了,并不涉及到此问题。
第二种方式:watch当前页data中 lang 字段的变化,通过 v-if 局部刷新某些相关组件:
// 在这里通过改变某个标志位 结合 v-if 来触发某个局部组件的重新渲染
第三种方式:结合vuex派发全局的语言状态,接收到状态变化时进行更新,或者自己简单地改写vuex-i18n的实现。这种方式相对复杂一些。
对于一些包含特殊字符的yaml键值,比如 [、] 等,需要进行转义。转的方式是给键值加上单引号引起来。