mirror of
https://github.com/mozilla/gecko-dev.git
synced 2024-11-08 04:27:37 +00:00
84 lines
2.8 KiB
JavaScript
84 lines
2.8 KiB
JavaScript
|
/* This Source Code Form is subject to the terms of the Mozilla Public
|
||
|
|
* License, v. 2.0. If a copy of the MPL was not distributed with this
|
||
|
|
* file, You can obtain one at http://mozilla.org/MPL/2.0/. */
|
||
|
|
"use strict";
|
||
|
|
|
||
|
|
module.metadata = {
|
||
|
|
"stability": "stable"
|
||
|
|
};
|
||
|
|
|
||
|
|
const core = require("./l10n/core");
|
||
|
|
const { getRulesForLocale } = require("./l10n/plural-rules");
|
||
|
|
|
||
|
|
// Retrieve the plural mapping function
|
||
|
|
let pluralMappingFunction = getRulesForLocale(core.language()) ||
|
||
|
|
getRulesForLocale("en");
|
||
|
|
|
||
|
|
exports.get = function get(k) {
|
||
|
|
// For now, we only accept a "string" as first argument
|
||
|
|
// TODO: handle plural forms in gettext pattern
|
||
|
|
if (typeof k !== "string")
|
||
|
|
throw new Error("First argument of localization method should be a string");
|
||
|
|
|
||
|
|
// Get translation from big hashmap or default to hard coded string:
|
||
|
|
let localized = core.get(k) || k;
|
||
|
|
|
||
|
|
// # Simplest usecase:
|
||
|
|
// // String hard coded in source code:
|
||
|
|
// _("Hello world")
|
||
|
|
// // Identifier of a key stored in properties file
|
||
|
|
// _("helloString")
|
||
|
|
if (arguments.length <= 1)
|
||
|
|
return localized;
|
||
|
|
|
||
|
|
let args = arguments;
|
||
|
|
|
||
|
|
if (typeof localized == "object" && "other" in localized) {
|
||
|
|
// # Plural form:
|
||
|
|
// // Strings hard coded in source code:
|
||
|
|
// _(["One download", "%d downloads"], 10);
|
||
|
|
// // Identifier of a key stored in properties file
|
||
|
|
// _("downloadNumber", 0);
|
||
|
|
let n = arguments[1];
|
||
|
|
|
||
|
|
// First handle simple universal forms that may not be mandatory
|
||
|
|
// for each language, (i.e. not different than 'other' form,
|
||
|
|
// but still usefull for better phrasing)
|
||
|
|
// For example 0 in english is the same form than 'other'
|
||
|
|
// but we accept 'zero' form if specified in localization file
|
||
|
|
if (n === 0 && "zero" in localized)
|
||
|
|
localized = localized["zero"];
|
||
|
|
else if (n === 1 && "one" in localized)
|
||
|
|
localized = localized["one"];
|
||
|
|
else if (n === 2 && "two" in localized)
|
||
|
|
localized = localized["two"];
|
||
|
|
else {
|
||
|
|
let pluralForm = pluralMappingFunction(n);
|
||
|
|
if (pluralForm in localized)
|
||
|
|
localized = localized[pluralForm];
|
||
|
|
else // Fallback in case of error: missing plural form
|
||
|
|
localized = localized["other"];
|
||
|
|
}
|
||
|
|
|
||
|
|
// Simulate a string with one placeholder:
|
||
|
|
args = [null, n];
|
||
|
|
}
|
||
|
|
|
||
|
|
// # String with placeholders:
|
||
|
|
// // Strings hard coded in source code:
|
||
|
|
// _("Hello %s", username)
|
||
|
|
// // Identifier of a key stored in properties file
|
||
|
|
// _("helloString", username)
|
||
|
|
// * We supports `%1s`, `%2s`, ... pattern in order to change arguments order
|
||
|
|
// in translation.
|
||
|
|
// * In case of plural form, we has `%d` instead of `%s`.
|
||
|
|
let offset = 1;
|
||
|
|
localized = localized.replace(/%(\d*)(s|d)/g, function (v, n) {
|
||
|
|
let rv = args[n != "" ? n : offset];
|
||
|
|
offset++;
|
||
|
|
return rv;
|
||
|
|
});
|
||
|
|
|
||
|
|
return localized;
|
||
|
|
}
|