react-umi 国际化（中英文切换）

最新推荐文章于 2024-05-28 15:06:05 发布

原创最新推荐文章于 2024-05-28 15:06:05 发布 · 5.5k 阅读

4 ·

CC 4.0 BY-SA版权

本文介绍如何在React Umi项目中配置和使用国际化功能，实现中英文切换。通过.default配置及zh-CN.js、en-US.js文件进行语言包设定。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

.umirc.js国际化默认配置

export default {
  plugins: [
    [
      'umi-plugin-react',
      {
        locale: {
          default: 'zh-CN', //默认语言 zh-CN
          baseNavigator: true, // 为true时，用navigator.language的值作为默认语言
          antd: true // 是否启用antd的<LocaleProvider />
        }
      }
    ]
  ]
};

目录及约定


```javascript
├── dist/                          
├── mock/                         
└── src/                          
    ├── layouts/index.js          
    ├── pages/                    
    └── locales               // 多语言文件存放目录，里面的文件会被umi自动读取
        ├── zh-CN.js
        └── en-US.js               
├── .umirc.js                     
├── .env                          
└── package.json

多语言文件约定
多语言文件的命名规范：-.js

多语言文件的内容规范：键-值组成的字面量，如下：

zh-CN.js

zh-CN.js

export default {
  WELCOME_TO_UMI_WORLD: '{name}，欢迎光临umi的世界',
}

en-US.js`

export default {//前面即ID，后面显示的内容
  WELCOME_TO_UMI_WORLD: '{name}, welcome to umi\'s world',
}

使用

import { formatMessage, setLocale, getLocale, FormattedMessage } from 'umi/locale'
//setLocale('en-US') 设置默认
//getLocale 获取当前语言
//setLocale 切换语言传参文件夹名字
//FormattedMessage 通过id渲染
//标签---主要

// 设置为 en-US
setLocale('en-US')

// 获取当前语言
console.log(getLocale() === 'en-US')
//使用标签 此处id为en-us文件夹和zh-cn文件夹的id， id后面的内容会自动显示到标签上
<FormattedMessage id="WELCOME_TO_UMI_WORLD" }/>
//------次要了解
// 获取指定文字的多语言版本
const formatedText = formatMessage({
  id: 'WELCOME_TO_UMI_WORLD'
}, {
  name: '小伙子',
})

console.log(formatedText === '小伙子，欢迎光临umi的世界')
// 渲染一个文字标签
function Example() {
  return <FormattedMessage id="WELCOME_TO_UMI_WORLD" values={{ name: '小伙子' }} />
}