+++ /dev/null
-/*\r
-Copyright (c) 2003-2013, CKSource - Frederico Knabben. All rights reserved.\r
-For licensing, see LICENSE.html or http://ckeditor.com/license\r
-*/\r
-\r
-/**\r
- * @fileOverview Defines the {@link CKEDITOR.resourceManager} class, which is\r
- * the base for resource managers, like plugins and themes.\r
- */\r
-\r
- /**\r
- * Base class for resource managers, like plugins and themes. This class is not\r
- * intended to be used out of the CKEditor core code.\r
- * @param {String} basePath The path for the resources folder.\r
- * @param {String} fileName The name used for resource files.\r
- * @namespace\r
- * @example\r
- */\r
-CKEDITOR.resourceManager = function( basePath, fileName )\r
-{\r
- /**\r
- * The base directory containing all resources.\r
- * @name CKEDITOR.resourceManager.prototype.basePath\r
- * @type String\r
- * @example\r
- */\r
- this.basePath = basePath;\r
-\r
- /**\r
- * The name used for resource files.\r
- * @name CKEDITOR.resourceManager.prototype.fileName\r
- * @type String\r
- * @example\r
- */\r
- this.fileName = fileName;\r
-\r
- /**\r
- * Contains references to all resources that have already been registered\r
- * with {@link #add}.\r
- * @name CKEDITOR.resourceManager.prototype.registered\r
- * @type Object\r
- * @example\r
- */\r
- this.registered = {};\r
-\r
- /**\r
- * Contains references to all resources that have already been loaded\r
- * with {@link #load}.\r
- * @name CKEDITOR.resourceManager.prototype.loaded\r
- * @type Object\r
- * @example\r
- */\r
- this.loaded = {};\r
-\r
- /**\r
- * Contains references to all resources that have already been registered\r
- * with {@link #addExternal}.\r
- * @name CKEDITOR.resourceManager.prototype.externals\r
- * @type Object\r
- * @example\r
- */\r
- this.externals = {};\r
-\r
- /**\r
- * @private\r
- */\r
- this._ =\r
- {\r
- // List of callbacks waiting for plugins to be loaded.\r
- waitingList : {}\r
- };\r
-};\r
-\r
-CKEDITOR.resourceManager.prototype =\r
-{\r
- /**\r
- * Registers a resource.\r
- * @param {String} name The resource name.\r
- * @param {Object} [definition] The resource definition.\r
- * @example\r
- * CKEDITOR.plugins.add( 'sample', { ... plugin definition ... } );\r
- * @see CKEDITOR.pluginDefinition\r
- */\r
- add : function( name, definition )\r
- {\r
- if ( this.registered[ name ] )\r
- throw '[CKEDITOR.resourceManager.add] The resource name "' + name + '" is already registered.';\r
-\r
- CKEDITOR.fire( name + CKEDITOR.tools.capitalize( this.fileName ) + 'Ready',\r
- this.registered[ name ] = definition || {} );\r
- },\r
-\r
- /**\r
- * Gets the definition of a specific resource.\r
- * @param {String} name The resource name.\r
- * @type Object\r
- * @example\r
- * var definition = <b>CKEDITOR.plugins.get( 'sample' )</b>;\r
- */\r
- get : function( name )\r
- {\r
- return this.registered[ name ] || null;\r
- },\r
-\r
- /**\r
- * Get the folder path for a specific loaded resource.\r
- * @param {String} name The resource name.\r
- * @type String\r
- * @example\r
- * alert( <b>CKEDITOR.plugins.getPath( 'sample' )</b> ); // "<editor path>/plugins/sample/"\r
- */\r
- getPath : function( name )\r
- {\r
- var external = this.externals[ name ];\r
- return CKEDITOR.getUrl( ( external && external.dir ) || this.basePath + name + '/' );\r
- },\r
-\r
- /**\r
- * Get the file path for a specific loaded resource.\r
- * @param {String} name The resource name.\r
- * @type String\r
- * @example\r
- * alert( <b>CKEDITOR.plugins.getFilePath( 'sample' )</b> ); // "<editor path>/plugins/sample/plugin.js"\r
- */\r
- getFilePath : function( name )\r
- {\r
- var external = this.externals[ name ];\r
- return CKEDITOR.getUrl(\r
- this.getPath( name ) +\r
- ( ( external && ( typeof external.file == 'string' ) ) ? external.file : this.fileName + '.js' ) );\r
- },\r
-\r
- /**\r
- * Registers one or more resources to be loaded from an external path\r
- * instead of the core base path.\r
- * @param {String} names The resource names, separated by commas.\r
- * @param {String} path The path of the folder containing the resource.\r
- * @param {String} [fileName] The resource file name. If not provided, the\r
- * default name is used; If provided with a empty string, will implicitly indicates that {@param path}\r
- * is already the full path.\r
- * @example\r
- * // Loads a plugin from '/myplugin/samples/plugin.js'.\r
- * CKEDITOR.plugins.addExternal( 'sample', '/myplugins/sample/' );\r
- * @example\r
- * // Loads a plugin from '/myplugin/samples/my_plugin.js'.\r
- * CKEDITOR.plugins.addExternal( 'sample', '/myplugins/sample/', 'my_plugin.js' );\r
- * @example\r
- * // Loads a plugin from '/myplugin/samples/my_plugin.js'.\r
- * CKEDITOR.plugins.addExternal( 'sample', '/myplugins/sample/my_plugin.js', '' );\r
- */\r
- addExternal : function( names, path, fileName )\r
- {\r
- names = names.split( ',' );\r
- for ( var i = 0 ; i < names.length ; i++ )\r
- {\r
- var name = names[ i ];\r
-\r
- this.externals[ name ] =\r
- {\r
- dir : path,\r
- file : fileName\r
- };\r
- }\r
- },\r
-\r
- /**\r
- * Loads one or more resources.\r
- * @param {String|Array} name The name of the resource to load. It may be a\r
- * string with a single resource name, or an array with several names.\r
- * @param {Function} callback A function to be called when all resources\r
- * are loaded. The callback will receive an array containing all\r
- * loaded names.\r
- * @param {Object} [scope] The scope object to be used for the callback\r
- * call.\r
- * @example\r
- * <b>CKEDITOR.plugins.load</b>( 'myplugin', function( plugins )\r
- * {\r
- * alert( plugins['myplugin'] ); // "object"\r
- * });\r
- */\r
- load : function( names, callback, scope )\r
- {\r
- // Ensure that we have an array of names.\r
- if ( !CKEDITOR.tools.isArray( names ) )\r
- names = names ? [ names ] : [];\r
-\r
- var loaded = this.loaded,\r
- registered = this.registered,\r
- urls = [],\r
- urlsNames = {},\r
- resources = {};\r
-\r
- // Loop through all names.\r
- for ( var i = 0 ; i < names.length ; i++ )\r
- {\r
- var name = names[ i ];\r
-\r
- if ( !name )\r
- continue;\r
-\r
- // If not available yet.\r
- if ( !loaded[ name ] && !registered[ name ] )\r
- {\r
- var url = this.getFilePath( name );\r
- urls.push( url );\r
- if ( !( url in urlsNames ) )\r
- urlsNames[ url ] = [];\r
- urlsNames[ url ].push( name );\r
- }\r
- else\r
- resources[ name ] = this.get( name );\r
- }\r
-\r
- CKEDITOR.scriptLoader.load( urls, function( completed, failed )\r
- {\r
- if ( failed.length )\r
- {\r
- throw '[CKEDITOR.resourceManager.load] Resource name "' + urlsNames[ failed[ 0 ] ].join( ',' )\r
- + '" was not found at "' + failed[ 0 ] + '".';\r
- }\r
-\r
- for ( var i = 0 ; i < completed.length ; i++ )\r
- {\r
- var nameList = urlsNames[ completed[ i ] ];\r
- for ( var j = 0 ; j < nameList.length ; j++ )\r
- {\r
- var name = nameList[ j ];\r
- resources[ name ] = this.get( name );\r
-\r
- loaded[ name ] = 1;\r
- }\r
- }\r
-\r
- callback.call( scope, resources );\r
- }\r
- , this);\r
- }\r
-};\r
Got questions, comments, patches, etc.? Contact Jason Woofenden