Getting Started with the Kendo UI for Angular Localization

The Localization package enables you to translate the components into different languages.

Together with the Internationalization package, the Localization package provides the globalization features of Kendo UI for Angular. For more information on the globalization aspects which are available for each component, refer to the article on globalization support.

To adapt a component to a different locale, you can translate its messages and enable its right-to-left support.

Messages Translation

As part of the @progress/kendo-angular-messages package, Kendo UI for Angular ships ready-to-use translations for common locales. These translations are used to populate Angular Internationalization (i18n) message files. The package with the available translations is hosted on GitHub and is open for contributions. For more information on how to obtain localized messages, refer to the article on translating the messages of the components.

RTL Support

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.

In web applications, the RTL mode can be enabled with the dir attribute of a DOM element. To enable the RTL mode for all Kendo UI components in your Angular application, provide a text direction value by using the RTL token in the root module of the application. You can also limit the RTL mode to a part of the application by providing the value to a sub-module. By default, the RTL mode is disabled.

Example
View Source
Edit In Stackblitz  
Change Theme:

Dynamic Update of Text Direction

In specific scenariosfor example, if the language of your application changes dynamicallyyou can change the text direction at runtime. The dynamic update of the text direction is handled through the Message Service because the text direction typically changes with the messages. For more information, refer to the section on updating messages dynamically.

If the translation of messages is handled elsewhere and you only want to change the text direction, call notify on the default MessageService.

Example
View Source
Edit In Stackblitz  
Change Theme: