Nefariously Programmed Mecha

    ex-react-native-i18n
    TypeScript icon, indicating that this package has built-in type declarations

    0.0.6 • Public • Published

    NPM version Downloads reactnative.gallery

    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

    import I18n from 'react-native-i18n'
     
     
    class Demo extends React.Component {
      // Async call to init the locale
      componentWillMount() {
        I18n.initAsync();
      }
      render () {
        return (
          <Text>{I18n.t('greeting')}</Text>
        )
      }
    }
     
    // Enable fallbacks if you want `en-US` and `en-GB` to fallback to `en`
    I18n.fallbacks = true
     
    I18n.translations = {
      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.

    I18n.fallbacks = true
     
    I18n.translations = {
      '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:

    import I18n from 'ex-react-native-i18n'
    const deviceLocale = I18n.locale

    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!

    Install

    npm i ex-react-native-i18n

    DownloadsWeekly Downloads

    277

    Version

    0.0.6

    License

    MIT

    Unpacked Size

    34.5 kB

    Total Files

    8

    Last publish

    Collaborators

    • xcarpentier