Translate Angular Project

How to setup language translation on AngularJS project

If you are googling to find how to internalizate your angularjs, you would find angular-translate or angular-gettext mostly. The first reason I choose angular-translate is because this has setting for reading translation data through json file. angular-gettext is using .po format and they have own tool to edit, but I don’t want to use other specific tool for editing. Because I have to ask for translation to other team, and it is a bugging job to guide how to work on with this. Editing text or json is more simple, and this is why I made this decision.

You can find more details about angular-translate on https://angular-translate.github.io

Screenshot

Add library file with bower for setup…

{% highlight bash %} {% raw %} bower install angular-translate {% endraw %} {% endhighlight %}

and add path and module for this. Module name is pascalprecht.translate.

{% highlight html %} {% raw %} …

… {% endraw %} {% endhighlight %}

Now go on for simple translation.

{% highlight html %} {% raw %}

{{ 'TITLE' | translate }}

... {% endraw %} {% endhighlight %}

Translation data is being defined with module $translateProvider. After config is setup, you can select your target language by using $translate.use('your-target-language') on your controller. You don’t even need to refresh your page. Just calling this command switches your resources directly.

This will be enough if you have only few of strings to handle. But if you have more resource to translate, and want to manage list on seperate file, you need more things to do.

Get several libraries with bower again…

{% highlight bash %} {% raw %} bower install angular-translate-loader-static-files bower install angular-translate-storage-local bower install angular-translate-storage-cookie {% endraw %} {% endhighlight %}

and add path for these.

{% highlight html %} {% raw %} …

… {% endraw %} {% endhighlight %}

Now you need to call your JSON list. First, as you know, you cannot inject $http service inside configuration on AngularJS. There are some of detour for this, but it is not recommended. Thankfully, there are prebuild module translateProvider.useStaticFilesLoader for this. Change your config file like this:

{% highlight javascript %} {% raw %} … var app = angular.module(‘appName’, [‘pascalprecht.translate’]); app.config( function ($translateProvider) {

    $translateProvider
        .useStaticFilesLoader({
            prefix: 'json/file/path/',
            suffix: '.json'
        })
        .preferredLanguage('de')
        .fallbackLanguage(['en']).useLocalStorage();

}); … {% endraw %} {% endhighlight %}

file: json/file/path/en.json {% highlight json %} {% raw %} { “TITLE”: “Hello” } {% endraw %} {% endhighlight %}

file: json/file/path/de.json {% highlight json %} {% raw %} { “TITLE”: “Hallo” } {% endraw %} {% endhighlight %}

This is it. Now this will work just same as first configurations.

There is also a way to lazy-load language resource. Maybe that way could be another answer, but unless you have massive size of resource, this is enough fast, and more simple to implement. I am working with about 500 resouce, but couldn’t find any delay loading this.

updatedupdated2023-03-212023-03-21