Globalization

The globalization process combines the translation of component messages with adapting them to specific locales.

For more information on how globalization practices are implemented in KendoReact, refer to the overview article. For more information on the globalization aspects which are available for each component, refer to the article on globalization support.

The following example demonstrates how to:

• Change the date format and month names to Spanish.
• Localize the built-in Grid messages.
• Localize the column header messages.

The key points in the implementation of the above examples are as follows:

• Change Grid's built-in messages using the LocalizationProvider component and the loadMessages function.

Using the loadMessages method as follows will assign the texts in the esMessages object to the 'es-ES' language definition.

Copy Code    loadMessages(esMessages, 'es-ES');

Having the above, by changing between the es-ES and the default es-EN languages(the language prop of the LocalizationProvider), we can switch the built-in messages of the Grid.

Copy Code    <LocalizationProvider language={locale}>
    ...
    </LocalizationProvider>

• Change Grid's data formatting based on a specific country selection using the IntlProvider component and the load function.

Using the load function as follows will load the specific formatting for the Spanish language. You can notice that the numbers, currencies, caGregorian, dateFields and timeZoneNames are imported from file that has es in its URL. If we want to import the formatting configurations for French, for example, we need to update the URL from es to fr.

Copy Code    import likelySubtags from 'cldr-core/supplemental/likelySubtags.json';
    import currencyData from 'cldr-core/supplemental/currencyData.json';
    import weekData from 'cldr-core/supplemental/weekData.json';
    import numbers from 'cldr-numbers-full/main/es/numbers.json';
    import currencies from 'cldr-numbers-full/main/es/currencies.json';
    import caGregorian from 'cldr-dates-full/main/es/ca-gregorian.json';
    import dateFields from 'cldr-dates-full/main/es/dateFields.json';
    import timeZoneNames from 'cldr-dates-full/main/es/timeZoneNames.json';

    load(
      likelySubtags,
      currencyData,
      weekData,
      numbers,
      currencies,
      caGregorian,
      dateFields,
      timeZoneNames
    );
    );

With the import above, by changing the locale prop of the IntlProvider component, we can switch between the loaded formatting configurations.

Copy Code     <IntlProvider locale={locale === 'es-ES' ? 'es' : 'en'}>
        .............
     </IntlProvider>

Internationalization

The internationalization process applies specific culture formats to a web application.

For more information, refer to:

• KendoReact documentation on internationalization
• kendo-intl (the base Internationalization package on GitHub)

Messages

The Grid supports the localization of its messages by utilizing the KendoReact Internationalization package.

The following table lists the built-in message keys and their default values.

Right-to-Left Support

The following example demonstrates how to utilize the RTL support for the Grid.

Suggested Links

• Globalization
• Internationalization
• Localization