How to implement language support for JavaFX in FXML documents?


How can I have different languages for a view in a FXML document to support many countries?

10/12/2014 1:03:03 PM

Accepted Answer

Use ResourceBundles to store the locale-dependent text, and access the data in the bundle using "%resourceKey".

Specifically, create text files for each language you want to support and place them in the classpath. The Javadocs for ResourceBundle have the details on the naming scheme, but you should have a default bundle defined by and bundles for other languages and variants defined by For example (with the resources directory in the root of the classpath):


greeting = Hello


greeting = Bonjour

Then in your FXML file you can do

<Label text = "%greeting" />

To pass the ResourceBundle to the FXMLLoader do:

ResourceBundle bundle = ResourceBundle.getBundle("resources.UIResources");
FXMLLoader loader = new FXMLLoader(getClass().getResource("/path/to/FXML.fxml"), bundle);
Parent root = loader.load();

This code will load the resource bundle corresponding to the default locale (typically the locale you have set at the OS level), falling back on the default if it can't find a corresponding bundle. If you want to force it to use a particular bundle, you can do

ResourceBundle bundle = ResourceBundle.getBundle("/resources/UIResources", new Locale("fr"));

Finally, if you need access to the resource bundle in the FXML controller, you can inject it into a field of type ResourceBundle and name resources:

public class MyController {

    private ResourceBundle resources ;

    // ...
10/28/2016 10:56:17 PM

Licensed under: CC-BY-SA with attribution
Not affiliated with: Stack Overflow