64 lines
2 KiB
JavaScript
64 lines
2 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";
|
|
|
|
const FluentReact = require("resource://devtools/client/shared/vendor/fluent-react.js");
|
|
|
|
/**
|
|
* Wrapper over FluentReact. It encapsulates instantiation of the localization
|
|
* bundles, and offers a simpler way of accessing `getString`.
|
|
*/
|
|
class FluentL10n {
|
|
/**
|
|
* Initializes the wrapper, generating the bundles for the given resource ids.
|
|
* It can optionally add the right attributes to the document element.
|
|
* @param {Array} resourceIds
|
|
* @param {Object} [options]
|
|
* @param {boolean} [options.setAttributesOnDocument]
|
|
*/
|
|
async init(resourceIds, { setAttributesOnDocument } = {}) {
|
|
if (setAttributesOnDocument) {
|
|
const primaryLocale = Services.locale.appLocalesAsBCP47[0];
|
|
document.documentElement.setAttribute("lang", primaryLocale);
|
|
const direction = Services.locale.isAppLocaleRTL ? "rtl" : "ltr";
|
|
document.documentElement.setAttribute("dir", direction);
|
|
}
|
|
|
|
const locales = Services.locale.appLocalesAsBCP47;
|
|
const generator = L10nRegistry.getInstance().generateBundles(
|
|
locales,
|
|
resourceIds
|
|
);
|
|
|
|
this._bundles = [];
|
|
for await (const bundle of generator) {
|
|
this._bundles.push(bundle);
|
|
}
|
|
this._reactLocalization = new FluentReact.ReactLocalization(this._bundles);
|
|
}
|
|
|
|
/**
|
|
* Returns the fluent bundles generated.
|
|
*/
|
|
getBundles() {
|
|
return this._bundles;
|
|
}
|
|
|
|
/**
|
|
* Returns the localized string for the provided id, formatted using args.
|
|
*/
|
|
getString(...args) {
|
|
// Forward arguments via .apply() so that the original method can:
|
|
// - perform asserts based on the number of arguments
|
|
// - add new arguments
|
|
return this._reactLocalization.getString.apply(
|
|
this._reactLocalization,
|
|
args
|
|
);
|
|
}
|
|
}
|
|
|
|
// Export the class
|
|
exports.FluentL10n = FluentL10n;
|