React 项目实现多语言切换

前言:

     在做项目过程中,遇到一个需求就是支持多语言,实现国际化的功能。感谢React社区的强大,提供了 umi-plugin-locale插件来实现国际化的功能。

首先我们是基于 Umi 搭建的项目。

 umi-plugin-locale 约定 在 src/locales 中引入 相应的 js,例如 en-US.js 和 zh-CN.js,

注意:文件名称要和locale的值要对应起来。

   并且在项目配置文件中做如下配置:

    

      locale: {
        enable: true, // default false
        default: 'zh-CN', // default zh-CN
        baseNavigator: true, // default true, when it is true, will use `navigator.language` overwrite default
      },

就可以在代码中使用全球化的功能了。

umi-plugin-locale 封装了react-intl, api 与 react-intl 基本相同,并做了封装使用起来更加方便。全部 api 如下:

import { formatMessage, setLocale, getLocale, FormattedMessage } from 'umi/locale';

格式化字符串#

如果我们在 en-US.js 和 zh-CN.js 中分别作了如下配置:

// en-US.js

export default {
  'navbar.lang': '中文',
}

// zh-CN.js

export default {
  'navbar.lang': 'English',
}

我们就可以在组件中这样使用

import { formatMessage } from 'umi/locale';

export default () => {
  return <div>{formatMessage({ id: 'navbar.lang' })}</div>;
};

设置区域#

umi-plugin-locale 暴露了名为 setLocale 和 getLocale 的 api,通过这两个 api 可以方便的切换区域。

代码看起来像这样的:

...
 changLang = () => {
    const locale = getLocale();
    if (!locale || locale === 'zh-CN') {
      setLocale('en-US');
    } else {
      setLocale('zh-CN');
    }
  };
  render(){
        <Button
          size="small"
          ghost={theme === 'dark'}
          style={{
            margin: '0 8px',
          }}
          onClick={() => {
            this.changLang();
          }}
        >
          <FormattedMessage id="navbar.lang" />
        </Button>
  }

一个简单的demo:

     https://github.com/lghxuelang/localeLange.git

 

 

 

React Umi支持多语言切换,以下是实现方法: 1. 安装umi-plugin-locale插件:运行`npm install umi-plugin-locale --save-dev`或`yarn add umi-plugin-locale --dev`。 2. 在.umirc.js文件中配置locale插件: ``` export default { plugins: [ ['umi-plugin-locale', { default: 'zh-CN', baseNavigator: true, antd: true, }], ], }; ``` 其中,default为默认语言,baseNavigator为基于浏览器语言设置语言,antd为使用Ant Design组件的多语言支持。 3. 在src/locales目录下创建语言文件,如zh-CN.js、en-US.js,其中包含对应语言的翻译信息: ``` export default { 'app.title': 'React Umi 多语言示例', 'app.hello': '你好 {name}!', }; ``` 4. 在组件中使用intl对象实现语言切换。在组件中引入FormattedMessage组件,并使用intl.formatMessage方法获取对应翻译信息: ``` import { FormattedMessage } from 'umi/locale'; function Hello(props) { const { name } = props; return ( <div> <h1> <FormattedMessage id="app.title" /> </h1> <p> <FormattedMessage id="app.hello" values={{ name }} /> </p> </div> ); } ``` 其中,id属性对应语言文件中的键值,values属性为动态参数。 5. 实现语言切换功能。可以通过点击按钮或链接等方式触发切换语言的函数,然后调用intl对象的setLocale方法切换语言: ``` import { connect } from 'dva'; import { Button } from 'antd'; import { FormattedMessage, setLocale } from 'umi/locale'; function LanguageSwitch(props) { const { dispatch } = props; return ( <div> <Button onClick={() => { setLocale('en-US', false); dispatch({ type: 'global/changeLocale', payload: 'en-US' }); }} > <FormattedMessage id="lang.en-US" /> </Button> <Button onClick={() => { setLocale('zh-CN', false); dispatch({ type: 'global/changeLocale', payload: 'zh-CN' }); }} > <FormattedMessage id="lang.zh-CN" /> </Button> </div> ); } export default connect()(LanguageSwitch); ``` 在setLocale方法中,第一个参数为切换语言类型,第二个参数为是否使用浏览器语言设置。在dispatch方法中,将语言类型传递给dva model中的changeLocale函数,实现全局语言切换
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值