react-intlable
v1.1.0
Published
High order component for declarative internationalization
Downloads
4
Readme
React intlable
intl-messageformat bindings for React
Installation
npm install --save intl-messageformat react-intlable
Implementation
import React from 'react'
import { IntlableProvider } from 'react-intlable'
import Application from './Application'
const { messages, locale } = window.__LOCALE_DATA__
const ApplicationContainer = () => (
<IntlableProvider messages={messages} locale={locale}>
<Application />
</IntlableProvider>
)
Decorator
import React from 'react'
import { intlable } from 'react-intlable'
const Application = ({formatMessage, formatDate, formatNumber}) => (
<div>
<h1>{formatMessage(`application.greeting`, { name: `World`})}</h1>
<p>{formatDate(new Date())}</p>
<p>{formatNumber(100, { style: `currency`, currency: `USD`, currencyDisplay: `symbol` })</p>
</div>
)
export default intlable(Application)
Messages
Simple object
{
application: {
greeting: `Hello {name}!`
}
}
Browser support
If you want fully cross browser support, these steps for you:
Install inlt polyfill
npm install --save intl
Use ready loader
import AppContainer from './AppContainer'
import React from 'react'
import ReactDOM from 'react-dom'
import {ready} from 'react-intlable'
import pathToLocale from 'intl/locale-data/json/en.json'
ready(pathToLocale, () => {
ReactDOM.render(<AppContainer />, document.getElementById(`app`))
})
pathToLocale is a public url for localization data required by intl polyfill
If you use webpack, you can use file-loader to get this url
{
test: /\.json$/,
loader: `file?name=[hash].[ext]`
}
Universal rendering
For consistent results of internationalization you should use polyfill both on server and client
On server
global.Intl = require(`intl`)
require(`intl/locale-data/jsonp/en.js`)
require(`intl/locale-data/jsonp/eu.js`)
...
And force loading required data on client
ready(pathToLocale, () => {
ReactDOM.render(<AppContainer />, document.getElementById(`app`))
}, true)