discourse/app/assets/javascripts/locales/i18n.js

Ignoring revisions in .git-blame-ignore-revs. Click here to bypass and see the normal blame view.

343 lines
8.6 KiB
JavaScript
Raw Normal View History

2013-03-01 03:31:39 +08:00
// Instantiate the object
var I18n = I18n || {};
// Set default locale to english
I18n.defaultLocale = "en";
// Set default pluralization rule
2013-03-01 03:31:39 +08:00
I18n.pluralizationRules = {
en: function(n) {
return n === 0 ? ["zero", "none", "other"] : n === 1 ? "one" : "other";
2013-03-01 03:31:39 +08:00
}
};
// Set current locale to null
I18n.locale = null;
I18n.fallbackLocale = null;
2013-03-01 03:31:39 +08:00
// Set the placeholder format. Accepts `{{placeholder}}` and `%{placeholder}`.
I18n.PLACEHOLDER = /(?:\{\{|%\{)(.*?)(?:\}\}?)/gm;
2013-03-01 03:31:39 +08:00
I18n.SEPARATOR = ".";
2013-03-01 03:31:39 +08:00
I18n.noFallbacks = false;
2013-03-01 03:31:39 +08:00
I18n.isValidNode = function(obj, node, undefined) {
return obj[node] !== null && obj[node] !== undefined;
};
I18n.lookup = function(scope, options) {
options = options || {};
var translations = this.prepareOptions(I18n.translations),
2020-03-13 02:07:38 +08:00
locale = options.locale || I18n.currentLocale(),
messages = translations[locale] || {},
currentScope;
2013-03-01 03:31:39 +08:00
options = this.prepareOptions(options);
if (typeof scope === "object") {
scope = scope.join(this.SEPARATOR);
2013-03-01 03:31:39 +08:00
}
if (options.scope) {
scope = options.scope.toString() + this.SEPARATOR + scope;
2013-03-01 03:31:39 +08:00
}
var originalScope = scope;
scope = scope.split(this.SEPARATOR);
2016-08-26 04:33:29 +08:00
if (scope.length > 0 && scope[0] !== "js") {
scope.unshift("js");
}
2013-03-01 03:31:39 +08:00
while (messages && scope.length > 0) {
currentScope = scope.shift();
messages = messages[currentScope];
}
if (messages === undefined && this.extras && this.extras[locale]) {
messages = this.extras[locale];
scope = originalScope.split(this.SEPARATOR);
while (messages && scope.length > 0) {
currentScope = scope.shift();
messages = messages[currentScope];
}
}
if (messages === undefined) {
messages = options.defaultValue;
}
2013-03-01 03:31:39 +08:00
return messages;
};
// Merge several hash options, checking if value is set before
2013-03-01 03:31:39 +08:00
// overwriting any value. The precedence is from left to right.
//
// I18n.prepareOptions({name: "John Doe"}, {name: "Mary Doe", role: "user"});
// #=> {name: "John Doe", role: "user"}
//
I18n.prepareOptions = function() {
var options = {},
2020-03-13 02:07:38 +08:00
opts,
count = arguments.length;
2013-03-01 03:31:39 +08:00
for (var i = 0; i < count; i++) {
opts = arguments[i];
if (!opts) {
continue;
}
for (var key in opts) {
if (!this.isValidNode(options, key)) {
options[key] = opts[key];
}
}
}
return options;
};
I18n.interpolate = function(message, options) {
options = this.prepareOptions(options);
var matches = message.match(this.PLACEHOLDER),
2020-03-13 02:07:38 +08:00
placeholder,
value,
name;
2013-03-01 03:31:39 +08:00
2020-03-13 02:07:38 +08:00
if (!matches) {
return message;
}
2013-03-01 03:31:39 +08:00
2020-03-13 02:07:38 +08:00
for (var i = 0; (placeholder = matches[i]); i++) {
2013-03-01 03:31:39 +08:00
name = placeholder.replace(this.PLACEHOLDER, "$1");
if (typeof options[name] === "string") {
// The dollar sign (`$`) is a special replace pattern, and `$&` inserts
// the matched string. Thus dollars signs need to be escaped with the
// special pattern `$$`, which inserts a single `$`.
// https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String/replace#Specifying_a_string_as_a_parameter
value = options[name].replace(/\$/g, "$$$$");
} else {
value = options[name];
}
2013-03-01 03:31:39 +08:00
if (!this.isValidNode(options, name)) {
value = "[missing " + placeholder + " value]";
}
2020-03-13 02:07:38 +08:00
var regex = new RegExp(
placeholder.replace(/\{/gm, "\\{").replace(/\}/gm, "\\}")
);
2013-03-01 03:31:39 +08:00
message = message.replace(regex, value);
}
return message;
};
I18n.translate = function(scope, options) {
options = this.prepareOptions(options);
options.needsPluralization = typeof options.count === "number";
options.ignoreMissing = !this.noFallbacks;
2016-08-26 04:33:29 +08:00
var translation = this.findTranslation(scope, options);
if (!this.noFallbacks) {
if (!translation && this.fallbackLocale) {
options.locale = this.fallbackLocale;
translation = this.findTranslation(scope, options);
}
options.ignoreMissing = false;
if (!translation && this.currentLocale() !== this.defaultLocale) {
options.locale = this.defaultLocale;
translation = this.findTranslation(scope, options);
}
2020-03-13 02:07:38 +08:00
if (!translation && this.currentLocale() !== "en") {
options.locale = "en";
translation = this.findTranslation(scope, options);
}
}
2013-03-01 03:31:39 +08:00
try {
return this.interpolate(translation, options);
} catch (error) {
2013-03-01 03:31:39 +08:00
return this.missingTranslation(scope);
}
};
I18n.findTranslation = function(scope, options) {
var translation = this.lookup(scope, options);
if (translation && options.needsPluralization) {
translation = this.pluralize(translation, scope, options);
}
return translation;
};
2013-03-01 03:31:39 +08:00
I18n.toNumber = function(number, options) {
2020-03-13 02:07:38 +08:00
options = this.prepareOptions(options, this.lookup("number.format"), {
precision: 3,
separator: this.SEPARATOR,
delimiter: ",",
strip_insignificant_zeros: false
});
2013-03-01 03:31:39 +08:00
var negative = number < 0,
2020-03-13 02:07:38 +08:00
string = Math.abs(number)
.toFixed(options.precision)
.toString(),
parts = string.split(this.SEPARATOR),
buffer = [],
formattedNumber;
2013-03-01 03:31:39 +08:00
number = parts[0];
while (number.length > 0) {
buffer.unshift(number.substr(Math.max(0, number.length - 3), 3));
2020-03-13 02:07:38 +08:00
number = number.substr(0, number.length - 3);
2013-03-01 03:31:39 +08:00
}
formattedNumber = buffer.join(options.delimiter);
if (options.precision > 0) {
formattedNumber += options.separator + parts[1];
}
if (negative) {
formattedNumber = "-" + formattedNumber;
}
if (options.strip_insignificant_zeros) {
var regex = {
2020-03-13 02:07:38 +08:00
separator: new RegExp(options.separator.replace(/\./, "\\.") + "$"),
zeros: /0+$/
2013-03-01 03:31:39 +08:00
};
formattedNumber = formattedNumber
.replace(regex.zeros, "")
2020-03-13 02:07:38 +08:00
.replace(regex.separator, "");
2013-03-01 03:31:39 +08:00
}
return formattedNumber;
};
I18n.toHumanSize = function(number, options) {
var kb = 1024,
2020-03-13 02:07:38 +08:00
size = number,
iterations = 0,
unit,
precision;
2013-03-01 03:31:39 +08:00
while (size >= kb && iterations < 4) {
size = size / kb;
iterations += 1;
}
if (iterations === 0) {
2020-03-13 02:07:38 +08:00
unit = this.t("number.human.storage_units.units.byte", { count: size });
2013-03-01 03:31:39 +08:00
precision = 0;
} else {
2020-03-13 02:07:38 +08:00
unit = this.t(
"number.human.storage_units.units." +
[null, "kb", "mb", "gb", "tb"][iterations]
);
precision = size - Math.floor(size) === 0 ? 0 : 1;
2013-03-01 03:31:39 +08:00
}
2020-03-13 02:07:38 +08:00
options = this.prepareOptions(options, {
precision: precision,
format: this.t("number.human.storage_units.format"),
2020-03-13 02:07:38 +08:00
delimiter: ""
});
2013-03-01 03:31:39 +08:00
number = this.toNumber(size, options);
2020-03-13 02:07:38 +08:00
number = options.format.replace("%u", unit).replace("%n", number);
2013-03-01 03:31:39 +08:00
return number;
};
I18n.pluralizer = function(locale) {
2013-06-21 00:47:43 +08:00
var pluralizer = this.pluralizationRules[locale];
2013-03-01 03:31:39 +08:00
if (pluralizer !== undefined) return pluralizer;
return this.pluralizationRules["en"];
};
I18n.findAndTranslateValidNode = function(keys, translation) {
2013-06-21 00:47:43 +08:00
for (var i = 0; i < keys.length; i++) {
var key = keys[i];
2013-03-01 03:31:39 +08:00
if (this.isValidNode(translation, key)) return translation[key];
}
return null;
};
I18n.pluralize = function(translation, scope, options) {
if (typeof translation !== "object") return translation;
2013-03-01 03:31:39 +08:00
options = this.prepareOptions(options);
var count = options.count.toString();
2013-03-01 03:31:39 +08:00
var pluralizer = this.pluralizer(options.locale || this.currentLocale());
2013-06-21 00:47:43 +08:00
var key = pluralizer(Math.abs(count));
2020-03-13 02:07:38 +08:00
var keys = typeof key === "object" && key instanceof Array ? key : [key];
2013-03-01 03:31:39 +08:00
var message = this.findAndTranslateValidNode(keys, translation);
2013-03-01 03:31:39 +08:00
if (message !== null || options.ignoreMissing) {
return message;
}
return this.missingTranslation(scope, keys[0]);
2013-03-01 03:31:39 +08:00
};
I18n.missingTranslation = function(scope, key) {
2020-03-13 02:07:38 +08:00
var message = "[" + this.currentLocale() + this.SEPARATOR + scope;
if (key) {
message += this.SEPARATOR + key;
}
return message + "]";
2013-03-01 03:31:39 +08:00
};
I18n.currentLocale = function() {
return I18n.locale || I18n.defaultLocale;
2013-03-01 03:31:39 +08:00
};
I18n.enableVerboseLocalization = function() {
var counter = 0;
var keys = {};
var t = I18n.t;
I18n.noFallbacks = true;
2020-03-13 02:07:38 +08:00
I18n.t = I18n.translate = function(scope, value) {
var current = keys[scope];
if (!current) {
current = keys[scope] = ++counter;
var message = "Translation #" + current + ": " + scope;
if (value && Object.keys(value).length > 0) {
message += ", parameters: " + JSON.stringify(value);
}
// eslint-disable-next-line no-console
console.info(message);
}
return t.apply(I18n, [scope, value]) + " (#" + current + ")";
};
};
I18n.enableVerboseLocalizationSession = function() {
sessionStorage.setItem("verbose_localization", "true");
I18n.enableVerboseLocalization();
2020-03-13 02:07:38 +08:00
return "Verbose localization is enabled. Close the browser tab to turn it off. Reload the page to see the translation keys.";
};
2013-03-01 03:31:39 +08:00
// shortcuts
I18n.t = I18n.translate;