i18njs

i18njs

A simple i18n for Javascript with a templating feature.

Installation

Either

npm install --save i18njs

or

bower install --save i18njs

Usage

After importing it var i18n = require('i18njs');

Add locales

By default, language is set to en.

var en = {
	'hello_world': {
		'hello': 'Hello',
		'world': 'World'
	}
};
// i18n.add(language, namespace [optional], locales);
i18n.add('en', 'first_test', en);

Change language

i18n.lng = 'fr';

Get basic localized string

// i18n.get(key, data, options);
i18n.get('first_test.hello_world.hello'); // Hello

Get templated string

It uses a basic templating engine, the same as underscore.

It works in the form of {{=interpolate}}, {{evaluate}} or {{-escape}} :

var en = {
	'st': '{{=interpolate}} {{for(var i = 0, max = 1; i < max; i += 1) {}}to{{}}} {{-escape}}'
};

var data = {
	'interpolate': 'Hello',
	'escape': '\'<the>\' `&` "World"'
};

i18n.add('en', en);
var st = i18n.get('st', data);
// "Hello  to  &#x27;&lt;the&gt;&#x27; &#x60;&amp;&#x60; &quot;World&quot;"

You can also change delimeters by passing the third options arguments

var st = i18n.get('st', data, {
	evaluate: /<%([\s\S]+?)%>/g;
    interpolate: /<%=([\s\S]+?)%>/g;
    escape: /<%-([\s\S]+?)%>/g;
});

Will result in <%=interpolate%>, <%evaluate%> or <%-escape%>

Changelog

1.1.0 (2015-04-06)

Bug Fixes

• update commonjs and amd support (7005923)

<a name="1.0.1"></a>