Constructor
new ve.init.Platform()abstract
#
Children
Generic Initialization platform.
- Mixes in:
- Source:
Properties
addMessagesabstract
#
Add multiple messages to the localization system.
- Source:
addParsedMessagesabstract
#
Add multiple parsed messages to the localization system.
- Source:
createSafeStorageabstract
#
Create a safe storage object
- Source:
formatNumberabstract
#
For a number as a string
- Source:
getConfigabstract
#
Get a platform config value
- Source:
getExternalLinkUrlProtocolsRegExpabstract
#
Get an anchored regular expression that matches allowed external link URLs starting at the beginning of an input string.
- Source:
Get an anchored regular expression that matches allowed external link URLs starting at the beginning of an input string.
getHtmlMessageabstract
#
Get an HTML message from the localization system, with HTML or DOM arguments
- Source:
getLanguageAutonymabstract
#
Get a language's autonym from its code.
- Source:
getLanguageCodesabstract
#
Get a list of all language codes.
- Source:
getLanguageDirectionabstract
#
Get a language's direction from its code.
- Source:
getLanguageNameabstract
#
Get a language's name from its code, in the current user language if possible.
- Source:
getMediaSourcesabstract
#
Get a list of URL entry points where media can be found.
- Source:
getMessageabstract
#
Get a message from the localization system.
- Source:
getParsedMessageabstract
#
Get a parsed message as HTML string.
Does not support $# replacements.
- Source:
getUnanchoredExternalLinkUrlProtocolsRegExpabstract
#
Get an unanchored regular expression that matches allowed external link URLs anywhere in an input string.
- Source:
Get an unanchored regular expression that matches allowed external link URLs anywhere in an input string.
getUserConfigabstract
#
Get a user config value
- Source:
getUserLanguagesabstract
#
Get the user language and any fallback languages.
- Source:
notifyabstract
#
Show a read-only notification to the user.
- Source:
parseNumberabstract
#
Parse a string into a number
- Source:
setUserConfigabstract
#
Set a user config value
- Source:
deferredPlatformprivatestatic
#
A jQuery.Deferred that tracks when the platform has been created.
- Source:
initializedPromisestatic
#
A promise that tracks when ve.init.platform is ready for use. When this promise is resolved the platform will have been created and initialized.
This promise is safe to access early in VE startup before
ve.init.platform has been set.
Properties:
| Type | Description |
|---|---|
| jQuery.Promise |
- Source:
Methods
createConflictableStorage(safeStorage) → {ve.init.ConflictableStorage}
#
Create a list storage object from a safe storage object
Parameters:
| Name | Type | Description |
|---|---|---|
safeStorage |
ve.init.SafeStorage |
- Source:
Returns:
decodeEntities(html) → {string}
#
Decode HTML entities for insertion into the document
Parameters:
| Name | Type | Description |
|---|---|---|
html |
string | HTML string |
- Source:
Returns:
- Type
- string
fetchSpecialCharList() → {jQuery.Promise}
#
Fetch the special character list object
Returns a promise which resolves with the character list
- Source:
Returns:
- Type
- jQuery.Promise
Fetch the special character list object
Returns a promise which resolves with the character list
getInitializedPromise() → {jQuery.Promise}
#
Get a promise to track when the platform has initialized. The platform won't be ready for use until this promise is resolved.
Since the initialization only happens once, and the same (resolved) promise is returned when called again, and since the Platform instance is global (shared between different Target instances) it is important not to rely on this promise being asynchronous.
- Source:
Returns:
Promise that will be resolved once the platform is ready
- Type
- jQuery.Promise
getMetadataIdRegExp() → {RegExp|null}
#
null}
#
Get a regular expression that matches IDs used only for linking document data to metadata. Use null if your document format does not have such IDs.
- Source:
Returns:
Regular expression object
- Type
-
RegExp
|
null
Get a regular expression that matches IDs used only for linking document data to metadata.
getUserName() → {string|null}
#
null}
#
Get the current user's name, if the platform supports it
- Source:
Returns:
User name, or null if not applicable
- Type
-
string
|
null
hasLanguageCode(code) → {boolean}
#
Check if a language code is known to this platform.
Parameters:
| Name | Type | Description |
|---|---|---|
code |
string | Language code |
- Source:
Returns:
Language code is known
- Type
- boolean
initialize() → {jQuery.Promise}private
#
Initialize the platform. The default implementation is to do nothing and return a resolved promise. Subclasses should override this if they have asynchronous initialization work to do. The promise rejects if the platform is incompatible.
External callers should not call this. Instead, call #getInitializedPromise.
- Source:
Returns:
Promise that will be resolved once initialization is done
- Type
- jQuery.Promise
processSpecialCharSymbols(symbols) → {Array.<Object>}
#
Post-process the symbol list.
If a keyed object format is used, it is coverted to an array, and the label property is set from the key when required.
For individual symbols, turns the source property into a CSS class.
Parameters:
- Source:
Returns:
getSystemPlatform() → {string}static
#
Get client platform string from browser.
- Source:
Returns:
Client platform string
- Type
- string
isEdge() → {boolean}static
#
Check whether we are running in Edge.
- Source:
Returns:
We are in Edge
- Type
- boolean
isIos() → {boolean}static
#
Check whether we are running on iOS
- Source:
Returns:
We are running on iOS
- Type
- boolean