i18n-zone: A module with clean and nice syntax supports internationalization in projects using JavaScript. It has no dependencies, very lightweight (less than 8KB without gzip). Main features: translating, number formatting, pluralization, selection.
npm install i18n-zonevi.json
{
"What is your name?": "Tên bạn là gì?",
"My name is :myName.": "Tên tôi là :myName.",
"there_are_some_dogs{numOfDogs}": "Có :numOfDogs con chó."
}en.json
{
"there_are_some_dogs{numOfDogs}": "There :numOfDogs(PLURAL, 1 is one dog, ! are :@ dogs)."
}const {settings} = require('i18n-zone');
settings.setResource('vi', require('/path/to/vi.json'));
settings.setResource('en', require('/path/to/en.json'));
settings.setDefaultLocale('en');
settings.setLocale('vi');const {translate} = require('i18n-zone');
translate('What is your name?');
// -> Tên bạn là gì?
translate('My name is :myName.', {myName: 'Quyết'});
// -> Tên tôi là Quyết.translate('there_are_some_dogs{numOfDogs}', {numOfDogs: 10});
// -> Có 10 con chó
// current locale is 'vi'
// however, we can force locale to be 'en' by passing it as third argument
translate('there_are_some_dogs{numOfDogs}', {numOfDogs: 10}, 'en');
// -> There are 10 dogs.
// change locale to 'en'
settings.setLocale('en');
translate('there_are_some_dogs{numOfDogs}', {numOfDogs: 1});
// -> There is one dog.
// more variants
// use wildcard :@ to insert value into variants
translate('There :count(PLURAL, 0 are no comments, 1 is one comment, <10 are some comments, <=100 are :@ comments, ! are a lot of comments)', {count: 10});
// -> There are 10 comments.translate('Hello :gender(SELECT, *male* Mr., *female* Ms.) :name!', {gender: 'male', name: 'Jame'});
// -> Hello Mr. Jame!// change the way to format number
/**
* @return {string} formatted number
*/
const formatNumber = (number, locale) => {
// your code goes here
// by default, Number.prototype.toLocaleString is used
return Number(number).toLocaleString(locale);
}
settings.setNumberFormatter(formatNumber);translate('there_are_some_dogs{numOfDogs}', {numOfDogs: 100000});
// -> There are 100,000 dog.
translate('That car costs :price USD', {price: 55000});
// -> That car costs 55,000 USD
// Use string if you don't want to format
translate('This year is :year', {year: '2020'});
// -> This year is 2020/**
* @return {string} formatted value
*/
const formatCurrency = (amount, locale, style) => {
if (style === 'symbol') {
return translate('$:amount', {amount}, locale);
}
return translate(':amount USD', {amount}, locale);
};
settings.setCurrencyFormatter(formatCurrency);translate('Total amount is :amount(CURRENCY)', {amount: 10000});
// -> Total amount is 10,000 USD
translate('Total amount is :amount(CURRENCY, symbol)', {amount: 10000});
// -> Total amount is $10,000/**
* @return {string} formatted date
*/
const formatDate = (date, locale, style) => {
const d = new Date(date);
const pad = t => (t < 10 ? '0' : '') + t;
return `${pad(d.getDate())}/${pad(d.getMonth() + 1)}/${d.getFullYear()}`;
};
settings.setDateFormatter(formatDate);translate('Today is :today(DATE)', {today: new Date()});
// -> Today is 21/11/2020
translate('Updated on :date(DATE)', {date: '2021-02-01 23:00:00'});
// -> Updated on 01/02/2021Place the text in square brackets to escape
translate('This car has the power of :power[HP]', {power: 800});
// -> This car has the power of 800HP
translate('I have :amount[[USD]]', {amount: 100});
// -> I have 100[USD]
translate('I have [ :amount[[USD]] ].', {amount: 100});
// -> I have [ 100[USD]] .
translate('Hi :police, [:criminal] has been [[escaped]]', {police: 'Jame', criminal: 'Billy'});
// -> Hi Jame, :criminal has been [escaped]
translate('Hi :police, :criminal has been [arrested]', {police: 'Jame', criminal: 'Billy'});
// -> Hi Jame, Billy has been arrested
// if no params passed, raw message will be returned
translate(':nothing will be [escaped] if no params');
// -> :nothing will be [escaped] if no params
// escaping in variants
translate('There :count(PLURAL, 1 is one comment, >=100 are :@ comments[,] awesome!, ! are :@ comments)', {count: 100});
// -> There are 100 comments, awesome!
translate('Hello:gender(SELECT, *male* [ ]Mr., *female* [ ]Ms., [,]) :name!', {gender: 'other', name: 'Jack'});
// -> Hello, Jack!const {validator} from 'i18n-zone';
validator.validateResources();If no errors found, returns:
nullIf has errors, returns an object contains errors correspond with each ID:
{
"vi": {
"message_id": [
"error 1",
"error 2"
]
}
}Validate that IDs do not start or end with whitespaces
Type: boolean
Default: true
validator.setOption('idShouldBeTrimmed', false);Validate that messages do not start or end with whitespaces
Type: boolean
Default: true
validator.setOption('messageShouldBeTrimmed', false);Validate that IDs do not contains too many characters. Set null to disable.
Type: number|null
Default: 100
validator.setOption('idMaxLength', null);Validate that single-word messages do not contain: too many characters. Set null to disable.
(Single-word messages are messages contain only one word, no whitespaces between).
Type: number|null
Default: 20
validator.setOption('singleWordMessageMaxLength', null);Validate that IDs reflect exactly the same params with corresponding messages.
Type: boolean
Default: true
validator.setOption('idShouldReflectParams', false);