X-Git-Url: https://scripts.mit.edu/gitweb/autoinstalls/mediawiki.git/blobdiff_plain/19e297c21b10b1b8a3acad5e73fc71dcb35db44a..6932310fd58ebef145fa01eb76edf7150284d8ea:/resources/mediawiki/mediawiki.js diff --git a/resources/mediawiki/mediawiki.js b/resources/mediawiki/mediawiki.js deleted file mode 100644 index 03f92844..00000000 --- a/resources/mediawiki/mediawiki.js +++ /dev/null @@ -1,1154 +0,0 @@ -/* - * JavaScript backwards-compatibility alternatives and other convenience functions - */ - -jQuery.extend({ - trimLeft : function( str ) { - return str == null ? '' : str.toString().replace( /^\s+/, '' ); - }, - trimRight : function( str ) { - return str == null ? - '' : str.toString().replace( /\s+$/, '' ); - }, - ucFirst : function( str ) { - return str.substr( 0, 1 ).toUpperCase() + str.substr( 1, str.length ); - }, - escapeRE : function( str ) { - return str.replace ( /([\\{}()\|.?*+-^$\[\]])/g, "\\$1" ); - }, - isEmpty : function( v ) { - var key; - if ( v === "" || v === 0 || v === "0" || v === null - || v === false || typeof v === 'undefined' ) - { - return true; - } - // the for-loop could potentially contain prototypes - // to avoid that we check it's length first - if ( v.length === 0 ) { - return true; - } - if ( typeof v === 'object' ) { - for ( key in v ) { - return false; - } - return true; - } - return false; - }, - compareArray : function( arrThis, arrAgainst ) { - if ( arrThis.length != arrAgainst.length ) { - return false; - } - for ( var i = 0; i < arrThis.length; i++ ) { - if ( arrThis[i] instanceof Array ) { - if ( !$.compareArray( arrThis[i], arrAgainst[i] ) ) { - return false; - } - } else if ( arrThis[i] !== arrAgainst[i] ) { - return false; - } - } - return true; - } -}); - -/* - * Core MediaWiki JavaScript Library - */ - -// Attach to window -window.mediaWiki = new ( function( $ ) { - - /* Constants */ - - // This will not change until we are 100% ready to turn off legacy globals - var LEGACY_GLOBALS = true; - - /* Private Members */ - - // List of messages that have been requested to be loaded - var messageQueue = {}; - - /* Prototypes */ - - /** - * An object which allows single and multiple get/set/exists functionality - * on a list of key / value pairs. - * - * @param {boolean} global Whether to get/set/exists values on the window - * object or a private object - */ - function Map( global ) { - this.values = ( global === true ) ? window : {}; - }; - - /** - * Gets the value of a key, or a list of key/value pairs for an array of keys. - * - * If called with no arguments, all values will be returned. - * - * @param selection mixed Key or array of keys to get values for - * @param fallback mixed Value to use in case key(s) do not exist (optional) - */ - Map.prototype.get = function( selection, fallback ) { - if ( typeof selection === 'object' ) { - selection = $.makeArray( selection ); - var results = {}; - for ( var i = 0; i < selection.length; i++ ) { - results[selection[i]] = this.get( selection[i], fallback ); - } - return results; - } else if ( typeof selection === 'string' ) { - if ( typeof this.values[selection] === 'undefined' ) { - if ( typeof fallback !== 'undefined' ) { - return fallback; - } - return null; - } - return this.values[selection]; - } - return this.values; - }; - - /** - * Sets one or multiple key/value pairs. - * - * @param selection mixed Key or object of key/value pairs to set - * @param value mixed Value to set (optional, only in use when key is a string) - */ - Map.prototype.set = function( selection, value ) { - if ( typeof selection === 'object' ) { - for ( var s in selection ) { - this.values[s] = selection[s]; - } - } else if ( typeof selection === 'string' && typeof value !== 'undefined' ) { - this.values[selection] = value; - } - }; - - /** - * Checks if one or multiple keys exist. - * - * @param selection mixed Key or array of keys to check - * @return boolean Existence of key(s) - */ - Map.prototype.exists = function( selection ) { - if ( typeof selection === 'object' ) { - for ( var s = 0; s < selection.length; s++ ) { - if ( !( selection[s] in this.values ) ) { - return false; - } - } - return true; - } else { - return selection in this.values; - } - }; - - /** - * Message object, similar to Message in PHP - */ - function Message( map, key, parameters ) { - this.format = 'parse'; - this.map = map; - this.key = key; - this.parameters = typeof parameters === 'undefined' ? [] : $.makeArray( parameters ); - }; - - /** - * Appends parameters for replacement - * - * @param parameters mixed First in a list of variadic arguments to append as message parameters - */ - Message.prototype.params = function( parameters ) { - for ( var i = 0; i < parameters.length; i++ ) { - this.parameters[this.parameters.length] = parameters[i]; - } - return this; - }; - - /** - * Converts message object to it's string form based on the state of format - * - * @return {string} String form of message - */ - Message.prototype.toString = function() { - if ( !this.map.exists( this.key ) ) { - // Return if key does not exist - return '<' + this.key + '>'; - } - var text = this.map.get( this.key ); - var parameters = this.parameters; - text = text.replace( /\$(\d+)/g, function( string, match ) { - var index = parseInt( match, 10 ) - 1; - return index in parameters ? parameters[index] : '$' + match; - } ); - /* This should be fixed up when we have a parser - if ( this.format === 'parse' && 'language' in mediaWiki ) { - text = mediaWiki.language.parse( text ); - } - */ - return text; - }; - - /** - * Changes format to parse and converts message to string - * - * @return {string} String form of parsed message - */ - Message.prototype.parse = function() { - this.format = 'parse'; - return this.toString(); - }; - - /** - * Changes format to plain and converts message to string - * - * @return {string} String form of plain message - */ - Message.prototype.plain = function() { - this.format = 'plain'; - return this.toString(); - }; - - /** - * Checks if message exists - * - * @return {string} String form of parsed message - */ - Message.prototype.exists = function() { - return this.map.exists( this.key ); - }; - - /** - * User object - */ - function User() { - this.options = new Map(); - - /* Public Methods */ - - /* - * Generates a random user session ID (32 alpha-numeric characters). - * - * This information would potentially be stored in a cookie to identify a user during a - * session or series of sessions. It's uniqueness should not be depended on. - * - * @return string random set of 32 alpha-numeric characters - */ - function generateId() { - var id = ''; - var seed = '0123456789ABCDEFGHIJKLMNOPQRSTUVWXTZabcdefghiklmnopqrstuvwxyz'; - for ( var i = 0, r; i < 32; i++ ) { - r = Math.floor( Math.random() * seed.length ); - id += seed.substring( r, r + 1 ); - } - return id; - } - - /* - * Gets the current user's name. - * - * @return mixed user name string or null if users is anonymous - */ - this.name = function() { - return mediaWiki.config.get( 'wgUserName' ); - }; - - /* - * Gets a random session ID automatically generated and kept in a cookie. - * - * This ID is ephemeral for everyone, staying in their browser only until they close - * their browser. - * - * Do not use this method before the first call to mediaWiki.loader.go(), it depends on - * jquery.cookie, which is added to the first pay-load just after mediaWiki is defined, but - * won't be loaded until the first call to go(). - * - * @return string user name or random session ID - */ - this.sessionId = function () { - var sessionId = $.cookie( 'mediaWiki.user.sessionId' ); - if ( typeof sessionId == 'undefined' || sessionId == null ) { - sessionId = generateId(); - $.cookie( 'mediaWiki.user.sessionId', sessionId, { 'expires': null, 'path': '/' } ); - } - return sessionId; - }; - - /* - * Gets the current user's name or a random ID automatically generated and kept in a cookie. - * - * This ID is persistent for anonymous users, staying in their browser up to 1 year. The - * expiration time is reset each time the ID is queried, so in most cases this ID will - * persist until the browser's cookies are cleared or the user doesn't visit for 1 year. - * - * Do not use this method before the first call to mediaWiki.loader.go(), it depends on - * jquery.cookie, which is added to the first pay-load just after mediaWiki is defined, but - * won't be loaded until the first call to go(). - * - * @return string user name or random session ID - */ - this.id = function() { - var name = that.name(); - if ( name ) { - return name; - } - var id = $.cookie( 'mediaWiki.user.id' ); - if ( typeof id == 'undefined' || id == null ) { - id = generateId(); - } - // Set cookie if not set, or renew it if already set - $.cookie( 'mediaWiki.user.id', id, { 'expires': 365, 'path': '/' } ); - return id; - }; - } - - /* Public Members */ - - /* - * Dummy function which in debug mode can be replaced with a function that - * does something clever - */ - this.log = function() { }; - - /* - * List of configuration values - * - * In legacy mode the values this object wraps will be in the global space - */ - this.config = new Map( LEGACY_GLOBALS ); - - /* - * Information about the current user - */ - this.user = new User(); - - /* - * Localization system - */ - this.messages = new Map(); - - /* Public Methods */ - - /** - * Gets a message object, similar to wfMessage() - * - * @param key string Key of message to get - * @param parameters mixed First argument in a list of variadic arguments, each a parameter for $ - * replacement - */ - this.message = function( key, parameters ) { - // Support variadic arguments - if ( typeof parameters !== 'undefined' ) { - parameters = $.makeArray( arguments ); - parameters.shift(); - } else { - parameters = []; - } - return new Message( mediaWiki.messages, key, parameters ); - }; - - /** - * Gets a message string, similar to wfMsg() - * - * @param key string Key of message to get - * @param parameters mixed First argument in a list of variadic arguments, each a parameter for $ - * replacement - */ - this.msg = function( key, parameters ) { - return mediaWiki.message.apply( mediaWiki.message, arguments ).toString(); - }; - - /** - * Client-side module loader which integrates with the MediaWiki ResourceLoader - */ - this.loader = new ( function() { - - /* Private Members */ - - /** - * Mapping of registered modules - * - * The jquery module is pre-registered, because it must have already - * been provided for this object to have been built, and in debug mode - * jquery would have been provided through a unique loader request, - * making it impossible to hold back registration of jquery until after - * mediawiki. - * - * Format: - * { - * 'moduleName': { - * 'dependencies': ['required module', 'required module', ...], (or) function() {} - * 'state': 'registered', 'loading', 'loaded', 'ready', or 'error' - * 'script': function() {}, - * 'style': 'css code string', - * 'messages': { 'key': 'value' }, - * 'version': ############## (unix timestamp) - * } - * } - */ - var registry = {}; - // List of modules which will be loaded as when ready - var batch = []; - // List of modules to be loaded - var queue = []; - // List of callback functions waiting for modules to be ready to be called - var jobs = []; - // Flag indicating that requests should be suspended - var suspended = true; - // Flag inidicating that document ready has occured - var ready = false; - // Marker element for adding dynamic styles - var $marker = $( 'head meta[name=ResourceLoaderDynamicStyles]' ); - - /* Private Methods */ - - function compare( a, b ) { - if ( a.length != b.length ) { - return false; - } - for ( var i = 0; i < b.length; i++ ) { - if ( $.isArray( a[i] ) ) { - if ( !compare( a[i], b[i] ) ) { - return false; - } - } - if ( a[i] !== b[i] ) { - return false; - } - } - return true; - }; - - /** - * Generates an ISO8601 "basic" string from a UNIX timestamp - */ - function formatVersionNumber( timestamp ) { - function pad( a, b, c ) { - return [a < 10 ? '0' + a : a, b < 10 ? '0' + b : b, c < 10 ? '0' + c : c].join( '' ); - } - var d = new Date(); - d.setTime( timestamp * 1000 ); - return [ - pad( d.getUTCFullYear(), d.getUTCMonth() + 1, d.getUTCDate() ), 'T', - pad( d.getUTCHours(), d.getUTCMinutes(), d.getUTCSeconds() ), 'Z' - ].join( '' ); - } - - /** - * Recursively resolves dependencies and detects circular references - */ - function recurse( module, resolved, unresolved ) { - if ( typeof registry[module] === 'undefined' ) { - throw new Error( 'Unknown dependency: ' + module ); - } - // Resolves dynamic loader function and replaces it with its own results - if ( typeof registry[module].dependencies === 'function' ) { - registry[module].dependencies = registry[module].dependencies(); - // Ensures the module's dependencies are always in an array - if ( typeof registry[module].dependencies !== 'object' ) { - registry[module].dependencies = [registry[module].dependencies]; - } - } - // Tracks down dependencies - for ( var n = 0; n < registry[module].dependencies.length; n++ ) { - if ( $.inArray( registry[module].dependencies[n], resolved ) === -1 ) { - if ( $.inArray( registry[module].dependencies[n], unresolved ) !== -1 ) { - throw new Error( - 'Circular reference detected: ' + module + - ' -> ' + registry[module].dependencies[n] - ); - } - recurse( registry[module].dependencies[n], resolved, unresolved ); - } - } - resolved[resolved.length] = module; - unresolved.splice( $.inArray( module, unresolved ), 1 ); - } - - /** - * Gets a list of module names that a module depends on in their proper dependency order - * - * @param module string module name or array of string module names - * @return list of dependencies - * @throws Error if circular reference is detected - */ - function resolve( module, resolved, unresolved ) { - // Allow calling with an array of module names - if ( typeof module === 'object' ) { - var modules = []; - for ( var m = 0; m < module.length; m++ ) { - var dependencies = resolve( module[m] ); - for ( var n = 0; n < dependencies.length; n++ ) { - modules[modules.length] = dependencies[n]; - } - } - return modules; - } else if ( typeof module === 'string' ) { - // Undefined modules have no dependencies - if ( !( module in registry ) ) { - return []; - } - var resolved = []; - recurse( module, resolved, [] ); - return resolved; - } - throw new Error( 'Invalid module argument: ' + module ); - }; - - /** - * Narrows a list of module names down to those matching a specific - * state. Possible states are 'undefined', 'registered', 'loading', - * 'loaded', or 'ready' - * - * @param states string or array of strings of module states to filter by - * @param modules array list of module names to filter (optional, all modules - * will be used by default) - * @return array list of filtered module names - */ - function filter( states, modules ) { - // Allow states to be given as a string - if ( typeof states === 'string' ) { - states = [states]; - } - // If called without a list of modules, build and use a list of all modules - var list = []; - if ( typeof modules === 'undefined' ) { - modules = []; - for ( module in registry ) { - modules[modules.length] = module; - } - } - // Build a list of modules which are in one of the specified states - for ( var s = 0; s < states.length; s++ ) { - for ( var m = 0; m < modules.length; m++ ) { - if ( typeof registry[modules[m]] === 'undefined' ) { - // Module does not exist - if ( states[s] == 'undefined' ) { - // OK, undefined - list[list.length] = modules[m]; - } - } else { - // Module exists, check state - if ( registry[modules[m]].state === states[s] ) { - // OK, correct state - list[list.length] = modules[m]; - } - } - } - } - return list; - } - - /** - * Executes a loaded module, making it ready to use - * - * @param module string module name to execute - */ - function execute( module ) { - if ( typeof registry[module] === 'undefined' ) { - throw new Error( 'Module has not been registered yet: ' + module ); - } else if ( registry[module].state === 'registered' ) { - throw new Error( 'Module has not been requested from the server yet: ' + module ); - } else if ( registry[module].state === 'loading' ) { - throw new Error( 'Module has not completed loading yet: ' + module ); - } else if ( registry[module].state === 'ready' ) { - throw new Error( 'Module has already been loaded: ' + module ); - } - // Add style sheet to document - if ( typeof registry[module].style === 'string' && registry[module].style.length ) { - $marker.before( mediaWiki.html.element( 'style', - { type: 'text/css' }, - new mediaWiki.html.Cdata( registry[module].style ) - ) ); - } else if ( typeof registry[module].style === 'object' - && !( registry[module].style instanceof Array ) ) - { - for ( var media in registry[module].style ) { - $marker.before( mediaWiki.html.element( 'style', - { type: 'text/css', media: media }, - new mediaWiki.html.Cdata( registry[module].style[media] ) - ) ); - } - } - // Add localizations to message system - if ( typeof registry[module].messages === 'object' ) { - mediaWiki.messages.set( registry[module].messages ); - } - // Execute script - try { - registry[module].script( jQuery, mediaWiki ); - registry[module].state = 'ready'; - // Run jobs who's dependencies have just been met - for ( var j = 0; j < jobs.length; j++ ) { - if ( compare( - filter( 'ready', jobs[j].dependencies ), - jobs[j].dependencies ) ) - { - if ( typeof jobs[j].ready === 'function' ) { - jobs[j].ready(); - } - jobs.splice( j, 1 ); - j--; - } - } - // Execute modules who's dependencies have just been met - for ( r in registry ) { - if ( registry[r].state == 'loaded' ) { - if ( compare( - filter( ['ready'], registry[r].dependencies ), - registry[r].dependencies ) ) - { - execute( r ); - } - } - } - } catch ( e ) { - mediaWiki.log( 'Exception thrown by ' + module + ': ' + e.message ); - mediaWiki.log( e ); - registry[module].state = 'error'; - // Run error callbacks of jobs affected by this condition - for ( var j = 0; j < jobs.length; j++ ) { - if ( $.inArray( module, jobs[j].dependencies ) !== -1 ) { - if ( typeof jobs[j].error === 'function' ) { - jobs[j].error(); - } - jobs.splice( j, 1 ); - j--; - } - } - } - } - - /** - * Adds a dependencies to the queue with optional callbacks to be run - * when the dependencies are ready or fail - * - * @param dependencies string module name or array of string module names - * @param ready function callback to execute when all dependencies are ready - * @param error function callback to execute when any dependency fails - */ - function request( dependencies, ready, error ) { - // Allow calling by single module name - if ( typeof dependencies === 'string' ) { - dependencies = [dependencies]; - if ( dependencies[0] in registry ) { - for ( var n = 0; n < registry[dependencies[0]].dependencies.length; n++ ) { - dependencies[dependencies.length] = - registry[dependencies[0]].dependencies[n]; - } - } - } - // Add ready and error callbacks if they were given - if ( arguments.length > 1 ) { - jobs[jobs.length] = { - 'dependencies': filter( - ['undefined', 'registered', 'loading', 'loaded'], - dependencies ), - 'ready': ready, - 'error': error - }; - } - // Queue up any dependencies that are undefined or registered - dependencies = filter( ['undefined', 'registered'], dependencies ); - for ( var n = 0; n < dependencies.length; n++ ) { - if ( $.inArray( dependencies[n], queue ) === -1 ) { - queue[queue.length] = dependencies[n]; - } - } - // Work the queue - mediaWiki.loader.work(); - } - - function sortQuery(o) { - var sorted = {}, key, a = []; - for ( key in o ) { - if ( o.hasOwnProperty( key ) ) { - a.push( key ); - } - } - a.sort(); - for ( key = 0; key < a.length; key++ ) { - sorted[a[key]] = o[a[key]]; - } - return sorted; - } - - /** - * Converts a module map of the form { foo: [ 'bar', 'baz' ], bar: [ 'baz, 'quux' ] } - * to a query string of the form foo.bar,baz|bar.baz,quux - */ - function buildModulesString( moduleMap ) { - var arr = []; - for ( var prefix in moduleMap ) { - var p = prefix === '' ? '' : prefix + '.'; - arr.push( p + moduleMap[prefix].join( ',' ) ); - } - return arr.join( '|' ); - } - - - /* Public Methods */ - - /** - * Requests dependencies from server, loading and executing when things when ready. - */ - this.work = function() { - // Appends a list of modules to the batch - for ( var q = 0; q < queue.length; q++ ) { - // Only request modules which are undefined or registered - if ( !( queue[q] in registry ) || registry[queue[q]].state == 'registered' ) { - // Prevent duplicate entries - if ( $.inArray( queue[q], batch ) === -1 ) { - batch[batch.length] = queue[q]; - // Mark registered modules as loading - if ( queue[q] in registry ) { - registry[queue[q]].state = 'loading'; - } - } - } - } - // Clean up the queue - queue = []; - // After document ready, handle the batch - if ( !suspended && batch.length ) { - // Always order modules alphabetically to help reduce cache - // misses for otherwise identical content - batch.sort(); - // Build a list of request parameters - var base = { - 'skin': mediaWiki.config.get( 'skin' ), - 'lang': mediaWiki.config.get( 'wgUserLanguage' ), - 'debug': mediaWiki.config.get( 'debug' ) - }; - // Extend request parameters with a list of modules in the batch - var requests = []; - // Split into groups - var groups = {}; - for ( var b = 0; b < batch.length; b++ ) { - var group = registry[batch[b]].group; - if ( !( group in groups ) ) { - groups[group] = []; - } - groups[group][groups[group].length] = batch[b]; - } - for ( var group in groups ) { - // Calculate the highest timestamp - var version = 0; - for ( var g = 0; g < groups[group].length; g++ ) { - if ( registry[groups[group][g]].version > version ) { - version = registry[groups[group][g]].version; - } - } - var reqBase = $.extend( { 'version': formatVersionNumber( version ) }, base ); - var reqBaseLength = $.param( reqBase ).length; - var reqs = []; - var limit = mw.config.get( 'wgResourceLoaderMaxQueryLength', -1 ); - // We may need to split up the request to honor the query string length limit - // So build it piece by piece - var l = reqBaseLength + 9; // '&modules='.length == 9 - var r = 0; - reqs[0] = {}; // { prefix: [ suffixes ] } - for ( var i = 0; i < groups[group].length; i++ ) { - // Determine how many bytes this module would add to the query string - var lastDotIndex = groups[group][i].lastIndexOf( '.' ); - // Note that these substr() calls work even if lastDotIndex == -1 - var prefix = groups[group][i].substr( 0, lastDotIndex ); - var suffix = groups[group][i].substr( lastDotIndex + 1 ); - var bytesAdded = prefix in reqs[r] ? - suffix.length + 3 : // '%2C'.length == 3 - groups[group][i].length + 3; // '%7C'.length == 3 - - // If the request would become too long, create a new one, - // but don't create empty requests - if ( limit > 0 && reqs[r] != {} && l + bytesAdded > limit ) { - // This request would become too long, create a new one - r++; - reqs[r] = {}; - l = reqBaseLength + 9; - } - if ( !( prefix in reqs[r] ) ) { - reqs[r][prefix] = []; - } - reqs[r][prefix].push( suffix ); - l += bytesAdded; - } - for ( var r = 0; r < reqs.length; r++ ) { - requests[requests.length] = $.extend( - { 'modules': buildModulesString( reqs[r] ) }, reqBase - ); - } - } - // Clear the batch - this MUST happen before we append the - // script element to the body or it's possible that the script - // will be locally cached, instantly load, and work the batch - // again, all before we've cleared it causing each request to - // include modules which are already loaded - batch = []; - // Asynchronously append a script tag to the end of the body - function request() { - var html = ''; - for ( var r = 0; r < requests.length; r++ ) { - requests[r] = sortQuery( requests[r] ); - // Build out the HTML - var src = mediaWiki.config.get( 'wgLoadScript' ) + '?' + $.param( requests[r] ); - html += mediaWiki.html.element( 'script', - { type: 'text/javascript', src: src }, '' ); - } - return html; - } - // Load asynchronously after doumument ready - if ( ready ) { - setTimeout( function() { $( 'body' ).append( request() ); }, 0 ) - } else { - document.write( request() ); - } - } - }; - - /** - * Registers a module, letting the system know about it and its - * dependencies. loader.js files contain calls to this function. - */ - this.register = function( module, version, dependencies, group ) { - // Allow multiple registration - if ( typeof module === 'object' ) { - for ( var m = 0; m < module.length; m++ ) { - if ( typeof module[m] === 'string' ) { - mediaWiki.loader.register( module[m] ); - } else if ( typeof module[m] === 'object' ) { - mediaWiki.loader.register.apply( mediaWiki.loader, module[m] ); - } - } - return; - } - // Validate input - if ( typeof module !== 'string' ) { - throw new Error( 'module must be a string, not a ' + typeof module ); - } - if ( typeof registry[module] !== 'undefined' ) { - throw new Error( 'module already implemeneted: ' + module ); - } - // List the module as registered - registry[module] = { - 'state': 'registered', - 'group': typeof group === 'string' ? group : null, - 'dependencies': [], - 'version': typeof version !== 'undefined' ? parseInt( version ) : 0 - }; - if ( typeof dependencies === 'string' ) { - // Allow dependencies to be given as a single module name - registry[module].dependencies = [dependencies]; - } else if ( typeof dependencies === 'object' || typeof dependencies === 'function' ) { - // Allow dependencies to be given as an array of module names - // or a function which returns an array - registry[module].dependencies = dependencies; - } - }; - - /** - * Implements a module, giving the system a course of action to take - * upon loading. Results of a request for one or more modules contain - * calls to this function. - */ - this.implement = function( module, script, style, localization ) { - // Automatically register module - if ( typeof registry[module] === 'undefined' ) { - mediaWiki.loader.register( module ); - } - // Validate input - if ( typeof script !== 'function' ) { - throw new Error( 'script must be a function, not a ' + typeof script ); - } - if ( typeof style !== 'undefined' - && typeof style !== 'string' - && typeof style !== 'object' ) - { - throw new Error( 'style must be a string or object, not a ' + typeof style ); - } - if ( typeof localization !== 'undefined' - && typeof localization !== 'object' ) - { - throw new Error( 'localization must be an object, not a ' + typeof localization ); - } - if ( typeof registry[module] !== 'undefined' - && typeof registry[module].script !== 'undefined' ) - { - throw new Error( 'module already implemeneted: ' + module ); - } - // Mark module as loaded - registry[module].state = 'loaded'; - // Attach components - registry[module].script = script; - if ( typeof style === 'string' - || typeof style === 'object' && !( style instanceof Array ) ) - { - registry[module].style = style; - } - if ( typeof localization === 'object' ) { - registry[module].messages = localization; - } - // Execute or queue callback - if ( compare( - filter( ['ready'], registry[module].dependencies ), - registry[module].dependencies ) ) - { - execute( module ); - } else { - request( module ); - } - }; - - /** - * Executes a function as soon as one or more required modules are ready - * - * @param dependencies string or array of strings of modules names the callback - * dependencies to be ready before - * executing - * @param ready function callback to execute when all dependencies are ready (optional) - * @param error function callback to execute when if dependencies have a errors (optional) - */ - this.using = function( dependencies, ready, error ) { - // Validate input - if ( typeof dependencies !== 'object' && typeof dependencies !== 'string' ) { - throw new Error( 'dependencies must be a string or an array, not a ' + - typeof dependencies ) - } - // Allow calling with a single dependency as a string - if ( typeof dependencies === 'string' ) { - dependencies = [dependencies]; - } - // Resolve entire dependency map - dependencies = resolve( dependencies ); - // If all dependencies are met, execute ready immediately - if ( compare( filter( ['ready'], dependencies ), dependencies ) ) { - if ( typeof ready === 'function' ) { - ready(); - } - } - // If any dependencies have errors execute error immediately - else if ( filter( ['error'], dependencies ).length ) { - if ( typeof error === 'function' ) { - error(); - } - } - // Since some dependencies are not yet ready, queue up a request - else { - request( dependencies, ready, error ); - } - }; - - /** - * Loads an external script or one or more modules for future use - * - * @param modules mixed either the name of a module, array of modules, - * or a URL of an external script or style - * @param type string mime-type to use if calling with a URL of an - * external script or style; acceptable values are "text/css" and - * "text/javascript"; if no type is provided, text/javascript is - * assumed - */ - this.load = function( modules, type ) { - // Validate input - if ( typeof modules !== 'object' && typeof modules !== 'string' ) { - throw new Error( 'dependencies must be a string or an array, not a ' + - typeof dependencies ) - } - // Allow calling with an external script or single dependency as a string - if ( typeof modules === 'string' ) { - // Support adding arbitrary external scripts - if ( modules.substr( 0, 7 ) == 'http://' || modules.substr( 0, 8 ) == 'https://' ) { - if ( type === 'text/css' ) { - $( 'head' ) - .append( $( '' ) - .attr( 'href', modules ) ); - return true; - } else if ( type === 'text/javascript' || typeof type === 'undefined' ) { - var script = mediaWiki.html.element( 'script', - { type: 'text/javascript', src: modules }, '' ); - if ( ready ) { - $( 'body' ).append( script ); - } else { - document.write( script ); - } - return true; - } - // Unknown type - return false; - } - // Called with single module - modules = [modules]; - } - // Resolve entire dependency map - modules = resolve( modules ); - // If all modules are ready, nothing dependency be done - if ( compare( filter( ['ready'], modules ), modules ) ) { - return true; - } - // If any modules have errors return false - else if ( filter( ['error'], modules ).length ) { - return false; - } - // Since some modules are not yet ready, queue up a request - else { - request( modules ); - return true; - } - }; - - /** - * Flushes the request queue and begin executing load requests on demand - */ - this.go = function() { - suspended = false; - mediaWiki.loader.work(); - }; - - /** - * Changes the state of a module - * - * @param module string module name or object of module name/state pairs - * @param state string state name - */ - this.state = function( module, state ) { - if ( typeof module === 'object' ) { - for ( var m in module ) { - mediaWiki.loader.state( m, module[m] ); - } - return; - } - if ( !( module in registry ) ) { - mediaWiki.loader.register( module ); - } - registry[module].state = state; - }; - - /** - * Gets the version of a module - * - * @param module string name of module to get version for - */ - this.version = function( module ) { - if ( module in registry && 'version' in registry[module] ) { - return formatVersionNumber( registry[module].version ); - } - return null; - }; - - /* Cache document ready status */ - - $(document).ready( function() { ready = true; } ); - } )(); - - /** HTML construction helper functions */ - this.html = new ( function () { - function escapeCallback( s ) { - switch ( s ) { - case "'": - return '''; - case '"': - return '"'; - case '<': - return '<'; - case '>': - return '>'; - case '&': - return '&'; - } - } - - /** - * Escape a string for HTML. Converts special characters to HTML entities. - * @param s The string to escape - */ - this.escape = function( s ) { - return s.replace( /['"<>&]/g, escapeCallback ); - }; - - /** - * Wrapper object for raw HTML passed to mediaWiki.html.element(). - */ - this.Raw = function( value ) { - this.value = value; - }; - - /** - * Wrapper object for CDATA element contents passed to mediaWiki.html.element() - */ - this.Cdata = function( value ) { - this.value = value; - }; - - /** - * Create an HTML element string, with safe escaping. - * - * @param name The tag name. - * @param attrs An object with members mapping element names to values - * @param contents The contents of the element. May be either: - * - string: The string is escaped. - * - null or undefined: The short closing form is used, e.g.
. - * - this.Raw: The value attribute is included without escaping. - * - this.Cdata: The value attribute is included, and an exception is - * thrown if it contains an illegal ETAGO delimiter. - * See http://www.w3.org/TR/1999/REC-html401-19991224/appendix/notes.html#h-B.3.2 - * - * Example: - * var h = mediaWiki.html; - * return h.element( 'div', {}, - * new h.Raw( h.element( 'img', {src: '<'} ) ) ); - * Returns
- */ - this.element = function( name, attrs, contents ) { - var s = '<' + name; - for ( var attrName in attrs ) { - s += ' ' + attrName + '="' + this.escape( attrs[attrName] ) + '"'; - } - if ( typeof contents == 'undefined' || contents === null ) { - // Self close tag - s += '/>'; - return s; - } - // Regular open tag - s += '>'; - if ( typeof contents === 'string') { - // Escaped - s += this.escape( contents ); - } else if ( contents instanceof this.Raw ) { - // Raw HTML inclusion - s += contents.value; - } else if ( contents instanceof this.Cdata ) { - // CDATA - if ( /<\/[a-zA-z]/.test( contents.value ) ) { - throw new Error( 'mw.html.element: Illegal end tag found in CDATA' ); - } - s += contents.value; - } else { - throw new Error( 'mw.html.element: Invalid type of contents' ); - } - s += ''; - return s; - }; - } )(); - - - /* Extension points */ - - this.legacy = {}; - -} )( jQuery ); - -/* Auto-register from pre-loaded startup scripts */ - -if ( typeof startUp === 'function' ) { - startUp(); - delete startUp; -} - -// Add jQuery Cookie to initial payload (used in mediaWiki.user) -mediaWiki.loader.load( 'jquery.cookie' ); - -// Alias $j to jQuery for backwards compatibility -window.$j = jQuery; -window.mw = mediaWiki;