vue3项目配置vue-i18n国际化

介绍:

本项目基于vue3setup+ts+pinia+element-plus

可以直接根据此篇,实现简单国际化和项目中配合点击切换语言的写法,供参考
 

vue I18n官网 :Getting started | Vue I18n 

看文档可以实现简单的配置,可是不太相符实际项目中的写法,于是:

安装

NPM#

npm install vue-i18n@9

Yarn#

yarn add vue-i18n@9

 配置

在src目录新建i18n目录,en.ts为英文,zh.ts为中文,index.ts为配置文件,如图

zh.js文件内容

export default {
  messages: {
      username: '用户名',
      password: '密码',
    }
}

en.ts 文件内容

export default {
  messages: {
      username: 'username',
      password: 'password',
    }
}

 index.ts 文件内容

// index.ts

import { createI18n } from 'vue-i18n'
import enLocale from './config/en';
import zhLocale from './config/zh';
import { getStoredLanguage, saveStoredLanguage } from "../languageStorage";

const messages = {
    简体中文: zhLocale,
    'English/USD': enLocale,
}

const defaultLocale = "English/USD";
const storedLocale = getStoredLanguage() || defaultLocale;

const i18n = createI18n({
    globalInjection: true, //全局生效$t
    fallbackLocale: 'English/USD',
    locale: storedLocale,
    legacy: false, // 解决legacy mode 报错
    messages
})

export default i18n;

main.ts中引入i18n

import { createApp } from 'vue'
import App from './App.vue'
import i18n from './i18n';

import './style.css'
import router from './routers/index'
import ElementPlus from 'element-plus'
import 'element-plus/dist/index.css'
import 'element-plus/theme-chalk/dark/css-vars.css'
import * as ElIcons from '@element-plus/icons'
import pinia from './store/index';

const app = createApp(App);

for (const name in ElIcons){
	app.component(name,(ElIcons as any)[name])
}
console.log(i18n)
createApp(App).use(ElementPlus).use(router).use(i18n).use(pinia).mount('#app')

使用

两种使用方法,一种直接 $t 在template引用,如:

<template>
    <div
        {{ $t('messages.usernmae') }}
    </div>
</template>

第二种: 在table的标签,button,input等输入框中动态绑定:

// 首先需要在script标签中 引入+定义

<script>

import { useI18n } from "vue-i18n";
const { t } = useI18n();

</script>

<template>
    <div
         <el-button :text="t('messages.username')"></el-button>
    </div>
</template>

还有一种情况是在遍历数组的内容里使用国际化

注意数组内容不要加"",会被认为是字符串

<template>
  <div v-for="(item, index) in firstCard" :key="index">
    <div class="msg">{{ item.msg }}</div>
</template>

<script>
import { useI18n } from "vue-i18n";
const { t } = useI18n();

const firstCard = [
  {
    msg: t("messages.password"),
  },
  {
    msg: t("messages.username"),
  },
];
</script>

改变语言

首先添加一个languageStorage.ts文件
 

//获取用户保存的语言首选项
export function getStoredLanguage(): string | null {
  return localStorage.getItem("selectedLanguage");
}
//保存新的语言选择
export function saveStoredLanguage(language: string): void {
  localStorage.setItem("selectedLanguage", language);
}

 在点击切换语言的页面内,如下操作

<el-dropdown-item>
  <div
    @click.native="changeLanguage('English/USD')"
  >
    English
  </div>
</el-dropdown-item>
<el-dropdown-item>
  <div
    @click.native="changeLanguage('简体中文')"
  >
    简体中文
  </div>
</el-dropdown-item>

<script>
import { saveStoredLanguage } from "../../languageStorage";
import { getCurrentInstance } from "vue";

let $this = getCurrentInstance()?.appContext.config.globalProperties as any;

const changeLanguage = (selectedLanguage: any) => {
  $this.$i18n.locale = selectedLanguage;
  saveStoredLanguage(selectedLanguage);
  currentLanguage.value = selectedLanguage;
  location.reload(); //可以切换语言后刷新界面
};
</script>