Translated Labels (TLBS)

Get custom translations to your app easily!

Installation and Initialization

Use npm i tlabels to install.

Then, in your code, import the module.

import tLabels from 'tlabels';

Next, initialize the instance with the default language and the path to the labels file (If not exist, it will be created).

const labels = tLabels('en', 'path/to/save/files/json');

Now you can use the instance to get the labels.

Usage guide

• To CREATE or EDIT a label, use the method setLabel passing the label name, the label value and the language to use (optional, default is the default language that you set in the initialization).

// Create a label in the default language
await labels.setLabel('hello_world', 'hello world');

// Create a label in a specific language
await labels.setLabel('hello_world', 'hello world', 'en');

• To GET a specific label value, use the method getLabel passing the label name and the language to use (optional).

// Get the label value in the default language
let label = await labels.getLabel('hello_world');

// Get the label value in a specific language
let label = await labels.getLabel('hello_world', 'pt');

• To DELETE one label use the method deleteLabel passing just the label name.

await labels.deleteLabel('hello_world');

• To check if a label EXIST, use the method exist passing the label name.

let labelExist = await labels.exist('hello_world');

• To get CURRENT LANGUAGE use the method getCurrentLanguage without parameters (is not async).

let language = labels.getCurrentLanguage();

• To CHANGE LANGUAGE use the method setCurrentLanguage passing the language to use (is not async).

labels.getCurrentLanguage('es');

Notes

• The name of the labels must be unique, if you try to create a label with the same name in the same language, the value will be updated.

• The labels key must be in the format snake case. Ex: label_name. If you try to create a label with a key in another format, the key will be converted to snake case.

• If you try to get a label that does not exist, the method getLabel will return the label name.

• If you remoove a label, the label will be removed from all languages.