yui.js revision 81633afa56473067b37b848ef71bd39fc5c8d92e
16e78d3096c92e820034cebbda137cb7fa2c6ac4Eric Ferraiuolo/**
7d1348cc07acb3ce7fc3ed0e8352e6e65f782a68Eric Ferraiuolo * YUI core
7d1348cc07acb3ce7fc3ed0e8352e6e65f782a68Eric Ferraiuolo * @module yui
7d1348cc07acb3ce7fc3ed0e8352e6e65f782a68Eric Ferraiuolo */
421945fc2bca8dfac11d6a92f5cc7933c7ca53c2Eric Ferraiuolo(function() {
16e78d3096c92e820034cebbda137cb7fa2c6ac4Eric Ferraiuolo
16e78d3096c92e820034cebbda137cb7fa2c6ac4Eric Ferraiuolo var _instances = {},
16e78d3096c92e820034cebbda137cb7fa2c6ac4Eric Ferraiuolo
16e78d3096c92e820034cebbda137cb7fa2c6ac4Eric Ferraiuolo// @TODO: this needs to be created at build time from module metadata
16e78d3096c92e820034cebbda137cb7fa2c6ac4Eric Ferraiuolo
16e78d3096c92e820034cebbda137cb7fa2c6ac4Eric Ferraiuolo _APPLY_TO_WHITE_LIST = {
7d1348cc07acb3ce7fc3ed0e8352e6e65f782a68Eric Ferraiuolo 'io.xdrReady': 1,
7d1348cc07acb3ce7fc3ed0e8352e6e65f782a68Eric Ferraiuolo 'io.start': 1,
7d1348cc07acb3ce7fc3ed0e8352e6e65f782a68Eric Ferraiuolo 'io.success': 1,
7d1348cc07acb3ce7fc3ed0e8352e6e65f782a68Eric Ferraiuolo 'io.failure': 1,
421945fc2bca8dfac11d6a92f5cc7933c7ca53c2Eric Ferraiuolo 'io.abort': 1
421945fc2bca8dfac11d6a92f5cc7933c7ca53c2Eric Ferraiuolo };
421945fc2bca8dfac11d6a92f5cc7933c7ca53c2Eric Ferraiuolo
7d1348cc07acb3ce7fc3ed0e8352e6e65f782a68Eric Ferraiuolo
7d1348cc07acb3ce7fc3ed0e8352e6e65f782a68Eric Ferraiuoloif (typeof YUI === 'undefined' || !YUI) {
7d1348cc07acb3ce7fc3ed0e8352e6e65f782a68Eric Ferraiuolo
16e78d3096c92e820034cebbda137cb7fa2c6ac4Eric Ferraiuolo /**
16e78d3096c92e820034cebbda137cb7fa2c6ac4Eric Ferraiuolo * The YUI global namespace object. If YUI is already defined, the
16e78d3096c92e820034cebbda137cb7fa2c6ac4Eric Ferraiuolo * existing YUI object will not be overwritten so that defined
d9d247a8a6f960720e449399984fa3be10134d61Eric Ferraiuolo * namespaces are preserved.
d9d247a8a6f960720e449399984fa3be10134d61Eric Ferraiuolo *
d9d247a8a6f960720e449399984fa3be10134d61Eric Ferraiuolo * @class YUI
7d1348cc07acb3ce7fc3ed0e8352e6e65f782a68Eric Ferraiuolo * @constructor
d9d247a8a6f960720e449399984fa3be10134d61Eric Ferraiuolo * @global
d9d247a8a6f960720e449399984fa3be10134d61Eric Ferraiuolo * @uses Event.Target
d9d247a8a6f960720e449399984fa3be10134d61Eric Ferraiuolo * @param o Optional configuration object. Options:
d9d247a8a6f960720e449399984fa3be10134d61Eric Ferraiuolo * <ul>
d9d247a8a6f960720e449399984fa3be10134d61Eric Ferraiuolo * <li>------------------------------------------------------------------------</li>
7d1348cc07acb3ce7fc3ed0e8352e6e65f782a68Eric Ferraiuolo * <li>Global:</li>
d9d247a8a6f960720e449399984fa3be10134d61Eric Ferraiuolo * <li>------------------------------------------------------------------------</li>
d9d247a8a6f960720e449399984fa3be10134d61Eric Ferraiuolo * <li>debug:
d9d247a8a6f960720e449399984fa3be10134d61Eric Ferraiuolo * Turn debug statements on or off</li>
7d1348cc07acb3ce7fc3ed0e8352e6e65f782a68Eric Ferraiuolo * <li>useConsole:
7d1348cc07acb3ce7fc3ed0e8352e6e65f782a68Eric Ferraiuolo * Log to the browser console if debug is on and the console is available</li>
d9d247a8a6f960720e449399984fa3be10134d61Eric Ferraiuolo * <li>logInclude:
d9d247a8a6f960720e449399984fa3be10134d61Eric Ferraiuolo * A hash of log sources that should be logged. If specified, only log messages from these sources will be logged.
d9d247a8a6f960720e449399984fa3be10134d61Eric Ferraiuolo *
d9d247a8a6f960720e449399984fa3be10134d61Eric Ferraiuolo * </li>
d9d247a8a6f960720e449399984fa3be10134d61Eric Ferraiuolo * <li>logExclude:
7d1348cc07acb3ce7fc3ed0e8352e6e65f782a68Eric Ferraiuolo * A hash of log sources that should be not be logged. If specified, all sources are logged if not on this list.</li>
d9d247a8a6f960720e449399984fa3be10134d61Eric Ferraiuolo * <li>throwFail:
d9d247a8a6f960720e449399984fa3be10134d61Eric Ferraiuolo * If throwFail is set, Y.fail will generate or re-throw a JS error. Otherwise the failure is logged.
16e78d3096c92e820034cebbda137cb7fa2c6ac4Eric Ferraiuolo * <li>win:
16e78d3096c92e820034cebbda137cb7fa2c6ac4Eric Ferraiuolo * The target window/frame</li>
16e78d3096c92e820034cebbda137cb7fa2c6ac4Eric Ferraiuolo * <li>core:
d9d247a8a6f960720e449399984fa3be10134d61Eric Ferraiuolo * A list of modules that defines the YUI core (overrides the default)</li>
d9d247a8a6f960720e449399984fa3be10134d61Eric Ferraiuolo * <li>------------------------------------------------------------------------</li>
d9d247a8a6f960720e449399984fa3be10134d61Eric Ferraiuolo * <li>For event and get:</li>
7d1348cc07acb3ce7fc3ed0e8352e6e65f782a68Eric Ferraiuolo * <li>------------------------------------------------------------------------</li>
d9d247a8a6f960720e449399984fa3be10134d61Eric Ferraiuolo * <li>pollInterval:
16e78d3096c92e820034cebbda137cb7fa2c6ac4Eric Ferraiuolo * The default poll interval</li>
16e78d3096c92e820034cebbda137cb7fa2c6ac4Eric Ferraiuolo * <li>-------------------------------------------------------------------------</li>
16e78d3096c92e820034cebbda137cb7fa2c6ac4Eric Ferraiuolo * <li>For loader:</li>
16e78d3096c92e820034cebbda137cb7fa2c6ac4Eric Ferraiuolo * <li>-------------------------------------------------------------------------</li>
7d1348cc07acb3ce7fc3ed0e8352e6e65f782a68Eric Ferraiuolo * <li>base:
7d1348cc07acb3ce7fc3ed0e8352e6e65f782a68Eric Ferraiuolo * The base dir</li>
7d1348cc07acb3ce7fc3ed0e8352e6e65f782a68Eric Ferraiuolo * <li>secureBase:
7d1348cc07acb3ce7fc3ed0e8352e6e65f782a68Eric Ferraiuolo * The secure base dir (not implemented)</li>
7d1348cc07acb3ce7fc3ed0e8352e6e65f782a68Eric Ferraiuolo * <li>comboBase:
7d1348cc07acb3ce7fc3ed0e8352e6e65f782a68Eric Ferraiuolo * The YUI combo service base dir. Ex: http://yui.yahooapis.com/combo?</li>
7d1348cc07acb3ce7fc3ed0e8352e6e65f782a68Eric Ferraiuolo * <li>root:
7d1348cc07acb3ce7fc3ed0e8352e6e65f782a68Eric Ferraiuolo * The root path to prepend to module names for the combo service. Ex: 2.5.2/build/</li>
7d1348cc07acb3ce7fc3ed0e8352e6e65f782a68Eric Ferraiuolo * <li>filter:
7d1348cc07acb3ce7fc3ed0e8352e6e65f782a68Eric Ferraiuolo *
7d1348cc07acb3ce7fc3ed0e8352e6e65f782a68Eric Ferraiuolo * A filter to apply to result urls. This filter will modify the default
d9d247a8a6f960720e449399984fa3be10134d61Eric Ferraiuolo * path for all modules. The default path for the YUI library is the
99d4ac376f33d146e113dfd79e8bc62392116203Eric Ferraiuolo * minified version of the files (e.g., event-min.js). The filter property
99d4ac376f33d146e113dfd79e8bc62392116203Eric Ferraiuolo * can be a predefined filter or a custom filter. The valid predefined
99d4ac376f33d146e113dfd79e8bc62392116203Eric Ferraiuolo * filters are:
d9d247a8a6f960720e449399984fa3be10134d61Eric Ferraiuolo * <dl>
99d4ac376f33d146e113dfd79e8bc62392116203Eric Ferraiuolo * <dt>DEBUG</dt>
99d4ac376f33d146e113dfd79e8bc62392116203Eric Ferraiuolo * <dd>Selects the debug versions of the library (e.g., event-debug.js).
99d4ac376f33d146e113dfd79e8bc62392116203Eric Ferraiuolo * This option will automatically include the logger widget</dd>
99d4ac376f33d146e113dfd79e8bc62392116203Eric Ferraiuolo * <dt>RAW</dt>
7d1348cc07acb3ce7fc3ed0e8352e6e65f782a68Eric Ferraiuolo * <dd>Selects the non-minified version of the library (e.g., event.js).</dd>
99d4ac376f33d146e113dfd79e8bc62392116203Eric Ferraiuolo * </dl>
99d4ac376f33d146e113dfd79e8bc62392116203Eric Ferraiuolo * You can also define a custom filter, which must be an object literal
99d4ac376f33d146e113dfd79e8bc62392116203Eric Ferraiuolo * containing a search expression and a replace string:
99d4ac376f33d146e113dfd79e8bc62392116203Eric Ferraiuolo * <pre>
99d4ac376f33d146e113dfd79e8bc62392116203Eric Ferraiuolo * myFilter: &#123;
99d4ac376f33d146e113dfd79e8bc62392116203Eric Ferraiuolo * 'searchExp': "-min\\.js",
d9d247a8a6f960720e449399984fa3be10134d61Eric Ferraiuolo * 'replaceStr': "-debug.js"
d9d247a8a6f960720e449399984fa3be10134d61Eric Ferraiuolo * &#125;
16e78d3096c92e820034cebbda137cb7fa2c6ac4Eric Ferraiuolo * </pre>
7d1348cc07acb3ce7fc3ed0e8352e6e65f782a68Eric Ferraiuolo *
7d1348cc07acb3ce7fc3ed0e8352e6e65f782a68Eric Ferraiuolo * </li>
16e78d3096c92e820034cebbda137cb7fa2c6ac4Eric Ferraiuolo * <li>combine:
16e78d3096c92e820034cebbda137cb7fa2c6ac4Eric Ferraiuolo * Use the YUI combo service to reduce the number of http connections required to load your dependencies</li>
d9d247a8a6f960720e449399984fa3be10134d61Eric Ferraiuolo * <li>ignore:
d9d247a8a6f960720e449399984fa3be10134d61Eric Ferraiuolo * A list of modules that should never be dynamically loaded</li>
7d1348cc07acb3ce7fc3ed0e8352e6e65f782a68Eric Ferraiuolo * <li>force:
7d1348cc07acb3ce7fc3ed0e8352e6e65f782a68Eric Ferraiuolo * A list of modules that should always be loaded when required, even if already present on the page</li>
7d1348cc07acb3ce7fc3ed0e8352e6e65f782a68Eric Ferraiuolo * <li>insertBefore:
16e78d3096c92e820034cebbda137cb7fa2c6ac4Eric Ferraiuolo * Node or id for a node that should be used as the insertion point for new nodes</li>
7d1348cc07acb3ce7fc3ed0e8352e6e65f782a68Eric Ferraiuolo * <li>charset:
16e78d3096c92e820034cebbda137cb7fa2c6ac4Eric Ferraiuolo * charset for dynamic nodes</li>
16e78d3096c92e820034cebbda137cb7fa2c6ac4Eric Ferraiuolo * <li>timeout:
16e78d3096c92e820034cebbda137cb7fa2c6ac4Eric Ferraiuolo * number of milliseconds before a timeout occurs when dynamically loading nodes. in not set, there is no timeout</li>
16e78d3096c92e820034cebbda137cb7fa2c6ac4Eric Ferraiuolo * <li>context:
16e78d3096c92e820034cebbda137cb7fa2c6ac4Eric Ferraiuolo * execution context for all callbacks</li>
16e78d3096c92e820034cebbda137cb7fa2c6ac4Eric Ferraiuolo * <li>onSuccess:
16e78d3096c92e820034cebbda137cb7fa2c6ac4Eric Ferraiuolo * callback for the 'success' event</li>
16e78d3096c92e820034cebbda137cb7fa2c6ac4Eric Ferraiuolo * <li>onFailure:
16e78d3096c92e820034cebbda137cb7fa2c6ac4Eric Ferraiuolo * callback for the 'failure' event</li>
16e78d3096c92e820034cebbda137cb7fa2c6ac4Eric Ferraiuolo * <li>onTimeout:
16e78d3096c92e820034cebbda137cb7fa2c6ac4Eric Ferraiuolo * callback for the 'timeout' event</li>
16e78d3096c92e820034cebbda137cb7fa2c6ac4Eric Ferraiuolo * <li>onProgress:
16e78d3096c92e820034cebbda137cb7fa2c6ac4Eric Ferraiuolo * callback executed each time a script or css file is loaded</li>
16e78d3096c92e820034cebbda137cb7fa2c6ac4Eric Ferraiuolo * <li>modules:
16e78d3096c92e820034cebbda137cb7fa2c6ac4Eric Ferraiuolo * A list of module definitions. See Loader.addModule for the supported module metadata</li>
16e78d3096c92e820034cebbda137cb7fa2c6ac4Eric Ferraiuolo * </ul>
16e78d3096c92e820034cebbda137cb7fa2c6ac4Eric Ferraiuolo */
16e78d3096c92e820034cebbda137cb7fa2c6ac4Eric Ferraiuolo
16e78d3096c92e820034cebbda137cb7fa2c6ac4Eric Ferraiuolo /*global YUI*/
16e78d3096c92e820034cebbda137cb7fa2c6ac4Eric Ferraiuolo YUI = function(o) {
16e78d3096c92e820034cebbda137cb7fa2c6ac4Eric Ferraiuolo var Y = this;
16e78d3096c92e820034cebbda137cb7fa2c6ac4Eric Ferraiuolo // Allow var yui = YUI() instead of var yui = new YUI()
16e78d3096c92e820034cebbda137cb7fa2c6ac4Eric Ferraiuolo if (Y == window) {
16e78d3096c92e820034cebbda137cb7fa2c6ac4Eric Ferraiuolo return new YUI(o);
d9d247a8a6f960720e449399984fa3be10134d61Eric Ferraiuolo } else {
7d1348cc07acb3ce7fc3ed0e8352e6e65f782a68Eric Ferraiuolo // set up the core environment
7d1348cc07acb3ce7fc3ed0e8352e6e65f782a68Eric Ferraiuolo Y._init(o);
d9d247a8a6f960720e449399984fa3be10134d61Eric Ferraiuolo
7d1348cc07acb3ce7fc3ed0e8352e6e65f782a68Eric Ferraiuolo // bind the specified additional modules for this instance
7d1348cc07acb3ce7fc3ed0e8352e6e65f782a68Eric Ferraiuolo Y._setup();
d9d247a8a6f960720e449399984fa3be10134d61Eric Ferraiuolo
d9d247a8a6f960720e449399984fa3be10134d61Eric Ferraiuolo return Y;
d9d247a8a6f960720e449399984fa3be10134d61Eric Ferraiuolo }
7d1348cc07acb3ce7fc3ed0e8352e6e65f782a68Eric Ferraiuolo };
d9d247a8a6f960720e449399984fa3be10134d61Eric Ferraiuolo}
d9d247a8a6f960720e449399984fa3be10134d61Eric Ferraiuolo
99d4ac376f33d146e113dfd79e8bc62392116203Eric Ferraiuolo// The prototype contains the functions that are required to allow the external
99d4ac376f33d146e113dfd79e8bc62392116203Eric Ferraiuolo// modules to be registered and for the instance to be initialized.
99d4ac376f33d146e113dfd79e8bc62392116203Eric FerraiuoloYUI.prototype = {
d9d247a8a6f960720e449399984fa3be10134d61Eric Ferraiuolo
d9d247a8a6f960720e449399984fa3be10134d61Eric Ferraiuolo /**
d9d247a8a6f960720e449399984fa3be10134d61Eric Ferraiuolo * Initialize this YUI instance
d9d247a8a6f960720e449399984fa3be10134d61Eric Ferraiuolo * @param o config options
d9d247a8a6f960720e449399984fa3be10134d61Eric Ferraiuolo * @private
d9d247a8a6f960720e449399984fa3be10134d61Eric Ferraiuolo */
d9d247a8a6f960720e449399984fa3be10134d61Eric Ferraiuolo _init: function(o) {
d9d247a8a6f960720e449399984fa3be10134d61Eric Ferraiuolo
16e78d3096c92e820034cebbda137cb7fa2c6ac4Eric Ferraiuolo
7d1348cc07acb3ce7fc3ed0e8352e6e65f782a68Eric Ferraiuolo o = o || {};
7d1348cc07acb3ce7fc3ed0e8352e6e65f782a68Eric Ferraiuolo
7d1348cc07acb3ce7fc3ed0e8352e6e65f782a68Eric Ferraiuolo // find targeted window and @TODO create facades
16e78d3096c92e820034cebbda137cb7fa2c6ac4Eric Ferraiuolo var w = (o.win) ? (o.win.contentWindow) : o.win || window;
16e78d3096c92e820034cebbda137cb7fa2c6ac4Eric Ferraiuolo o.win = w;
16e78d3096c92e820034cebbda137cb7fa2c6ac4Eric Ferraiuolo o.doc = w.document;
16e78d3096c92e820034cebbda137cb7fa2c6ac4Eric Ferraiuolo o.debug = ('debug' in o) ? o.debug : true;
16e78d3096c92e820034cebbda137cb7fa2c6ac4Eric Ferraiuolo o.useConsole = ('useConsole' in o) ? o.useConsole: true;
16e78d3096c92e820034cebbda137cb7fa2c6ac4Eric Ferraiuolo
16e78d3096c92e820034cebbda137cb7fa2c6ac4Eric Ferraiuolo o.throwFail = ('throwFail' in o) ? o.debug : true;
16e78d3096c92e820034cebbda137cb7fa2c6ac4Eric Ferraiuolo
7d1348cc07acb3ce7fc3ed0e8352e6e65f782a68Eric Ferraiuolo // add a reference to o for anything that needs it
7d1348cc07acb3ce7fc3ed0e8352e6e65f782a68Eric Ferraiuolo // before _setup is called.
7d1348cc07acb3ce7fc3ed0e8352e6e65f782a68Eric Ferraiuolo this.config = o;
7d1348cc07acb3ce7fc3ed0e8352e6e65f782a68Eric Ferraiuolo
16e78d3096c92e820034cebbda137cb7fa2c6ac4Eric Ferraiuolo this.Env = {
16e78d3096c92e820034cebbda137cb7fa2c6ac4Eric Ferraiuolo // @todo expand the new module metadata
16e78d3096c92e820034cebbda137cb7fa2c6ac4Eric Ferraiuolo mods: {},
16e78d3096c92e820034cebbda137cb7fa2c6ac4Eric Ferraiuolo _idx: 0,
16e78d3096c92e820034cebbda137cb7fa2c6ac4Eric Ferraiuolo _pre: 'yuid',
16e78d3096c92e820034cebbda137cb7fa2c6ac4Eric Ferraiuolo _used: {},
7d1348cc07acb3ce7fc3ed0e8352e6e65f782a68Eric Ferraiuolo _attached: {},
7d1348cc07acb3ce7fc3ed0e8352e6e65f782a68Eric Ferraiuolo _yidx: 0,
7d1348cc07acb3ce7fc3ed0e8352e6e65f782a68Eric Ferraiuolo _uidx: 0
7d1348cc07acb3ce7fc3ed0e8352e6e65f782a68Eric Ferraiuolo };
16e78d3096c92e820034cebbda137cb7fa2c6ac4Eric Ferraiuolo
16e78d3096c92e820034cebbda137cb7fa2c6ac4Eric Ferraiuolo if (YUI.Env) {
7d1348cc07acb3ce7fc3ed0e8352e6e65f782a68Eric Ferraiuolo this.Env._yidx = ++YUI.Env._idx;
7d1348cc07acb3ce7fc3ed0e8352e6e65f782a68Eric Ferraiuolo this.id = this.stamp(this);
7d1348cc07acb3ce7fc3ed0e8352e6e65f782a68Eric Ferraiuolo _instances[this.id] = this;
16e78d3096c92e820034cebbda137cb7fa2c6ac4Eric Ferraiuolo }
7d1348cc07acb3ce7fc3ed0e8352e6e65f782a68Eric Ferraiuolo
16e78d3096c92e820034cebbda137cb7fa2c6ac4Eric Ferraiuolo this.constructor = YUI;
16e78d3096c92e820034cebbda137cb7fa2c6ac4Eric Ferraiuolo
16e78d3096c92e820034cebbda137cb7fa2c6ac4Eric Ferraiuolo },
16e78d3096c92e820034cebbda137cb7fa2c6ac4Eric Ferraiuolo
d9d247a8a6f960720e449399984fa3be10134d61Eric Ferraiuolo /**
16e78d3096c92e820034cebbda137cb7fa2c6ac4Eric Ferraiuolo * Finishes the instance setup. Attaches whatever modules were defined
d9d247a8a6f960720e449399984fa3be10134d61Eric Ferraiuolo * when the yui modules was registered.
d9d247a8a6f960720e449399984fa3be10134d61Eric Ferraiuolo * @method _setup
d9d247a8a6f960720e449399984fa3be10134d61Eric Ferraiuolo * @private
d9d247a8a6f960720e449399984fa3be10134d61Eric Ferraiuolo */
d9d247a8a6f960720e449399984fa3be10134d61Eric Ferraiuolo _setup: function(o) {
d9d247a8a6f960720e449399984fa3be10134d61Eric Ferraiuolo this.use("yui");
d9d247a8a6f960720e449399984fa3be10134d61Eric Ferraiuolo // @TODO eval the need to copy the config
99d4ac376f33d146e113dfd79e8bc62392116203Eric Ferraiuolo this.config = this.merge(this.config);
d9d247a8a6f960720e449399984fa3be10134d61Eric Ferraiuolo },
d9d247a8a6f960720e449399984fa3be10134d61Eric Ferraiuolo
d9d247a8a6f960720e449399984fa3be10134d61Eric Ferraiuolo /**
d9d247a8a6f960720e449399984fa3be10134d61Eric Ferraiuolo * Executes a method on a YUI instance with
d9d247a8a6f960720e449399984fa3be10134d61Eric Ferraiuolo * the specified id if the specified method is whitelisted.
d9d247a8a6f960720e449399984fa3be10134d61Eric Ferraiuolo * @method applyTo
d9d247a8a6f960720e449399984fa3be10134d61Eric Ferraiuolo * @param id {string} the YUI instance id
d9d247a8a6f960720e449399984fa3be10134d61Eric Ferraiuolo * @param method {string} the name of the method to exectute.
d9d247a8a6f960720e449399984fa3be10134d61Eric Ferraiuolo * Ex: 'Object.keys'
d9d247a8a6f960720e449399984fa3be10134d61Eric Ferraiuolo * @param args {Array} the arguments to apply to the method
d9d247a8a6f960720e449399984fa3be10134d61Eric Ferraiuolo * @return {object} the return value from the applied method or null
d9d247a8a6f960720e449399984fa3be10134d61Eric Ferraiuolo */
d9d247a8a6f960720e449399984fa3be10134d61Eric Ferraiuolo applyTo: function(id, method, args) {
16e78d3096c92e820034cebbda137cb7fa2c6ac4Eric Ferraiuolo
d9d247a8a6f960720e449399984fa3be10134d61Eric Ferraiuolo if (!(method in _APPLY_TO_WHITE_LIST)) {
99d4ac376f33d146e113dfd79e8bc62392116203Eric Ferraiuolo this.fail(method + ': applyTo not allowed');
16e78d3096c92e820034cebbda137cb7fa2c6ac4Eric Ferraiuolo return null;
16e78d3096c92e820034cebbda137cb7fa2c6ac4Eric Ferraiuolo }
d9d247a8a6f960720e449399984fa3be10134d61Eric Ferraiuolo
d9d247a8a6f960720e449399984fa3be10134d61Eric Ferraiuolo var instance = _instances[id];
16e78d3096c92e820034cebbda137cb7fa2c6ac4Eric Ferraiuolo
16e78d3096c92e820034cebbda137cb7fa2c6ac4Eric Ferraiuolo if (instance) {
16e78d3096c92e820034cebbda137cb7fa2c6ac4Eric Ferraiuolo
16e78d3096c92e820034cebbda137cb7fa2c6ac4Eric Ferraiuolo var nest = method.split('.'), m = instance;
16e78d3096c92e820034cebbda137cb7fa2c6ac4Eric Ferraiuolo
16e78d3096c92e820034cebbda137cb7fa2c6ac4Eric Ferraiuolo for (var i=0; i<nest.length; i=i+1) {
16e78d3096c92e820034cebbda137cb7fa2c6ac4Eric Ferraiuolo
d9d247a8a6f960720e449399984fa3be10134d61Eric Ferraiuolo m = m[nest[i]];
d9d247a8a6f960720e449399984fa3be10134d61Eric Ferraiuolo
d9d247a8a6f960720e449399984fa3be10134d61Eric Ferraiuolo if (!m) {
d9d247a8a6f960720e449399984fa3be10134d61Eric Ferraiuolo this.fail('applyTo not found: ' + method);
d9d247a8a6f960720e449399984fa3be10134d61Eric Ferraiuolo }
d9d247a8a6f960720e449399984fa3be10134d61Eric Ferraiuolo }
d9d247a8a6f960720e449399984fa3be10134d61Eric Ferraiuolo
d9d247a8a6f960720e449399984fa3be10134d61Eric Ferraiuolo return m.apply(instance, args);
99d4ac376f33d146e113dfd79e8bc62392116203Eric Ferraiuolo }
d9d247a8a6f960720e449399984fa3be10134d61Eric Ferraiuolo
d9d247a8a6f960720e449399984fa3be10134d61Eric Ferraiuolo return null;
16e78d3096c92e820034cebbda137cb7fa2c6ac4Eric Ferraiuolo },
16e78d3096c92e820034cebbda137cb7fa2c6ac4Eric Ferraiuolo
16e78d3096c92e820034cebbda137cb7fa2c6ac4Eric Ferraiuolo /**
16e78d3096c92e820034cebbda137cb7fa2c6ac4Eric Ferraiuolo * Register a module
d9d247a8a6f960720e449399984fa3be10134d61Eric Ferraiuolo * @method add
16e78d3096c92e820034cebbda137cb7fa2c6ac4Eric Ferraiuolo * @param name {string} module name
16e78d3096c92e820034cebbda137cb7fa2c6ac4Eric Ferraiuolo * @param fn {Function} entry point into the module that
16e78d3096c92e820034cebbda137cb7fa2c6ac4Eric Ferraiuolo * is used to bind module to the YUI instance
16e78d3096c92e820034cebbda137cb7fa2c6ac4Eric Ferraiuolo * @param version {string} version string
d9d247a8a6f960720e449399984fa3be10134d61Eric Ferraiuolo * @return {YUI} the YUI instance
d9d247a8a6f960720e449399984fa3be10134d61Eric Ferraiuolo *
16e78d3096c92e820034cebbda137cb7fa2c6ac4Eric Ferraiuolo * requires - features that should be present before loading
16e78d3096c92e820034cebbda137cb7fa2c6ac4Eric Ferraiuolo * optional - optional features that should be present if load optional defined
16e78d3096c92e820034cebbda137cb7fa2c6ac4Eric Ferraiuolo * use - features that should be attached automatically
d9d247a8a6f960720e449399984fa3be10134d61Eric Ferraiuolo * skinnable -
d9d247a8a6f960720e449399984fa3be10134d61Eric Ferraiuolo * rollup
16e78d3096c92e820034cebbda137cb7fa2c6ac4Eric Ferraiuolo * omit - features that should not be loaded if this module is present
16e78d3096c92e820034cebbda137cb7fa2c6ac4Eric Ferraiuolo */
d9d247a8a6f960720e449399984fa3be10134d61Eric Ferraiuolo add: function(name, fn, version, details) {
16e78d3096c92e820034cebbda137cb7fa2c6ac4Eric Ferraiuolo
16e78d3096c92e820034cebbda137cb7fa2c6ac4Eric Ferraiuolo
16e78d3096c92e820034cebbda137cb7fa2c6ac4Eric Ferraiuolo // @todo expand this to include version mapping
7d1348cc07acb3ce7fc3ed0e8352e6e65f782a68Eric Ferraiuolo
16e78d3096c92e820034cebbda137cb7fa2c6ac4Eric Ferraiuolo // @todo allow requires/supersedes
16e78d3096c92e820034cebbda137cb7fa2c6ac4Eric Ferraiuolo
16e78d3096c92e820034cebbda137cb7fa2c6ac4Eric Ferraiuolo // @todo may want to restore the build property
ce4cefb48a881b28475d82002d20aca07191acd7Eric Ferraiuolo
16e78d3096c92e820034cebbda137cb7fa2c6ac4Eric Ferraiuolo // @todo fire moduleAvailable event
16e78d3096c92e820034cebbda137cb7fa2c6ac4Eric Ferraiuolo
16e78d3096c92e820034cebbda137cb7fa2c6ac4Eric Ferraiuolo var m = {
16e78d3096c92e820034cebbda137cb7fa2c6ac4Eric Ferraiuolo name: name,
16e78d3096c92e820034cebbda137cb7fa2c6ac4Eric Ferraiuolo fn: fn,
16e78d3096c92e820034cebbda137cb7fa2c6ac4Eric Ferraiuolo version: version,
16e78d3096c92e820034cebbda137cb7fa2c6ac4Eric Ferraiuolo details: details || {}
16e78d3096c92e820034cebbda137cb7fa2c6ac4Eric Ferraiuolo };
16e78d3096c92e820034cebbda137cb7fa2c6ac4Eric Ferraiuolo
16e78d3096c92e820034cebbda137cb7fa2c6ac4Eric Ferraiuolo YUI.Env.mods[name] = m;
16e78d3096c92e820034cebbda137cb7fa2c6ac4Eric Ferraiuolo
16e78d3096c92e820034cebbda137cb7fa2c6ac4Eric Ferraiuolo return this; // chain support
16e78d3096c92e820034cebbda137cb7fa2c6ac4Eric Ferraiuolo },
16e78d3096c92e820034cebbda137cb7fa2c6ac4Eric Ferraiuolo
16e78d3096c92e820034cebbda137cb7fa2c6ac4Eric Ferraiuolo _attach: function(r, fromLoader) {
16e78d3096c92e820034cebbda137cb7fa2c6ac4Eric Ferraiuolo
16e78d3096c92e820034cebbda137cb7fa2c6ac4Eric Ferraiuolo var mods = YUI.Env.mods,
16e78d3096c92e820034cebbda137cb7fa2c6ac4Eric Ferraiuolo attached = this.Env._attached;
16e78d3096c92e820034cebbda137cb7fa2c6ac4Eric Ferraiuolo
16e78d3096c92e820034cebbda137cb7fa2c6ac4Eric Ferraiuolo for (var i=0, l=r.length; i<l; i=i+1) {
16e78d3096c92e820034cebbda137cb7fa2c6ac4Eric Ferraiuolo var name = r[i], m = mods[name], mm;
ce4cefb48a881b28475d82002d20aca07191acd7Eric Ferraiuolo if (!attached[name] && m) {
16e78d3096c92e820034cebbda137cb7fa2c6ac4Eric Ferraiuolo
16e78d3096c92e820034cebbda137cb7fa2c6ac4Eric Ferraiuolo attached[name] = true;
16e78d3096c92e820034cebbda137cb7fa2c6ac4Eric Ferraiuolo
16e78d3096c92e820034cebbda137cb7fa2c6ac4Eric Ferraiuolo var d = m.details, req = d.requires, use = d.use;
16e78d3096c92e820034cebbda137cb7fa2c6ac4Eric Ferraiuolo
16e78d3096c92e820034cebbda137cb7fa2c6ac4Eric Ferraiuolo if (req) {
16e78d3096c92e820034cebbda137cb7fa2c6ac4Eric Ferraiuolo this._attach(this.Array(req));
16e78d3096c92e820034cebbda137cb7fa2c6ac4Eric Ferraiuolo }
16e78d3096c92e820034cebbda137cb7fa2c6ac4Eric Ferraiuolo
16e78d3096c92e820034cebbda137cb7fa2c6ac4Eric Ferraiuolo
16e78d3096c92e820034cebbda137cb7fa2c6ac4Eric Ferraiuolo if (m.fn) {
16e78d3096c92e820034cebbda137cb7fa2c6ac4Eric Ferraiuolo m.fn(this);
16e78d3096c92e820034cebbda137cb7fa2c6ac4Eric Ferraiuolo }
16e78d3096c92e820034cebbda137cb7fa2c6ac4Eric Ferraiuolo
16e78d3096c92e820034cebbda137cb7fa2c6ac4Eric Ferraiuolo if (use) {
16e78d3096c92e820034cebbda137cb7fa2c6ac4Eric Ferraiuolo this._attach(this.Array(use));
16e78d3096c92e820034cebbda137cb7fa2c6ac4Eric Ferraiuolo }
16e78d3096c92e820034cebbda137cb7fa2c6ac4Eric Ferraiuolo }
16e78d3096c92e820034cebbda137cb7fa2c6ac4Eric Ferraiuolo }
16e78d3096c92e820034cebbda137cb7fa2c6ac4Eric Ferraiuolo
ce4cefb48a881b28475d82002d20aca07191acd7Eric Ferraiuolo },
16e78d3096c92e820034cebbda137cb7fa2c6ac4Eric Ferraiuolo
16e78d3096c92e820034cebbda137cb7fa2c6ac4Eric Ferraiuolo /**
16e78d3096c92e820034cebbda137cb7fa2c6ac4Eric Ferraiuolo * Bind a module to a YUI instance
ce4cefb48a881b28475d82002d20aca07191acd7Eric Ferraiuolo * @param modules* {string} 1-n modules to bind (uses arguments array)
ce4cefb48a881b28475d82002d20aca07191acd7Eric Ferraiuolo * @param *callback {function} callback function executed when
ce4cefb48a881b28475d82002d20aca07191acd7Eric Ferraiuolo * the instance has the required functionality. If included, it
ce4cefb48a881b28475d82002d20aca07191acd7Eric Ferraiuolo * must be the last parameter.
ce4cefb48a881b28475d82002d20aca07191acd7Eric Ferraiuolo *
ce4cefb48a881b28475d82002d20aca07191acd7Eric Ferraiuolo * @TODO
ce4cefb48a881b28475d82002d20aca07191acd7Eric Ferraiuolo * Implement versioning? loader can load different versions?
16e78d3096c92e820034cebbda137cb7fa2c6ac4Eric Ferraiuolo * Should sub-modules/plugins be normal modules, or do
16e78d3096c92e820034cebbda137cb7fa2c6ac4Eric Ferraiuolo * we add syntax for specifying these?
16e78d3096c92e820034cebbda137cb7fa2c6ac4Eric Ferraiuolo *
16e78d3096c92e820034cebbda137cb7fa2c6ac4Eric Ferraiuolo * YUI().use('dragdrop')
16e78d3096c92e820034cebbda137cb7fa2c6ac4Eric Ferraiuolo * YUI().use('dragdrop:2.4.0'); // specific version
16e78d3096c92e820034cebbda137cb7fa2c6ac4Eric Ferraiuolo * YUI().use('dragdrop:2.4.0-'); // at least this version
16e78d3096c92e820034cebbda137cb7fa2c6ac4Eric Ferraiuolo * YUI().use('dragdrop:2.4.0-2.9999.9999'); // version range
ce4cefb48a881b28475d82002d20aca07191acd7Eric Ferraiuolo * YUI().use('*'); // use all available modules
16e78d3096c92e820034cebbda137cb7fa2c6ac4Eric Ferraiuolo * YUI().use('lang+dump+substitute'); // use lang and some plugins
16e78d3096c92e820034cebbda137cb7fa2c6ac4Eric Ferraiuolo * YUI().use('lang+*'); // use lang and all known plugins
16e78d3096c92e820034cebbda137cb7fa2c6ac4Eric Ferraiuolo *
16e78d3096c92e820034cebbda137cb7fa2c6ac4Eric Ferraiuolo *
ce4cefb48a881b28475d82002d20aca07191acd7Eric Ferraiuolo * @return {YUI} the YUI instance
ce4cefb48a881b28475d82002d20aca07191acd7Eric Ferraiuolo */
ce4cefb48a881b28475d82002d20aca07191acd7Eric Ferraiuolo use: function() {
ce4cefb48a881b28475d82002d20aca07191acd7Eric Ferraiuolo
16e78d3096c92e820034cebbda137cb7fa2c6ac4Eric Ferraiuolo var Y = this,
16e78d3096c92e820034cebbda137cb7fa2c6ac4Eric Ferraiuolo a=Array.prototype.slice.call(arguments, 0),
16e78d3096c92e820034cebbda137cb7fa2c6ac4Eric Ferraiuolo mods = YUI.Env.mods,
16e78d3096c92e820034cebbda137cb7fa2c6ac4Eric Ferraiuolo used = Y.Env._used,
16e78d3096c92e820034cebbda137cb7fa2c6ac4Eric Ferraiuolo loader,
16e78d3096c92e820034cebbda137cb7fa2c6ac4Eric Ferraiuolo firstArg = a[0],
16e78d3096c92e820034cebbda137cb7fa2c6ac4Eric Ferraiuolo dynamic = false,
16e78d3096c92e820034cebbda137cb7fa2c6ac4Eric Ferraiuolo callback = a[a.length-1];
16e78d3096c92e820034cebbda137cb7fa2c6ac4Eric Ferraiuolo
16e78d3096c92e820034cebbda137cb7fa2c6ac4Eric Ferraiuolo
16e78d3096c92e820034cebbda137cb7fa2c6ac4Eric Ferraiuolo // The last argument supplied to use can be a load complete callback
16e78d3096c92e820034cebbda137cb7fa2c6ac4Eric Ferraiuolo if (typeof callback === 'function') {
a.pop();
Y.Env._callback = callback;
} else {
callback = null;
}
// YUI().use('*'); // bind everything available
if (firstArg === "*") {
a = [];
for (var k in mods) {
if (mods.hasOwnProperty(k)) {
a.push(k);
}
}
return Y.use.apply(Y, a);
}
// use loader to expand dependencies and sort the
// requirements if it is available.
if (Y.Loader) {
dynamic = true;
loader = new Y.Loader(Y.config);
loader.require(a);
loader.ignoreRegistered = true;
loader.allowRollup = false;
loader.calculate();
a = loader.sorted;
}
var missing = [], r = [], f = function(name) {
// only attach a module once
if (used[name]) {
return;
}
var m = mods[name], j, req, use;
if (m) {
used[name] = true;
req = m.details.requires;
use = m.details.use;
} else {
missing.push(name);
}
// make sure requirements are attached
if (req) {
if (Y.Lang.isString(req)) {
f(req);
} else {
for (j = 0; j < req.length; j = j + 1) {
f(req[j]);
}
}
}
// add this module to full list of things to attach
r.push(name);
};
// process each requirement and any additional requirements
// the module metadata specifies
for (var i=0, l=a.length; i<l; i=i+1) {
f(a[i]);
}
var onComplete = function(fromLoader) {
fromLoader = fromLoader || {
success: true,
msg: 'not dynamic'
};
if (Y.Env._callback) {
var cb = Y.Env._callback;
Y.Env._callback = null;
cb(Y, fromLoader);
}
if (Y.fire) {
Y.fire('yui:load', Y, fromLoader);
}
};
// dynamic load
if (Y.Loader && missing.length) {
loader = new Y.Loader(Y.config);
loader.onSuccess = onComplete;
loader.onFailure = onComplete;
loader.onTimeout = onComplete;
loader.attaching = a;
loader.require(missing);
loader.insert();
} else {
Y._attach(r);
onComplete();
}
return Y; // chain support var yui = YUI().use('dragdrop');
},
/**
* Returns the namespace specified and creates it if it doesn't exist
* <pre>
* YUI.namespace("property.package");
* YUI.namespace("YAHOO.property.package");
* </pre>
* Either of the above would create YAHOO.property, then
* YUI.property.package
*
* Be careful when naming packages. Reserved words may work in some browsers
* and not others. For instance, the following will fail in Safari:
* <pre>
* YUI.namespace("really.long.nested.namespace");
* </pre>
* This fails because "long" is a future reserved word in ECMAScript
*
* @method namespace
* @param {string*} arguments 1-n namespaces to create
* @return {object} A reference to the last namespace object created
*/
namespace: function() {
var a=arguments, o=null, i, j, d;
for (i=0; i<a.length; i=i+1) {
d = a[i].split(".");
o = this;
for (j=(d[0] == "YAHOO") ? 1 : 0; j<d.length; j=j+1) {
o[d[j]] = o[d[j]] || {};
o = o[d[j]];
}
}
return o;
},
// this is replaced if the log module is included
log: function() {
},
/**
* Report an error. The reporting mechanism is controled by
* the 'throwFail' configuration attribute. If throwFail is
* not specified, the message is written to the logger, otherwise
* a JS error is thrown
* @method fail
* @param msg {string} the failure message
* @param e {Error} Optional JS error that was caught. If supplied
* and throwFail is specified, this error will be re-thrown.
* @return {YUI} this YUI instance
*/
fail: function(msg, e) {
if (this.config.throwFail) {
throw (e || new Error(msg));
} else {
var instance = this;
instance.log(msg, "error"); // don't scrub this one
}
return this;
},
/**
* Generate an id that is unique among all YUI instances
* @method guid
* @param pre {string} optional guid prefix
* @return {string} the guid
*/
guid: function(pre) {
var e = this.Env, p = (pre) || e._pre;
return p +'-' + e._yidx + '-' + e._uidx++;
},
/**
* Stamps an object with a guid. If the object already
* has one, a new one is not created
* @method stamp
* @param o The object to stamp
* @return {string} The object's guid
*/
stamp: function(o) {
if (!o) {
return o;
}
var uid = (typeof o === 'string') ? o : o._yuid;
if (!uid) {
uid = this.guid();
o._yuid = uid;
}
return uid;
}
};
// Give the YUI global the same properties as an instance.
// This makes it so that the YUI global can be used like the YAHOO
// global was used prior to 3.x. More importantly, the YUI global
// provides global metadata, so env needs to be configured.
// @TODO review
var Y = YUI, p = Y.prototype, i;
// inheritance utilities are not available yet
for (i in p) {
if (true) { // hasOwnProperty not available yet and not needed
Y[i] = p[i];
}
}
// set up the environment
Y._init();
})();
/**
* YUI stub
* @module yui
* @submodule yui-base
*/
// This is just a stub to for dependency processing
YUI.add("yui-base", null, "@VERSION@");
/*
* YUI console logger
* @module yui
* @submodule log
*/
YUI.add("log", function(instance) {
/**
* If the 'debug' config is true, a 'yui:log' event will be
* dispatched, which the logger widget and anything else
* can consume. If the 'useConsole' config is true, it will
* write to the browser console if available.
*
* @method log
* @for YUI
* @param {String} msg The message to log.
* @param {String} cat The log category for the message. Default
* categories are "info", "warn", "error", time".
* Custom categories can be used as well. (opt)
* @param {String} src The source of the the message (opt)
* @return {YUI} YUI instance
*/
instance.log = function(msg, cat, src) {
var Y = instance, c = Y.config, es = Y.Env._eventstack,
// bail = (es && es.logging);
bail = false;
// suppress log message if the config is off or the event stack
// or the event call stack contains a consumer of the yui:log event
if (c.debug && !bail) {
// apply source filters
if (src) {
var exc = c.logExclude, inc = c.logInclude;
// console.log('checking src filter: ' + src + ', inc: ' + inc + ', exc: ' + exc);
if (inc && !(src in inc)) {
// console.log('bail: inc list found, but src is not in list: ' + src);
bail = true;
} else if (exc && (src in exc)) {
// console.log('bail: exc list found, and src is in it: ' + src);
bail = true;
}
}
if (!bail) {
if (c.useConsole && typeof console != 'undefined') {
var f = (cat && console[cat]) ? cat : 'log',
m = (src) ? src + ': ' + msg : msg;
console[f](m);
}
if (Y.fire && !bail) {
Y.fire('yui:log', msg, cat, src);
}
}
}
return Y;
};
}, "@VERSION@");
/*
* YUI lang utils
* @module yui
* @submodule lang
*/
YUI.add("lang", function(Y) {
/**
* Provides the language utilites and extensions used by the library
* @class Lang
* @static
*/
Y.Lang = Y.Lang || {};
var L = Y.Lang, SPLICE="splice", LENGTH="length";
/**
* Determines whether or not the provided object is an array.
* Testing typeof/instanceof/constructor of arrays across frame
* boundaries isn't possible in Safari unless you have a reference
* to the other frame to test against its Array prototype. To
* handle this case, we test well-known array properties instead.
* properties.
* @TODO can we kill this cross frame hack?
* @method isArray
* @static
* @param o The object to test
* @return {boolean} true if o is an array
*/
L.isArray = function(o) {
if (o) {
//return L.isNumber(o.length) && L.isFunction(o.splice);
return (o[SPLICE] && L.isNumber(o[LENGTH]));
}
return false;
};
/**
* Determines whether or not the provided object is a boolean
* @method isBoolean
* @static
* @param o The object to test
* @return {boolean} true if o is a boolean
*/
L.isBoolean = function(o) {
return typeof o === 'boolean';
};
/**
* Determines whether or not the provided object is a function
* @method isFunction
* @static
* @param o The object to test
* @return {boolean} true if o is a function
*/
L.isFunction = function(o) {
return typeof o === 'function';
};
/**
* Determines whether or not the supplied object is a date instance
* @method isDate
* @static
* @param o The object to test
* @return {boolean} true if o is a date
*/
L.isDate = function(o) {
return o instanceof Date;
};
/**
* Determines whether or not the provided object is null
* @method isNull
* @static
* @param o The object to test
* @return {boolean} true if o is null
*/
L.isNull = function(o) {
return o === null;
};
/**
* Determines whether or not the provided object is a legal number
* @method isNumber
* @static
* @param o The object to test
* @return {boolean} true if o is a number
*/
L.isNumber = function(o) {
return typeof o === 'number' && isFinite(o);
};
/**
* Determines whether or not the provided object is of type object
* or function
* @method isObject
* @static
* @param o The object to test
* @param failfn {boolean} fail if the input is a function
* @return {boolean} true if o is an object
*/
L.isObject = function(o, failfn) {
return (o && (typeof o === 'object' || (!failfn && L.isFunction(o)))) || false;
};
/**
* Determines whether or not the provided object is a string
* @method isString
* @static
* @param o The object to test
* @return {boolean} true if o is a string
*/
L.isString = function(o) {
return typeof o === 'string';
};
/**
* Determines whether or not the provided object is undefined
* @method isUndefined
* @static
* @param o The object to test
* @return {boolean} true if o is undefined
*/
L.isUndefined = function(o) {
return typeof o === 'undefined';
};
/**
* Returns a string without any leading or trailing whitespace. If
* the input is not a string, the input will be returned untouched.
* @method trim
* @static
* @param s {string} the string to trim
* @return {string} the trimmed string
*/
L.trim = function(s){
try {
return s.replace(/^\s+|\s+$/g, "");
} catch(e) {
return s;
}
};
/**
* A convenience method for detecting a legitimate non-null value.
* Returns false for null/undefined/NaN, true for other values,
* including 0/false/''
* @method isValue
* @static
* @param o The item to test
* @return {boolean} true if it is not null/undefined/NaN || false
*/
L.isValue = function(o) {
// return (o || o === false || o === 0 || o === ''); // Infinity fails
return (L.isObject(o) || L.isString(o) || L.isNumber(o) || L.isBoolean(o));
};
}, "@VERSION@");
/*
* Array utilities
* @module yui
* @submodule array
*/
/**
* YUI core
* @module yui
*/
YUI.add("array", function(Y) {
var L = Y.Lang, Native = Array.prototype;
/**
* Adds the following array utilities to the YUI instance
* @class YUI~array
*/
/**
* Y.Array(o) returns an array:
* - Arrays are return unmodified unless the start position is specified.
* - "Array-like" collections (@see Array.test) are converted to arrays
* - For everything else, a new array is created with the input as the sole item
* - The start position is used if the input is or is like an array to return
* a subset of the collection.
*
* @TODO this will not automatically convert elements that are also collections
* such as forms and selects. Passing true as the third param will
* force a conversion.
*
* @method Array
* @static
* @param o the item to arrayify
* @param i {int} if an array or array-like, this is the start index
* @param al {boolean} if true, it forces the array-like fork. This
* can be used to avoid multiple array.test calls.
* @return {Array} the resulting array
*/
Y.Array = function(o, i, al) {
var t = (al) ? 2 : Y.Array.test(o);
switch (t) {
case 1:
return (i) ? o.slice(o, i) : o;
case 2:
return Native.slice.call(o, i || 0);
default:
return [o];
}
};
var A = Y.Array;
/**
* Evaluates the input to determine if it is an array, array-like, or
* something else. This is used to handle the arguments collection
* available within functions, and HTMLElement collections
*
* @method Array.test
* @static
*
* @todo current implementation (intenionally) will not implicitly
* handle html elements that are array-like (forms, selects, etc).
*
* @return {int} a number indicating the results:
* 0: Not an array or an array-like collection
* 1: A real array.
* 2: array-like collection.
*/
A.test = function(o) {
var r = 0;
if (L.isObject(o, true)) {
if (L.isArray(o)) {
r = 1;
} else {
try {
// indexed, but no tagName (element) or alert (window)
if ("length" in o && !("tagName" in o) && !("alert" in o)) {
r = 2;
}
} catch(ex) {}
}
}
return r;
};
/**
* Executes the supplied function on each item in the array.
* @method Array.each
* @static
* @return {YUI} the YUI instance
*/
A.each = (Native.forEach) ?
function (a, f, o) {
Native.forEach.call(a, f, o || Y);
return Y;
} :
function (a, f, o) {
var l = a.length, i;
for (i = 0; i < l; i=i+1) {
f.call(o || Y, a[i], i, a);
}
return Y;
};
/**
* Returns an object using the first array as keys, and
* the second as values. If the second array is not
* provided the value is set to true for each.
* @method Array.hash
* @static
* @param k {Array} keyset
* @param v {Array} optional valueset
* @return {object} the hash
*/
A.hash = function(k, v) {
var o = {}, l = k.length, vl = v && v.length, i;
for (i=0; i<l; i=i+1) {
o[k[i]] = (vl && vl > i) ? v[i] : true;
}
return o;
};
/**
* Returns the index of the first item in the array
* that contains the specified value, -1 if the
* value isn't found.
* @TODO use native method if avail
* @method Array.indexOf
* @static
* @param a {Array} the array to search
* @param val the value to search for
* @return {int} the index of the item that contains the value or -1
*/
A.indexOf = function(a, val) {
for (var i=0; i<a.length; i=i+1) {
if (a[i] === val) {
return i;
}
}
return -1;
};
}, "@VERSION@");
/*
* YUI core utilities
* @module yui
* @submodule core
*/
// requires lang
YUI.add("core", function(Y) {
var L = Y.Lang,
A = Y.Array,
OP = Object.prototype,
IEF = ["toString", "valueOf"],
PROTO = 'prototype',
/**
* IE will not enumerate native functions in a derived object even if the
* function was overridden. This is a workaround for specific functions
* we care about on the Object prototype.
* @property _iefix
* @param {Function} r the object to receive the augmentation
* @param {Function} s the object that supplies the properties to augment
* @param w a whitelist object (the keys are the valid items to reference)
* @private
* @for YUI
*/
_iefix = (Y.UA && Y.UA.ie) ?
function(r, s, w) {
for (var i=0, a=IEF; i<a.length; i=i+1) {
var n = a[i], f = s[n];
if (L.isFunction(f) && f != OP[n]) {
if (!w || (n in w)) {
r[n]=f;
}
}
}
} : function() {};
/**
* Returns a new object containing all of the properties of
* all the supplied objects. The properties from later objects
* will overwrite those in earlier objects. Passing in a
* single object will create a shallow copy of it. For a deep
* copy, use clone.
* @method merge
* @param arguments {Object*} the objects to merge
* @return {object} the new merged object
*/
Y.merge = function() {
// var o={}, a=arguments;
// for (var i=0, l=a.length; i<l; i=i+1) {
//var a=arguments, o=Y.Object(a[0]);
var a=arguments, o={};
for (var i=0, l=a.length; i<l; i=i+1) {
Y.mix(o, a[i], true);
}
return o;
};
/**
* Applies the supplier's properties to the receiver. By default
* all prototype and static propertes on the supplier are applied
* to the corresponding spot on the receiver. By default all
* properties are applied, and a property that is already on the
* reciever will not be overwritten. The default behavior can
* be modified by supplying the appropriate parameters.
*
* @TODO add constants for the modes
*
* @method mix
* @param {Function} r the object to receive the augmentation
* @param {Function} s the object that supplies the properties to augment
* @param ov {boolean} if true, properties already on the receiver
* will be overwritten if found on the supplier.
* @param wl {string[]} a whitelist. If supplied, only properties in
* this list will be applied to the receiver.
* @param {int} mode what should be copies, and to where
* default(0): object to object
* 1: prototype to prototype (old augment)
* 2: prototype to prototype and object props (new augment)
* 3: prototype to object
* 4: object to prototype
* @param merge {boolean} merge objects instead of overwriting/ignoring
* Used by Y.aggregate
* @return {object} the augmented object
* @TODO review for PR2
*/
Y.mix = function(r, s, ov, wl, mode, merge) {
if (!s||!r) {
return Y;
}
var w = (wl && wl.length) ? A.hash(wl) : null, m = merge,
f = function(fr, fs, proto, iwl) {
var arr = m && L.isArray(fr);
for (var i in fs) {
// We never want to overwrite the prototype
// if (PROTO === i) {
if (PROTO === i || '_yuid' === i) {
continue;
}
// @TODO deal with the hasownprop issue
// check white list if it was supplied
if (!w || iwl || (i in w)) {
// if the receiver has this property, it is an object,
// and merge is specified, merge the two objects.
if (m && L.isObject(fr[i], true)) {
// console.log('aggregate RECURSE: ' + i);
// @TODO recursive or no?
// Y.mix(fr[i], fs[i]); // not recursive
f(fr[i], fs[i], proto, true); // recursive
// otherwise apply the property only if overwrite
// is specified or the receiver doesn't have one.
// @TODO make sure the 'arr' check isn't desructive
} else if (!arr && (ov || !(i in fr))) {
// console.log('hash: ' + i);
fr[i] = fs[i];
// if merge is specified and the receiver is an array,
// append the array item
} else if (arr) {
// console.log('array: ' + i);
// @TODO probably will need to remove dups
fr.push(fs[i]);
}
}
}
_iefix(fr, fs, w);
};
var rp = r.prototype, sp = s.prototype;
switch (mode) {
case 1: // proto to proto
f(rp, sp, true);
break;
case 2: // object to object and proto to proto
f(r, s);
f(rp, sp, true);
break;
case 3: // proto to static
f(r, sp, true);
break;
case 4: // static to proto
f(rp, s);
break;
default: // object to object
f(r, s);
}
return r;
};
}, "@VERSION@");
/*
* YUI object utilities
* @module yui
* @submodule object
*/
YUI.add("object", function(Y) {
/**
* Adds the following Object utilities to the YUI instance
* @class YUI~object
*/
/**
* Y.Object(o) returns a new object based upon the supplied object.
* @method Object
* @static
* @param o the supplier object
* @return {object} the new object
*/
Y.Object = function(o) {
var F = function() {};
F.prototype = o;
return new F();
};
var O = Y.Object, L = Y.Lang;
/**
* Determines whether or not the property was added
* to the object instance. Returns false if the property is not present
* in the object, or was inherited from the prototype.
*
* @deprecated Safari 1.x support has been removed, so this is simply a
* wrapper for the native implementation. Use the native implementation
* directly instead.
*
* @TODO Remove in PR2
*
* @method Object.owns
* @static
* @param o {any} The object being testing
* @param p {string} the property to look for
* @return {boolean} true if the object has the property on the instance
*/
O.owns = function(o, p) {
return (o && o.hasOwnProperty) ? o.hasOwnProperty(p) : false;
};
/**
* Returns an array containing the object's keys
* @method Object.keys
* @static
* @param o an object
* @return {string[]} the keys
*/
O.keys = function(o) {
var a=[], i;
for (i in o) {
if (o.hasOwnProperty(i)) {
a.push(i);
}
}
return a;
};
/**
* Executes a function on each item. The function
* receives the value, the key, and the object
* as paramters (in that order).
* @method Object.each
* @static
* @param o the object to iterate
* @param f {function} the function to execute
* @param c the execution context
* @param proto {boolean} include proto
* @return {YUI} the YUI instance
*/
O.each = function (o, f, c, proto) {
var s = c || Y;
for (var i in o) {
if (proto || o.hasOwnProperty(i)) {
f.call(s, o[i], i, o);
}
}
return Y;
};
}, "@VERSION@");
/*
* YUI user agent detection
* @module yui
* @submodule ua
*/
YUI.add("ua", function(Y) {
/**
* Browser/platform detection
* @class UA
* @static
*/
Y.UA = function() {
var o={
/**
* Internet Explorer version number or 0. Example: 6
* @property ie
* @type float
* @static
*/
ie:0,
/**
* Opera version number or 0. Example: 9.2
* @property opera
* @type float
* @static
*/
opera:0,
/**
* Gecko engine revision number. Will evaluate to 1 if Gecko
* is detected but the revision could not be found. Other browsers
* will be 0. Example: 1.8
* <pre>
* Firefox 1.0.0.4: 1.7.8 <-- Reports 1.7
* Firefox 1.5.0.9: 1.8.0.9 <-- Reports 1.8
* Firefox 2.0.0.3: 1.8.1.3 <-- Reports 1.8
* Firefox 3 alpha: 1.9a4 <-- Reports 1.9
* </pre>
* @property gecko
* @type float
* @static
*/
gecko:0,
/**
* AppleWebKit version. KHTML browsers that are not WebKit browsers
* will evaluate to 1, other browsers 0. Example: 418.9.1
* <pre>
* Safari 1.3.2 (312.6): 312.8.1 <-- Reports 312.8 -- currently the
* latest available for Mac OSX 10.3.
* Safari 2.0.2: 416 <-- hasOwnProperty introduced
* Safari 2.0.4: 418 <-- preventDefault fixed
* Safari 2.0.4 (419.3): 418.9.1 <-- One version of Safari may run
* different versions of webkit
* Safari 2.0.4 (419.3): 419 <-- Tiger installations that have been
* updated, but not updated
* to the latest patch.
* Webkit 212 nightly: 522+ <-- Safari 3.0 precursor (with native SVG
* and many major issues fixed).
* Safari 3.0.4 (523.12) 523.12 <-- First Tiger release - automatic update
* from 2.x via the 10.4.11 OS patch
*
* </pre>
* http://developer.apple.com/internet/safari/uamatrix.html
* @property webkit
* @type float
* @static
*/
webkit:0,
/**
* The mobile property will be set to a string containing any relevant
* user agent information when a modern mobile browser is detected.
* Currently limited to Safari on the iPhone/iPod Touch, Nokia N-series
* devices with the WebKit-based browser, and Opera Mini.
* @property mobile
* @type string
* @static
*/
mobile: null
};
var ua=navigator.userAgent, m;
// Modern KHTML browsers should qualify as Safari X-Grade
if ((/KHTML/).test(ua)) {
o.webkit=1;
}
// Modern WebKit browsers are at least X-Grade
m=ua.match(/AppleWebKit\/([^\s]*)/);
if (m&&m[1]) {
o.webkit=parseFloat(m[1]);
// Mobile browser check
if (/ Mobile\//.test(ua)) {
o.mobile = "Apple"; // iPhone or iPod Touch
} else {
m=ua.match(/NokiaN[^\/]*/);
if (m) {
o.mobile = m[0]; // Nokia N-series, ex: NokiaN95
}
}
}
if (!o.webkit) { // not webkit
// @todo check Opera/8.01 (J2ME/MIDP; Opera Mini/2.0.4509/1316; fi; U; ssr)
m=ua.match(/Opera[\s\/]([^\s]*)/);
if (m&&m[1]) {
o.opera=parseFloat(m[1]);
m=ua.match(/Opera Mini[^;]*/);
if (m) {
o.mobile = m[0]; // ex: Opera Mini/2.0.4509/1316
}
} else { // not opera or webkit
m=ua.match(/MSIE\s([^;]*)/);
if (m&&m[1]) {
o.ie=parseFloat(m[1]);
} else { // not opera, webkit, or ie
m=ua.match(/Gecko\/([^\s]*)/);
if (m) {
o.gecko=1; // Gecko detected, look for revision
m=ua.match(/rv:([^\s\)]*)/);
if (m&&m[1]) {
o.gecko=parseFloat(m[1]);
}
}
}
}
}
return o;
}();
}, "@VERSION@");
/*
* YUI setTimeout/setInterval abstraction
* @module yui
* @submodule later
*/
YUI.add("later", function(Y) {
var L = Y.Lang;
/**
* Executes the supplied function in the context of the supplied
* object 'when' milliseconds later. Executes the function a
* single time unless periodic is set to true.
* @method later
* @for YUI
* @param when {int} the number of milliseconds to wait until the fn
* is executed.
* @param o the context object.
* @param fn {Function|String} the function to execute or the name of
* the method in the 'o' object to execute.
* @param data [Array] data that is provided to the function. This accepts
* either a single item or an array. If an array is provided, the
* function is executed with one parameter for each array item. If
* you need to pass a single array parameter, it needs to be wrapped in
* an array [myarray].
* @param periodic {boolean} if true, executes continuously at supplied
* interval until canceled.
* @return {object} a timer object. Call the cancel() method on this object to
* stop the timer.
*/
var later = function(when, o, fn, data, periodic) {
when = when || 0;
o = o || {};
var m=fn, d=data, f, r;
if (L.isString(fn)) {
m = o[fn];
}
if (!m) {
Y.fail("method undefined");
}
if (!L.isArray(d)) {
d = [data];
}
f = function() {
m.apply(o, d);
};
r = (periodic) ? setInterval(f, when) : setTimeout(f, when);
return {
interval: periodic,
cancel: function() {
if (this.interval) {
clearInterval(r);
} else {
clearTimeout(r);
}
}
};
};
Y.later = later;
L.later = later;
}, "@VERSION@");
YUI.add("get", function(Y) {
var ua=Y.UA,
L=Y.Lang;
/**
* Provides a mechanism to fetch remote resources and
* insert them into a document.
* @module yui
* @submodule get
*/
/**
* Fetches and inserts one or more script or link nodes into the document
* @class Get
* @static
*/
Y.Get = function() {
/**
* hash of queues to manage multiple requests
* @property queues
* @private
*/
var queues={},
/**
* queue index used to generate transaction ids
* @property qidx
* @type int
* @private
*/
qidx=0,
/**
* node index used to generate unique node ids
* @property nidx
* @type int
* @private
*/
nidx=0,
// ridx=0,
// sandboxFrame=null,
/**
* interal property used to prevent multiple simultaneous purge
* processes
* @property purging
* @type boolean
* @private
*/
purging=false;
/**
* Generates an HTML element, this is not appended to a document
* @method _node
* @param type {string} the type of element
* @param attr {string} the attributes
* @param win {Window} optional window to create the element in
* @return {HTMLElement} the generated node
* @private
*/
var _node = function(type, attr, win) {
var w = win || Y.config.win, d=w.document, n=d.createElement(type);
for (var i in attr) {
if (attr[i] && Y.Object.owns(attr, i)) {
n.setAttribute(i, attr[i]);
}
}
return n;
};
/**
* Generates a link node
* @method _linkNode
* @param url {string} the url for the css file
* @param win {Window} optional window to create the node in
* @return {HTMLElement} the generated node
* @private
*/
var _linkNode = function(url, win, charset) {
var c = charset || "utf-8";
return _node("link", {
"id": "yui__dyn_" + (nidx++),
"type": "text/css",
"charset": c,
"rel": "stylesheet",
"href": url
}, win);
};
/**
* Generates a script node
* @method _scriptNode
* @param url {string} the url for the script file
* @param win {Window} optional window to create the node in
* @return {HTMLElement} the generated node
* @private
*/
var _scriptNode = function(url, win, charset) {
var c = charset || "utf-8";
return _node("script", {
"id": "yui__dyn_" + (nidx++),
"type": "text/javascript",
"charset": c,
"src": url
}, win);
};
/*
* The request failed, execute fail handler with whatever
* was accomplished. There isn't a failure case at the
* moment unless you count aborted transactions
* @method _fail
* @param id {string} the id of the request
* @private
*/
var _fail = function(id, msg) {
var q = queues[id];
if (q.timer) {
q.timer.cancel();
}
// execute failure callback
if (q.onFailure) {
var sc=q.context || q;
q.onFailure.call(sc, _returnData(q, msg));
}
};
var _get = function(nId, tId) {
var q = queues[tId],
n = (L.isString(nId)) ? q.win.document.getElementById(nId) : nId;
if (!n) {
_fail(tId, "target node not found: " + nId);
}
return n;
};
/**
* Removes the nodes for the specified queue
* @method _purge
* @private
*/
var _purge = function(tId) {
var q=queues[tId];
if (q) {
var n=q.nodes, l=n.length, d=q.win.document,
h=d.getElementsByTagName("head")[0];
if (q.insertBefore) {
var s = _get(q.insertBefore, tId);
if (s) {
h = s.parentNode;
}
}
for (var i=0; i<l; i=i+1) {
h.removeChild(n[i]);
}
}
q.nodes = [];
};
/**
* Returns the data payload for callback functions
* @method _returnData
* @private
*/
var _returnData = function(q, msg) {
return {
tId: q.tId,
win: q.win,
data: q.data,
nodes: q.nodes,
msg: msg,
purge: function() {
_purge(this.tId);
}
};
};
/**
* The request is complete, so executing the requester's callback
* @method _finish
* @param id {string} the id of the request
* @private
*/
var _finish = function(id) {
var q = queues[id];
if (q.timer) {
q.timer.cancel();
}
q.finished = true;
if (q.aborted) {
var msg = "transaction " + id + " was aborted";
_fail(id, msg);
return;
}
// execute success callback
if (q.onSuccess) {
var sc=q.context || q;
q.onSuccess.call(sc, _returnData(q));
}
};
/**
* Timeout detected
* @method _timeout
* @param id {string} the id of the request
* @private
*/
var _timeout = function(id) {
var q = queues[id];
if (q.onTimeout) {
var sc=q.context || q;
q.onTimeout.call(sc, _returnData(q));
}
};
/**
* Loads the next item for a given request
* @method _next
* @param id {string} the id of the request
* @param loaded {string} the url that was just loaded, if any
* @private
*/
var _next = function(id, loaded) {
var q = queues[id];
if (q.timer) {
q.timer.cancel();
}
if (q.aborted) {
var msg = "transaction " + id + " was aborted";
_fail(id, msg);
return;
}
if (loaded) {
q.url.shift();
if (q.varName) {
q.varName.shift();
}
} else {
// This is the first pass: make sure the url is an array
q.url = (L.isString(q.url)) ? [q.url] : q.url;
if (q.varName) {
q.varName = (L.isString(q.varName)) ? [q.varName] : q.varName;
}
}
var w=q.win, d=w.document, h=d.getElementsByTagName("head")[0], n;
if (q.url.length === 0) {
_finish(id);
return;
}
var url = q.url[0];
// if the url is undefined, this is probably a trailing comma problem in IE
if (!url) {
q.url.shift();
return _next(id);
}
if (q.timeout) {
q.timer = L.later(q.timeout, q, _timeout, id);
}
if (q.type === "script") {
n = _scriptNode(url, w, q.charset);
} else {
n = _linkNode(url, w, q.charset);
}
// track this node's load progress
_track(q.type, n, id, url, w, q.url.length);
// add the node to the queue so we can return it to the user supplied callback
q.nodes.push(n);
// add it to the head or insert it before 'insertBefore'
if (q.insertBefore) {
var s = _get(q.insertBefore, id);
if (s) {
s.parentNode.insertBefore(n, s);
}
} else {
h.appendChild(n);
}
// FireFox does not support the onload event for link nodes, so there is
// no way to make the css requests synchronous. This means that the css
// rules in multiple files could be applied out of order in this browser
// if a later request returns before an earlier one. Safari too.
if ((ua.webkit || ua.gecko) && q.type === "css") {
_next(id, url);
}
};
/**
* Removes processed queues and corresponding nodes
* @method _autoPurge
* @private
*/
var _autoPurge = function() {
if (purging) {
return;
}
purging = true;
for (var i in queues) {
if (queues.hasOwnProperty(i)) {
var q = queues[i];
if (q.autopurge && q.finished) {
_purge(q.tId);
delete queues[i];
}
}
}
purging = false;
};
/**
* Saves the state for the request and begins loading
* the requested urls
* @method queue
* @param type {string} the type of node to insert
* @param url {string} the url to load
* @param opts the hash of options for this request
* @private
*/
var _queue = function(type, url, opts) {
var id = "q" + (qidx++);
opts = opts || {};
if (qidx % Y.Get.PURGE_THRESH === 0) {
_autoPurge();
}
queues[id] = Y.merge(opts, {
tId: id,
type: type,
url: url,
finished: false,
nodes: []
});
var q = queues[id];
q.win = q.win || Y.config.win;
q.context = q.context || q;
q.autopurge = ("autopurge" in q) ? q.autopurge :
(type === "script") ? true : false;
L.later(0, q, _next, id);
return {
tId: id
};
};
/**
* Detects when a node has been loaded. In the case of
* script nodes, this does not guarantee that contained
* script is ready to use.
* @method _track
* @param type {string} the type of node to track
* @param n {HTMLElement} the node to track
* @param id {string} the id of the request
* @param url {string} the url that is being loaded
* @param win {Window} the targeted window
* @param qlength the number of remaining items in the queue,
* including this one
* @param trackfn {Function} function to execute when finished
* the default is _next
* @private
*/
var _track = function(type, n, id, url, win, qlength, trackfn) {
var f = trackfn || _next;
// IE supports the readystatechange event for script and css nodes
// Opera only for script nodes. Opera support onload for script
// nodes, but this doesn't fire when their is a load failure.
// The onreadystatechange appears to be a better way to respond
// to both success and failure.
if (ua.ie) {
n.onreadystatechange = function() {
var rs = this.readyState;
if ("loaded" === rs || "complete" === rs) {
n.onreadystatechange = null;
f(id, url);
}
};
// webkit prior to 3.x is no longer supported
} else if (ua.webkit) {
if (type === "script") {
// Safari 3.x supports the load event for script nodes (DOM2)
n.addEventListener("load", function() {
f(id, url);
});
}
// FireFox and Opera support onload (but not DOM2 in FF) handlers for
// script nodes. Opera, but not FF, supports the onload event for link
// nodes.
} else {
n.onload = function() {
f(id, url);
};
n.onerror = function(e) {
_fail(id, e + ": " + url);
};
}
};
return {
/**
* The number of request required before an automatic purge.
* property PURGE_THRESH
* @static
* @type int
* @default 20
*/
PURGE_THRESH: 20,
/**
* Called by the the helper for detecting script load in Safari
* @method _finalize
* @static
* @param id {string} the transaction id
* @private
*/
_finalize: function(id) {
L.later(0, null, _finish, id);
},
/**
* Abort a transaction
* @method abort
* @static
* @param o {string|object} Either the tId or the object returned from
* script() or css()
*/
abort: function(o) {
var id = (L.isString(o)) ? o : o.tId;
var q = queues[id];
if (q) {
q.aborted = true;
}
},
/**
* Fetches and inserts one or more script nodes into the head
* of the current document or the document in a specified window.
*
* @method script
* @static
* @param url {string|string[]} the url or urls to the script(s)
* @param opts {object} Options:
* <dl>
* <dt>onSuccess</dt>
* <dd>
* callback to execute when the script(s) are finished loading
* The callback receives an object back with the following
* data:
* <dl>
* <dt>win</dt>
* <dd>the window the script(s) were inserted into</dd>
* <dt>data</dt>
* <dd>the data object passed in when the request was made</dd>
* <dt>nodes</dt>
* <dd>An array containing references to the nodes that were
* inserted</dd>
* <dt>purge</dt>
* <dd>A function that, when executed, will remove the nodes
* that were inserted</dd>
* <dt>
* </dl>
* </dd>
* <dt>onTimeout</dt>
* <dd>
* callback to execute when a timeout occurs.
* The callback receives an object back with the following
* data:
* <dl>
* <dt>win</dt>
* <dd>the window the script(s) were inserted into</dd>
* <dt>data</dt>
* <dd>the data object passed in when the request was made</dd>
* <dt>nodes</dt>
* <dd>An array containing references to the nodes that were
* inserted</dd>
* <dt>purge</dt>
* <dd>A function that, when executed, will remove the nodes
* that were inserted</dd>
* <dt>
* </dl>
* </dd>
* <dt>onFailure</dt>
* <dd>
* callback to execute when the script load operation fails
* The callback receives an object back with the following
* data:
* <dl>
* <dt>win</dt>
* <dd>the window the script(s) were inserted into</dd>
* <dt>data</dt>
* <dd>the data object passed in when the request was made</dd>
* <dt>nodes</dt>
* <dd>An array containing references to the nodes that were
* inserted successfully</dd>
* <dt>purge</dt>
* <dd>A function that, when executed, will remove any nodes
* that were inserted</dd>
* <dt>
* </dl>
* </dd>
* <dt>context</dt>
* <dd>the execution context for the callbacks</dd>
* <dt>win</dt>
* <dd>a window other than the one the utility occupies</dd>
* <dt>autopurge</dt>
* <dd>
* setting to true will let the utilities cleanup routine purge
* the script once loaded
* </dd>
* <dt>data</dt>
* <dd>
* data that is supplied to the callback when the script(s) are
* loaded.
* </dd>
* <dt>insertBefore</dt>
* <dd>node or node id that will become the new node's nextSibling</dd>
* </dl>
* <dt>charset</dt>
* <dd>Node charset, default utf-8</dd>
* <dt>timeout</dt>
* <dd>Number of milliseconds to wait before aborting and firing the timeout event</dd>
* <pre>
* &nbsp;&nbsp;Y.Get.script(
* &nbsp;&nbsp;["http://yui.yahooapis.com/2.5.2/build/yahoo/yahoo-min.js",
* &nbsp;&nbsp;&nbsp;"http://yui.yahooapis.com/2.5.2/build/event/event-min.js"], &#123;
* &nbsp;&nbsp;&nbsp;&nbsp;onSuccess: function(o) &#123;
* &nbsp;&nbsp;&nbsp;&nbsp;&#125;,
* &nbsp;&nbsp;&nbsp;&nbsp;onFailure: function(o) &#123;
* &nbsp;&nbsp;&nbsp;&nbsp;&#125;,
* &nbsp;&nbsp;&nbsp;&nbsp;onTimeout: function(o) &#123;
* &nbsp;&nbsp;&nbsp;&nbsp;&#125;,
* &nbsp;&nbsp;&nbsp;&nbsp;data: "foo",
* &nbsp;&nbsp;&nbsp;&nbsp;timeout: 10000, // 10 second timeout
* &nbsp;&nbsp;&nbsp;&nbsp;context: Y, // make the YUI instance
* &nbsp;&nbsp;&nbsp;&nbsp;// win: otherframe // target another window/frame
* &nbsp;&nbsp;&nbsp;&nbsp;autopurge: true // allow the utility to choose when to remove the nodes
* &nbsp;&nbsp;&#125;);
* </pre>
* @return {tId: string} an object containing info about the transaction
*/
script: function(url, opts) {
return _queue("script", url, opts);
},
/**
* Fetches and inserts one or more css link nodes into the
* head of the current document or the document in a specified
* window.
* @method css
* @static
* @param url {string} the url or urls to the css file(s)
* @param opts Options:
* <dl>
* <dt>onSuccess</dt>
* <dd>
* callback to execute when the css file(s) are finished loading
* The callback receives an object back with the following
* data:
* <dl>win</dl>
* <dd>the window the link nodes(s) were inserted into</dd>
* <dt>data</dt>
* <dd>the data object passed in when the request was made</dd>
* <dt>nodes</dt>
* <dd>An array containing references to the nodes that were
* inserted</dd>
* <dt>purge</dt>
* <dd>A function that, when executed, will remove the nodes
* that were inserted</dd>
* <dt>
* </dl>
* </dd>
* <dt>context</dt>
* <dd>the execution context for the callbacks</dd>
* <dt>win</dt>
* <dd>a window other than the one the utility occupies</dd>
* <dt>data</dt>
* <dd>
* data that is supplied to the callbacks when the nodes(s) are
* loaded.
* </dd>
* <dt>insertBefore</dt>
* <dd>node or node id that will become the new node's nextSibling</dd>
* <dt>charset</dt>
* <dd>Node charset, default utf-8</dd>
* </dl>
* <pre>
* Y.Get.css("http://yui.yahooapis.com/2.3.1/build/menu/assets/skins/sam/menu.css");
* </pre>
* <pre>
* &nbsp;&nbsp;Y.Get.css(
* &nbsp;&nbsp;["http://yui.yahooapis.com/2.3.1/build/menu/assets/skins/sam/menu.css",
* &nbsp;&nbsp;&nbsp;"http://yui.yahooapis.com/2.3.1/build/logger/assets/skins/sam/logger.css"], &#123;
* &nbsp;&nbsp;&nbsp;&nbsp;insertBefore: 'custom-styles' // nodes will be inserted before the specified node
* &nbsp;&nbsp;&#125;);
* </pre>
* @return {tId: string} an object containing info about the transaction
*/
css: function(url, opts) {
return _queue("css", url, opts);
}
};
}();
}, "@VERSION@");
/**
* Loader dynamically loads script and css files. It includes the dependency
* info for the version of the library in use, and will automatically pull in
* dependencies for the modules requested. It supports rollup files and will
* automatically use these when appropriate in order to minimize the number of
* http connections required to load all of the dependencies. It can load the
* files from the Yahoo! CDN, and it can utilize the combo service provided on
* this network to reduce the number of http connections required to download
* YUI files.
*
* @module yui
* @submodule loader
*/
/**
* Loader dynamically loads script and css files. It includes the dependency
* info for the version of the library in use, and will automatically pull in
* dependencies for the modules requested. It supports rollup files and will
* automatically use these when appropriate in order to minimize the number of
* http connections required to load all of the dependencies. It can load the
* files from the Yahoo! CDN, and it can utilize the combo service provided on
* this network to reduce the number of http connections required to download
* YUI files.
* @class Loader
* @constructor
* @param o an optional set of configuration options. Valid options:
* <ul>
* <li>base:
* The base dir</li>
* <li>secureBase:
* The secure base dir (not implemented)</li>
* <li>comboBase:
* The YUI combo service base dir. Ex: http://yui.yahooapis.com/combo?</li>
* <li>root:
* The root path to prepend to module names for the combo service. Ex: 2.5.2/build/</li>
* <li>filter:
*
* A filter to apply to result urls. This filter will modify the default
* path for all modules. The default path for the YUI library is the
* minified version of the files (e.g., event-min.js). The filter property
* can be a predefined filter or a custom filter. The valid predefined
* filters are:
* <dl>
* <dt>DEBUG</dt>
* <dd>Selects the debug versions of the library (e.g., event-debug.js).
* This option will automatically include the logger widget</dd>
* <dt>RAW</dt>
* <dd>Selects the non-minified version of the library (e.g., event.js).</dd>
* </dl>
* You can also define a custom filter, which must be an object literal
* containing a search expression and a replace string:
* <pre>
* myFilter: &#123;
* 'searchExp': "-min\\.js",
* 'replaceStr': "-debug.js"
* &#125;
* </pre>
*
* </li>
* <li>combine:
* Use the YUI combo service to reduce the number of http connections required to load your dependencies</li>
* <li>ignore:
* A list of modules that should never be dynamically loaded</li>
* <li>force:
* A list of modules that should always be loaded when required, even if already present on the page</li>
* <li>insertBefore:
* Node or id for a node that should be used as the insertion point for new nodes</li>
* <li>charset:
* charset for dynamic nodes</li>
* <li>timeout:
* number of milliseconds before a timeout occurs when dynamically loading nodes. in not set, there is no timeout</li>
* <li>context:
* execution context for all callbacks</li>
* <li>onSuccess:
* callback for the 'success' event</li>
* <li>onFailure:
* callback for the 'failure' event</li>
* <li>onTimeout:
* callback for the 'timeout' event</li>
* <li>onProgress:
* callback executed each time a script or css file is loaded</li>
* <li>modules:
* A list of module definitions. See Loader.addModule for the supported module metadata</li>
* </ul>
*/
// @TODO backed out the custom event changes so that the event system
// isn't required in the seed build. If needed, we may want to
// add them back if the event system is detected.
/*
* Executed when the loader successfully completes an insert operation
* This can be subscribed to normally, or a listener can be passed
* as an onSuccess config option.
* @event success
*/
/*
* Executed when the loader fails to complete an insert operation.
* This can be subscribed to normally, or a listener can be passed
* as an onFailure config option.
*
* @event failure
*/
/*
* Executed when a Get operation times out.
* This can be subscribed to normally, or a listener can be passed
* as an onTimeout config option.
*
* @event timeout
*/
// http://yui.yahooapis.com/combo?2.5.2/build/yahoo/yahoo-min.js&2.5.2/build/dom/dom-min.js&2.5.2/build/event/event-min.js&2.5.2/build/autocomplete/autocomplete-min.js"
YUI.add("loader", function(Y) {
var BASE = 'base',
CSS = 'css',
JS = 'js',
CSSRESET = 'cssreset',
CSSFONTS = 'cssfonts',
CSSGRIDS = 'cssgrids',
CSSBASE = 'cssbase',
CSS_AFTER = [CSSRESET, CSSFONTS, CSSGRIDS, 'cssreset-context', 'cssfonts-context', 'cssgrids-context'],
YUI_CSS = ['reset', 'fonts', 'grids', 'base'],
VERSION = '@VERSION@',
ROOT = VERSION + '/build/',
CONTEXT = '-context',
META = {
version: VERSION,
root: ROOT,
base: 'http://yui.yahooapis.com/' + ROOT,
comboBase: 'http://yui.yahooapis.com/combo?',
modules: {
dom: {
requires: ['event'],
submodules: {
'dom-base': {
requires: ['event']
},
'dom-style': {
requires: ['dom-base']
},
'dom-screen': {
requires: ['dom-base', 'dom-style']
},
selector: {
requires: ['dom-base']
}
}
},
node: {
requires: ['dom'],
submodules: {
'node-base': {
requires: ['dom-base', 'selector']
},
'node-style': {
requires: ['dom-style', 'node-base']
},
'node-screen': {
requires: ['dom-screen', 'node-base']
},
'node-event-simulate': {
requires: ['node-base']
}
}
},
anim: {
requires: [BASE, 'node'],
submodules: {
'anim-base': {
requires: ['base', 'node-style']
},
'anim-color': {
requires: ['anim-base']
},
'anim-curve': {
requires: ['anim-xy']
},
'anim-easing': {
},
'anim-scroll': {
requires: ['anim-base']
},
'anim-xy': {
requires: ['anim-base', 'node-screen']
},
'anim-node-plugin': {
requires: ['node', 'anim-base']
}
}
},
attribute: {
requires: ['event']
},
base: {
requires: ['attribute']
},
compat: {
requires: ['node']
},
cookie: { },
// Note: CSS attributes are modified programmatically to reduce metadata size
// cssbase: {
// after: CSS_AFTER
// },
// cssgrids: {
// requires: [CSSFONTS],
// optional: [CSSRESET]
// },
dd:{
submodules: {
'dd-ddm-base': {
requires: ['node', BASE]
},
'dd-ddm':{
requires: ['dd-ddm-base']
},
'dd-ddm-drop':{
requires: ['dd-ddm']
},
'dd-drag':{
requires: ['dd-ddm-base']
},
'dd-drop':{
requires: ['dd-ddm-drop']
},
'dd-proxy':{
requires: ['dd-drag']
},
'dd-constrain':{
requires: ['dd-drag', 'dd-proxy']
},
'dd-plugin':{
requires: ['dd-drag'],
optional: ['dd-constrain', 'dd-proxy']
},
'dd-drop-plugin':{
requires: ['dd-drop']
}
}
},
dump: { },
event: {
requires: ['oop']
},
get: {
requires: ['yui-base']
},
io: {
requires: ['node']
},
json: {
submodules: {
'json-parse': {
},
'json-stringify': {
}
}
},
loader: {
requires: ['get']
},
oop: {
requires: ['yui-base']
},
queue: { },
substitute: {
optional: ['dump']
},
// Since YUI is required for everything else, it should not be specified as
// a dependency.
yui: {
supersedes: ['yui-base', 'get', 'loader']
},
'yui-base': { }
}
};
var _path = function(dir, file, type) {
return dir + '/' + file + '-min.' + (type || CSS);
};
var _cssmeta = function() {
var mods = META.modules;
// modify the meta info for YUI CSS
for (var i=0; i<YUI_CSS.length; i=i+1) {
var bname = YUI_CSS[i],
mname = CSS + bname;
mods[mname] = {
type: CSS,
path: _path(mname, bname)
};
// define -context module
var contextname = mname + CONTEXT;
bname = bname + CONTEXT;
mods[contextname] = {
type: CSS,
path: _path(mname, bname)
};
if (mname == CSSGRIDS) {
mods[mname].requires = [CSSFONTS];
mods[mname].optional = [CSSRESET];
mods[contextname].requires = [CSSFONTS + CONTEXT];
mods[contextname].optional = [CSSRESET + CONTEXT];
} else if (mname == CSSBASE) {
mods[mname].after = CSS_AFTER;
mods[contextname].after = CSS_AFTER;
}
}
}();
Y.Env.meta = META;
var L=Y.Lang, env=Y.Env,
PROV = "_provides", SUPER = "_supersedes",
REQ = "expanded";
Y.Loader = function(o) {
/**
* Internal callback to handle multiple internal insert() calls
* so that css is inserted prior to js
* @property _internalCallback
* @private
*/
this._internalCallback = null;
/**
* Use the YUI environment listener to detect script load. This
* is only switched on for Safari 2.x and below.
* @property _useYahooListener
* @private
*/
this._useYahooListener = false;
/**
* Callback that will be executed when the loader is finished
* with an insert
* @method onSuccess
* @type function
*/
this.onSuccess = null;
/**
* Callback that will be executed if there is a failure
* @method onFailure
* @type function
*/
this.onFailure = null;
/**
* Callback executed each time a script or css file is loaded
* @method onProgress
* @type function
*/
this.onProgress = null;
/**
* Callback that will be executed if a timeout occurs
* @method onTimeout
* @type function
*/
this.onTimeout = null;
/**
* The execution context for all callbacks
* @property context
* @default {YUI} the YUI instance
*/
this.context = Y;
/**
* Data that is passed to all callbacks
* @property data
*/
this.data = null;
/**
* Node reference or id where new nodes should be inserted before
* @property insertBefore
* @type string|HTMLElement
*/
this.insertBefore = null;
/**
* The charset attribute for inserted nodes
* @property charset
* @type string
* @default utf-8
*/
this.charset = null;
/**
* The base directory.
* @property base
* @type string
* @default http://yui.yahooapis.com/[YUI VERSION]/build/
*/
this.base = Y.Env.meta.base;
/**
* Base path for the combo service
* @property comboBase
* @type string
* @default http://yui.yahooapis.com/combo?
*/
this.comboBase = Y.Env.meta.comboBase;
/**
* If configured, YUI JS resources will use the combo
* handler
* @property combine
* @type boolean
* @default true if a base dir isn't in the config
*/
this.combine = (!(BASE in o));
/**
* Ignore modules registered on the YUI global
* @property ignoreRegistered
* @default false
*/
this.ignoreRegistered = false;
/**
* Root path to prepend to module path for the combo
* service
* @property root
* @type string
* @default [YUI VERSION]/build/
*/
this.root = Y.Env.meta.root;
/**
* Timeout value in milliseconds. If set, this value will be used by
* the get utility. the timeout event will fire if
* a timeout occurs.
* @property timeout
* @type int
*/
this.timeout = 0;
/**
* A list of modules that should not be loaded, even if
* they turn up in the dependency tree
* @property ignore
* @type string[]
*/
this.ignore = null;
/**
* A list of modules that should always be loaded, even
* if they have already been inserted into the page.
* @property force
* @type string[]
*/
this.force = null;
/**
* Should we allow rollups
* @property allowRollup
* @type boolean
* @default true
*/
this.allowRollup = true;
/**
* A filter to apply to result urls. This filter will modify the default
* path for all modules. The default path for the YUI library is the
* minified version of the files (e.g., event-min.js). The filter property
* can be a predefined filter or a custom filter. The valid predefined
* filters are:
* <dl>
* <dt>DEBUG</dt>
* <dd>Selects the debug versions of the library (e.g., event-debug.js).
* This option will automatically include the logger widget</dd>
* <dt>RAW</dt>
* <dd>Selects the non-minified version of the library (e.g., event.js).</dd>
* </dl>
* You can also define a custom filter, which must be an object literal
* containing a search expression and a replace string:
* <pre>
* myFilter: &#123;
* 'searchExp': "-min\\.js",
* 'replaceStr': "-debug.js"
* &#125;
* </pre>
* @property filter
* @type string|{searchExp: string, replaceStr: string}
*/
this.filter = null;
/**
* The list of requested modules
* @property required
* @type {string: boolean}
*/
this.required = {};
/**
* The library metadata
* @property moduleInfo
*/
// this.moduleInfo = Y.merge(Y.Env.meta.moduleInfo);
this.moduleInfo = {};
var defaults = Y.Env.meta.modules;
for (var i in defaults) {
if (defaults.hasOwnProperty(i)) {
this._internal = true;
this.addModule(defaults[i], i);
this._internal = false;
}
}
/**
* List of rollup files found in the library metadata
* @property rollups
*/
this.rollups = null;
/**
* Whether or not to load optional dependencies for
* the requested modules
* @property loadOptional
* @type boolean
* @default false
*/
this.loadOptional = false;
/**
* All of the derived dependencies in sorted order, which
* will be populated when either calculate() or insert()
* is called
* @property sorted
* @type string[]
*/
this.sorted = [];
/**
* Set when beginning to compute the dependency tree.
* Composed of what YUI reports to be loaded combined
* with what has been loaded by the tool
* @propery loaded
* @type {string: boolean}
*/
this.loaded = {};
/**
* A list of modules to attach to the YUI instance when complete.
* If not supplied, the sorted list of dependencies are applied.
* @property attaching
*/
this.attaching = null;
/**
* Flag to indicate the dependency tree needs to be recomputed
* if insert is called again.
* @property dirty
* @type boolean
* @default true
*/
this.dirty = true;
/**
* List of modules inserted by the utility
* @property inserted
* @type {string: boolean}
*/
this.inserted = {};
this.skipped = {};
// Y.on('yui:load', this.loadNext, this);
this._config(o);
};
Y.Loader.prototype = {
FILTERS: {
RAW: {
'searchExp': "-min\\.js",
'replaceStr': ".js"
},
DEBUG: {
'searchExp': "-min\\.js",
'replaceStr': "-debug.js"
}
},
_config: function(o) {
// apply config values
if (o) {
for (var i in o) {
var val = o[i];
if (o.hasOwnProperty(i)) {
if (i == 'require') {
this.require(val);
// support the old callback syntax
// } else if (i.indexOf('on') === 0) {
// this.subscribe(i.substr(2).toLowerCase(), o[i], o.context || this);
} else if (i == 'modules') {
// add a hash of module definitions
for (var j in val) {
this.addModule(val[j], j);
}
} else {
this[i] = val;
}
}
}
}
// fix filter
var f = this.filter;
if (L.isString(f)) {
f = f.toUpperCase();
this.filterName = f;
// the logger must be available in order to use the debug
// versions of the library
// @TODO review when logreader is available
// if (f === "DEBUG") {
// this.require("log");
// }
this.filter = this.FILTERS[f];
}
},
/** Add a new module to the component metadata.
* <dl>
* <dt>name:</dt> <dd>required, the component name</dd>
* <dt>type:</dt> <dd>required, the component type (js or css)</dd>
* <dt>path:</dt> <dd>required, the path to the script from "base"</dd>
* <dt>requires:</dt> <dd>array of modules required by this component</dd>
* <dt>optional:</dt> <dd>array of optional modules for this component</dd>
* <dt>supersedes:</dt> <dd>array of the modules this component replaces</dd>
* <dt>after:</dt> <dd>array of modules the components which, if present, should be sorted above this one</dd>
* <dt>rollup:</dt> <dd>the number of superseded modules required for automatic rollup</dd>
* <dt>fullpath:</dt> <dd>If fullpath is specified, this is used instead of the configured base + path</dd>
* <dt>skinnable:</dt> <dd>flag to determine if skin assets should automatically be pulled in</dd>
* <dt>submodules:</dt> <dd>a has of submodules</dd>
* </dl>
* @method addModule
* @param o An object containing the module data
* @param name the module name (optional), required if not in the module data
* @return {boolean} true if the module was added, false if
* the object passed in did not provide all required attributes
*/
addModule: function(o, name) {
name = name || o.name;
o.name = name;
if (!o || !o.name) {
return false;
}
if (!o.type) {
o.type = JS;
}
if (!o.path && !o.fullpath) {
// o.path = name + "/" + name + "-min." + o.type;
o.path = _path(name, name, o.type);
}
o.ext = ('ext' in o) ? o.ext : (this._internal) ? false : true;
o.requires = o.requires || [];
// Handle submodule logic
var subs = o.submodules;
if (subs) {
var sup = [], l=0;
for (var i in subs) {
var s = subs[i];
s.path = _path(name, i, o.type);
this.addModule(s, i);
sup.push(i);
l++;
}
o.supersedes = sup;
o.rollup = Math.min(l-1, 4);
}
this.moduleInfo[name] = o;
this.dirty = true;
return o;
},
/**
* Add a requirement for one or more module
* @method require
* @param what {string[] | string*} the modules to load
*/
require: function(what) {
var a = (typeof what === "string") ? arguments : what;
this.dirty = true;
Y.mix(this.required, Y.Array.hash(a));
},
/**
* Returns an object containing properties for all modules required
* in order to load the requested module
* @method getRequires
* @param mod The module definition from moduleInfo
*/
getRequires: function(mod) {
if (!mod) {
return [];
}
if (!this.dirty && mod.expanded) {
return mod.expanded;
}
var i, d=[], r=mod.requires, o=mod.optional,
info=this.moduleInfo, m, j, add;
for (i=0; i<r.length; i=i+1) {
d.push(r[i]);
m = this.getModule(r[i]);
add = this.getRequires(m);
for (j=0;j<add.length;j=j+1) {
d.push(add[j]);
}
}
// get the requirements from superseded modules, if any
r=mod.supersedes;
if (r) {
for (i=0; i<r.length; i=i+1) {
d.push(r[i]);
m = this.getModule(r[i]);
add = this.getRequires(m);
for (j=0;j<add.length;j=j+1) {
d.push(add[j]);
}
}
}
if (o && this.loadOptional) {
for (i=0; i<o.length; i=i+1) {
d.push(o[i]);
add = this.getRequires(info[o[i]]);
for (j=0;j<add.length;j=j+1) {
d.push(add[j]);
}
}
}
mod.expanded = Y.Object.keys(Y.Array.hash(d));
return mod.expanded;
},
/**
* Returns an object literal of the modules the supplied module satisfies
* @method getProvides
* @param name{string} The name of the module
* @param notMe {string} don't add this module name, only include superseded modules
* @return what this module provides
*/
getProvides: function(name, notMe) {
var addMe = !(notMe), ckey = (addMe) ? PROV : SUPER,
m = this.getModule(name), o = {};
if (!m) {
return o;
}
if (m[ckey]) {
return m[ckey];
}
var s = m.supersedes, done={}, me = this;
// use worker to break cycles
var add = function(mm) {
if (!done[mm]) {
done[mm] = true;
// we always want the return value normal behavior
// (provides) for superseded modules.
Y.mix(o, me.getProvides(mm));
}
// else {
// }
};
// calculate superseded modules
if (s) {
for (var i=0; i<s.length; i=i+1) {
add(s[i]);
}
}
// supersedes cache
m[SUPER] = o;
// provides cache
m[PROV] = Y.merge(o);
m[PROV][name] = true;
return m[ckey];
},
/**
* Calculates the dependency tree, the result is stored in the sorted
* property
* @method calculate
* @param o optional options object
*/
calculate: function(o) {
if (o || this.dirty) {
this._config(o);
this._setup();
this._explode();
if (this.allowRollup) {
this._rollup();
}
this._reduce();
this._sort();
this.dirty = false;
}
},
/**
* Investigates the current YUI configuration on the page. By default,
* modules already detected will not be loaded again unless a force
* option is encountered. Called by calculate()
* @method _setup
* @private
*/
_setup: function() {
var info = this.moduleInfo, name, i, j;
var l = Y.merge(this.inserted); // shallow clone
// available modules
if (!this.ignoreRegistered) {
Y.mix(l, YUI.Env.mods);
}
// add the ignore list to the list of loaded packages
if (this.ignore) {
// OU.appendArray(l, this.ignore);
Y.mix(l, Y.Array.hash(this.ignore));
}
// expand the list to include superseded modules
for (j in l) {
if (l.hasOwnProperty(j)) {
Y.mix(l, this.getProvides(j));
}
}
// remove modules on the force list from the loaded list
if (this.force) {
for (i=0; i<this.force.length; i=i+1) {
if (this.force[i] in l) {
delete l[this.force[i]];
}
}
}
this.loaded = l;
},
/**
* Inspects the required modules list looking for additional
* dependencies. Expands the required list to include all
* required modules. Called by calculate()
* @method _explode
* @private
*/
_explode: function() {
var r=this.required, i, mod;
for (i in r) {
if (r.hasOwnProperty(i)) {
mod = this.getModule(i);
var req = this.getRequires(mod);
if (req) {
Y.mix(r, Y.Array.hash(req));
}
}
}
},
getModule: function(name) {
var m = this.moduleInfo[name];
// create the default module
// if (!m) {
// m = this.addModule({ext: false}, name);
// }
return m;
},
/**
* Look for rollup packages to determine if all of the modules a
* rollup supersedes are required. If so, include the rollup to
* help reduce the total number of connections required. Called
* by calculate()
* @method _rollup
* @private
*/
_rollup: function() {
var i, j, m, s, rollups={}, r=this.required, roll,
info = this.moduleInfo;
// find and cache rollup modules
if (this.dirty || !this.rollups) {
for (i in info) {
if (info.hasOwnProperty(i)) {
m = this.getModule(i);
// if (m && m.rollup && m.supersedes) {
if (m && m.rollup) {
rollups[i] = m;
}
}
}
this.rollups = rollups;
}
// make as many passes as needed to pick up rollup rollups
for (;;) {
var rolled = false;
// go through the rollup candidates
for (i in rollups) {
// there can be only one
if (!r[i] && !this.loaded[i]) {
m =this.getModule(i); s = m.supersedes ||[]; roll=false;
if (!m.rollup) {
continue;
}
var c=0;
// check the threshold
for (j=0;j<s.length;j=j+1) {
// if the superseded module is loaded, we can't load the rollup
// if (this.loaded[s[j]] && (!_Y.dupsAllowed[s[j]])) {
if (this.loaded[s[j]]) {
roll = false;
break;
// increment the counter if this module is required. if we are
// beyond the rollup threshold, we will use the rollup module
} else if (r[s[j]]) {
c++;
roll = (c >= m.rollup);
if (roll) {
break;
}
}
}
if (roll) {
// add the rollup
r[i] = true;
rolled = true;
// expand the rollup's dependencies
this.getRequires(m);
}
}
}
// if we made it here w/o rolling up something, we are done
if (!rolled) {
break;
}
}
},
/**
* Remove superceded modules and loaded modules. Called by
* calculate() after we have the mega list of all dependencies
* @method _reduce
* @private
*/
_reduce: function() {
var i, j, s, m, r=this.required;
for (i in r) {
// remove if already loaded
if (i in this.loaded) {
delete r[i];
// remove anything this module supersedes
} else {
m = this.getModule(i);
s = m && m.supersedes;
if (s) {
for (j=0; j<s.length; j=j+1) {
if (s[j] in r) {
delete r[s[j]];
}
}
}
}
}
},
_attach: function() {
// this is the full list of items the YUI needs attached,
// which is needed if some dependencies are already on
// the page without their dependencies.
if (this.attaching) {
Y._attach(this.attaching);
} else {
Y._attach(this.sorted);
}
this._pushEvents();
},
_onSuccess: function() {
this._attach();
for (var i in this.skipped) {
delete this.inserted[i];
}
this.skipped = {};
// this.fire('success', {
// data: this.data
// });
var f = this.onSuccess;
if (f) {
f.call(this.context, {
msg: 'success',
data: this.data,
success: true
});
}
},
_onFailure: function(msg) {
this._attach();
// this.fire('failure', {
// msg: 'operation failed: ' + msg,
// data: this.data
// });
var f = this.onFailure;
if (f) {
f.call(this.context, {
msg: 'failure: ' + msg,
data: this.data,
success: false
});
}
},
_onTimeout: function() {
this._attach();
// this.fire('timeout', {
// data: this.data
// });
var f = this.onTimeout;
if (f) {
f.call(this.context, {
msg: 'timeout',
data: this.data,
success: false
});
}
},
/**
* Sorts the dependency tree. The last step of calculate()
* @method _sort
* @private
*/
_sort: function() {
// create an indexed list
var s=Y.Object.keys(this.required), info=this.moduleInfo, loaded=this.loaded,
me = this;
// returns true if b is not loaded, and is required
// directly or by means of modules it supersedes.
var requires = function(aa, bb) {
var mm=info[aa];
if (loaded[bb] || !mm) {
return false;
}
var ii, rr = mm.expanded,
after = mm.after, other=info[bb];
// check if this module requires the other directly
if (rr && Y.Array.indexOf(rr, bb) > -1) {
return true;
}
// check if this module should be sorted after the other
if (after && Y.Array.indexOf(after, bb) > -1) {
return true;
}
// check if this module requires one the other supersedes
var ss=info[bb] && info[bb].supersedes;
if (ss) {
for (ii=0; ii<ss.length; ii=ii+1) {
if (requires(aa, ss[ii])) {
return true;
}
}
}
// external css files should be sorted below yui css
if (mm.ext && mm.type == CSS && !other.ext && other.type == CSS) {
return true;
}
return false;
};
// pointer to the first unsorted item
var p=0;
// keep going until we make a pass without moving anything
for (;;) {
var l=s.length, a, b, j, k, moved=false;
// start the loop after items that are already sorted
for (j=p; j<l; j=j+1) {
// check the next module on the list to see if its
// dependencies have been met
a = s[j];
// check everything below current item and move if we
// find a requirement for the current item
for (k=j+1; k<l; k=k+1) {
if (requires(a, s[k])) {
// extract the dependency so we can move it up
b = s.splice(k, 1);
// insert the dependency above the item that
// requires it
s.splice(j, 0, b[0]);
moved = true;
break;
}
}
// jump out of loop if we moved something
if (moved) {
break;
// this item is sorted, move our pointer and keep going
} else {
p = p + 1;
}
}
// when we make it here and moved is false, we are
// finished sorting
if (!moved) {
break;
}
}
this.sorted = s;
},
/**
* inserts the requested modules and their dependencies.
* <code>type</code> can be "js" or "css". Both script and
* css are inserted if type is not provided.
* @method insert
* @param o optional options object
* @param type {string} the type of dependency to insert
*/
insert: function(o, type) {
// build the dependency list
this.calculate(o);
if (!type) {
var self = this;
this._internalCallback = function() {
self._internalCallback = null;
self.insert(null, JS);
};
this.insert(null, CSS);
return;
}
// set a flag to indicate the load has started
this._loading = true;
// flag to indicate we are done with the combo service
// and any additional files will need to be loaded
// individually
this._combineComplete = false;
// keep the loadType (js, css or undefined) cached
this.loadType = type;
// start the load
this.loadNext();
},
/**
* Executed every time a module is loaded, and if we are in a load
* cycle, we attempt to load the next script. Public so that it
* is possible to call this if using a method other than
* Y.register to determine when scripts are fully loaded
* @method loadNext
* @param mname {string} optional the name of the module that has
* been loaded (which is usually why it is time to load the next
* one)
*/
loadNext: function(mname) {
// It is possible that this function is executed due to something
// else one the page loading a YUI module. Only react when we
// are actively loading something
if (!this._loading) {
return;
}
var s, len, i, m, url, self=this;
// @TODO this will need to handle the two phase insert when
// CSS support is added
if (this.loadType !== CSS && this.combine && (!this._combineComplete)) {
this._combining = [];
s=this.sorted;
len=s.length;
url=this.comboBase;
for (i=0; i<len; i=i+1) {
m = this.getModule(s[i]);
// @TODO we can't combine CSS yet until we deliver files with absolute paths to the assets
// Do not try to combine non-yui JS
if (m && m.type == JS && !m.ext) {
url += this.root + m.path;
if (i < len-1) {
url += '&';
}
this._combining.push(s[i]);
}
}
if (this._combining.length) {
var callback=function(o) {
this._combineComplete = true;
var c=this._combining, len=c.length, i, m;
for (i=0; i<len; i=i+1) {
this.inserted[c[i]] = true;
}
this.loadNext(o.data);
};
// @TODO get rid of the redundant Get code
Y.Get.script(url, {
data: this._loading,
onSuccess: callback,
onFailure: this._onFailure,
onTimeout: this._onTimeout,
insertBefore: this.insertBefore,
charset: this.charset,
timeout: this.timeout,
context: self
});
return;
} else {
this._combineComplete = true;
}
}
if (mname) {
// if the module that was just loaded isn't what we were expecting,
// continue to wait
if (mname !== this._loading) {
return;
}
// The global handler that is called when each module is loaded
// will pass that module name to this function. Storing this
// data to avoid loading the same module multiple times
this.inserted[mname] = true;
// this.fire('progress', {
// name: mname,
// data: this.data
// });
if (this.onProgress) {
this.onProgress.call(this.context, {
name: mname,
data: this.data
});
}
}
s=this.sorted;
len=s.length;
for (i=0; i<len; i=i+1) {
// this.inserted keeps track of what the loader has loaded.
// move on if this item is done.
if (s[i] in this.inserted) {
continue;
}
// Because rollups will cause multiple load notifications
// from Y, loadNext may be called multiple times for
// the same module when loading a rollup. We can safely
// skip the subsequent requests
if (s[i] === this._loading) {
return;
}
// log("inserting " + s[i]);
m = this.getModule(s[i]);
if (!m) {
var msg = "Undefined module " + s[i] + " skipped";
this.inserted[s[i]] = true;
this.skipped[s[i]] = true;
continue;
// this.fire('failure', {
// msg: msg,
// data: this.data
// });
}
// The load type is stored to offer the possibility to load
// the css separately from the script.
if (!this.loadType || this.loadType === m.type) {
this._loading = s[i];
var fn=(m.type === CSS) ? Y.Get.css : Y.Get.script,
onsuccess=function(o) {
self.loadNext(o.data);
};
url=m.fullpath || this._url(m.path, s[i]);
self=this;
fn(url, {
data: s[i],
onSuccess: onsuccess,
insertBefore: this.insertBefore,
charset: this.charset,
onFailure: this._onFailure,
onTimeout: this._onTimeout,
timeout: this.timeout,
context: self
});
return;
}
}
// we are finished
this._loading = null;
// internal callback for loading css first
if (this._internalCallback) {
var f = this._internalCallback;
this._internalCallback = null;
f.call(this);
// } else if (this.onSuccess) {
} else {
// call Y.use passing this instance. Y will use the sorted
// dependency list.
this._onSuccess();
}
},
/**
* In IE, the onAvailable/onDOMReady events need help when Event is
* loaded dynamically
* @method _pushEvents
* @param {Function} optional function reference
* @private
*/
_pushEvents: function() {
if (Y.Event) {
Y.Event._load();
}
},
/**
* Generates the full url for a module
* method _url
* @param path {string} the path fragment
* @return {string} the full url
* @private
*/
_url: function(path, name) {
var u = (this.base || "") + path,
f = this.filter;
if (f) {
var useFilter = true;
if (this.filterName == "DEBUG") {
var self = this,
exc = self.logExclude,
inc = self.logInclude;
if (inc && !(name in inc)) {
useFilter = false;
} else if (exc && (name in exc)) {
useFilter = false;
}
}
if (useFilter) {
u = u.replace(new RegExp(f.searchExp), f.replaceStr);
}
}
return u;
}
};
// Y.augment(Y.Loader, Y.Event.Target);
}, "@VERSION@");
/*
* YUI initializer
* @module yui
* @submodule init
*/
(function() {
var min = ['yui-base', 'log', 'lang', 'array', 'core'], core,
M = function(Y) {
var C = Y.config;
// apply the minimal required functionality
Y.use.apply(Y, min);
if (C.core) {
core = C.core;
} else {
core = ["object", "ua", "later"];
core.push(
"get",
"loader");
}
Y.use.apply(Y, core);
};
YUI.add("yui", M, "@VERSION@");
// {
// the following will be bound automatically when this code is loaded
// use: core
// });
})();