Getting Started with KendoReact Server Localization

The KendoReact Server Localization package enables you to adapt a component to a different locale by providing options for translating its messages or by enabling its right-to-left support.

KendoReact Server Components are in an experimental phase and are not intended for production use. APIs may change without introducing a breaking change. Please refer to the Umbrella GitHub issue for general feedback, bug reports, and more information.

KendoReact Server Localization Mechanism

The localization mechanism ensures that all imported JSON messages for the KendoReact Server Components will be loaded only on the server. This means that the bundle size sent on the client will reduce dramatically when the JSON messages contain large sets of data.

Translation of Messages

The Localization message files get populated when the files with the translated messages for the specific locales are available. Some of the provided localization files might be incomplete because of one or more missing translations for the respective language. For the complete list of currently available message translations, refer to https://github.com/telerik/kendo-react-messages.

To add a new localization file for a specific language:

  1. Fork https://github.com/telerik/kendo-react-messages.
  2. Apply your changes.
  3. Open a pull request. This will grant you Telerik points.

Optionally, you can directly send the new localization files through the Support Ticket system. The Support Team will apply the changes in the kendo-react-messages repository and update your Telerik points.

RTL Support (Coming Soon)

Right-to-Left (RTL) support represents the ability of a library, website, or application to handle and respond to users who communicate through right-to-left languages. Right-to-left languages are Arabic, Hebrew, Chinese, Japanese, and others.

By default, the RTL mode is disabled. In web applications, the RTL mode is enabled through the dir attribute of a DOM element. To enable the RTL mode for all KendoReact components in your React application, set a text direction value to the root element of the application. You can also limit the RTL mode to a part of the application by providing the dir property to a KendoReact component.