language-select | Vaadin

Language Picker for Vaadin 14

This Component is intended for Vaadin 14 Applications that use an I18NProvider. It is a Language Picker based on the Select component from Vaadin.

Changing the Language with this component will automatically set a new Locale in the VaadinSession and all UI's that belong to that Session. It will trigger the localeChange(LocaleChangeEvent event) function of every opened View that implements LocaleChangeObserver, so that any translated labels and strings can be re-translated in the new language and replaced in the View without reloading.

You can now also choose to set a language cookie upon value change, so you can manually set the Session Locale to the used Locale upon Session-Init. See Code Samples for how to do that. Using the Constructor without a boolean parameter will NOT set language cookies upon value change.

You need to provide a flag image for each Locale/Language that you will add as item. Place these images in img/languageflags/ folder, and name them [language_code].png
For example en.png for english flag.

To find out where the img folder should be, see It will either be /src/main/webapp/img or /src/main/resources/META-INF/resources/img

Warning: if using Spring Security, you need to ignore '/img/**' in your WebSecurityConfigurerAdapter::configure(WebSecurity web). I will fix that in next version by using /images folder instead of /img.

In the ResourceBundle that your I18NProvider implementation uses, add Translations for each Locale/Language that you will use. The keys must be named LanguageSelect.[language_code]
For example LanguageSelect.en=English in the English resourcebundle-file, and LanguageSelect.en=Inglés in the Spanish resourcebundle-file


Link to this version
ExperimentalReleased 23 November 2020Apache License 2.0
Framework Support
Vaadin platform 14+
Install with
Release notes - Version 1.0.9

cleaned own pom file to not include any unnecessary dependencies