by burawi | v0.0.10
Nativescript internationalization module
npm i --save tns-i18n


This is a Nativescript plugin that implements i18n easily.

It adds _L function to global variable and XML files so you can use it anywhere in the app.

It is inspired by nativescript-i18n, The only difference between them is that with this plugin you don't need to rebuild the app with every change, so you can continue watching the app smoothly.

The module detects the preferred user language and displays text in this language if it is handled by the app, if not, it will load the text in the default language you chose.

Prefer Videos ?

Here is a short video tutorial on this plugin.


tns plugin add tns-i18n



Import the module in app.js before anything else:

You have to mention the default language code

require('tns-i18n')('en'); // We set 'en' as default language
var application = require("application");

application.start({ moduleName: "./home" });

Creating locales

Now, create a i18n folder in app folder.

|___ i18n
|___ en.js
|___ ar.js

Must export in files

The files containing the strings, must export an object of the strings.

Eg: en.js

module.exports = {
greetings: 'Hello %s',
bye: 'Nice to meet you %s, see you in %s days'

Load strings


In XML files:

<Label text="{{_L('greetings')}}"></Label>




The module supports replacements of %s.


<Label text="{{_L('greetings', 'My friend')}}"></Label>
<!-- Will give: Hello My friend -->

Multiple replacements

For multiple replacements, you can use an array, separate arguments or even both.


<Label text="{{_L('bye', 'My friend', '5')}}"></Label>
<!-- Will give: Nice to meet you My friend, see you in 5 days -->


<Label text="{{_L('bye', ['My friend', '5'])}}"></Label>
<!-- Will give: Nice to meet you My friend, see you in 5 days -->