blob: 722988b5e1cd3badcc41cf14e47449445e06eca8 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
|
/* 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 style;
sequence<DOMString> keys;
};
[GenerateInit]
dictionary DisplayNameResult {
DOMString locale;
DOMString style;
record<DOMString, DOMString> values;
};
[GenerateInit]
dictionary LocaleInfo {
DOMString locale;
DOMString direction;
};
/**
* The IntlUtils interface provides helper functions for localization.
*/
[NoInterfaceObject,
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 two optional properties:
*
* keys:
* an Array of string values that are paths to individual terms
*
* style:
* a String with a value "long", "short" or "narrow"
*
* It returns an object with properties:
*
* locale:
* a negotiated locale string
*
* style:
* negotiated style
*
* values:
* a key-value pair list of requested keys and corresponding translated
* values
*
*/
[Throws]
DisplayNameResult getDisplayNames(sequence<DOMString> locales,
optional DisplayNameOptions options = {});
/**
* Helper function to retrieve useful information about a locale.
*
* The function takes one argument - locales which is a list of locale
* strings.
*
* It returns an object with properties:
*
* locale:
* a negotiated locale string
*
* direction:
* text direction, "ltr" or "rtl"
*
*/
[Throws]
LocaleInfo getLocaleInfo(sequence<DOMString> locales);
/**
* 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();
};
|
