Page MenuHomeWickedGov Phorge
Files F1431437

mediawiki.language.init.js
No OneTemporary
Actions

Size
2 KB
Referenced Files
None
Subscribers
None

mediawiki.language.init.js
View Options

( function () {
/**
* Methods for transforming message syntax.
*
* Base language object with methods related to language support, attempting to mirror some of the
* functionality of the Language class in MediaWiki:
*
* - storing and retrieving language data
* - transforming message syntax (`{{PLURAL:}}`, `{{GRAMMAR:}}`,
* `{{GENDER:}}`, `{{#FORMAL:}}`)
* - formatting numbers
*
* @namespace mw.language
* @singleton
*/
mw.language = {
/**
* Language-related data (keyed by language, contains instances of mw.Map).
*
* Exported dynamically by the ResourceLoader\LanguageDataModule class in PHP.
*
* To set data:
* ```
* // Override, extend or create the language data object of 'nl'
* mw.language.setData( 'nl', 'myKey', 'My value' );
*
* // Set multiple key/values pairs at once
* mw.language.setData( 'nl', { foo: 'X', bar: 'Y' } );
* ```
*
* To get GrammarForms data for language 'nl':
* ```
* var grammarForms = mw.language.getData( 'nl', 'grammarForms' );
* ```
*
* Possible data keys:
*
* - `digitTransformTable`
* - `separatorTransformTable`
* - `minimumGroupingDigits`
* - `formalityIndex`
* - `grammarForms`
* - `pluralRules`
* - `digitGroupingPattern`
* - `fallbackLanguages`
* - `bcp47Map`
* - `languageNames`
*
* @type {Object}
*/
data: {},
/**
* Convenience method for retrieving language data.
*
* Structured by language code and data key, covering for the potential inexistence of a
* data object for this language.
*
* @param {string} langCode
* @param {string} dataKey
* @return {any} Value stored in the mw.Map (or `undefined` if there is no map for the
* specified langCode)
*/
getData: function ( langCode, dataKey ) {
const langData = mw.language.data;
langCode = langCode.toLowerCase();
if ( langData && langData[ langCode ] instanceof mw.Map ) {
return langData[ langCode ].get( dataKey );
}
return undefined;
},
/**
* Convenience method for setting language data.
*
* Creates the data {@link mw.Map} if there isn't one for the specified language already.
*
* @param {string} langCode
* @param {string|Object} dataKey Key or object of key/values
* @param {any} [value] Value for dataKey, omit if dataKey is an object
*/
setData: function ( langCode, dataKey, value ) {
const langData = mw.language.data;
langCode = langCode.toLowerCase();
if ( !( langData[ langCode ] instanceof mw.Map ) ) {
langData[ langCode ] = new mw.Map();
}
if ( arguments.length > 2 ) {
langData[ langCode ].set( dataKey, value );
} else {
langData[ langCode ].set( dataKey );
}
}
};
}() );

File Metadata

Mime Type
text/plain
Expires
Sat, May 16, 20:28 (1 d, 5 h)
Storage Engine
local-disk
Storage Format
Raw Data
Storage Handle
89/22/0cfb9b050b953c4fee39fe52b41d
Default Alt Text
mediawiki.language.init.js (2 KB)

Event Timeline