使用 react-intl 实现 React 组件国际化

开始之前，先了解目前常用的 React 国际化插件：The Best Libraries for React i18n。因为看上去使用方法比较简单，我先选择了 react-i18next。但是使用过程中遇到很多问题，不想继续浪费时间，于是转而使用react-intl。事实证明及时改变方案是明智的。

React Intl

React Intl 用于国际化 React 组件，提供 React 组件和 API 来格式化日期，数字，字符串（包括单复数和翻译）。这次只用它实现文本翻译。

用法

先安装： npm install react-intl --save 。

载入语言环境数据。React Intl 依赖这些数据来支持单复数和相对时间格式化的功能。

// Main.js
import { addLocaleData } from 'react-intl'; /* react-intl imports */
import en from 'react-intl/locale-data/en';
import zh from 'react-intl/locale-data/zh';
addLocaleData([...en, ...zh]);  // 引入多语言环境的数据

虽然我只用到了文本翻译的功能，以为就不需要加载这些数据，但后来发现这是必须的步骤。不然会报错：

[React Intl] Missing locale data for locale: "zh". Using default locale: "en" as fallback.

使用<IntlProvider>组件包裹需要实现国际化的根组件，这个组件树之后就会在配置的i18n上下文中了。
由于项目中用到了react-hot-loader，根组件 Main被<AppContainer>包裹了，并且是从单独的一个文件 import 了 Main 组件。

//app.js
import { AppContainer } from 'react-hot-loader'
import Main from './components/Main'
//... ...
const render = Component => {
    ReactDOM.render(
        <AppContainer>
            <Component />
        </AppContainer>,
        document.getElementById('app')
    )
}
render(Main);

于是直接在 Main.js 中使用<IntlProvider>组件。把它加到 render()返回节点的最外层就行了。

// Main.js
import { addLocaleData, IntlProvider } from 'react-intl'; /* react-intl imports */
render(){
    return (
        <IntlProvider>
          //··· ···
        </IntlProvider>
    )
}

添加多种语言对应的文本。比如要支持中英文，为了方便之后维护，可以新建两个文件：

// en_US.js
const en_US = {
    hello: "Hello!"，
    //... ...
}
export default en_US;

// zh_CN.js
const zh_CN = {
    hello: "你好！"，
    //... ...
}
export default zh_CN;

然后在Main.js中引入这两个变量。

// Main.js
import zh_CN from "../locale/zh_CN"     // import defined messages in Chinese
import en_US from "../locale/en_US"     // import defined messages in English

全局配置当前的语言，和相对应的文本。即配置<IntlProvider>组件的两个属性locale和messages。

// Main.js
render(){
    let messages = {}
    messages['en'] = en_US;
    messages['zh'] = zh_CN;
    return (
        <IntlProvider locale={this.state.lang} messages={messages[this.state.lang]}>
            //··· ···
        </IntlProvider>
    )
}

这样基本配置就完成了，可以通过改变 this.state.lang的值来改变页面语言。

// Main.js
/**
 * Change language
 * @param {String} lang new language
 */
changeLanguage(lang) {
    this.setState({
        lang: lang
    })
}

接下来，添加翻译的文本到页面中。
基本只需要使用到一个组件：<FormattedMessage>。这个组件默认生成一个<span>，内容是翻译后的文本，也就是 messages中对应字段的值。
在需要添加国际化文本的组件中，引入FormattedMessage组件。
```
import { FormattedMessage  } from 'react-intl'; /* react-intl imports */
//... ...
<FormattedMessage id="hello" />
```
当前语言为en时，生成结果：
```
<span>Hello!</span>
```
到这里，基本的国际化就实现了。

更进一步

文本中添加变量。

// en_US.js
const en_US = {
    helloSomeone: "Hello, {name}!"
}
// zh_CN.js
const zh_CN = {
    helloSomeone: "{name}，你好！"
}

<FormattedMessage id="helloSomeone" values={{name:"Evelyn"}}/>

在任意组件，获取当前页面语言。
基于以上的配置，可以看出当前语言是英语还是中文，取决于Main组件的 state.lang。那如果在其他组件中想要知道当前语言呢？方法一是直接传递给Main组件的子组件的props，但由于使用了 react-router不方便使用这方法；于是选择了方法二。
React Intl 提供一个API，injectIntl，可以把命令式格式化的 API 注入到任意组件的props中。然后可以在那个组件中通过this.props.intl直接去调用一些API和属性，比如this.props.intl.locale的值就是当前语言了。

injectIntl 把 API 注入到组件的 props 中

injectIntl 的使用方法可以看官方文档的例子，这里不赘述了。

自定义标签名，不生成<span>。比如生成 <p>。
```
<FormattedMessage id="hello" tagName="p" />
```
生成的文本中包含富文本。在messages中直接包含富文本无效，不会被解析。可以通过values传值时，加上富文本，比如：
```
<FormattedMessage 
  id="helloSomeone" 
  tagName="div" 
  values={{
    name:<p className="name">Evelyn</p>
  }} />
```
注意此处name不是字符串，而是 React 元素。结果为：
```
<div>Hello, <p class="name">Evelyn</p>!</div>
```

自定义生成的节点。比如，生成一个按钮：

<FormattedMessage id='hello'>
    {(txt) => (
      <input type="button"
        className="btn-hello"
        onClick={this.handleClickHello.bind(this)}
        value={txt} />
    )}
</FormattedMessage>

txt对应messages中的文本。当语言为en时生成结果：

<input type="button" class="btn-hello" value="Hello!">

此时再定义tagName属性是无效的。

参考阅读

The Best Libraries for React i18n: https://phraseapp.com/blog/posts/react-i18n-best-libraries/
React Intl wiki: https://github.com/yahoo/react-intl/wiki#getting-started