/react-i18next

Internationalization for react done right. Using the i18next i18n ecosystem.

Primary LanguageJavaScriptMIT LicenseMIT

react-i18next

Higher-order components and components for React when using i18next.

Travis CI Code Climate Coverage Status Quality dependencies devdependencies

How will my code look like?

Before: Your react code would have looked something like:

...
<div>Just simple content</div>
<div>
  Hello <strong title="this is your name">{name}</strong>, you have {count} unread message(s). <Link to="/msgs">Go to messages</Link>.
</div>
...

After: With the trans component just change it to:

...
<div>{t('simpleContent')}</div>
<Trans i18nKey="userMessagesUnread" count={count}>
  Hello <strong title={t('nameTitle')}>{{name}}</strong>, you have {{count}} unread message. <Link to="/msgs">Go to messages</Link>.
</Trans>
...

Have a look at the interactive playground at webpackbin.

video

watch the video

Documentation

The documentation is published on react.i18next.com

Installation

Source can be loaded via npm, bower or downloaded from this repo.

# npm package
$ npm install react-i18next

# bower
$ bower install react-i18next
  • If you don't use a module loader it will be added to window.reactI18next

Examples

Requirements

  • react >= 0.14.0
  • i18next >= 2.0.0

NEWS: localization as a service - locize.com

Needing a translation management? Want to edit your translations with an InContext Editor? Use the orginal provided to you by the maintainers of i18next!

locize

With using locize you directly support the future of i18next and react-i18next.