如何在vue3项目中实现国际化

简介: 如何在vue3项目中实现国际化

前言


国际化就是指在一个项目中,项目中的语言可以进行切换(中英文切换),那么在实际项目中是如何实现的呢?


首先我们进行一下最终效果的展示:


image.png


了解国际化的实现思路⚽️⚽️


首先在正式的实现国际化之前,我们不妨先来了解一下实现国际化的思路:

//定义msg值的数据源
const messages={
   en:{
   msg:"hello world"
 }
  zh:{
   msg:"你好世界"
 }
}
//定义切换变量
let locale="en";
//3.定义赋值函数
function t(key){
    return messages[locale][key]
}

首先讲解一下国际化的实现原理,其实就是定义了一个对象,然后在这个对象中包含两种(当然也可以是多种)语言,比如在这里这个messages对象中就包含两个对象分别文enzh,这两个对象中都有同一个属性msgzh中对应的是中文,而en对应的就是英文,

我们在初始的时候定义一个locale变量,并且指定变量值为"en",同时我们还定义了一个函数,这个函数接收一个key值,我们可以理解为这个key是想要获取国际化处理的变量值(可能不是很好理解,之后会有例子讲解),比如在这个例子里面这个key就代表着 "msg",这样我们只需要修改locale的值就可以获取不同语言下的msg的值了,这就实现了国际化


在项目开发中使用国际化⛹️‍♀️⛹️‍♀️


初始化配置


在了解了国际化的原理之后,其实实现国际化的原理并不复杂,那么我们在实际项目中是如何做的呢?

在开发过程中,一般我们需要借助第三方的包来实现。

首先安装指定的包

npm i vue-i18n@next

对于国际化我们实现分为一下几个步骤:

  • 配置修改element-plus的语言包
  • 创建并导入自定义的语言包
  • 创建一个组件用于修改locale

在安装指定的包之后我在实际项目中是这样处理的:

  • 首先在src文件下面创建一个i18n文件夹专门用来处理国际化的问题
  • 然后在里面新建index.js文件,用于i18函数的创建,配置相关的语言包等等。
  • 并且建立一个文件夹名称为lang,专门用来存放自定义的语言包
import { createI18n } from "vue-i18n";
//这是我自己创建的语言包
import mZhLocale from "./lang/zh";
import mEnLocale from "./lang/en";
//这里使用了vuex来进行全局的数据共享
import store from "@/store";
//创建messages对象,里面注册相应的语言包,这里面我注册了自己定义的语言包
const messages = {
  en: {
    ...mEnLocale,
  },
  zh: {
    ...mZhLocale,
  },
};
// 进行持久化处理,防止在页面刷新之后数据丢失
const getLanguage = () => {
  return store && store.getters && store.getters.language;
};
const i18n = createI18n({
  legacy: false, // 使用composition API
  locale: getLanguage(),//初始的时候调用这个函数获取vuex中的数据,当然vuex初始数据调用localstorage中存储的数据,或者默认赋值为”zh“
  globalInjection: true,  // 表明使用全局t函数
  messages,
});
export default i18n;//将i18函数导出

我们在index.js中进行i18函数的创建和导出,注册使用了自己定义的语言包,我们导出之后还需要在main.js中进行注册使用

main.js中

import App from "./App.vue";
import i18n from "@/i18n/index";
const app = createApp(App);
app.use(i18n);

在进行注册完之后我们还要在项目中对要展示的文字的部分进行修改配置,因此我们要使用$t函数


在项目中使用


其中的"navBar.home"则是在语言包中定义的数据 例如在英语语言包中:

export default{
 navBar:{
   home:"Home"
 }
}

在中文语言包中就会有一个对应的中文数据

export default{
 navBar:{
   home:"主页"
 }
}

这里只是做一个实例。

<span>{{ $t("navBar.home") }}</span>

t函数的第一种使用方式,我们当然还会遇到其他的情况。

就比如说是在登录注册页面中的输入框我们也想要使用t函数来进行国际化的处理:

 <el-input :placeholder="$t('login.inputName')"></el-input>

没有发生太大的变化,只是要注意一下,当然我们有的时候可能需要封装一个函数,然后在函数中我们封装了国际化的相关需求,这个时候如何做呢?

其实也不复杂,比如我们封装了一个函数用来处理sideBarItem中的标题。

import i18n from "@/i18n";
// 根据这个函数来处理面包屑和sidebar
export const generateTitle = (title) => {
  return i18n.global.t("route." + title);
};

这里面我们导入了之前创建的I18n文件夹下面的idnex.js文件,注意最后我们在函数返回值上面通过i18n.global.t()来将相应的值返回。


element-plus组件中的国际化处理🍆🍆


在上面的说明中我们只是配置了自定义的语言包处理,那么我们如何处理element-plus中的组件的国际化处理呢?

在element-plus的给出的方案中,我们一般这么处理:

  • 在APP.vue中使用el-config-provider组件将router-view标签包裹
  • 其次我们需要给locale定义值,这里我们同样还是使用vuex中的共享数据来进行定义,判断vuex中的存储的值,如果是zh的化就配置中文语言包,否则就是英文语言包。
  • 我们需要导入element-plus自带的语言包来进行相应的处理。
<template>
  <el-config-provider :locale="$store.getters.language === 'zh' ? ZhCn : En">
    <router-view></router-view>
  </el-config-provider>
</template>
<script setup>
import En from "element-plus/lib/locale/lang/en";
import ZhCn from "element-plus/lib/locale/lang/zh-cn";
</script>

这样当我们vuex中的数据发生变化的时候,element-plus中的语言也会发生相应的变化。


封装语言切换组件


当然为了切换语言我封装了一个组件LangSelect:

<template>
  <div>
    <el-dropdown trigger="click" @command="handleSetLanguage">
      <div>
        <el-tooltip content="国际化">
          <div><svg-icon icon="language"></svg-icon></div>
        </el-tooltip>
      </div>
        
      <template #dropdown>
        <el-dropdown-menu>
          <el-dropdown-item command="zh" :disabled="language === 'zh'"
            >中文</el-dropdown-item
          >
          <el-dropdown-item command="en" :disabled="language === 'en'"
            >English</el-dropdown-item
          >
        </el-dropdown-menu>
      </template>
    </el-dropdown>
  </div>
</template>
<script setup>
import { computed } from "vue";
import { useStore } from "vuex";
import { useI18n } from "vue-i18n";
import { ElMessage } from "element-plus";
const store = useStore();
// 实例化i18
const i18 = useI18n();
const language = computed(() => store.getters.language);
// 进行语言切换
const handleSetLanguage = (lang) => {    
  i18.locale.value = lang;
  store.commit("app/setLanguage", lang);
  ElMessage.success("更新完成");
  console.log(lang);
};
</script>

注意这里我们使用了useI18n这个函数来进行实例化,然后我们定义了一个函数handleSetLanguage,用来切换语言,

  • 在函数内部,通过修改i18.locale.value的值来更新当前语言。
  • 然后调用store.commit方法来触发名为"setLanguage"的Vuex mutation,更新store中的语言状态。
  • 使用computed函数创建名为language的计算属性,language属性依赖于store.getters.language,即从Vuex store的language`的getters中获取当前语言。

vuex中的数据

export default {
state: {
    // 获取缓存中的显示文字类型,如果为空默认为中文
    language: getItem(LANG) || "zh",
  },
    mutations: {
    //通过这个方法来修改vuex中的数据
    setLanguage(state, lang) {
      // 给缓存中添加数据
      setItem(LANG, lang);
      state.language = lang;
    },
  },
  }


相关文章
|
9天前
|
SQL JavaScript 安全
【04】Java+若依+vue.js技术栈实现钱包积分管理系统项目-若依框架二次开发准备工作-以及建立初步后端目录菜单列-优雅草卓伊凡商业项目实战
【04】Java+若依+vue.js技术栈实现钱包积分管理系统项目-若依框架二次开发准备工作-以及建立初步后端目录菜单列-优雅草卓伊凡商业项目实战
47 11
【04】Java+若依+vue.js技术栈实现钱包积分管理系统项目-若依框架二次开发准备工作-以及建立初步后端目录菜单列-优雅草卓伊凡商业项目实战
|
10天前
|
前端开发 JavaScript Java
【03】Java+若依+vue.js技术栈实现钱包积分管理系统项目-若依框架搭建-服务端-后台管理-整体搭建-优雅草卓伊凡商业项目实战
【03】Java+若依+vue.js技术栈实现钱包积分管理系统项目-若依框架搭建-服务端-后台管理-整体搭建-优雅草卓伊凡商业项目实战
57 13
【03】Java+若依+vue.js技术栈实现钱包积分管理系统项目-若依框架搭建-服务端-后台管理-整体搭建-优雅草卓伊凡商业项目实战
|
10天前
|
人工智能 JavaScript 关系型数据库
【02】Java+若依+vue.js技术栈实现钱包积分管理系统项目-商业级电玩城积分系统商业项目实战-ui设计图figmaUI设计准备-figma汉化插件-mysql数据库设计-优雅草卓伊凡商业项目实战
【02】Java+若依+vue.js技术栈实现钱包积分管理系统项目-商业级电玩城积分系统商业项目实战-ui设计图figmaUI设计准备-figma汉化插件-mysql数据库设计-优雅草卓伊凡商业项目实战
57 14
【02】Java+若依+vue.js技术栈实现钱包积分管理系统项目-商业级电玩城积分系统商业项目实战-ui设计图figmaUI设计准备-figma汉化插件-mysql数据库设计-优雅草卓伊凡商业项目实战
|
12天前
|
监控 JavaScript 前端开发
ry-vue-flowable-xg:震撼来袭!这款基于 Vue 和 Flowable 的企业级工程项目管理项目,你绝不能错过
基于 Vue 和 Flowable 的企业级工程项目管理平台,免费开源且高度定制化。它覆盖投标管理、进度控制、财务核算等全流程需求,提供流程设计、部署、监控和任务管理等功能,适用于企业办公、生产制造、金融服务等多个场景,助力企业提升效率与竞争力。
66 12
|
13天前
|
人工智能 JavaScript 安全
【01】Java+若依+vue.js技术栈实现钱包积分管理系统项目-商业级电玩城积分系统商业项目实战-需求改为思维导图-设计数据库-确定基础架构和设计-优雅草卓伊凡商业项目实战
【01】Java+若依+vue.js技术栈实现钱包积分管理系统项目-商业级电玩城积分系统商业项目实战-需求改为思维导图-设计数据库-确定基础架构和设计-优雅草卓伊凡商业项目实战
55 13
【01】Java+若依+vue.js技术栈实现钱包积分管理系统项目-商业级电玩城积分系统商业项目实战-需求改为思维导图-设计数据库-确定基础架构和设计-优雅草卓伊凡商业项目实战
|
30天前
|
资源调度 JavaScript 前端开发
创建vue3项目步骤以及安装第三方插件步骤【保姆级教程】
这是一篇关于创建Vue项目的详细指南,涵盖从环境搭建到项目部署的全过程。
160 1
|
2月前
|
JavaScript API 数据处理
vue3使用pinia中的actions,需要调用接口的话
通过上述步骤,您可以在Vue 3中使用Pinia和actions来管理状态并调用API接口。Pinia的简洁设计使得状态管理和异步操作更加直观和易于维护。无论是安装配置、创建Store还是在组件中使用Store,都能轻松实现高效的状态管理和数据处理。
146 3
|
9月前
|
JavaScript 前端开发
报错:关于Vue项目下载swiper插件时没有dist文件夹的问题
报错:关于Vue项目下载swiper插件时没有dist文件夹的问题
166 0
|
9月前
|
前端开发 JavaScript 测试技术
Vue3+Vite+TypeScript常用项目模块详解(下)
现在无论gitee还是github,越来越多的前端开源项目采用Vue3+Vite+TypeScript+Pinia+Elementplus+axios+Sass(css预编译语言等),其中还有各种项目配置比如eslint 校验代码工具配置等等,而我们想要进行前端项目的二次开发,就必须了解会使用这些东西,所以作者写了这篇文章进行简单的介绍。
177 0
|
9月前
|
JavaScript 前端开发 API
Vue3+Vite+TypeScript常用项目模块详解
现在无论gitee还是github,越来越多的前端开源项目采用Vue3+Vite+TypeScript+Pinia+Elementplus+axios+Sass(css预编译语言等),其中还有各种项目配置比如eslint 校验代码工具配置等等,而我们想要进行前端项目的二次开发,就必须了解会使用这些东西,所以作者写了这篇文章进行简单的介绍。
173 0
Vue3+Vite+TypeScript常用项目模块详解

热门文章

最新文章