jfTranslations

Simple class for translations system.

See here for data structure of parsed JSON translations files.

Usage

Examples

// File: translations/en.ui.json
{
    "charset"      : "utf-8",
    "translations" : {
        "" : {
            "Hola {name}, bienvenido a {site}" : {
                "msgstr" : ["Hello {name}, welcome {site}"]
            }
        }
    }
}

// You can use it as singleton 
const translations = require('@jf/translations/src/Browser').i();
// Or using new operator. 
const Translations = require('@jf/translations/src/Browser');
const translations = new Translations();
//
translations.poDir = __dirname + '/translations';
translations.addLanguage('en', 'ui');
console.log(
    translations.tr(
        'Hola {name}, bienvenido a {site}',
        {
            name : 'Guest',
            site : 'home'
        }
    )
); // Hello Guest, welcome home

Plurals

const count = 20;
console.log(
    translations.trn(
        count,
        'You have no items in your cart',
        'You have 1 item in your cart',
        'You have {count} items in your cart',
        {
            count : count
        }
    )
); // You have 20 items in your cart

Mixing formats

You can mix printf-like format with context placeholders.

printf placeholders are replaced before context placeholders and their order is important. Context placeholders order is not important because each context is merged.

console.log(
    translations.tr(
        'First file `{file}` has %d bytes and second file `%s` has {size} bytes.',
        1234,                 // %d - First printf placeholder.
        'file2.js',           // %s - Second printf placeholder.
        {
            size : 4567       // {size}
        },
        {
            file : 'file1.js' // {file}
        }
    )
); // First file `file1.js` has 1234 bytes and second file `file2.js` has 4567 bytes.',