Internationalization

React Native Starter

Search…

2.0.0

Getting Started

Architecture

Testing

Internationalization

Adding Pages and Components

Components

Screens

Theming

Internationalization

We understand that your users can speak many different languages, so we've included an internalization support into the React Native Starter. It's done with the help of https://github.com/react-native-community/react-native-localize and https://github.com/fnando/i18n-js.
All the translations files live under the src/translations folder. Translation for each language are placed inside the json files with locale names.
Adding a new language
In order to add a new language you need to do 3 simple steps. Let's imagine you're adding a support for German language :
1.Create a file called src/translations/de.json and add translations strings there (see below for explanation on translation strings).
2.Change the src/translations/index.js to be the following
src/translations/index.js
1
import * as RNLocalize from 'react-native-localize';
2
import i18n from 'i18n-js';
3
​
4
import en from './en.json';
5
import ru from './ru.json';
6
​
7
// Import newly added language file
8
import de from './de.json';
9
​
10
// Add the German translation to the list
11
const translations = { en, ru, de };
12
​
13
const { languageTag } = RNLocalize.findBestAvailableLanguage(
14
  Object.keys(translations),
15
) || { languageTag: 'en' };
16
​
17
i18n.locale = languageTag;
18
i18n.fallbacks = true;
19
i18n.translations = translations;
20
​
21
export default i18n;
Copied!
And now you can use translations in your files.
Using Translated Strings
First of all, let's see, how to define translations string in translation files. Look at the example translation file:
src/translations/en.json
1
{
2
  "Common": {
3
    "minutes": "Minutes",
4
    "days": "Days",
5
    "button": {
6
      "save": "SAVE",
7
      "cancel": "CANCEL",
8
    },
9
    "done": "Done",
10
  },
11
  "Settings": {
12
    "audio": "Audio Enabled?"
13
  }
14
}
Copied!
In such file you define your translated strings as a nested JSON.
After you defined your translations, you can use it anywhere in your code like this:
src/settings/SettingsSection.js
1
// ... All the imports
2
​
3
// Import from your translations index
4
import I18t from '../translations';
5
​
6
export default function SettingsSection() {
7
  return (
8
    <View>
9
      <Text>{I18t.t('Settings.audio')}</Text>
10
      <Button>{I18t.t('Settings.Common.button.save')}</Button>
11
    </View>
12
  );
13
}
Copied!
Call to I18t.t('PATH') will return the translated string for the current user language from json file with a path, equal to PATH 
For more information, refer to https://github.com/react-native-community/react-native-localize documentation.

Testing

Adding Pages and Components

Last modified 3yr ago

Copy link

Contents

Adding a new language

Using Translated Strings