Language Menu

Introduction

Mendix makes it easy to present the same information to users who have different language requirements. All text presented to end users can be translated to different languages.

These translatable texts include the following:

• button captions
• data grid columns
• labels
• menu items
• messages that are sent from a microflow
• text

Working in the Currently Selected Language

You can see the language you are currently working in at the bottom right of the screen.

When you have multiple languages set up in your app, you can choose a language to work in by doing one of the following:

• selecting it from the Language > Current Language menu
• using the drop-down in the lower-right corner of Studio Pro's main window
• using the Ctrl + L or Ctrl + Shift + L keyboard shortcut combinations, which cycle through the configured languages

When working in a language that is not the default, you can identify texts that have not been translated yet. These show the text in the default language between angle brackets. For example, <Name>. When you replace the text with the appropriate translation, it updates for the currently selected language.

If you edit your app to add new widgets while not in the default language, any new translatable texts for those widgets will be added to the current language. The text in the default language will either be left blank or will have the placeholder text for the widget.

All untranslated texts will be displayed in the default language when you run the application.

English (US) and Dutch translations are added by default even if you do not use these languages in your app. When you add a new element (for example, a button), it gets an English and Dutch translation in the system, but you will not see it until you add those languages. You may want to delete all English and Dutch translations if you do not plan to have your app in these languages. Before deleting English (US), make sure you have another default language set up. For more information on how to delete translations, see the Delete section in Language Operations.

If you plan to export your module or app as an add-on or solution, the best practice is to remove default Dutch translations to avoid confusion for your customers in case they plan to translate their app to Dutch. For more information, see the Exporting Add-on Modules and Solutions section in Configuring Add-on and Solution Modules for Publishing.

The Language Menu

The Language menu allows you to manage additional languages and translations for your app. This includes features to help you to translate a text in all places where it appears with a single change instead of having to change each occurrence individually:

Menu Items

The following table describes the Language menu items:

Setting the End-User's Language

The language displayed to the end-user is determined by the Language object associated with the User object for the current end-user via the association User_Language.

If the associated language is not one of those set in the app, then the end-user will see pages in the default language.

If the end-user is not associated with a language (for example, they are an anonymous user), the language used depends on the user's browser or operating system settings. If the requested language is not present in the app, then the app's default language is used. The requested language is as follows:

• For web apps – the first language that matches a language set in the app based on the browser's preferred order of languages.
• For mobile apps – the operating system language.

If you allow end-users to change their display language within the app, the changes are not applied immediately. This is because the translatable texts for the app are already set to the end-user's original language.

There are two options to ensure that the language is changed:

1. Ask the end-user to do something manually:

   • Sign out and sign in again
   • Use their browser's refresh command

2. Force Mendix to reload the page, for example, by doing the following:

   1. Add the platform supported widget HTML / JavaScript Snippet to your app.
   2. Create a pop-up page.
   3. Place the HTMLSnippet widget on the pop-up page.
   4. Add the JavaScript content window.reload(); to the widget.
   5. Open your new pop-up page from a microflow when you want to switch the user's language.

   

   When reloading the page, the language change must be made for the $currentUser object of entity type User. The language will not change immediately if you use an association to a specialization of the User entity, such as Administration.Account.

Read More

• Translating Your App Content – a worked example of adding a translation
• Using Translatable Validation Messages
• Change language by clicking a link – explanations and ideas in the Mendix Community for refreshing the page when the language is changed
• Anonymous User Journey – a discussion in the Mendix Community about switching languages for anonymous end-users