目的
项目需要支持多语言,我们需要提取出项目中使用的静态文本,使用语言包进行管理, 当切换语言设置的时候,可以自动切换整个项目的文字显示。
发现Vue项目中有对应的组件vue-i18n
,而且对项目的代码修改不大,于是就使用了这个组件去修改项目中的代码。
安装
// script 引入
<script src="https://unpkg.com/vue/dist/vue.js"></script>
<script src="https://unpkg.com/vue-i18n/dist/vue-i18n.js"></script>
// npm 安装
npm install vue-i18n
// yarn 安装
yarn add vue-i18n
一般一个项目中使用都是通过安装包的方式去运行的,script
引入的较少。
使用
项目中配置i18n
import VueI18n from 'vue-i18n'
Vue.use(VueI18n)
const i18n = new VueI18n({
local: 'cn', // 设置语言
messages // 语言包
})
new Vue({
el: '#app',
...
i18n
})
// messages 大概的使用格式
{
cn: {
name: '名字'
},
us: {
name: 'Name'
}
}
使用i18n
简单使用
// html 需要使用 {{}} 将 name包装起来
{{$t('name')}}
// js
$t('name')
可传入变量
// 命名传入参数
// messages:
{
cn: {
name: '名字:{name}'
},
us: {
name: 'Name: {name}'
}
}
$t('name', {name: 'Jack'}) // Name:Jack
// 列表传入参数
// messages:
{
cn: {
name: '名字:{0}{1}'
},
us: {
name: 'Name: {0}{1}'
}
}
// array
$t('name', ['Jack', 'Job'])
// object
$t('name', {'0':'Jack', '1': 'Job'])
复数格式
使用分隔符 |
// messages:
{
us: {
car: 'car | cars | {count} cars'
}
}
$tc('car', x) // 选用不同的car类型
时间格式
const dateTimeFormats = {
'us': {
short: {
year: 'numeric', month: 'short', day: 'numeric'
},
long: {
year: 'numeric', month: 'short', day: 'numeric',
weekday: 'short', hour: 'numeric', minute: 'numeric'
}
},
cn: {
xxx
}
}
// 需要放入配置项中
const i18n = new VueI18n({
locale: '',
messages,
dateTimeFormats
})
// 使用
$d(new Date(), 'short')
$d(new Date(), 'long')
$d(new Date(), 'short', 'cn')
金额符号
const numberFormats = {
'en-US': {
currency: {
style: 'currency', currency: 'USD'
}
},
'ja-JP': {
currency: {
style: 'currency', currency: 'JPY', currencyDisplay: 'symbol'
}
}
}
// 同样也要加入配置项中
const i18n = new VueI18n({
numberFormats
})
// 使用
$n(100, 'currency') // $100.00
$n(100, 'currency', 'ja-JP') // ¥100
提供一个默认语言设置fallbackLocale
当某个语言不存在时,提供一个默认全的语言去处理
const messages = {
cn: {
name: 'Name:'
}
us: {
}
}
// us 的语言包中不存在 name , 我们默认cn,当us不存在时,使用cn的值
const i18n = new VueI18n({
locale: 'us',
fallbackLocale: 'cn',
messages
})
v-t
可以用于变量的引用,类似于$t
v-t
指令
// 官网的列子
new Vue({
i18n: new VueI18n({
locale: 'en',
messages: {
en: { hello: 'hi {name}!' },
ja: { hello: 'こんにちは、{name}!' }
}
}),
computed: {
nickName () { return 'kazupon' }
},
data: { path: 'hello' }
}).$mount('#object-syntax')
<div id="object-syntax">
<!-- literal -->
<p v-t="{ path: 'hello', locale: 'ja', args: { name: 'kazupon' } }"></p>
<!-- data biniding via data -->
<p v-t="{ path: path, args: { name: nickName } }"></p>
</div>
<div id="object-syntax">
<p>こんにちは、kazupon!</p>
<p>hi kazupon!</p>
</div>
$t
与 v-t
对比
$t
是方法调用,v-t
是一个指令v-t
性能比$t
更好,有自定义指令的缓存$t
使用更灵活,使用方法更简单
还有一些其他的用法,具体的请参考官方文档。。
切换语言的话,可以使用内置变量:
// 通过设置 locale 来切换语言
this.$i18n.locale = cn | us
插入组件
如果遇到这样的场景,如何去处理?
<p>I accept xxx <a href="/term">Terms of Service Agreement</a></p>
我的第一反应是分成两个字段,a标签不属于翻译的内容,只要写成:
<p>{{ $t('xx1') }}<a href="/term">{{ $t('xx2') }}</a></p>
看了官网的介绍,说这种处理太笨拙了,可以通过组件的方式去处理
// 这里使用了i81n 组件
<i18n path="term" tag="label" for="tos">
<a :href="url" target="_blank">{{ $t('tos') }}</a>
</i18n>
const messages = {
en: {
tos: 'Term of Service',
term: 'I accept xxx {0}.'
}
}
new Vue({
el: '#app',
i18n,
data: {
url: '/term'
}
})
可以看到,仍然使用了两个变量存储信息,但是通过tag
来生产标签,path
来制定标签的内容。
这种方式来说,使用起来较为复杂,相比使用**两个$t(”)**的方式,对我来说可能暂时不需要,因为没有看实际的实现方法,没有对比过性能,无法直接给出结论,后续深入的话,还需要仔细对比。
更高级的用法,可以控制html元素的插入位置,通过place
来指定出现在html中的位置。
<i18n path="info" tag="p">
<span place="limit">{{ changeLimit }}</span>
<a place="action" :href="changeUrl">{{ $t('change') }}</a>
</i18n>
const messages = {
en: {
info: 'You can {action} until {limit} minutes from departure.',
change: 'change your flight',
refund: 'refund the ticket'
}
}
const i18n = new VueI18n({
locale: 'en',
messages
})
new Vue({
i18n,
data: {
changeUrl: '/change',
refundUrl: '/refund',
changeLimit: 15,
refundLimit: 30
}
}).$mount('#app')
// result
<p>
You can <a href="/change">change your flight</a> until <span>15</span> minutes from departure.
</p>
保留了语句的一体性,但是如果只是针对名词进行多语言的翻译,不对语法进行要求的话,可能使用不到。
动态加载语言包
一次加载所有的语言包是没有必要的,特别是语言包过的情况下,之前我也提出了这个问题,发现官网上是给了解决方式的。
//i18n-setup.js
import Vue from 'vue'
import VueI18n from 'vue-i18n'
import messages from '@/lang' // 语言包的地址,随项目本身设置修改
import axios from 'axios' // 根据项目中使用api请求模块去设置,不一定是axios
Vue.use(VueI18n)
export const i18n = new VueI18n({
locale: 'en', // set locale
fallbackLocale: 'en', // 默认语言设置,当其他语言没有的情况下,使用en作为默认语言
messages // set locale messages
})
const loadedLanguages = ['en'] // our default language that is prelaoded
function setI18nLanguage (lang) {
i18n.locale = lang
axios.defaults.headers.common['Accept-Language'] = lang // 设置请求头部
document.querySelector('html').setAttribute('lang', lang) // 根元素增加lang属性
return lang
}
export function loadLanguageAsync (lang) {
if (i18n.locale !== lang) {
if (!loadedLanguages.includes(lang)) {
return import(/* webpackChunkName: "lang-[request]" */ `@/lang/${lang}`).then(msgs => {
i18n.setLocaleMessage(lang, msgs.default)
loadedLanguages.push(lang)
return setI18nLanguage(lang)
})
}
return Promise.resolve(setI18nLanguage(lang))
}
return Promise.resolve(lang)
}
// 在vue-router的beforeEach的全局钩子了处理
router.beforeEach((to, from, next) => {
const lang = to.params.lang
loadLanguageAsync(lang).then(() => next())
})
语言包的生成 & 替换项目中原有的静态文本
这一步最关键,
- 抽离出所有出现的汉字
- 替换成
$t('xxx')
,$n
,$d
,v-t
等,根据合适的情况自己选择 - 维护多个版本的语言文件
语言包这边是这么处理的,项目下新增一个目录languages
--languages
--lib
-- cn.js // 中文语言包
-- us.js // 英文语言包
-- .. // 其他语言,暂未实践
-- index.js // 导出语言包
cn.js
export default {
common: {
message: '消息'
},
xxx: {
}
}
us.js
export default {
common: {
message: 'Messages'
},
xxx: {
}
}
index.js
import cn from './lib/cn.js'
export default {
cn,
us
}
替换文本
<template>
...
<div>{{$t('message')}}</div>
...
</template>
问题
- 不同的语言,格式不同,长度不同,可能需要调整项目的样式,以保正常
- 对于一个已经在使用的项目,生成语言包这一步工作量大,浪费时间
今天的文章vue项目国际化 vue-i18n 使用分享到此就结束了,感谢您的阅读。
版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容, 请发送邮件至 举报,一经查实,本站将立刻删除。
如需转载请保留出处:https://bianchenghao.cn/18450.html