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.
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" });
Now, create a i18n folder in app folder.
app
|___ i18n
|___ en.js
|___ ar.js
.
.
.
.
.
.
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'
};
In XML files:
<Label text="{{_L('greetings')}}"></Label>
_L("greetings")
The module supports replacements of %s
.
Eg:
<Label text="{{_L('greetings', 'My friend')}}"></Label>
<!-- Will give: Hello My friend -->
For multiple replacements, you can use an array, separate arguments or even both.
Eg:
<Label text="{{_L('bye', 'My friend', '5')}}"></Label>
<!-- Will give: Nice to meet you My friend, see you in 5 days -->
Or:
<Label text="{{_L('bye', ['My friend', '5'])}}"></Label>
<!-- Will give: Nice to meet you My friend, see you in 5 days -->