latest
legacy v9
SSR (v9)
Using next.js?
You should have a look at next-i18next which extends react-i18next to bring it to next.js the easiest way.
Samples
To learn more you should have a look at our samples:
The usage of the
reactI18nextModule for holding the i18n instance is not a valid option (the instance would be set globally). Always use the I18nextProvider like done in the samples above.Pass language and translations down to client
Both the i18nextProvider and translate hoc allow to pass in
initialI18nStore and initialLanguage. By doing so the translations won't be loaded and initial clientside render will avoid any flickering or rerender by checksum mismatch.For details check the docs of those components or have a look at the examples above.
loadNamespaces helper
loadNamespaces: Function that will pre-load all namespaces used by your components. Works well with
react-router match functionprops:
- components: Components that need to have namespaces loaded.
- i18n: the i18n instance to load translations into
1
import { I18nextProvider, loadNamespaces } from 'react-i18next';
2
import { match } from 'react-router';
3
4
match({...matchArguments}, (error, redirectLocation, renderProps) => {
5
loadNamespaces({ ...renderProps, i18n: i18nInstance })
6
.then(()=>{
7
// All i18n namespaces required to render this route are loaded
8
})
9
});
Copied!
use the i18next-express-middleware
When using i18next-express-middleware, you can use
req.i18n as the i18next instance for I18nextProvider it will assert no request conflicts happen (each request gets it's cloned instance of i18next):1
import { I18nextProvider } from 'react-i18next';
2
import i18n from './i18next'; // your own initialized i18next instance
3
import App from './app';
4
5
app.use((req, res) => {
6
const component = (
7
<I18nextProvider i18n={req.i18n}>
8
<App />
9
</I18nextProvider>
10
);
11
12
// render as desired now ...
13
});
Copied!
Last modified 8mo ago