aab-intl v1.0.0
aab-intl
a@b framework - Internationalization
Locales
NodeJS use
const { Locales } = require("aab-intl"),
locales = new Locales("./locales"),
terms = locales.get("fr-CA", "welcomepage");
locales = new Locales( "./locales" )
In the example above, the root folder is locales. When relative, absolute path is based on process.cwd(). You can find an example in test/locales directory.
locales.locales
This property returns a Set of defined locales having a translation file or defined in map.json file.
locales.get( locale, key )
This methods returns an object of terms defined for ui key.
Define locales
root directory
This directory should contain json translation files or custom settings into map.json and keymap.json files explain below.
translation files
Translation file name is the name of locale ( ie: fr-FR.json ) and should contain an object having at least 3 levels: ui key, term and translation value. All other levels will be flatten with dots into term ( ie: title.long ) .
As translation files are imported with require() command, so you can split them into folders if you define an index.
{
"common": {
"ok": "Ok",
"submit": "Submit"
},
"main": {
"title": "Main title",
"info": "Main info"
},
"welcome": {
"title": {
"short": "Welcome",
"long": "Welcome long title"
},
"info": "Welcome info"
}
}
keymap.json
Tired with repeating "Submit" for all ui buttons? this file is for you.
You may define a fake ui in translation files containing submit. This map allows you to map any term to another to avoid translating terms twice.
{
"welcome": {
"button": "common.submit"
}
}
map.json
You have Brazilian and Portuguese translators and you want a fallback between languages? Here is the solution.
map.json is a map for each language defining inheritance between languages.
{
"pt": [ "pt-PT", "pt-BR", "en" ],
"pt-PT": [ "pt", "pt-BR", "en" ],
"pt-BR": [ "pt", "pt-PT", "en" ],
}
Language order defines priority.
Further methods & properties
locales.keymap
keymap.json file computed: terms and mapping are inverted to optimize search.
locales.map
Entries from map.json file with key language will be added as first argument.
locales.terms
Array of terms stored as objects containing:
- locale
- key
- term
- value
- pattern ( key.term )
locales.root
Absolute path to locales directory defined on creation.
locales.load( locale, key, term, value )
This method adds locales.terms entries.
locales.setKeymap( key, term, pattern )
This method edits locales.keymap.
locales.setMap( locale, ...locales )
This method edits locales.map.
6 years ago