ex-react-native-i18n for Expo
Integrates I18n.js with React Native and Expo. Uses the device's locale as default.
Automatic setup
$ npm install ex-react-native-i18n --save
or
$ yarn add ex-react-native-i18n
Usage
Before copy usage see this issue: https://github.com/xcarpentier/ex-react-native-i18n/issues/7
Component // Async call to init the locale { I18n; } { return <Text>I18n</Text> } // Enable fallbacks if you want `en-US` and `en-GB` to fallback to `en`I18nfallbacks = true I18ntranslations = en: greeting: 'Hi!' fr: greeting: 'Bonjour!'
This will render Hi!
for devices with the English locale, and Bonjour!
for devices with the French locale.
Fallbacks
When fallbacks are enabled (which is generally recommended), i18n.js
will try to look up translations in the following order (for a device with en_US
locale):
- en-US
- en
Note: iOS locales use underscored (en_US
) but i18n.js
locales are dasherized (en-US
). This conversion is done automatically for you.
I18nfallbacks = true I18ntranslations = 'en': greeting: 'Hi!' 'en-GB': greeting: 'Hi from the UK!'
For a device with a en_GB
locale this will return Hi from the UK!'
, for a device with a en_US
locale it will return Hi!
.
Device's locale
You can get the device's locale with the RNI18n
native module:
const deviceLocale = I18nlocale
Returns en-US
.
I18n.js documentation
For more info about I18n.js methods (localize
, pluralize
, etc) and settings see its documentation.
Hire an expert!
Looking for a ReactNative freelance expert with more than 12 years experience? Contact me from my website!