3 * Base language object with methods related to language support, attempting to mirror some of the
4 * functionality of the Language class in MediaWiki:
6 * - storing and retrieving language data
7 * - transforming message syntax (`{{PLURAL:}}`, `{{GRAMMAR:}}`, `{{GENDER:}}`)
15 * Language-related data (keyed by language, contains instances of mw.Map). Loaded dynamically
16 * (see ResourceLoaderLanguageDataModule in PHP docs, aka mediawiki.language.data module).
20 * // Override, extend or create the language data object of 'nl'
21 * mw.language.setData( 'nl', 'myKey', 'My value' );
23 * // Set multiple values at once
24 * mw.language.setData( 'nl', { foo: 'X', bar: 'Y' } );
26 * To get GrammarForms data for language 'nl':
28 * var grammarForms = mw.language.getData( 'nl', 'grammarForms' );
32 * - `digitTransformTable`
33 * - `separatorTransformTable`
36 * - `digitGroupingPattern`
43 * Convenience method for retrieving language data.
45 * Structured by language code and data key, covering for the potential inexistence of a
46 * data object for this language.
48 * @param {string} langCode
49 * @param {string} dataKey
50 * @return {Mixed} Value stored in the mw.Map (or `undefined` if there is no map for the specified
53 getData: function ( langCode
, dataKey
) {
54 var langData
= mw
.language
.data
;
55 if ( langData
&& langData
[langCode
] instanceof mw
.Map
) {
56 return langData
[langCode
].get( dataKey
);
62 * Convenience method for setting language data.
64 * Creates the data mw.Map if there isn't one for the specified language already.
66 * @param {string} langCode
67 * @param {string|Object} dataKey Key or object of key/values.
68 * @param {Mixed} value Value for dataKey, ignored if dataKey is an object.
70 setData: function ( langCode
, dataKey
, value
) {
71 var langData
= mw
.language
.data
;
72 if ( !( langData
[langCode
] instanceof mw
.Map
) ) {
73 langData
[langCode
] = new mw
.Map();
75 langData
[langCode
].set( dataKey
, value
);