vue3国际化适配

最近公司接手了一个香港地区的项目,由于语言的不同涉及到了国际化,于是花时间研究了一下,配置也是很简单,简单的几步就可以配置好了

什么是国际化?

是指使软件应用能够适应不同语言和地区文化差异的过程。其主要目标是让应用能够为不同语言的用户提供本地化的内容和体验,特别是在做一些港澳地区和海外项目的时候,进行国际化适配是必不可少的。

为什么叫i18n?

"i18n" 是 "internationalization"(国际化)的缩写形式

"i18n" 是一个惯用的简写形式,其中 "i" 代表单词的开头字母,"n" 代表单词的结尾字母,而 "18" 则表示在这两个字母之间的18个字母

主要目的是为了简化表达和方便使用

类似的缩写还有 "l10n" 代表 "localization"(本地化),"a11y" 代表 "accessibility"(无障碍设计)

如何进行国际化适配?

安装插件

bash 复制代码
pnpm i vue-i18n

配置 vue-i18n

创建一个用于配置国际化的文件,导出配置的国际化实例

src/i18n/index.js

js 复制代码
import { createI18n } from 'vue-i18n'

import en from './locales/en-US'
import cn from './locales/zh-CN'
import tw from './locales/zh-TW'

const messages = {
  'en-US': en,
  'zh-CN': cn,
  'zh-TW': tw,
}

// 创建 i18n 实例
const i18n = createI18n({
  locale: 'zh-CN', // 默认语言
  legacy: false, //  启用 Composition API 语法
  messages, // 语言包,也就是你要翻译的内容
  globalInjection: true, // 全局注入 $t
})

export const t = i18n.global.t // 全局导出 t 方法,简化和方便使用,减少使用的心智负担

export function useLocale(){
  return computed({
      get(){
          return i18n.global.locale.value
      },
      set(locale){
          i18n.global.locale.value = locale
      }
  })
}

export default i18n

创建语言包

js 复制代码
src/i18n/locales/en-US.js
export default {
  登录: 'login',
  注册: 'register',
  用户名: 'username',
  密码: 'password',
}
js 复制代码
src/i18n/locales/zh-CN.js
export default {
  登录: '登录',
  注册: '注册',
  用户名: '用户名',
  密码: '密码',
}
js 复制代码
src/i18n/locales/en-TW.js
export default {
  登录: '登入',
  注册: '註冊',
  用户名: '用户名',
  密码: '密碼',
}

为什么上面使用了缓存?

因为切换语言是依靠 vue-i18n 提供的一个全局变量 locale ,切换locale来使用不同的语言包,当页面刷新相当于又重置了默认值,所以使用缓存来解决,当然解决方法不止一种,也可以使用 watch 来解决

目前还只是页面上所有文字的切换显示多语言,一般在开发的时候会使用到组件库配合开发,还要配置组件库的国际化适配 下面我以 naive-ui 为例,其他组件库同理

vue 复制代码
app.vue
<template>
  <n-config-provider :locale="naiveLocale">
    <router-view />
  </n-config-provider>
</template>
<!--
naiveLocale 为全局提供给 naive ui 的全局语言,使用计算属性动态计算
-->
<script setup>
  import { computed } from 'vue'
  import { useI18n } from 'vue-i18n'
  import { zhCN, enUS, zhTW } from 'naive-ui' // 引入 naive ui 的语言包


const { locale } = useI18n()

// 定义一个映射表,将语言代码映射到 Naive UI 的本地化配置对象
const naiveLocaleMapping = {
  'en-US': enUS, // 英语设置
  'zh-CN': zhCN, // 简体中文设置
  'zh-TW': zhTW  // 繁体中文设置
}

const naiveLocale = computed(() => naiveLocaleMapping[locale.value])
// 这里的意思是,读取当前的 locale 使用的语言环境值,然后去 naiveLocales 中找到对应的语言包,赋值给 naiveLocale

</script>
  • 首先导入 naive-ui 的语言包
  • 使用 locale 获取当前的语言环境,去映射表中找到对应的语言赋值给 naiveLocale
  • 最后在 n-config-provider 中使用 naiveLocale

这样,当切换语言的时候,组件库的语言也会跟着切换

注意:组件库的语言包需要和 vue-i18n 的语言包一一对应,不然切换语言的时候组件库的语言不会跟着切换

最终实现效果

相关推荐
小曲曲14 分钟前
接口上传视频和oss直传视频到阿里云组件
javascript·阿里云·音视频
学不会•1 小时前
css数据不固定情况下,循环加不同背景颜色
前端·javascript·html
EasyNTS2 小时前
H.264/H.265播放器EasyPlayer.js视频流媒体播放器关于websocket1006的异常断连
javascript·h.265·h.264
活宝小娜4 小时前
vue不刷新浏览器更新页面的方法
前端·javascript·vue.js
程序视点4 小时前
【Vue3新工具】Pinia.js:提升开发效率,更轻量、更高效的状态管理方案!
前端·javascript·vue.js·typescript·vue·ecmascript
coldriversnow4 小时前
在Vue中,vue document.onkeydown 无效
前端·javascript·vue.js
我开心就好o4 小时前
uniapp点左上角返回键, 重复来回跳转的问题 解决方案
前端·javascript·uni-app
开心工作室_kaic5 小时前
ssm161基于web的资源共享平台的共享与开发+jsp(论文+源码)_kaic
java·开发语言·前端
刚刚好ā5 小时前
js作用域超全介绍--全局作用域、局部作用、块级作用域
前端·javascript·vue.js·vue
沉默璇年6 小时前
react中useMemo的使用场景
前端·react.js·前端框架