summaryrefslogtreecommitdiff
path: root/js/codeq/translation.js
blob: f0c8aabe3f3c7fb5f468ac0afc6db140322cd254 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
(function () {

    var dicts = {},
        translateElement = function (jqElt, tkey, lang) {
            var dictionaryKey = jqElt.data('dict') || 'gui',
                translationKey = jqElt.data(tkey),
                dict = dicts[dictionaryKey],
                translations, html, key, att;
            if (dict === codeq.tr.emptyDictionary) return; // silent ignore
            if (!dict) {
                codeq.log.error('Cannot find translation dictionary ' + dictionaryKey);
                return;
            }
            if (!(typeof translationKey === 'number' || typeof translationKey === 'string')) {
                codeq.log.error('Cannot find the element\'s translation key, dictionary: ' + dictionaryKey);
                return;
            }
            translations = dict[translationKey];
            if (!translations) {
                codeq.log.error('Translation key ' + translationKey + ' is missing from dictionary ' + dictionaryKey);
                return;
            }
            html = translations[lang];
            if (!html) {
                html = translations['en'];
                if (html) {
                    codeq.log.info('There is no translation in language ' + lang + ' for key ' + translationKey + ' in dictionary ' + dictionaryKey + ', defaulting to language en');
                }
                else {
                    for (key in translations) {
                        if (!translations.hasOwnProperty(key)) continue;
                        html = translations[key];
                        if (!html) continue;
                        codeq.log.info('There is no translation in languages ' + lang + ' and en for key ' + translationKey + ' in dictionary ' + dictionaryKey + ', defaulting to language ' + key);
                        break;
                    }
                    if (!html) {
                        codeq.log.warn('There is no translation in any language for key ' + translationKey + ' in dictionary ' + dictionaryKey + ', leaving empty');
                        return;
                    }
                }
            }
            att = tkey.substring(5);
            if (att) jqElt.attr(att,html);
            else jqElt.html(html);
        },
        translateDocument = function (lang) {
            $('[data-tkey]').each(function () {
                translateElement($(this), 'tkey', lang);
            });
            $('[data-tkey-placeholder]').each(function () {
                translateElement($(this), 'tkey-placeholder', lang);
            });
            $('[data-tkey-title]').each(function () {
                translateElement($(this), 'tkey-title', lang);
            });
            $('[data-tkey-value]').each(function () {
                translateElement($(this), 'tkey-value', lang);
            });
        };

    // Translate the whole document when the user switches the display language
    codeq.on('langchange', function (args) {
        translateDocument(args.lang);
    });

    // ================================================================================
    // The module API
    // ================================================================================

    codeq.tr = {
        'registerDictionary': function (name, dict) {
            dicts[name] = dict;
        },

        'unregisterDictionary': function (name) {
            delete dicts[name];
        },

        'emptyDictionary': {}, // use this with registerDictionary when you don't want any translations

        'translateDom': function (jqTopElt) {
            var lang = codeq.settings['gui_lang'];
            jqTopElt.filter('[data-tkey]').each(function () {
                translateElement(jqTopElt,'tkey', lang)
            });
            jqTopElt.find('[data-tkey]').each(function () {
                translateElement($(this),'tkey', lang);
            });
        },

        'getDictionary': function (name) {
            return dicts[name];
        }
    };
})();