GlobalizeProvider

Propagates the Globalize object and formatting functionality throughout the app using React Context.

The GlobalizeProvider component makes it simple to enable formatting in all your other components and to change the locale or default currency on demand. Simply set the locale and currency props appropriately (ensuring that any required locale and message data is loaded using loadCldr and loadMessages) to get started. Then update the props to propagate those changes throughout your app.

One recommended recipe is to keep locale and currency in your application's global state (e.g. Redux). Configured correctly, you can then fire an action in response to a user's selection and update the locale used throughout the app.

To determine the default locale of a user's device, react-native-localize is recommended.

Usage

import React from 'react';
import { GlobalizeProvider } from 'react-native-globalize';
import App from './App';

const Root = () => (
  <GlobalizeProvider locale="en" currency="USD">
    <App />
  </GlobalizeProvider>
);

export default Root;

Props

• currency
• defaultLocale
• locale
• localeFallback
• onError

currency

Type	Required	Default	Description
string	No	USD	Default currency to use when formatting.

defaultLocale

Type	Required	Default	Description
string	No	none	Default locale to use when specified locale not available.

locale

Type	Required	Default	Description
string	No	en	Locale to use for formatting.

localeFallback

Type	Required	Default	Description
boolean	No	false	Whether to fall back to a similar locale if specified locale is not loaded (e.g. en-GB -> en)

onError

Type	Required	Default	Description
function	No	console.error	Error logging/handling function. Function signature is onError(message: string, exception?: Error). The default handler logs messages to console.error in development mode only.