-
Reiter, Christoph authored
Create a new instance with createInstance() and call setOverrides() with override data to override translations. See the tests for some examples.
Reiter, Christoph authoredCreate a new instance with createInstance() and call setOverrides() with override data to override translations. See the tests for some examples.
i18next.js 4.14 KiB
import i18next from 'i18next';
/**
* Like Intl.DateTimeFormat().format() but uses the current language as locale.
*
* A i18next instance can be created with createInstance()
*
* @param {i18next.i18n} i18n - The i18next instance
* @param {Date} date - The date to format
* @param {object} options - Options passed to Intl.DateTimeFormat
* @returns {string} The formatted datetime
*/
export function dateTimeFormat(i18n, date, options = {}) {
return new Intl.DateTimeFormat(i18n.languages, options).format(date);
}
/**
* Like Intl.NumberFormat().format() but uses the current language as locale.
*
* A i18next instance can be created with createInstance()
*
* @param {i18next.i18n} i18n - The i18next instance
* @param {number} number - The number to format
* @param {object} options - Options passed to Intl.NumberFormat
* @returns {string} The formatted number
*/
export function numberFormat(i18n, number, options = {}) {
return new Intl.NumberFormat(i18n.languages, options).format(number);
}
export function humanFileSize(bytes, si = false) {
const thresh = si ? 1000 : 1024;
if (Math.abs(bytes) < thresh) {
return bytes + ' B';
}
const units = ['kB','MB','GB','TB','PB','EB','ZB','YB'];
let u = -1;
do {
bytes /= thresh;
++u;
} while(Math.abs(bytes) >= thresh && u < units.length - 1);
return bytes.toFixed(1)+' '+units[u];
}
/**
* @param {string} namespace The namespace to override
* @returns {string} The new namespace name
*/
function getOverrideNamespace(namespace) {
// This just needs to be different to the namespace, make it special
// so it's clear what it is used for in case it ends up in some error
// message or something
return '--' + namespace + '-override';
}
/**
* Creates a new i18next instance that is fully initialized.
*
* Call changeLanguage() on the returned object to change the language.
*
* @param {object} languages - Mapping from languages to translation objects
* @param {string} lng - The default language
* @param {string} fallback - The fallback language to use for unknown languages or untranslated keys
* @param {string} [namespace] - The i18next namespace to load, defaults to 'translation'
* @returns {i18next.i18n} A new independent i18next instance
*/
export function createInstance(languages, lng, fallback, namespace) {
if (namespace === undefined) {
namespace = 'translation';
}
let overrideNamespace = getOverrideNamespace(namespace);
var options = {
lng: lng,
fallbackLng: fallback,
debug: false,
ns: [overrideNamespace, namespace],
defaultNS: namespace,
fallbackNS: namespace,
initImmediate: false, // Don't init async
resources: {},
};
Object.keys(languages).forEach(function(key) {
options['resources'][key] = {[namespace]: languages[key]};
});
var i18n = i18next.createInstance();
i18n.init(options);
console.assert(i18n.isInitialized);
return i18n;
}
/**
* Sets translation overrides for the given i18next instance. Any previously
* applied overrides will be removed first. So calling this with an empty overrides
* object is equal to removing all overrides.
*
* @param {i18next.i18n} i18n - The i18next instance
* @param {object} overrides - The override data in the following format: "{language: {namespace: {key: value}}}"
*/
export function setOverrides(i18n, overrides) {
// We add a special namespace which gets used with priority and falls back
// to the original one. This way we an change the overrides at runtime
// and can even remove them.
let namespace = i18n.options.fallbackNS;
let overrideNamespace = getOverrideNamespace(namespace);
let hasOverrides = false;
for(let lng of i18n.languages) {
i18n.removeResourceBundle(lng, overrideNamespace);
if (overrides[lng] === undefined || overrides[lng][namespace] === undefined)
continue;
let resources = overrides[lng][namespace];
hasOverrides = true;
i18n.addResourceBundle(lng, overrideNamespace, resources);
}
i18n.setDefaultNamespace(hasOverrides ? overrideNamespace : namespace);
}