Translation (render prop)

🏠 i18next 🌐 localization as a service 🔎 Find your translator 🎓 i18next crash course

Search…

What it does
The Translation is a render prop and gets the t function and i18n instance to your component.
import React from 'react';
import { Translation } from 'react-i18next';
​
export function MyComponent() {
  return (
    <Translation>
      {
        (t, { i18n }) => <p>{t('my translated text')}</p>
      }
    </Translation>
  )
}
While you most time only need the t function to translate your content you also get the i18n instance to eg. change the language.
i18n.changeLanguage('en-US');
The Translation render prop will trigger a Suspense if not ready (eg. pending load of translation files). You can set useSuspense to false if prefer not using Suspense.
When to use?
Use the Translation render prop inside any component (class or function) to access the translation function or i18n instance. 
Translation params
Loading namespaces
// load a specific namespace
// the t function will be set to that namespace as default
<Translation ns="ns1">
{
  (t) => <p>{t('my translated text')}</p> // will be looked up from namespace ns1
}
</Translation>
​
// load multiple namespaces
// the t function will be set to first namespace as default
<Translation ns={['ns1', 'ns2', 'ns3']}>
{
  (t) => <p>{t('my translated text')}</p> // will be looked up from namespace ns1
}
</Translation>
Overriding the i18next instance
// passing in an i18n instance
// use only if you do not like the default instance
// set by i18next.use(initReactI18next) or the I18nextProvider
import i18n from './i18n';
​
<Translation i18n={i18n}>
{
  (t, { i18n }) => <p>{t('my translated text')}</p> // will be looked up from namespace ns1
}
</Translation>
​

latest - Previous

withTranslation (HOC)

Next - latest

Trans Component

Last modified 3yr ago

Copy link

On this page

What it does

When to use?

Translation params

Loading namespaces

Overriding the i18next instance