Please nominate your Qt Champions for 2021!

Question around internationalization in QML

  • So I produced a .qm file and am able to load it when I pass it as a command on qmlviewer launch. Now how can I have a qml button that loads that translation when the user selects a language?

  • I don't think you can do that entirely from QML. I think you need some C++ for that, unless I overlooked the QML functionality that would do this.

  • How would I do this with C++ then?

  • Well, you could create a Object subclass that you register for use in QML (see qmlRegisterType()), so you can access the slots in that class from QML.

    Then, from that class, you can use QCoreApplication::installTranslator. I am just not sure if Quick plays nice with dynamic translation. You'd have to try that.

  • If we just forget the qml part of it for now, how can I load it up in C++? Will I need to restart the application? Does it just pick those files up on runtime?

  • Perhaps you should read up on using internationalization in Qt applications. There is an extensive page in the documentation on this. It comes down to you, as a programmer, having to load in the the translation files you want into a QTranslator, and installing them in your app using the above mentioned QCoreApplication::installTranslator. Normally, you would use QLocale to figure out which one to use, but if you want to be able to change that on runtime, you need to adapt your logic a bit to allow for that.

  • I read the documentation but it is still not clear to me how to deploy an application on a device with several languages and allow the user to navigate between them.

  • Do you get how to install a translation in a single language?
    You can use the same technique, except instead of loading the translation based on the locale, as is done in the example in the documentation, you load a translation file in response to a request from your user. The loading is the same, just the timing and the way you select the correct file to load will differ. If you are asking for ready-to-use code: I am sorry, I am not going to write it for you.

  • Should each of my qml files have qm file? Do I have to load each of those individually?

  • No, you make one per language for your whole project.

  • I am struggling with dynamic translation in QML as well. I can install new QM files, but I only get a translated UI on new Items that get loaded after the QM is installed. All existing items remain untranslated. Theoretically, the QDeclarativeView receives a changeEvent(LanguageChange) when the translation is installed, but changeEvent() hasn't been reimplemented in QDeclarativeView yet. Hopefully that feature will be added soon. For now, after you install the new translation file, you'll have to reload all of your text manually, i.e. using a Loader or some other mechanism.

  • Good to know I am not the only one struggling through it. Let me know if you find a good solution.


  • May I suggest filing a bugreport in "Jira": I considder it a bug that dynamic translation doesn't work with QDeclarativeView.

  • Great idea!


    It kind of makes sense to me that it wouldn't be translated. e.g.

    id: myTxt
    text: qsTr("Translate Me")

    When the above Text is created, qsTr() is script code that gets executed. The result is assigned to myTxt.text. So when a new translation is installed, there's no new script to be executed. However, there needs to be a mechanism to retranslate when a QEvent::LanguageChange is posted.

  • Turns out there was already a bug filed for this:


    And someone just posted a great suggestion for a workaround. I have verified it in my application:

    Text {
    text: qsTr("Translate Me") + rootItem.emptyString

    By binding "text:" to another property, the whole expression will be reevaluated whenever the property emptyString changes.

    In my case rootItem is a QObject that is installed with setContextProperty()

    My rootItem has:

    Q_PROPERTY(QString emptyString READ getEmptyString NOTIFY languageChanged)

    In my method that installs a new QM translation file, I end with:

    emit languageChanged();

    The method getNullString() just returns "" so it doesn't effect the display of the text.

    A better solution still needs to be resolved by the Trolls, but this will work until that time.


  • i have this problem now...
    i didn't understand your solution.
    can you please explain this or give an example, i tried to do the above but it's also didn't work.

  • goli:

    Basically, your code should look similar to this. Post your C++ code if this doesn't help.

    class MyClass : public QObject
    Q_PROPERTY(QString emptyString READ getEmptyString NOTIFY languageChanged)

    QString getEmptyString() { return ""; }

    Q_INVOKABLE void selectLanguage(QString language) {

    // Install QTranslator. See Docs for details

    emit languageChanged();

    int main(argc, argv) {

    QDeclarativeView view;
    MyClass myObj;

    view.rootContext()->setContextProperty("rootItem", (QObject *)&myObj);



    The selectLanguage() method installs a new QTranslator in the application. It then emits languageChanged(). All QML Text { } elements that use rootItem.emptyString in their text binding will receive a "NOTIFY" signal causing the qsTr("....") to be reevaluated using the new QTranslator. Because rootItem.emptyString is just "" (an empty string), it will alter the text in your GUI.

    Please post your code if you have more questions.


  • thank you very much. this was helpful :)

  • This code works, thank you. I had the same problem, but this method solved it.

    Waiting for more elegant solution - without adding any "empty strings"... ;)

  • Another approach would be to clear the engine's internal cache and set the main qml file again. clearComponentCache() forces all components to be reloaded, so there is no need for the emptyString property.

    side note: clearComponentCache() is also nice for dynamic qml loading without restarting your application. It really speeds qml development up.

    QDeclarativeView view;
    void languageChange ( QString qsLanguage )
    // install the translator here. See Qt docs about it

    // Now do:
    view.engine()->clearComponentCache ( );
    view.setSource(QUrl::fromLocalFile ("apps_main.qml"));


  • @digital_aspirin
    Hi,, How to achieve your method can you explain bit detail

Log in to reply