diff options
author | Daniel Baumann <daniel.baumann@progress-linux.org> | 2024-04-07 19:33:14 +0000 |
---|---|---|
committer | Daniel Baumann <daniel.baumann@progress-linux.org> | 2024-04-07 19:33:14 +0000 |
commit | 36d22d82aa202bb199967e9512281e9a53db42c9 (patch) | |
tree | 105e8c98ddea1c1e4784a60a5a6410fa416be2de /dom/webidl/IntlUtils.webidl | |
parent | Initial commit. (diff) | |
download | firefox-esr-36d22d82aa202bb199967e9512281e9a53db42c9.tar.xz firefox-esr-36d22d82aa202bb199967e9512281e9a53db42c9.zip |
Adding upstream version 115.7.0esr.upstream/115.7.0esr
Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>
Diffstat (limited to 'dom/webidl/IntlUtils.webidl')
-rw-r--r-- | dom/webidl/IntlUtils.webidl | 83 |
1 files changed, 83 insertions, 0 deletions
diff --git a/dom/webidl/IntlUtils.webidl b/dom/webidl/IntlUtils.webidl new file mode 100644 index 0000000000..1efa35c728 --- /dev/null +++ b/dom/webidl/IntlUtils.webidl @@ -0,0 +1,83 @@ +/* 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/. */ + +[GenerateConversionToJS] +dictionary DisplayNameOptions { + DOMString type; + DOMString style; + DOMString calendar; + sequence<DOMString> keys; +}; + +[GenerateInit] +dictionary DisplayNameResult { + DOMString locale; + DOMString type; + DOMString style; + DOMString calendar; + sequence<DOMString> values; +}; + +[GenerateInit] +dictionary LocaleInfo { + DOMString locale; + DOMString direction; +}; + +/** + * The IntlUtils interface provides helper functions for localization. + */ +[LegacyNoInterfaceObject, + Exposed=Window] +interface IntlUtils { + /** + * Helper function to retrieve the localized values for a list of requested + * keys. + * + * The function takes two arguments - locales which is a list of locale + * strings and options which is an object with four optional properties: + * + * keys: + * an Array of string values to localize + * + * type: + * a String with a value "language", "region", "script", "currency", + * "weekday", "month", "quarter", "dayPeriod", or "dateTimeField" + * + * style: + * a String with a value "long", "abbreviated", "short", or "narrow" + * + * calendar: + * a String to select a specific calendar type, e.g. "gregory" + * + * It returns an object with properties: + * + * locale: + * a negotiated locale string + * + * type: + * negotiated type + * + * style: + * negotiated style + * + * calendar: + * negotiated calendar + * + * values: + * a list of translated values for the requested keys + * + */ + [Throws] + DisplayNameResult getDisplayNames(sequence<DOMString> locales, + optional DisplayNameOptions options = {}); + + /** + * Helper function to determine if the current application locale is RTL. + * + * The result of this function can be overriden by this pref: + * - `intl.l10n.pseudo` + */ + boolean isAppLocaleRTL(); +}; |