Overview
Translation Function
Comparison to others
You now might expect we compare eg. react-i18next to react-intl but that won't happen ;). But we will list why you should trust i18next to be the best choice for internationalization.
Sustainability
I18next was created in late 2011. What does that mean? It's older than most of the libraries you will use nowadays, including your main frontend tech (react, vue, ...).
Believe it or not but by the time of writing, the v11.x.x can be dropped in as a replacement for v1 by just adding a minimal compatibility layer. It's important to us not breaking things just for the sake of using new fancy stuff (which does not mean we do not keep up with latest possibilities of development).
Maturity
Based on how long i18next already is available open source, there is no real i18n case that could not be solved with i18next.
Extensibility
With v2 of i18next we completely rebuild i18next to be as extensible as possible. Doing this i18next can be used in any javascript (and a few non-javascript - .net, elm, iOS, android, ...) environment, with any UI framework, with any i18n format, ... the possibilities are endless.
Just have a look at what the community built around the i18next core:
Richness
The regular i18n frameworks work like this:
- 1.You pass in all translations and the used language
- 2.You call a function that returns the correct translation based on the translations you passed in and provided values for plural and interpolation.
What you don't get by others - but get with i18next
- Splitting translations into multiple files. Only load translations needed.
- There are plugins to detect languages for most environments (browser, native, server). This enables to set priority of where to detect and even enables to cache set languages over requests / visits.
- There are endless plugins to load translation from server, filesystem, ... these backends also assert that loading gets retried on failure, or that a file does not get loaded twice and callbacks of success are only called once. Those backends can even provide an additional layer for local caching eg. in localStorage.
- Options what to load and how to fallback depending on language.
- Full control over management of the translations stored.
- Rich system of events to react on changes important to your application.
But I heard
i18next is complicated
True, i18next's documentation is bigger than that of other i18n frameworks - but that's also a tribute to offering a lot more features that you would have to build yourself otherwise (language detection, translation loading, ...).
If you do not need that i18next is as simple as any other i18n framework:
1
import i18next from 'i18next';​
2
​
3
i18next.init({
4
lng: 'de',
5
resources: {
6
de: {
7
translation: {
8
"hello world": "hallo Welt"
9
}
10
}
11
}
12
});​
13
i18next.t('hello world'); // hallo Welt
Copied!
i18next is bloated
Hm... ask this in one year again. When your i18n framework needs to catch up with the needs of production systems.
We work hard on keeping the code base clean and readable. We add new features which might help a lot of users and not based on we think it's easy to solve.
i18next is too big
Yes, a size of 33kb minified and 9kb gzipped is huge. But like you saw before there is a lot more inside than just the basic i18n functionality.
But you could make this smaller by precompiling the translations. We could bring down i18next to 4kb gzipped (good to advertise) but on the other hand your translation files would grow significantly.
We tell you
I18next can do more
Just two samples of extended functionality you can get:
a) Ever liked to dynamically fallback your error messages to a general info if no specific message is available?
translation.json
1
{
2
"error": {
3
"unspecific": "Something went wrong.",
4
"404": "The page was not found."
5
}
6
}
Copied!
Sample
1
const error = '404';
2
i18next.t([`error.${error}`, 'error.unspecific']) // -> "The page was not found"​
3
​
4
const error = '502';
5
i18next.t([`error.${error}`, 'error.unspecific']) // -> "Something went wrong"
Copied!
b) Or like to say something like interval plurals:
- many goodies still available
- just a few goodies remaining...
- no goodies remaining...sorry you're too late
1
{
2
key_interval: '(0){no goodies remaining...sorry you`re too late};(1-100){just a few goodies remaining...};(100-inf){many goodies still available};'
3
}
Copied!
Works on serverside
While some other i18n frameworks run on serverside too there are not many optimized for it. Loading translations only once (think of a render to string in react.js where you create a new instance and inject translations over and over). Also does it keep the set language during async requests or do simultaneous requests create race conditions in setting the right language?
Learn once - translate everywhere
Overview of what technologies i18next will integrate with. Some listed are: Electron, Phaser, iOS, Android, Aurelia, Meteor, React Native, Knockout, React, Angular, Ember, jQuery, Vue, Grunt, IntelliJ IDEA, Webpack, NodeJS, Express, Django, Koa, Microsoft .NET, PHP, Ruby Rails, Couchbase, MongoDB, Redis, Firebase, Locize.
Should speak for itself.
We bridge the gap to localization
Being honest, internationalization is the smaller pain in getting a site translated. Localization and the translation process are where the real hard work starts.
Last modified 3mo ago