目录

国际化

友情提示:

该章节,基于 《vue element plus admin —— 国际化》 (opens new window) 的内容修改。

如果你使用的 vscode 开发工具,则推荐安装 I18n-ally (opens new window) 这个插件

# 1. I18n-ally 插件

安装了该插件后,你的代码内可以实时看到对应的语言内容

# 2. 配置默认语言

src/store/modules/locale.ts (opens new window) 内配置 currentLocale 为其他语言。

查看代码
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
import { defineStore } from 'pinia'
import { store } from '../index'
import zhCn from 'element-plus/es/locale/lang/zh-cn'
import en from 'element-plus/es/locale/lang/en'
import { CACHE_KEY, useCache } from '@/hooks/web/useCache'
import { LocaleDropdownType } from '@/types/localeDropdown'

const { wsCache } = useCache()

const elLocaleMap = {
'zh-CN': zhCn,
en: en
}
interface LocaleState {
currentLocale: LocaleDropdownType
localeMap: LocaleDropdownType[]
}

export const useLocaleStore = defineStore('locales', {
state: (): LocaleState => {
return {
currentLocale: {
lang: wsCache.get(CACHE_KEY.LANG) || 'zh-CN',
elLocale: elLocaleMap[wsCache.get(CACHE_KEY.LANG) || 'zh-CN']
},
// 多语言
localeMap: [
{
lang: 'zh-CN',
name: '简体中文'
},
{
lang: 'en',
name: 'English'
}
]
}
},
getters: {
getCurrentLocale(): LocaleDropdownType {
return this.currentLocale
},
getLocaleMap(): LocaleDropdownType[] {
return this.localeMap
}
},
actions: {
setCurrentLocale(localeMap: LocaleDropdownType) {
// this.locale = Object.assign(this.locale, localeMap)
this.currentLocale.lang = localeMap?.lang
this.currentLocale.elLocale = elLocaleMap[localeMap?.lang]
wsCache.set(CACHE_KEY.LANG, localeMap?.lang)
}
}
})

export const useLocaleStoreWithOut = () => {
return useLocaleStore(store)
}

# 3. 语言文件

src/locales (opens new window) 可以配置具体的语言。

目前项目中的语言都是没有拆分的,全部放一起,后续会考虑拆分出来,比较好维护。

# 4. 语言导入逻辑说明

src/plugins/vueI18n/index.ts (opens new window) 内可以看到

1
const defaultLocal = await import(`../../locales/${locale.lang}.ts`)

这会导入 src/locales 文件语言包。

# 5. 使用

引入项目自带的 useI18n

注意不要引入 vue-i18n 的 useI18n

1
2
3
4
5
import { useI18n } from '/@/hooks/web/useI18n'

const { t } = useI18n()

const title = t('common.menu')

# 6. 切换语言

切换语言需要使用 src/hooks/web/useLocale.ts ( opens new window)

1
2
3
4
import { useLocale } from '@/hooks/web/useLocale'
const { changeLocale } = useLocale()

changeLocale('en')

# 7. 新增新语言

# 7.1 语言文件

src/locales ( opens new window) 增加对应语言的文件即可

# 7.2 新增语言

目前项目自带的语言只有 zh_CNen 两种

如果需要新增,按以下操作即可

  1. src/locales ( opens new window) 下语言文件
  2. types/global.d.ts ( opens new window)LocaleType 添加对应的类型
  3. src/store/modules/locale.ts localeMap 中添加对应语言

# 8. 远程读取语言数据

目前项目会在 src/main.ts 内等待 setupI18n 这个函数执行完之后才会渲染界面,所以只需在 setupI18n 内的 createI18nOptions 发送 ajax 请求,将对应的数据设置到 i18n 实例上即可。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
const createI18nOptions = async (): Promise<I18nOptions> => {
const localeStore = useLocaleStoreWithOut()
const locale = localeStore.getCurrentLocale
const localeMap = localeStore.getLocaleMap
// 这里改为远程请求即可。
const defaultLocal = await import(`../../locales/${locale.lang}.ts`)
const message = defaultLocal.default ?? {}

setHtmlPageLang(locale.lang)

localeStore.setCurrentLocale({
lang: locale.lang
// elLocale: elLocal
})

return {
legacy: false,
locale: locale.lang,
fallbackLocale: locale.lang,
messages: {
[locale.lang]: message
},
availableLocales: localeMap.map((v) => v.lang),
sync: true,
silentTranslationWarn: true,
missingWarn: false,
silentFallbackWarn: true
}
}

# 8.1 useLocale

代码: src/hooks/web/useLocale.ts ( opens new window)

当手动切换语言的时候会触发 useLocale 函数,useLocale 也是异步函数,只需等待接口返回响应的数据后,再进行设置即可

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
export const useLocale = () => {
// Switching the language will change the locale of useI18n
// And submit to configuration modification
const changeLocale = async (locale: LocaleType) => {
const globalI18n = i18n.global

// 改为远程获取
const langModule = await import(`../../locales/${locale}.ts`)

globalI18n.setLocaleMessage(locale, langModule.default)

setI18nLanguage(locale)
}

return {
changeLocale
}
}
上次更新: 2023/04/05, 22:46:09

本站由 钟意 使用 Stellar 1.28.1 主题创建。
又拍云 提供CDN加速/云存储服务
vercel 提供托管服务
湘ICP备2023019799号-1
总访问 次 | 本页访问