Localization

Localization is the process of adapting software to meet the requirements of local markets and different languages.

You can change the messages that are displayed in the Kendo UI widgets by including an additional script file in the document.

Setting the Current Language

By default, all Kendo UI widgets display their messages in US English. To replace the default text messages, include a language specifickendo.messages.<language>.js file in the document.

Include the localization script before the widgets are initialized. The best place to include it is right after the Kendo UI JavaScript files.

The following example demonstrates how to add the localization script to a document.

html

<scriptsrc="https://code.jquery.com/jquery-3.7.0.min.js"></script><scriptsrc="kendo.all.min.js"></script><scriptsrc="kendo.messages.bg-BG.js"></script>

The following example demonstrates how to add the localization script to a document from the CDN.

html

<scriptsrc="https://code.jquery.com/jquery-3.7.0.min.js"></script><scriptsrc="https://kendo.cdn.telerik.com/<version>/js/kendo.all.min.js"></script><scriptsrc="https://kendo.cdn.telerik.com/<version>/js/messages/kendo.messages.bg-BG.min.js"></script>

Currently, translations are not available for every language and some of the localization files may be incomplete. For more information on where to find the full list of available translations, refer to thesection on contributing.

Using HTML in the localization messages of the components is not supported. Localization messages are designed to use strings and no HTML can be passed to them.

Creating New Localization Files

The localization script replaces the default messages in the widget prototype with their equivalent translations. The file has to be named by following thekendo.messages.<language>.js convention. Alanguage code identifier list is available for free download from the Microsoft developer network website.

The following example demonstrates how to create a new localization file. Thekendo.messages.en-US.js contains all widget messages and may be used as a reference when you create the new localization file—copy the file, rename it, and translate the messages.

/* <Widget-name> messages */if(kendo.ui.<Widget-name>){kendo.ui.<Widget-name>.prototype.options.messages=$.extend(true, kendo.ui.<Widget-name>.prototype.options.messages,{"<message-name>":"<translation",//...});}

Common Scenarios

Localizing Widgets That Are Rendered by Server-Side Wrappers

The server-side wrappers (helpers) render some of the markup and the respective messages that are needed for the widgets from the server. Applying the UI localization on the client side may not work as expected. Currently, the ASP.NET MVC wrappers come with localization resource files which work with the default localization mechanism provided by ASP.NET MVC. For more information, refer to the article onglobalization in ASP.NET MVC.

Changing the Language at Runtime in AngularJS Applications

For a runnable example on changing the culture, language, and messages in an AngularJS application, refer tothis code library.

Contribution

Currently, translations are not available for every language and some of the localization files may be incomplete. The full list of currently available translations is available in theKendo UI Core repository.

If you notice any missing messages in the localization files or would like to add localization files for your language, do not hesitate to:

Fork the repository.
Apply the respective changes.
Submit a pull request.

Movatterモバイル変換