开始之前,先了解目前常用的 React 国际化插件:The Best Libraries for React i18n。因为看上去使用方法比较简单,我先选择了 react-i18next。但是使用过程中遇到很多问题,不想继续浪费时间,于是转而使用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属性是无效的。