| blob | 8dfce86b841fae2035f42b15d1c82637a176dfb9 |
1 /*
2 YUI 3.5.1 (build 22)
3 Copyright 2012 Yahoo! Inc. All rights reserved.
4 Licensed under the BSD License.
5 http://yuilibrary.com/license/
6 */
7 /**
8 * The YUI module contains the components required for building the YUI seed
9 * file. This includes the script loading mechanism, a simple queue, and
10 * the core utilities for the library.
11 * @module yui
12 * @submodule yui-base
13 */
15 if (typeof YUI != 'undefined') {
16 YUI._YUI = YUI;
17 }
19 /**
20 The YUI global namespace object. If YUI is already defined, the
21 existing YUI object will not be overwritten so that defined
22 namespaces are preserved. It is the constructor for the object
23 the end user interacts with. As indicated below, each instance
24 has full custom event support, but only if the event system
25 is available. This is a self-instantiable factory function. You
26 can invoke it directly like this:
28 YUI().use('*', function(Y) {
29 // ready
30 });
32 But it also works like this:
34 var Y = YUI();
36 Configuring the YUI object:
38 YUI({
39 debug: true,
40 combine: false
41 }).use('node', function(Y) {
42 //Node is ready to use
43 });
45 See the API docs for the <a href="config.html">Config</a> class
46 for the complete list of supported configuration properties accepted
47 by the YUI constuctor.
49 @class YUI
50 @constructor
51 @global
52 @uses EventTarget
53 @param [o]* {Object} 0..n optional configuration objects. these values
54 are store in Y.config. See <a href="config.html">Config</a> for the list of supported
55 properties.
56 */
57 /*global YUI*/
58 /*global YUI_config*/
59 var YUI = function() {
60 var i = 0,
61 Y = this,
62 args = arguments,
63 l = args.length,
64 instanceOf = function(o, type) {
65 return (o && o.hasOwnProperty && (o instanceof type));
66 },
67 gconf = (typeof YUI_config !== 'undefined') && YUI_config;
69 if (!(instanceOf(Y, YUI))) {
70 Y = new YUI();
71 } else {
72 // set up the core environment
73 Y._init();
75 /**
76 YUI.GlobalConfig is a master configuration that might span
77 multiple contexts in a non-browser environment. It is applied
78 first to all instances in all contexts.
79 @property GlobalConfig
80 @type {Object}
81 @global
82 @static
83 @example
86 YUI.GlobalConfig = {
87 filter: 'debug'
88 };
90 YUI().use('node', function(Y) {
91 //debug files used here
92 });
94 YUI({
95 filter: 'min'
96 }).use('node', function(Y) {
97 //min files used here
98 });
100 */
101 if (YUI.GlobalConfig) {
102 Y.applyConfig(YUI.GlobalConfig);
103 }
105 /**
106 YUI_config is a page-level config. It is applied to all
107 instances created on the page. This is applied after
108 YUI.GlobalConfig, and before the instance level configuration
109 objects.
110 @global
111 @property YUI_config
112 @type {Object}
113 @example
116 //Single global var to include before YUI seed file
117 YUI_config = {
118 filter: 'debug'
119 };
121 YUI().use('node', function(Y) {
122 //debug files used here
123 });
125 YUI({
126 filter: 'min'
127 }).use('node', function(Y) {
128 //min files used here
129 });
130 */
131 if (gconf) {
132 Y.applyConfig(gconf);
133 }
135 // bind the specified additional modules for this instance
136 if (!l) {
137 Y._setup();
138 }
139 }
141 if (l) {
142 // Each instance can accept one or more configuration objects.
143 // These are applied after YUI.GlobalConfig and YUI_Config,
144 // overriding values set in those config files if there is a '
145 // matching property.
146 for (; i < l; i++) {
147 Y.applyConfig(args[i]);
148 }
150 Y._setup();
151 }
153 Y.instanceOf = instanceOf;
155 return Y;
156 };
158 (function() {
160 var proto, prop,
161 VERSION = '3.5.1',
162 PERIOD = '.',
163 BASE = 'http://yui.yahooapis.com/',
164 DOC_LABEL = 'yui3-js-enabled',
165 CSS_STAMP_EL = 'yui3-css-stamp',
166 NOOP = function() {},
167 SLICE = Array.prototype.slice,
168 APPLY_TO_AUTH = { 'io.xdrReady': 1, // the functions applyTo
169 'io.xdrResponse': 1, // can call. this should
170 'SWF.eventHandler': 1 }, // be done at build time
171 hasWin = (typeof window != 'undefined'),
172 win = (hasWin) ? window : null,
173 doc = (hasWin) ? win.document : null,
174 docEl = doc && doc.documentElement,
175 docClass = docEl && docEl.className,
176 instances = {},
177 time = new Date().getTime(),
178 add = function(el, type, fn, capture) {
179 if (el && el.addEventListener) {
180 el.addEventListener(type, fn, capture);
181 } else if (el && el.attachEvent) {
182 el.attachEvent('on' + type, fn);
183 }
184 },
185 remove = function(el, type, fn, capture) {
186 if (el && el.removeEventListener) {
187 // this can throw an uncaught exception in FF
188 try {
189 el.removeEventListener(type, fn, capture);
190 } catch (ex) {}
191 } else if (el && el.detachEvent) {
192 el.detachEvent('on' + type, fn);
193 }
194 },
195 handleLoad = function() {
196 YUI.Env.windowLoaded = true;
197 YUI.Env.DOMReady = true;
198 if (hasWin) {
199 remove(window, 'load', handleLoad);
200 }
201 },
202 getLoader = function(Y, o) {
203 var loader = Y.Env._loader;
204 if (loader) {
205 //loader._config(Y.config);
206 loader.ignoreRegistered = false;
207 loader.onEnd = null;
208 loader.data = null;
209 loader.required = [];
210 loader.loadType = null;
211 } else {
212 loader = new Y.Loader(Y.config);
213 Y.Env._loader = loader;
214 }
215 YUI.Env.core = Y.Array.dedupe([].concat(YUI.Env.core, [ 'loader-base', 'loader-rollup', 'loader-yui3' ]));
217 return loader;
218 },
220 clobber = function(r, s) {
221 for (var i in s) {
222 if (s.hasOwnProperty(i)) {
223 r[i] = s[i];
224 }
225 }
226 },
228 ALREADY_DONE = { success: true };
230 // Stamp the documentElement (HTML) with a class of "yui-loaded" to
231 // enable styles that need to key off of JS being enabled.
232 if (docEl && docClass.indexOf(DOC_LABEL) == -1) {
233 if (docClass) {
234 docClass += ' ';
235 }
236 docClass += DOC_LABEL;
237 docEl.className = docClass;
238 }
240 if (VERSION.indexOf('@') > -1) {
241 VERSION = '3.3.0'; // dev time hack for cdn test
242 }
244 proto = {
245 /**
246 * Applies a new configuration object to the YUI instance config.
247 * This will merge new group/module definitions, and will also
248 * update the loader cache if necessary. Updating Y.config directly
249 * will not update the cache.
250 * @method applyConfig
251 * @param {Object} o the configuration object.
252 * @since 3.2.0
253 */
254 applyConfig: function(o) {
256 o = o || NOOP;
258 var attr,
259 name,
260 // detail,
261 config = this.config,
262 mods = config.modules,
263 groups = config.groups,
264 aliases = config.aliases,
265 loader = this.Env._loader;
267 for (name in o) {
268 if (o.hasOwnProperty(name)) {
269 attr = o[name];
270 if (mods && name == 'modules') {
271 clobber(mods, attr);
272 } else if (aliases && name == 'aliases') {
273 clobber(aliases, attr);
274 } else if (groups && name == 'groups') {
275 clobber(groups, attr);
276 } else if (name == 'win') {
277 config[name] = (attr && attr.contentWindow) || attr;
278 config.doc = config[name] ? config[name].document : null;
279 } else if (name == '_yuid') {
280 // preserve the guid
281 } else {
282 config[name] = attr;
283 }
284 }
285 }
287 if (loader) {
288 loader._config(o);
289 }
291 },
292 /**
293 * Old way to apply a config to the instance (calls `applyConfig` under the hood)
294 * @private
295 * @method _config
296 * @param {Object} o The config to apply
297 */
298 _config: function(o) {
299 this.applyConfig(o);
300 },
302 /**
303 * Initialize this YUI instance
304 * @private
305 * @method _init
306 */
307 _init: function() {
308 var filter, el,
309 Y = this,
310 G_ENV = YUI.Env,
311 Env = Y.Env,
312 prop;
314 /**
315 * The version number of the YUI instance.
316 * @property version
317 * @type string
318 */
319 Y.version = VERSION;
321 if (!Env) {
322 Y.Env = {
323 core: ['get','features','intl-base','yui-log','yui-later'],
324 mods: {}, // flat module map
325 versions: {}, // version module map
326 base: BASE,
327 cdn: BASE + VERSION + '/build/',
328 // bootstrapped: false,
329 _idx: 0,
330 _used: {},
331 _attached: {},
332 _missed: [],
333 _yidx: 0,
334 _uidx: 0,
335 _guidp: 'y',
336 _loaded: {},
337 // serviced: {},
338 // Regex in English:
339 // I'll start at the \b(simpleyui).
340 // 1. Look in the test string for "simpleyui" or "yui" or
341 // "yui-base" or "yui-davglass" or "yui-foobar" that comes after a word break. That is, it
342 // can't match "foyui" or "i_heart_simpleyui". This can be anywhere in the string.
343 // 2. After #1 must come a forward slash followed by the string matched in #1, so
344 // "yui-base/yui-base" or "simpleyui/simpleyui" or "yui-pants/yui-pants".
345 // 3. The second occurence of the #1 token can optionally be followed by "-debug" or "-min",
346 // so "yui/yui-min", "yui/yui-debug", "yui-base/yui-base-debug". NOT "yui/yui-tshirt".
347 // 4. This is followed by ".js", so "yui/yui.js", "simpleyui/simpleyui-min.js"
348 // 0. Going back to the beginning, now. If all that stuff in 1-4 comes after a "?" in the string,
349 // then capture the junk between the LAST "&" and the string in 1-4. So
350 // "blah?foo/yui/yui.js" will capture "foo/" and "blah?some/thing.js&3.3.0/build/yui-davglass/yui-davglass.js"
351 // will capture "3.3.0/build/"
352 //
353 // Regex Exploded:
354 // (?:\? Find a ?
355 // (?:[^&]*&) followed by 0..n characters followed by an &
356 // * in fact, find as many sets of characters followed by a & as you can
357 // ([^&]*) capture the stuff after the last & in \1
358 // )? but it's ok if all this ?junk&more_junk stuff isn't even there
359 // \b(simpleyui| after a word break find either the string "simpleyui" or
360 // yui(?:-\w+)? the string "yui" optionally followed by a -, then more characters
361 // ) and store the simpleyui or yui-* string in \2
362 // \/\2 then comes a / followed by the simpleyui or yui-* string in \2
363 // (?:-(min|debug))? optionally followed by "-min" or "-debug"
364 // .js and ending in ".js"
365 _BASE_RE: /(?:\?(?:[^&]*&)*([^&]*))?\b(simpleyui|yui(?:-\w+)?)\/\2(?:-(min|debug))?\.js/,
366 parseBasePath: function(src, pattern) {
367 var match = src.match(pattern),
368 path, filter;
370 if (match) {
371 path = RegExp.leftContext || src.slice(0, src.indexOf(match[0]));
373 // this is to set up the path to the loader. The file
374 // filter for loader should match the yui include.
375 filter = match[3];
377 // extract correct path for mixed combo urls
378 // http://yuilibrary.com/projects/yui3/ticket/2528423
379 if (match[1]) {
380 path += '?' + match[1];
381 }
382 path = {
383 filter: filter,
384 path: path
385 }
386 }
387 return path;
388 },
389 getBase: G_ENV && G_ENV.getBase ||
390 function(pattern) {
391 var nodes = (doc && doc.getElementsByTagName('script')) || [],
392 path = Env.cdn, parsed,
393 i, len, src;
395 for (i = 0, len = nodes.length; i < len; ++i) {
396 src = nodes[i].src;
397 if (src) {
398 parsed = Y.Env.parseBasePath(src, pattern);
399 if (parsed) {
400 filter = parsed.filter;
401 path = parsed.path;
402 break;
403 }
404 }
405 }
407 // use CDN default
408 return path;
409 }
411 };
413 Env = Y.Env;
415 Env._loaded[VERSION] = {};
417 if (G_ENV && Y !== YUI) {
418 Env._yidx = ++G_ENV._yidx;
419 Env._guidp = ('yui_' + VERSION + '_' +
420 Env._yidx + '_' + time).replace(/\./g, '_');
421 } else if (YUI._YUI) {
423 G_ENV = YUI._YUI.Env;
424 Env._yidx += G_ENV._yidx;
425 Env._uidx += G_ENV._uidx;
427 for (prop in G_ENV) {
428 if (!(prop in Env)) {
429 Env[prop] = G_ENV[prop];
430 }
431 }
433 delete YUI._YUI;
434 }
436 Y.id = Y.stamp(Y);
437 instances[Y.id] = Y;
439 }
441 Y.constructor = YUI;
443 // configuration defaults
444 Y.config = Y.config || {
445 bootstrap: true,
446 cacheUse: true,
447 debug: true,
448 doc: doc,
449 fetchCSS: true,
450 throwFail: true,
451 useBrowserConsole: true,
452 useNativeES5: true,
453 win: win
454 };
456 //Register the CSS stamp element
457 if (doc && !doc.getElementById(CSS_STAMP_EL)) {
458 el = doc.createElement('div');
459 el.innerHTML = '<div id="' + CSS_STAMP_EL + '" style="position: absolute !important; visibility: hidden !important"></div>';
460 YUI.Env.cssStampEl = el.firstChild;
461 docEl.insertBefore(YUI.Env.cssStampEl, docEl.firstChild);
462 }
464 Y.config.lang = Y.config.lang || 'en-US';
466 Y.config.base = YUI.config.base || Y.Env.getBase(Y.Env._BASE_RE);
468 if (!filter || (!('mindebug').indexOf(filter))) {
469 filter = 'min';
470 }
471 filter = (filter) ? '-' + filter : filter;
472 Y.config.loaderPath = YUI.config.loaderPath || 'loader/loader' + filter + '.js';
474 },
476 /**
477 * Finishes the instance setup. Attaches whatever modules were defined
478 * when the yui modules was registered.
479 * @method _setup
480 * @private
481 */
482 _setup: function(o) {
483 var i, Y = this,
484 core = [],
485 mods = YUI.Env.mods,
486 //extras = Y.config.core || ['get','features','intl-base','yui-log','yui-later'];
487 extras = Y.config.core || [].concat(YUI.Env.core); //Clone it..
489 for (i = 0; i < extras.length; i++) {
490 if (mods[extras[i]]) {
491 core.push(extras[i]);
492 }
493 }
495 Y._attach(['yui-base']);
496 Y._attach(core);
498 if (Y.Loader) {
499 getLoader(Y);
500 }
502 },
504 /**
505 * Executes a method on a YUI instance with
506 * the specified id if the specified method is whitelisted.
507 * @method applyTo
508 * @param id {String} the YUI instance id.
509 * @param method {String} the name of the method to exectute.
510 * Ex: 'Object.keys'.
511 * @param args {Array} the arguments to apply to the method.
512 * @return {Object} the return value from the applied method or null.
513 */
514 applyTo: function(id, method, args) {
515 if (!(method in APPLY_TO_AUTH)) {
516 this.log(method + ': applyTo not allowed', 'warn', 'yui');
517 return null;
518 }
520 var instance = instances[id], nest, m, i;
521 if (instance) {
522 nest = method.split('.');
523 m = instance;
524 for (i = 0; i < nest.length; i = i + 1) {
525 m = m[nest[i]];
526 if (!m) {
527 this.log('applyTo not found: ' + method, 'warn', 'yui');
528 }
529 }
530 return m && m.apply(instance, args);
531 }
533 return null;
534 },
536 /**
537 Registers a module with the YUI global. The easiest way to create a
538 first-class YUI module is to use the YUI component build tool.
540 http://yuilibrary.com/projects/builder
542 The build system will produce the `YUI.add` wrapper for you module, along
543 with any configuration info required for the module.
544 @method add
545 @param name {String} module name.
546 @param fn {Function} entry point into the module that is used to bind module to the YUI instance.
547 @param {YUI} fn.Y The YUI instance this module is executed in.
548 @param {String} fn.name The name of the module
549 @param version {String} version string.
550 @param details {Object} optional config data:
551 @param details.requires {Array} features that must be present before this module can be attached.
552 @param details.optional {Array} optional features that should be present if loadOptional
553 is defined. Note: modules are not often loaded this way in YUI 3,
554 but this field is still useful to inform the user that certain
555 features in the component will require additional dependencies.
556 @param details.use {Array} features that are included within this module which need to
557 be attached automatically when this module is attached. This
558 supports the YUI 3 rollup system -- a module with submodules
559 defined will need to have the submodules listed in the 'use'
560 config. The YUI component build tool does this for you.
561 @return {YUI} the YUI instance.
562 @example
564 YUI.add('davglass', function(Y, name) {
565 Y.davglass = function() {
566 alert('Dav was here!');
567 };
568 }, '3.4.0', { requires: ['yui-base', 'harley-davidson', 'mt-dew'] });
570 */
571 add: function(name, fn, version, details) {
572 details = details || {};
573 var env = YUI.Env,
574 mod = {
575 name: name,
576 fn: fn,
577 version: version,
578 details: details
579 },
580 loader,
581 i, versions = env.versions;
583 env.mods[name] = mod;
584 versions[version] = versions[version] || {};
585 versions[version][name] = mod;
587 for (i in instances) {
588 if (instances.hasOwnProperty(i)) {
589 loader = instances[i].Env._loader;
590 if (loader) {
591 if (!loader.moduleInfo[name] || loader.moduleInfo[name].temp) {
592 loader.addModule(details, name);
593 }
594 }
595 }
596 }
598 return this;
599 },
601 /**
602 * Executes the function associated with each required
603 * module, binding the module to the YUI instance.
604 * @param {Array} r The array of modules to attach
605 * @param {Boolean} [moot=false] Don't throw a warning if the module is not attached
606 * @method _attach
607 * @private
608 */
609 _attach: function(r, moot) {
610 var i, name, mod, details, req, use, after,
611 mods = YUI.Env.mods,
612 aliases = YUI.Env.aliases,
613 Y = this, j,
614 loader = Y.Env._loader,
615 done = Y.Env._attached,
616 len = r.length, loader,
617 c = [];
619 //Check for conditional modules (in a second+ instance) and add their requirements
620 //TODO I hate this entire method, it needs to be fixed ASAP (3.5.0) ^davglass
621 for (i = 0; i < len; i++) {
622 name = r[i];
623 mod = mods[name];
624 c.push(name);
625 if (loader && loader.conditions[name]) {
626 Y.Object.each(loader.conditions[name], function(def) {
627 var go = def && ((def.ua && Y.UA[def.ua]) || (def.test && def.test(Y)));
628 if (go) {
629 c.push(def.name);
630 }
631 });
632 }
633 }
634 r = c;
635 len = r.length;
637 for (i = 0; i < len; i++) {
638 if (!done[r[i]]) {
639 name = r[i];
640 mod = mods[name];
642 if (aliases && aliases[name]) {
643 Y._attach(aliases[name]);
644 continue;
645 }
646 if (!mod) {
647 if (loader && loader.moduleInfo[name]) {
648 mod = loader.moduleInfo[name];
649 moot = true;
650 }
653 //if (!loader || !loader.moduleInfo[name]) {
654 //if ((!loader || !loader.moduleInfo[name]) && !moot) {
655 if (!moot && name) {
656 if ((name.indexOf('skin-') === -1) && (name.indexOf('css') === -1)) {
657 Y.Env._missed.push(name);
658 Y.Env._missed = Y.Array.dedupe(Y.Env._missed);
659 Y.message('NOT loaded: ' + name, 'warn', 'yui');
660 }
661 }
662 } else {
663 done[name] = true;
664 //Don't like this, but in case a mod was asked for once, then we fetch it
665 //We need to remove it from the missed list ^davglass
666 for (j = 0; j < Y.Env._missed.length; j++) {
667 if (Y.Env._missed[j] === name) {
668 Y.message('Found: ' + name + ' (was reported as missing earlier)', 'warn', 'yui');
669 Y.Env._missed.splice(j, 1);
670 }
671 }
672 details = mod.details;
673 req = details.requires;
674 use = details.use;
675 after = details.after;
677 if (req) {
678 for (j = 0; j < req.length; j++) {
679 if (!done[req[j]]) {
680 if (!Y._attach(req)) {
681 return false;
682 }
683 break;
684 }
685 }
686 }
688 if (after) {
689 for (j = 0; j < after.length; j++) {
690 if (!done[after[j]]) {
691 if (!Y._attach(after, true)) {
692 return false;
693 }
694 break;
695 }
696 }
697 }
699 if (mod.fn) {
700 try {
701 mod.fn(Y, name);
702 } catch (e) {
703 Y.error('Attach error: ' + name, e, name);
704 return false;
705 }
706 }
708 if (use) {
709 for (j = 0; j < use.length; j++) {
710 if (!done[use[j]]) {
711 if (!Y._attach(use)) {
712 return false;
713 }
714 break;
715 }
716 }
717 }
721 }
722 }
723 }
725 return true;
726 },
728 /**
729 * Attaches one or more modules to the YUI instance. When this
730 * is executed, the requirements are analyzed, and one of
731 * several things can happen:
732 *
733 * * All requirements are available on the page -- The modules
734 * are attached to the instance. If supplied, the use callback
735 * is executed synchronously.
736 *
737 * * Modules are missing, the Get utility is not available OR
738 * the 'bootstrap' config is false -- A warning is issued about
739 * the missing modules and all available modules are attached.
740 *
741 * * Modules are missing, the Loader is not available but the Get
742 * utility is and boostrap is not false -- The loader is bootstrapped
743 * before doing the following....
744 *
745 * * Modules are missing and the Loader is available -- The loader
746 * expands the dependency tree and fetches missing modules. When
747 * the loader is finshed the callback supplied to use is executed
748 * asynchronously.
749 *
750 * @method use
751 * @param modules* {String|Array} 1-n modules to bind (uses arguments array).
752 * @param [callback] {Function} callback function executed when
753 * the instance has the required functionality. If included, it
754 * must be the last parameter.
755 * @param callback.Y {YUI} The `YUI` instance created for this sandbox
756 * @param callback.data {Object} Object data returned from `Loader`.
757 *
758 * @example
759 * // loads and attaches dd and its dependencies
760 * YUI().use('dd', function(Y) {});
761 *
762 * // loads and attaches dd and node as well as all of their dependencies (since 3.4.0)
763 * YUI().use(['dd', 'node'], function(Y) {});
764 *
765 * // attaches all modules that are available on the page
766 * YUI().use('*', function(Y) {});
767 *
768 * // intrinsic YUI gallery support (since 3.1.0)
769 * YUI().use('gallery-yql', function(Y) {});
770 *
771 * // intrinsic YUI 2in3 support (since 3.1.0)
772 * YUI().use('yui2-datatable', function(Y) {});
773 *
774 * @return {YUI} the YUI instance.
775 */
776 use: function() {
777 var args = SLICE.call(arguments, 0),
778 callback = args[args.length - 1],
779 Y = this,
780 i = 0,
781 a = [],
782 name,
783 Env = Y.Env,
784 provisioned = true;
786 // The last argument supplied to use can be a load complete callback
787 if (Y.Lang.isFunction(callback)) {
788 args.pop();
789 } else {
790 callback = null;
791 }
792 if (Y.Lang.isArray(args[0])) {
793 args = args[0];
794 }
796 if (Y.config.cacheUse) {
797 while ((name = args[i++])) {
798 if (!Env._attached[name]) {
799 provisioned = false;
800 break;
801 }
802 }
804 if (provisioned) {
805 if (args.length) {
806 }
807 Y._notify(callback, ALREADY_DONE, args);
808 return Y;
809 }
810 }
812 if (Y._loading) {
813 Y._useQueue = Y._useQueue || new Y.Queue();
814 Y._useQueue.add([args, callback]);
815 } else {
816 Y._use(args, function(Y, response) {
817 Y._notify(callback, response, args);
818 });
819 }
821 return Y;
822 },
823 /**
824 * Notify handler from Loader for attachment/load errors
825 * @method _notify
826 * @param callback {Function} The callback to pass to the `Y.config.loadErrorFn`
827 * @param response {Object} The response returned from Loader
828 * @param args {Array} The aruments passed from Loader
829 * @private
830 */
831 _notify: function(callback, response, args) {
832 if (!response.success && this.config.loadErrorFn) {
833 this.config.loadErrorFn.call(this, this, callback, response, args);
834 } else if (callback) {
835 try {
836 callback(this, response);
837 } catch (e) {
838 this.error('use callback error', e, args);
839 }
840 }
841 },
843 /**
844 * This private method is called from the `use` method queue. To ensure that only one set of loading
845 * logic is performed at a time.
846 * @method _use
847 * @private
848 * @param args* {String} 1-n modules to bind (uses arguments array).
849 * @param *callback {Function} callback function executed when
850 * the instance has the required functionality. If included, it
851 * must be the last parameter.
852 */
853 _use: function(args, callback) {
855 if (!this.Array) {
856 this._attach(['yui-base']);
857 }
859 var len, loader, handleBoot, handleRLS,
860 Y = this,
861 G_ENV = YUI.Env,
862 mods = G_ENV.mods,
863 Env = Y.Env,
864 used = Env._used,
865 aliases = G_ENV.aliases,
866 queue = G_ENV._loaderQueue,
867 firstArg = args[0],
868 YArray = Y.Array,
869 config = Y.config,
870 boot = config.bootstrap,
871 missing = [],
872 r = [],
873 ret = true,
874 fetchCSS = config.fetchCSS,
875 process = function(names, skip) {
877 var i = 0, a = [];
879 if (!names.length) {
880 return;
881 }
883 if (aliases) {
884 for (i = 0; i < names.length; i++) {
885 if (aliases[names[i]]) {
886 a = [].concat(a, aliases[names[i]]);
887 } else {
888 a.push(names[i]);
889 }
890 }
891 names = a;
892 }
894 YArray.each(names, function(name) {
896 // add this module to full list of things to attach
897 if (!skip) {
898 r.push(name);
899 }
901 // only attach a module once
902 if (used[name]) {
903 return;
904 }
906 var m = mods[name], req, use;
908 if (m) {
909 used[name] = true;
910 req = m.details.requires;
911 use = m.details.use;
912 } else {
913 // CSS files don't register themselves, see if it has
914 // been loaded
915 if (!G_ENV._loaded[VERSION][name]) {
916 missing.push(name);
917 } else {
918 used[name] = true; // probably css
919 }
920 }
922 // make sure requirements are attached
923 if (req && req.length) {
924 process(req);
925 }
927 // make sure we grab the submodule dependencies too
928 if (use && use.length) {
929 process(use, 1);
930 }
931 });
932 },
934 handleLoader = function(fromLoader) {
935 var response = fromLoader || {
936 success: true,
937 msg: 'not dynamic'
938 },
939 redo, origMissing,
940 ret = true,
941 data = response.data;
943 Y._loading = false;
945 if (data) {
946 origMissing = missing;
947 missing = [];
948 r = [];
949 process(data);
950 redo = missing.length;
951 if (redo) {
952 if (missing.sort().join() ==
953 origMissing.sort().join()) {
954 redo = false;
955 }
956 }
957 }
959 if (redo && data) {
960 Y._loading = true;
961 Y._use(missing, function() {
962 if (Y._attach(data)) {
963 Y._notify(callback, response, data);
964 }
965 });
966 } else {
967 if (data) {
968 ret = Y._attach(data);
969 }
970 if (ret) {
971 Y._notify(callback, response, args);
972 }
973 }
975 if (Y._useQueue && Y._useQueue.size() && !Y._loading) {
976 Y._use.apply(Y, Y._useQueue.next());
977 }
979 };
982 // YUI().use('*'); // bind everything available
983 if (firstArg === '*') {
984 ret = Y._attach(Y.Object.keys(mods));
985 if (ret) {
986 handleLoader();
987 }
988 return Y;
989 }
991 if (mods['loader'] && !Y.Loader) {
992 Y._attach(['loader']);
993 }
996 // use loader to expand dependencies and sort the
997 // requirements if it is available.
998 if (boot && Y.Loader && args.length) {
999 loader = getLoader(Y);
1000 loader.require(args);
1001 loader.ignoreRegistered = true;
1002 loader._boot = true;
1003 loader.calculate(null, (fetchCSS) ? null : 'js');
1004 args = loader.sorted;
1005 loader._boot = false;
1006 }
1008 // process each requirement and any additional requirements
1009 // the module metadata specifies
1010 process(args);
1012 len = missing.length;
1014 if (len) {
1015 missing = Y.Object.keys(YArray.hash(missing));
1016 len = missing.length;
1017 }
1020 // dynamic load
1021 if (boot && len && Y.Loader) {
1022 Y._loading = true;
1023 loader = getLoader(Y);
1024 loader.onEnd = handleLoader;
1025 loader.context = Y;
1026 loader.data = args;
1027 loader.ignoreRegistered = false;
1028 loader.require(args);
1029 loader.insert(null, (fetchCSS) ? null : 'js');
1031 } else if (boot && len && Y.Get && !Env.bootstrapped) {
1033 Y._loading = true;
1035 handleBoot = function() {
1036 Y._loading = false;
1037 queue.running = false;
1038 Env.bootstrapped = true;
1039 G_ENV._bootstrapping = false;
1040 if (Y._attach(['loader'])) {
1041 Y._use(args, callback);
1042 }
1043 };
1045 if (G_ENV._bootstrapping) {
1046 queue.add(handleBoot);
1047 } else {
1048 G_ENV._bootstrapping = true;
1049 Y.Get.script(config.base + config.loaderPath, {
1050 onEnd: handleBoot
1051 });
1052 }
1054 } else {
1055 ret = Y._attach(args);
1056 if (ret) {
1057 handleLoader();
1058 }
1059 }
1061 return Y;
1062 },
1065 /**
1066 Adds a namespace object onto the YUI global if called statically.
1068 // creates YUI.your.namespace.here as nested objects
1069 YUI.namespace("your.namespace.here");
1071 If called as a method on a YUI <em>instance</em>, it creates the
1072 namespace on the instance.
1074 // creates Y.property.package
1075 Y.namespace("property.package");
1077 Dots in the input string cause `namespace` to create nested objects for
1078 each token. If any part of the requested namespace already exists, the
1079 current object will be left in place. This allows multiple calls to
1080 `namespace` to preserve existing namespaced properties.
1082 If the first token in the namespace string is "YAHOO", the token is
1083 discarded.
1085 Be careful with namespace tokens. Reserved words may work in some browsers
1086 and not others. For instance, the following will fail in some browsers
1087 because the supported version of JavaScript reserves the word "long":
1089 Y.namespace("really.long.nested.namespace");
1091 <em>Note: If you pass multiple arguments to create multiple namespaces, only
1092 the last one created is returned from this function.</em>
1094 @method namespace
1095 @param {String} namespace* namespaces to create.
1096 @return {Object} A reference to the last namespace object created.
1097 **/
1098 namespace: function() {
1099 var a = arguments, o, i = 0, j, d, arg;
1101 for (; i < a.length; i++) {
1102 o = this; //Reset base object per argument or it will get reused from the last
1103 arg = a[i];
1104 if (arg.indexOf(PERIOD) > -1) { //Skip this if no "." is present
1105 d = arg.split(PERIOD);
1106 for (j = (d[0] == 'YAHOO') ? 1 : 0; j < d.length; j++) {
1107 o[d[j]] = o[d[j]] || {};
1108 o = o[d[j]];
1109 }
1110 } else {
1111 o[arg] = o[arg] || {};
1112 o = o[arg]; //Reset base object to the new object so it's returned
1113 }
1114 }
1115 return o;
1116 },
1118 // this is replaced if the log module is included
1119 log: NOOP,
1120 message: NOOP,
1121 // this is replaced if the dump module is included
1122 dump: function (o) { return ''+o; },
1124 /**
1125 * Report an error. The reporting mechanism is controlled by
1126 * the `throwFail` configuration attribute. If throwFail is
1127 * not specified, the message is written to the Logger, otherwise
1128 * a JS error is thrown. If an `errorFn` is specified in the config
1129 * it must return `true` to keep the error from being thrown.
1130 * @method error
1131 * @param msg {String} the error message.
1132 * @param e {Error|String} Optional JS error that was caught, or an error string.
1133 * @param src Optional additional info (passed to `Y.config.errorFn` and `Y.message`)
1134 * and `throwFail` is specified, this error will be re-thrown.
1135 * @return {YUI} this YUI instance.
1136 */
1137 error: function(msg, e, src) {
1138 //TODO Add check for window.onerror here
1140 var Y = this, ret;
1142 if (Y.config.errorFn) {
1143 ret = Y.config.errorFn.apply(Y, arguments);
1144 }
1146 if (Y.config.throwFail && !ret) {
1147 throw (e || new Error(msg));
1148 } else {
1149 Y.message(msg, 'error', ''+src); // don't scrub this one
1150 }
1152 return Y;
1153 },
1155 /**
1156 * Generate an id that is unique among all YUI instances
1157 * @method guid
1158 * @param pre {String} optional guid prefix.
1159 * @return {String} the guid.
1160 */
1161 guid: function(pre) {
1162 var id = this.Env._guidp + '_' + (++this.Env._uidx);
1163 return (pre) ? (pre + id) : id;
1164 },
1166 /**
1167 * Returns a `guid` associated with an object. If the object
1168 * does not have one, a new one is created unless `readOnly`
1169 * is specified.
1170 * @method stamp
1171 * @param o {Object} The object to stamp.
1172 * @param readOnly {Boolean} if `true`, a valid guid will only
1173 * be returned if the object has one assigned to it.
1174 * @return {String} The object's guid or null.
1175 */
1176 stamp: function(o, readOnly) {
1177 var uid;
1178 if (!o) {
1179 return o;
1180 }
1182 // IE generates its own unique ID for dom nodes
1183 // The uniqueID property of a document node returns a new ID
1184 if (o.uniqueID && o.nodeType && o.nodeType !== 9) {
1185 uid = o.uniqueID;
1186 } else {
1187 uid = (typeof o === 'string') ? o : o._yuid;
1188 }
1190 if (!uid) {
1191 uid = this.guid();
1192 if (!readOnly) {
1193 try {
1194 o._yuid = uid;
1195 } catch (e) {
1196 uid = null;
1197 }
1198 }
1199 }
1200 return uid;
1201 },
1203 /**
1204 * Destroys the YUI instance
1205 * @method destroy
1206 * @since 3.3.0
1207 */
1208 destroy: function() {
1209 var Y = this;
1210 if (Y.Event) {
1211 Y.Event._unload();
1212 }
1213 delete instances[Y.id];
1214 delete Y.Env;
1215 delete Y.config;
1216 }
1218 /**
1219 * instanceof check for objects that works around
1220 * memory leak in IE when the item tested is
1221 * window/document
1222 * @method instanceOf
1223 * @param o {Object} The object to check.
1224 * @param type {Object} The class to check against.
1225 * @since 3.3.0
1226 */
1227 };
1229 YUI.prototype = proto;
1231 // inheritance utilities are not available yet
1232 for (prop in proto) {
1233 if (proto.hasOwnProperty(prop)) {
1234 YUI[prop] = proto[prop];
1235 }
1236 }
1238 /**
1239 Static method on the Global YUI object to apply a config to all YUI instances.
1240 It's main use case is "mashups" where several third party scripts are trying to write to
1241 a global YUI config at the same time. This way they can all call `YUI.applyConfig({})` instead of
1242 overwriting other scripts configs.
1243 @static
1244 @since 3.5.0
1245 @method applyConfig
1246 @param {Object} o the configuration object.
1247 @example
1249 YUI.applyConfig({
1250 modules: {
1251 davglass: {
1252 fullpath: './davglass.js'
1253 }
1254 }
1255 });
1257 YUI.applyConfig({
1258 modules: {
1259 foo: {
1260 fullpath: './foo.js'
1261 }
1262 }
1263 });
1265 YUI().use('davglass', function(Y) {
1266 //Module davglass will be available here..
1267 });
1269 */
1270 YUI.applyConfig = function(o) {
1271 if (!o) {
1272 return;
1273 }
1274 //If there is a GlobalConfig, apply it first to set the defaults
1275 if (YUI.GlobalConfig) {
1276 this.prototype.applyConfig.call(this, YUI.GlobalConfig);
1277 }
1278 //Apply this config to it
1279 this.prototype.applyConfig.call(this, o);
1280 //Reset GlobalConfig to the combined config
1281 YUI.GlobalConfig = this.config;
1282 };
1284 // set up the environment
1285 YUI._init();
1287 if (hasWin) {
1288 // add a window load event at load time so we can capture
1289 // the case where it fires before dynamic loading is
1290 // complete.
1291 add(window, 'load', handleLoad);
1292 } else {
1293 handleLoad();
1294 }
1296 YUI.Env.add = add;
1297 YUI.Env.remove = remove;
1299 /*global exports*/
1300 // Support the CommonJS method for exporting our single global
1301 if (typeof exports == 'object') {
1302 exports.YUI = YUI;
1303 }
1305 }());
1308 /**
1309 * The config object contains all of the configuration options for
1310 * the `YUI` instance. This object is supplied by the implementer
1311 * when instantiating a `YUI` instance. Some properties have default
1312 * values if they are not supplied by the implementer. This should
1313 * not be updated directly because some values are cached. Use
1314 * `applyConfig()` to update the config object on a YUI instance that
1315 * has already been configured.
1316 *
1317 * @class config
1318 * @static
1319 */
1321 /**
1322 * Allows the YUI seed file to fetch the loader component and library
1323 * metadata to dynamically load additional dependencies.
1324 *
1325 * @property bootstrap
1326 * @type boolean
1327 * @default true
1328 */
1330 /**
1331 * Turns on writing Ylog messages to the browser console.
1332 *
1333 * @property debug
1334 * @type boolean
1335 * @default true
1336 */
1338 /**
1339 * Log to the browser console if debug is on and the browser has a
1340 * supported console.
1341 *
1342 * @property useBrowserConsole
1343 * @type boolean
1344 * @default true
1345 */
1347 /**
1348 * A hash of log sources that should be logged. If specified, only
1349 * log messages from these sources will be logged.
1350 *
1351 * @property logInclude
1352 * @type object
1353 */
1355 /**
1356 * A hash of log sources that should be not be logged. If specified,
1357 * all sources are logged if not on this list.
1358 *
1359 * @property logExclude
1360 * @type object
1361 */
1363 /**
1364 * Set to true if the yui seed file was dynamically loaded in
1365 * order to bootstrap components relying on the window load event
1366 * and the `domready` custom event.
1367 *
1368 * @property injected
1369 * @type boolean
1370 * @default false
1371 */
1373 /**
1374 * If `throwFail` is set, `Y.error` will generate or re-throw a JS Error.
1375 * Otherwise the failure is logged.
1376 *
1377 * @property throwFail
1378 * @type boolean
1379 * @default true
1380 */
1382 /**
1383 * The window/frame that this instance should operate in.
1384 *
1385 * @property win
1386 * @type Window
1387 * @default the window hosting YUI
1388 */
1390 /**
1391 * The document associated with the 'win' configuration.
1392 *
1393 * @property doc
1394 * @type Document
1395 * @default the document hosting YUI
1396 */
1398 /**
1399 * A list of modules that defines the YUI core (overrides the default list).
1400 *
1401 * @property core
1402 * @type Array
1403 * @default [ get,features,intl-base,yui-log,yui-later,loader-base, loader-rollup, loader-yui3 ]
1404 */
1406 /**
1407 * A list of languages in order of preference. This list is matched against
1408 * the list of available languages in modules that the YUI instance uses to
1409 * determine the best possible localization of language sensitive modules.
1410 * Languages are represented using BCP 47 language tags, such as "en-GB" for
1411 * English as used in the United Kingdom, or "zh-Hans-CN" for simplified
1412 * Chinese as used in China. The list can be provided as a comma-separated
1413 * list or as an array.
1414 *
1415 * @property lang
1416 * @type string|string[]
1417 */
1419 /**
1420 * The default date format
1421 * @property dateFormat
1422 * @type string
1423 * @deprecated use configuration in `DataType.Date.format()` instead.
1424 */
1426 /**
1427 * The default locale
1428 * @property locale
1429 * @type string
1430 * @deprecated use `config.lang` instead.
1431 */
1433 /**
1434 * The default interval when polling in milliseconds.
1435 * @property pollInterval
1436 * @type int
1437 * @default 20
1438 */
1440 /**
1441 * The number of dynamic nodes to insert by default before
1442 * automatically removing them. This applies to script nodes
1443 * because removing the node will not make the evaluated script
1444 * unavailable. Dynamic CSS is not auto purged, because removing
1445 * a linked style sheet will also remove the style definitions.
1446 * @property purgethreshold
1447 * @type int
1448 * @default 20
1449 */
1451 /**
1452 * The default interval when polling in milliseconds.
1453 * @property windowResizeDelay
1454 * @type int
1455 * @default 40
1456 */
1458 /**
1459 * Base directory for dynamic loading
1460 * @property base
1461 * @type string
1462 */
1464 /*
1465 * The secure base dir (not implemented)
1466 * For dynamic loading.
1467 * @property secureBase
1468 * @type string
1469 */
1471 /**
1472 * The YUI combo service base dir. Ex: `http://yui.yahooapis.com/combo?`
1473 * For dynamic loading.
1474 * @property comboBase
1475 * @type string
1476 */
1478 /**
1479 * The root path to prepend to module path for the combo service.
1480 * Ex: 3.0.0b1/build/
1481 * For dynamic loading.
1482 * @property root
1483 * @type string
1484 */
1486 /**
1487 * A filter to apply to result urls. This filter will modify the default
1488 * path for all modules. The default path for the YUI library is the
1489 * minified version of the files (e.g., event-min.js). The filter property
1490 * can be a predefined filter or a custom filter. The valid predefined
1491 * filters are:
1492 * <dl>
1493 * <dt>DEBUG</dt>
1494 * <dd>Selects the debug versions of the library (e.g., event-debug.js).
1495 * This option will automatically include the Logger widget</dd>
1496 * <dt>RAW</dt>
1497 * <dd>Selects the non-minified version of the library (e.g., event.js).</dd>
1498 * </dl>
1499 * You can also define a custom filter, which must be an object literal
1500 * containing a search expression and a replace string:
1501 *
1502 * myFilter: {
1503 * 'searchExp': "-min\\.js",
1504 * 'replaceStr': "-debug.js"
1505 * }
1506 *
1507 * For dynamic loading.
1508 *
1509 * @property filter
1510 * @type string|object
1511 */
1513 /**
1514 * The `skin` config let's you configure application level skin
1515 * customizations. It contains the following attributes which
1516 * can be specified to override the defaults:
1517 *
1518 * // The default skin, which is automatically applied if not
1519 * // overriden by a component-specific skin definition.
1520 * // Change this in to apply a different skin globally
1521 * defaultSkin: 'sam',
1522 *
1523 * // This is combined with the loader base property to get
1524 * // the default root directory for a skin.
1525 * base: 'assets/skins/',
1526 *
1527 * // Any component-specific overrides can be specified here,
1528 * // making it possible to load different skins for different
1529 * // components. It is possible to load more than one skin
1530 * // for a given component as well.
1531 * overrides: {
1532 * slider: ['capsule', 'round']
1533 * }
1534 *
1535 * For dynamic loading.
1536 *
1537 * @property skin
1538 */
1540 /**
1541 * Hash of per-component filter specification. If specified for a given
1542 * component, this overrides the filter config.
1543 *
1544 * For dynamic loading.
1545 *
1546 * @property filters
1547 */
1549 /**
1550 * Use the YUI combo service to reduce the number of http connections
1551 * required to load your dependencies. Turning this off will
1552 * disable combo handling for YUI and all module groups configured
1553 * with a combo service.
1554 *
1555 * For dynamic loading.
1556 *
1557 * @property combine
1558 * @type boolean
1559 * @default true if 'base' is not supplied, false if it is.
1560 */
1562 /**
1563 * A list of modules that should never be dynamically loaded
1564 *
1565 * @property ignore
1566 * @type string[]
1567 */
1569 /**
1570 * A list of modules that should always be loaded when required, even if already
1571 * present on the page.
1572 *
1573 * @property force
1574 * @type string[]
1575 */
1577 /**
1578 * Node or id for a node that should be used as the insertion point for new
1579 * nodes. For dynamic loading.
1580 *
1581 * @property insertBefore
1582 * @type string
1583 */
1585 /**
1586 * Object literal containing attributes to add to dynamically loaded script
1587 * nodes.
1588 * @property jsAttributes
1589 * @type string
1590 */
1592 /**
1593 * Object literal containing attributes to add to dynamically loaded link
1594 * nodes.
1595 * @property cssAttributes
1596 * @type string
1597 */
1599 /**
1600 * Number of milliseconds before a timeout occurs when dynamically
1601 * loading nodes. If not set, there is no timeout.
1602 * @property timeout
1603 * @type int
1604 */
1606 /**
1607 * Callback for the 'CSSComplete' event. When dynamically loading YUI
1608 * components with CSS, this property fires when the CSS is finished
1609 * loading but script loading is still ongoing. This provides an
1610 * opportunity to enhance the presentation of a loading page a little
1611 * bit before the entire loading process is done.
1612 *
1613 * @property onCSS
1614 * @type function
1615 */
1617 /**
1618 * A hash of module definitions to add to the list of YUI components.
1619 * These components can then be dynamically loaded side by side with
1620 * YUI via the `use()` method. This is a hash, the key is the module
1621 * name, and the value is an object literal specifying the metdata
1622 * for the module. See `Loader.addModule` for the supported module
1623 * metadata fields. Also see groups, which provides a way to
1624 * configure the base and combo spec for a set of modules.
1625 *
1626 * modules: {
1627 * mymod1: {
1628 * requires: ['node'],
1629 * fullpath: '/mymod1/mymod1.js'
1630 * },
1631 * mymod2: {
1632 * requires: ['mymod1'],
1633 * fullpath: '/mymod2/mymod2.js'
1634 * },
1635 * mymod3: '/js/mymod3.js',
1636 * mycssmod: '/css/mycssmod.css'
1637 * }
1638 *
1639 *
1640 * @property modules
1641 * @type object
1642 */
1644 /**
1645 * Aliases are dynamic groups of modules that can be used as
1646 * shortcuts.
1647 *
1648 * YUI({
1649 * aliases: {
1650 * davglass: [ 'node', 'yql', 'dd' ],
1651 * mine: [ 'davglass', 'autocomplete']
1652 * }
1653 * }).use('mine', function(Y) {
1654 * //Node, YQL, DD & AutoComplete available here..
1655 * });
1656 *
1657 * @property aliases
1658 * @type object
1659 */
1661 /**
1662 * A hash of module group definitions. It for each group you
1663 * can specify a list of modules and the base path and
1664 * combo spec to use when dynamically loading the modules.
1665 *
1666 * groups: {
1667 * yui2: {
1668 * // specify whether or not this group has a combo service
1669 * combine: true,
1670 *
1671 * // The comboSeperator to use with this group's combo handler
1672 * comboSep: ';',
1673 *
1674 * // The maxURLLength for this server
1675 * maxURLLength: 500,
1676 *
1677 * // the base path for non-combo paths
1678 * base: 'http://yui.yahooapis.com/2.8.0r4/build/',
1679 *
1680 * // the path to the combo service
1681 * comboBase: 'http://yui.yahooapis.com/combo?',
1682 *
1683 * // a fragment to prepend to the path attribute when
1684 * // when building combo urls
1685 * root: '2.8.0r4/build/',
1686 *
1687 * // the module definitions
1688 * modules: {
1689 * yui2_yde: {
1690 * path: "yahoo-dom-event/yahoo-dom-event.js"
1691 * },
1692 * yui2_anim: {
1693 * path: "animation/animation.js",
1694 * requires: ['yui2_yde']
1695 * }
1696 * }
1697 * }
1698 * }
1699 *
1700 * @property groups
1701 * @type object
1702 */
1704 /**
1705 * The loader 'path' attribute to the loader itself. This is combined
1706 * with the 'base' attribute to dynamically load the loader component
1707 * when boostrapping with the get utility alone.
1708 *
1709 * @property loaderPath
1710 * @type string
1711 * @default loader/loader-min.js
1712 */
1714 /**
1715 * Specifies whether or not YUI().use(...) will attempt to load CSS
1716 * resources at all. Any truthy value will cause CSS dependencies
1717 * to load when fetching script. The special value 'force' will
1718 * cause CSS dependencies to be loaded even if no script is needed.
1719 *
1720 * @property fetchCSS
1721 * @type boolean|string
1722 * @default true
1723 */
1725 /**
1726 * The default gallery version to build gallery module urls
1727 * @property gallery
1728 * @type string
1729 * @since 3.1.0
1730 */
1732 /**
1733 * The default YUI 2 version to build yui2 module urls. This is for
1734 * intrinsic YUI 2 support via the 2in3 project. Also see the '2in3'
1735 * config for pulling different revisions of the wrapped YUI 2
1736 * modules.
1737 * @since 3.1.0
1738 * @property yui2
1739 * @type string
1740 * @default 2.9.0
1741 */
1743 /**
1744 * The 2in3 project is a deployment of the various versions of YUI 2
1745 * deployed as first-class YUI 3 modules. Eventually, the wrapper
1746 * for the modules will change (but the underlying YUI 2 code will
1747 * be the same), and you can select a particular version of
1748 * the wrapper modules via this config.
1749 * @since 3.1.0
1750 * @property 2in3
1751 * @type string
1752 * @default 4
1753 */
1755 /**
1756 * Alternative console log function for use in environments without
1757 * a supported native console. The function is executed in the
1758 * YUI instance context.
1759 * @since 3.1.0
1760 * @property logFn
1761 * @type Function
1762 */
1764 /**
1765 * A callback to execute when Y.error is called. It receives the
1766 * error message and an javascript error object if Y.error was
1767 * executed because a javascript error was caught. The function
1768 * is executed in the YUI instance context. Returning `true` from this
1769 * function will stop the Error from being thrown.
1770 *
1771 * @since 3.2.0
1772 * @property errorFn
1773 * @type Function
1774 */
1776 /**
1777 * A callback to execute when the loader fails to load one or
1778 * more resource. This could be because of a script load
1779 * failure. It can also fail if a javascript module fails
1780 * to register itself, but only when the 'requireRegistration'
1781 * is true. If this function is defined, the use() callback will
1782 * only be called when the loader succeeds, otherwise it always
1783 * executes unless there was a javascript error when attaching
1784 * a module.
1785 *
1786 * @since 3.3.0
1787 * @property loadErrorFn
1788 * @type Function
1789 */
1791 /**
1792 * When set to true, the YUI loader will expect that all modules
1793 * it is responsible for loading will be first-class YUI modules
1794 * that register themselves with the YUI global. If this is
1795 * set to true, loader will fail if the module registration fails
1796 * to happen after the script is loaded.
1797 *
1798 * @since 3.3.0
1799 * @property requireRegistration
1800 * @type boolean
1801 * @default false
1802 */
1804 /**
1805 * Cache serviced use() requests.
1806 * @since 3.3.0
1807 * @property cacheUse
1808 * @type boolean
1809 * @default true
1810 * @deprecated no longer used
1811 */
1813 /**
1814 * Whether or not YUI should use native ES5 functionality when available for
1815 * features like `Y.Array.each()`, `Y.Object()`, etc. When `false`, YUI will
1816 * always use its own fallback implementations instead of relying on ES5
1817 * functionality, even when it's available.
1818 *
1819 * @method useNativeES5
1820 * @type Boolean
1821 * @default true
1822 * @since 3.5.0
1823 */
1824 YUI.add('yui-base', function(Y) {
1826 /*
1827 * YUI stub
1828 * @module yui
1829 * @submodule yui-base
1830 */
1831 /**
1832 * The YUI module contains the components required for building the YUI
1833 * seed file. This includes the script loading mechanism, a simple queue,
1834 * and the core utilities for the library.
1835 * @module yui
1836 * @submodule yui-base
1837 */
1839 /**
1840 * Provides core language utilites and extensions used throughout YUI.
1841 *
1842 * @class Lang
1843 * @static
1844 */
1846 var L = Y.Lang || (Y.Lang = {}),
1848 STRING_PROTO = String.prototype,
1849 TOSTRING = Object.prototype.toString,
1851 TYPES = {
1852 'undefined' : 'undefined',
1853 'number' : 'number',
1854 'boolean' : 'boolean',
1855 'string' : 'string',
1856 '[object Function]': 'function',
1857 '[object RegExp]' : 'regexp',
1858 '[object Array]' : 'array',
1859 '[object Date]' : 'date',
1860 '[object Error]' : 'error'
1861 },
1863 SUBREGEX = /\{\s*([^|}]+?)\s*(?:\|([^}]*))?\s*\}/g,
1864 TRIMREGEX = /^\s+|\s+$/g,
1865 NATIVE_FN_REGEX = /\{\s*\[(?:native code|function)\]\s*\}/i;
1867 // -- Protected Methods --------------------------------------------------------
1869 /**
1870 Returns `true` if the given function appears to be implemented in native code,
1871 `false` otherwise. Will always return `false` -- even in ES5-capable browsers --
1872 if the `useNativeES5` YUI config option is set to `false`.
1874 This isn't guaranteed to be 100% accurate and won't work for anything other than
1875 functions, but it can be useful for determining whether a function like
1876 `Array.prototype.forEach` is native or a JS shim provided by another library.
1878 There's a great article by @kangax discussing certain flaws with this technique:
1879 <http://perfectionkills.com/detecting-built-in-host-methods/>
1881 While his points are valid, it's still possible to benefit from this function
1882 as long as it's used carefully and sparingly, and in such a way that false
1883 negatives have minimal consequences. It's used internally to avoid using
1884 potentially broken non-native ES5 shims that have been added to the page by
1885 other libraries.
1887 @method _isNative
1888 @param {Function} fn Function to test.
1889 @return {Boolean} `true` if _fn_ appears to be native, `false` otherwise.
1890 @static
1891 @protected
1892 @since 3.5.0
1893 **/
1894 L._isNative = function (fn) {
1895 return !!(Y.config.useNativeES5 && fn && NATIVE_FN_REGEX.test(fn));
1896 };
1898 // -- Public Methods -----------------------------------------------------------
1900 /**
1901 * Determines whether or not the provided item is an array.
1902 *
1903 * Returns `false` for array-like collections such as the function `arguments`
1904 * collection or `HTMLElement` collections. Use `Y.Array.test()` if you want to
1905 * test for an array-like collection.
1906 *
1907 * @method isArray
1908 * @param o The object to test.
1909 * @return {boolean} true if o is an array.
1910 * @static
1911 */
1912 L.isArray = L._isNative(Array.isArray) ? Array.isArray : function (o) {
1913 return L.type(o) === 'array';
1914 };
1916 /**
1917 * Determines whether or not the provided item is a boolean.
1918 * @method isBoolean
1919 * @static
1920 * @param o The object to test.
1921 * @return {boolean} true if o is a boolean.
1922 */
1923 L.isBoolean = function(o) {
1924 return typeof o === 'boolean';
1925 };
1927 /**
1928 * Determines whether or not the supplied item is a date instance.
1929 * @method isDate
1930 * @static
1931 * @param o The object to test.
1932 * @return {boolean} true if o is a date.
1933 */
1934 L.isDate = function(o) {
1935 return L.type(o) === 'date' && o.toString() !== 'Invalid Date' && !isNaN(o);
1936 };
1938 /**
1939 * <p>
1940 * Determines whether or not the provided item is a function.
1941 * Note: Internet Explorer thinks certain functions are objects:
1942 * </p>
1943 *
1944 * <pre>
1945 * var obj = document.createElement("object");
1946 * Y.Lang.isFunction(obj.getAttribute) // reports false in IE
1947 *
1948 * var input = document.createElement("input"); // append to body
1949 * Y.Lang.isFunction(input.focus) // reports false in IE
1950 * </pre>
1951 *
1952 * <p>
1953 * You will have to implement additional tests if these functions
1954 * matter to you.
1955 * </p>
1956 *
1957 * @method isFunction
1958 * @static
1959 * @param o The object to test.
1960 * @return {boolean} true if o is a function.
1961 */
1962 L.isFunction = function(o) {
1963 return L.type(o) === 'function';
1964 };
1966 /**
1967 * Determines whether or not the provided item is null.
1968 * @method isNull
1969 * @static
1970 * @param o The object to test.
1971 * @return {boolean} true if o is null.
1972 */
1973 L.isNull = function(o) {
1974 return o === null;
1975 };
1977 /**
1978 * Determines whether or not the provided item is a legal number.
1979 * @method isNumber
1980 * @static
1981 * @param o The object to test.
1982 * @return {boolean} true if o is a number.
1983 */
1984 L.isNumber = function(o) {
1985 return typeof o === 'number' && isFinite(o);
1986 };
1988 /**
1989 * Determines whether or not the provided item is of type object
1990 * or function. Note that arrays are also objects, so
1991 * <code>Y.Lang.isObject([]) === true</code>.
1992 * @method isObject
1993 * @static
1994 * @param o The object to test.
1995 * @param failfn {boolean} fail if the input is a function.
1996 * @return {boolean} true if o is an object.
1997 * @see isPlainObject
1998 */
1999 L.isObject = function(o, failfn) {
2000 var t = typeof o;
2001 return (o && (t === 'object' ||
2002 (!failfn && (t === 'function' || L.isFunction(o))))) || false;
2003 };
2005 /**
2006 * Determines whether or not the provided item is a string.
2007 * @method isString
2008 * @static
2009 * @param o The object to test.
2010 * @return {boolean} true if o is a string.
2011 */
2012 L.isString = function(o) {
2013 return typeof o === 'string';
2014 };
2016 /**
2017 * Determines whether or not the provided item is undefined.
2018 * @method isUndefined
2019 * @static
2020 * @param o The object to test.
2021 * @return {boolean} true if o is undefined.
2022 */
2023 L.isUndefined = function(o) {
2024 return typeof o === 'undefined';
2025 };
2027 /**
2028 * A convenience method for detecting a legitimate non-null value.
2029 * Returns false for null/undefined/NaN, true for other values,
2030 * including 0/false/''
2031 * @method isValue
2032 * @static
2033 * @param o The item to test.
2034 * @return {boolean} true if it is not null/undefined/NaN || false.
2035 */
2036 L.isValue = function(o) {
2037 var t = L.type(o);
2039 switch (t) {
2040 case 'number':
2041 return isFinite(o);
2043 case 'null': // fallthru
2044 case 'undefined':
2045 return false;
2047 default:
2048 return !!t;
2049 }
2050 };
2052 /**
2053 * Returns the current time in milliseconds.
2054 *
2055 * @method now
2056 * @return {Number} Current time in milliseconds.
2057 * @static
2058 * @since 3.3.0
2059 */
2060 L.now = Date.now || function () {
2061 return new Date().getTime();
2062 };
2064 /**
2065 * Lightweight version of <code>Y.substitute</code>. Uses the same template
2066 * structure as <code>Y.substitute</code>, but doesn't support recursion,
2067 * auto-object coersion, or formats.
2068 * @method sub
2069 * @param {string} s String to be modified.
2070 * @param {object} o Object containing replacement values.
2071 * @return {string} the substitute result.
2072 * @static
2073 * @since 3.2.0
2074 */
2075 L.sub = function(s, o) {
2076 return s.replace ? s.replace(SUBREGEX, function (match, key) {
2077 return L.isUndefined(o[key]) ? match : o[key];
2078 }) : s;
2079 };
2081 /**
2082 * Returns a string without any leading or trailing whitespace. If
2083 * the input is not a string, the input will be returned untouched.
2084 * @method trim
2085 * @static
2086 * @param s {string} the string to trim.
2087 * @return {string} the trimmed string.
2088 */
2089 L.trim = STRING_PROTO.trim ? function(s) {
2090 return s && s.trim ? s.trim() : s;
2091 } : function (s) {
2092 try {
2093 return s.replace(TRIMREGEX, '');
2094 } catch (e) {
2095 return s;
2096 }
2097 };
2099 /**
2100 * Returns a string without any leading whitespace.
2101 * @method trimLeft
2102 * @static
2103 * @param s {string} the string to trim.
2104 * @return {string} the trimmed string.
2105 */
2106 L.trimLeft = STRING_PROTO.trimLeft ? function (s) {
2107 return s.trimLeft();
2108 } : function (s) {
2109 return s.replace(/^\s+/, '');
2110 };
2112 /**
2113 * Returns a string without any trailing whitespace.
2114 * @method trimRight
2115 * @static
2116 * @param s {string} the string to trim.
2117 * @return {string} the trimmed string.
2118 */
2119 L.trimRight = STRING_PROTO.trimRight ? function (s) {
2120 return s.trimRight();
2121 } : function (s) {
2122 return s.replace(/\s+$/, '');
2123 };
2125 /**
2126 Returns one of the following strings, representing the type of the item passed
2127 in:
2129 * "array"
2130 * "boolean"
2131 * "date"
2132 * "error"
2133 * "function"
2134 * "null"
2135 * "number"
2136 * "object"
2137 * "regexp"
2138 * "string"
2139 * "undefined"
2141 Known issues:
2143 * `typeof HTMLElementCollection` returns function in Safari, but
2144 `Y.Lang.type()` reports "object", which could be a good thing --
2145 but it actually caused the logic in <code>Y.Lang.isObject</code> to fail.
2147 @method type
2148 @param o the item to test.
2149 @return {string} the detected type.
2150 @static
2151 **/
2152 L.type = function(o) {
2153 return TYPES[typeof o] || TYPES[TOSTRING.call(o)] || (o ? 'object' : 'null');
2154 };
2155 /**
2156 @module yui
2157 @submodule yui-base
2158 */
2160 var Lang = Y.Lang,
2161 Native = Array.prototype,
2163 hasOwn = Object.prototype.hasOwnProperty;
2165 /**
2166 Provides utility methods for working with arrays. Additional array helpers can
2167 be found in the `collection` and `array-extras` modules.
2169 `Y.Array(thing)` returns a native array created from _thing_. Depending on
2170 _thing_'s type, one of the following will happen:
2172 * Arrays are returned unmodified unless a non-zero _startIndex_ is
2173 specified.
2174 * Array-like collections (see `Array.test()`) are converted to arrays.
2175 * For everything else, a new array is created with _thing_ as the sole
2176 item.
2178 Note: elements that are also collections, such as `<form>` and `<select>`
2179 elements, are not automatically converted to arrays. To force a conversion,
2180 pass `true` as the value of the _force_ parameter.
2182 @class Array
2183 @constructor
2184 @param {Any} thing The thing to arrayify.
2185 @param {Number} [startIndex=0] If non-zero and _thing_ is an array or array-like
2186 collection, a subset of items starting at the specified index will be
2187 returned.
2188 @param {Boolean} [force=false] If `true`, _thing_ will be treated as an
2189 array-like collection no matter what.
2190 @return {Array} A native array created from _thing_, according to the rules
2191 described above.
2192 **/
2193 function YArray(thing, startIndex, force) {
2194 var len, result;
2196 startIndex || (startIndex = 0);
2198 if (force || YArray.test(thing)) {
2199 // IE throws when trying to slice HTMLElement collections.
2200 try {
2201 return Native.slice.call(thing, startIndex);
2202 } catch (ex) {
2203 result = [];
2205 for (len = thing.length; startIndex < len; ++startIndex) {
2206 result.push(thing[startIndex]);
2207 }
2209 return result;
2210 }
2211 }
2213 return [thing];
2214 }
2216 Y.Array = YArray;
2218 /**
2219 Dedupes an array of strings, returning an array that's guaranteed to contain
2220 only one copy of a given string.
2222 This method differs from `Array.unique()` in that it's optimized for use only
2223 with strings, whereas `unique` may be used with other types (but is slower).
2224 Using `dedupe()` with non-string values may result in unexpected behavior.
2226 @method dedupe
2227 @param {String[]} array Array of strings to dedupe.
2228 @return {Array} Deduped copy of _array_.
2229 @static
2230 @since 3.4.0
2231 **/
2232 YArray.dedupe = function (array) {
2233 var hash = {},
2234 results = [],
2235 i, item, len;
2237 for (i = 0, len = array.length; i < len; ++i) {
2238 item = array[i];
2240 if (!hasOwn.call(hash, item)) {
2241 hash[item] = 1;
2242 results.push(item);
2243 }
2244 }
2246 return results;
2247 };
2249 /**
2250 Executes the supplied function on each item in the array. This method wraps
2251 the native ES5 `Array.forEach()` method if available.
2253 @method each
2254 @param {Array} array Array to iterate.
2255 @param {Function} fn Function to execute on each item in the array. The function
2256 will receive the following arguments:
2257 @param {Any} fn.item Current array item.
2258 @param {Number} fn.index Current array index.
2259 @param {Array} fn.array Array being iterated.
2260 @param {Object} [thisObj] `this` object to use when calling _fn_.
2261 @return {YUI} The YUI instance.
2262 @static
2263 **/
2264 YArray.each = YArray.forEach = Lang._isNative(Native.forEach) ? function (array, fn, thisObj) {
2265 Native.forEach.call(array || [], fn, thisObj || Y);
2266 return Y;
2267 } : function (array, fn, thisObj) {
2268 for (var i = 0, len = (array && array.length) || 0; i < len; ++i) {
2269 if (i in array) {
2270 fn.call(thisObj || Y, array[i], i, array);
2271 }
2272 }
2274 return Y;
2275 };
2277 /**
2278 Alias for `each()`.
2280 @method forEach
2281 @static
2282 **/
2284 /**
2285 Returns an object using the first array as keys and the second as values. If
2286 the second array is not provided, or if it doesn't contain the same number of
2287 values as the first array, then `true` will be used in place of the missing
2288 values.
2290 @example
2292 Y.Array.hash(['a', 'b', 'c'], ['foo', 'bar']);
2293 // => {a: 'foo', b: 'bar', c: true}
2295 @method hash
2296 @param {String[]} keys Array of strings to use as keys.
2297 @param {Array} [values] Array to use as values.
2298 @return {Object} Hash using the first array as keys and the second as values.
2299 @static
2300 **/
2301 YArray.hash = function (keys, values) {
2302 var hash = {},
2303 vlen = (values && values.length) || 0,
2304 i, len;
2306 for (i = 0, len = keys.length; i < len; ++i) {
2307 if (i in keys) {
2308 hash[keys[i]] = vlen > i && i in values ? values[i] : true;
2309 }
2310 }
2312 return hash;
2313 };
2315 /**
2316 Returns the index of the first item in the array that's equal (using a strict
2317 equality check) to the specified _value_, or `-1` if the value isn't found.
2319 This method wraps the native ES5 `Array.indexOf()` method if available.
2321 @method indexOf
2322 @param {Array} array Array to search.
2323 @param {Any} value Value to search for.
2324 @param {Number} [from=0] The index at which to begin the search.
2325 @return {Number} Index of the item strictly equal to _value_, or `-1` if not
2326 found.
2327 @static
2328 **/
2329 YArray.indexOf = Lang._isNative(Native.indexOf) ? function (array, value, from) {
2330 return Native.indexOf.call(array, value, from);
2331 } : function (array, value, from) {
2332 // http://es5.github.com/#x15.4.4.14
2333 var len = array.length;
2335 from = +from || 0;
2336 from = (from > 0 || -1) * Math.floor(Math.abs(from));
2338 if (from < 0) {
2339 from += len;
2341 if (from < 0) {
2342 from = 0;
2343 }
2344 }
2346 for (; from < len; ++from) {
2347 if (from in array && array[from] === value) {
2348 return from;
2349 }
2350 }
2352 return -1;
2353 };
2355 /**
2356 Numeric sort convenience function.
2358 The native `Array.prototype.sort()` function converts values to strings and
2359 sorts them in lexicographic order, which is unsuitable for sorting numeric
2360 values. Provide `Array.numericSort` as a custom sort function when you want
2361 to sort values in numeric order.
2363 @example
2365 [42, 23, 8, 16, 4, 15].sort(Y.Array.numericSort);
2366 // => [4, 8, 15, 16, 23, 42]
2368 @method numericSort
2369 @param {Number} a First value to compare.
2370 @param {Number} b Second value to compare.
2371 @return {Number} Difference between _a_ and _b_.
2372 @static
2373 **/
2374 YArray.numericSort = function (a, b) {
2375 return a - b;
2376 };
2378 /**
2379 Executes the supplied function on each item in the array. Returning a truthy
2380 value from the function will stop the processing of remaining items.
2382 @method some
2383 @param {Array} array Array to iterate over.
2384 @param {Function} fn Function to execute on each item. The function will receive
2385 the following arguments:
2386 @param {Any} fn.value Current array item.
2387 @param {Number} fn.index Current array index.
2388 @param {Array} fn.array Array being iterated over.
2389 @param {Object} [thisObj] `this` object to use when calling _fn_.
2390 @return {Boolean} `true` if the function returns a truthy value on any of the
2391 items in the array; `false` otherwise.
2392 @static
2393 **/
2394 YArray.some = Lang._isNative(Native.some) ? function (array, fn, thisObj) {
2395 return Native.some.call(array, fn, thisObj);
2396 } : function (array, fn, thisObj) {
2397 for (var i = 0, len = array.length; i < len; ++i) {
2398 if (i in array && fn.call(thisObj, array[i], i, array)) {
2399 return true;
2400 }
2401 }
2403 return false;
2404 };
2406 /**
2407 Evaluates _obj_ to determine if it's an array, an array-like collection, or
2408 something else. This is useful when working with the function `arguments`
2409 collection and `HTMLElement` collections.
2411 Note: This implementation doesn't consider elements that are also
2412 collections, such as `<form>` and `<select>`, to be array-like.
2414 @method test
2415 @param {Object} obj Object to test.
2416 @return {Number} A number indicating the results of the test:
2418 * 0: Neither an array nor an array-like collection.
2419 * 1: Real array.
2420 * 2: Array-like collection.
2422 @static
2423 **/
2424 YArray.test = function (obj) {
2425 var result = 0;
2427 if (Lang.isArray(obj)) {
2428 result = 1;
2429 } else if (Lang.isObject(obj)) {
2430 try {
2431 // indexed, but no tagName (element) or alert (window),
2432 // or functions without apply/call (Safari
2433 // HTMLElementCollection bug).
2434 if ('length' in obj && !obj.tagName && !obj.alert && !obj.apply) {
2435 result = 2;
2436 }
2437 } catch (ex) {}
2438 }
2440 return result;
2441 };
2442 /**
2443 * The YUI module contains the components required for building the YUI
2444 * seed file. This includes the script loading mechanism, a simple queue,
2445 * and the core utilities for the library.
2446 * @module yui
2447 * @submodule yui-base
2448 */
2450 /**
2451 * A simple FIFO queue. Items are added to the Queue with add(1..n items) and
2452 * removed using next().
2453 *
2454 * @class Queue
2455 * @constructor
2456 * @param {MIXED} item* 0..n items to seed the queue.
2457 */
2458 function Queue() {
2459 this._init();
2460 this.add.apply(this, arguments);
2461 }
2463 Queue.prototype = {
2464 /**
2465 * Initialize the queue
2466 *
2467 * @method _init
2468 * @protected
2469 */
2470 _init: function() {
2471 /**
2472 * The collection of enqueued items
2473 *
2474 * @property _q
2475 * @type Array
2476 * @protected
2477 */
2478 this._q = [];
2479 },
2481 /**
2482 * Get the next item in the queue. FIFO support
2483 *
2484 * @method next
2485 * @return {MIXED} the next item in the queue.
2486 */
2487 next: function() {
2488 return this._q.shift();
2489 },
2491 /**
2492 * Get the last in the queue. LIFO support.
2493 *
2494 * @method last
2495 * @return {MIXED} the last item in the queue.
2496 */
2497 last: function() {
2498 return this._q.pop();
2499 },
2501 /**
2502 * Add 0..n items to the end of the queue.
2503 *
2504 * @method add
2505 * @param {MIXED} item* 0..n items.
2506 * @return {object} this queue.
2507 */
2508 add: function() {
2509 this._q.push.apply(this._q, arguments);
2511 return this;
2512 },
2514 /**
2515 * Returns the current number of queued items.
2516 *
2517 * @method size
2518 * @return {Number} The size.
2519 */
2520 size: function() {
2521 return this._q.length;
2522 }
2523 };
2525 Y.Queue = Queue;
2527 YUI.Env._loaderQueue = YUI.Env._loaderQueue || new Queue();
2529 /**
2530 The YUI module contains the components required for building the YUI seed file.
2531 This includes the script loading mechanism, a simple queue, and the core
2532 utilities for the library.
2534 @module yui
2535 @submodule yui-base
2536 **/
2538 var CACHED_DELIMITER = '__',
2540 hasOwn = Object.prototype.hasOwnProperty,
2541 isObject = Y.Lang.isObject;
2543 /**
2544 Returns a wrapper for a function which caches the return value of that function,
2545 keyed off of the combined string representation of the argument values provided
2546 when the wrapper is called.
2548 Calling this function again with the same arguments will return the cached value
2549 rather than executing the wrapped function.
2551 Note that since the cache is keyed off of the string representation of arguments
2552 passed to the wrapper function, arguments that aren't strings and don't provide
2553 a meaningful `toString()` method may result in unexpected caching behavior. For
2554 example, the objects `{}` and `{foo: 'bar'}` would both be converted to the
2555 string `[object Object]` when used as a cache key.
2557 @method cached
2558 @param {Function} source The function to memoize.
2559 @param {Object} [cache={}] Object in which to store cached values. You may seed
2560 this object with pre-existing cached values if desired.
2561 @param {any} [refetch] If supplied, this value is compared with the cached value
2562 using a `==` comparison. If the values are equal, the wrapped function is
2563 executed again even though a cached value exists.
2564 @return {Function} Wrapped function.
2565 @for YUI
2566 **/
2567 Y.cached = function (source, cache, refetch) {
2568 cache || (cache = {});
2570 return function (arg) {
2571 var key = arguments.length > 1 ?
2572 Array.prototype.join.call(arguments, CACHED_DELIMITER) :
2573 String(arg);
2575 if (!(key in cache) || (refetch && cache[key] == refetch)) {
2576 cache[key] = source.apply(source, arguments);
2577 }
2579 return cache[key];
2580 };
2581 };
2583 /**
2584 Returns the `location` object from the window/frame in which this YUI instance
2585 operates, or `undefined` when executing in a non-browser environment
2586 (e.g. Node.js).
2588 It is _not_ recommended to hold references to the `window.location` object
2589 outside of the scope of a function in which its properties are being accessed or
2590 its methods are being called. This is because of a nasty bug/issue that exists
2591 in both Safari and MobileSafari browsers:
2592 [WebKit Bug 34679](https://bugs.webkit.org/show_bug.cgi?id=34679).
2594 @method getLocation
2595 @return {location} The `location` object from the window/frame in which this YUI
2596 instance operates.
2597 @since 3.5.0
2598 **/
2599 Y.getLocation = function () {
2600 // It is safer to look this up every time because yui-base is attached to a
2601 // YUI instance before a user's config is applied; i.e. `Y.config.win` does
2602 // not point the correct window object when this file is loaded.
2603 var win = Y.config.win;
2605 // It is not safe to hold a reference to the `location` object outside the
2606 // scope in which it is being used. The WebKit engine used in Safari and
2607 // MobileSafari will "disconnect" the `location` object from the `window`
2608 // when a page is restored from back/forward history cache.
2609 return win && win.location;
2610 };
2612 /**
2613 Returns a new object containing all of the properties of all the supplied
2614 objects. The properties from later objects will overwrite those in earlier
2615 objects.
2617 Passing in a single object will create a shallow copy of it. For a deep copy,
2618 use `clone()`.
2620 @method merge
2621 @param {Object} objects* One or more objects to merge.
2622 @return {Object} A new merged object.
2623 **/
2624 Y.merge = function () {
2625 var args = arguments,
2626 i = 0,
2627 len = args.length,
2628 result = {};
2630 for (; i < len; ++i) {
2631 Y.mix(result, args[i], true);
2632 }
2634 return result;
2635 };
2637 /**
2638 Mixes _supplier_'s properties into _receiver_.
2640 Properties on _receiver_ or _receiver_'s prototype will not be overwritten or
2641 shadowed unless the _overwrite_ parameter is `true`, and will not be merged
2642 unless the _merge_ parameter is `true`.
2644 In the default mode (0), only properties the supplier owns are copied (prototype
2645 properties are not copied). The following copying modes are available:
2647 * `0`: _Default_. Object to object.
2648 * `1`: Prototype to prototype.
2649 * `2`: Prototype to prototype and object to object.
2650 * `3`: Prototype to object.
2651 * `4`: Object to prototype.
2653 @method mix
2654 @param {Function|Object} receiver The object or function to receive the mixed
2655 properties.
2656 @param {Function|Object} supplier The object or function supplying the
2657 properties to be mixed.
2658 @param {Boolean} [overwrite=false] If `true`, properties that already exist
2659 on the receiver will be overwritten with properties from the supplier.
2660 @param {String[]} [whitelist] An array of property names to copy. If
2661 specified, only the whitelisted properties will be copied, and all others
2662 will be ignored.
2663 @param {Number} [mode=0] Mix mode to use. See above for available modes.
2664 @param {Boolean} [merge=false] If `true`, objects and arrays that already
2665 exist on the receiver will have the corresponding object/array from the
2666 supplier merged into them, rather than being skipped or overwritten. When
2667 both _overwrite_ and _merge_ are `true`, _merge_ takes precedence.
2668 @return {Function|Object|YUI} The receiver, or the YUI instance if the
2669 specified receiver is falsy.
2670 **/
2671 Y.mix = function(receiver, supplier, overwrite, whitelist, mode, merge) {
2672 var alwaysOverwrite, exists, from, i, key, len, to;
2674 // If no supplier is given, we return the receiver. If no receiver is given,
2675 // we return Y. Returning Y doesn't make much sense to me, but it's
2676 // grandfathered in for backcompat reasons.
2677 if (!receiver || !supplier) {
2678 return receiver || Y;
2679 }
2681 if (mode) {
2682 // In mode 2 (prototype to prototype and object to object), we recurse
2683 // once to do the proto to proto mix. The object to object mix will be
2684 // handled later on.
2685 if (mode === 2) {
2686 Y.mix(receiver.prototype, supplier.prototype, overwrite,
2687 whitelist, 0, merge);
2688 }
2690 // Depending on which mode is specified, we may be copying from or to
2691 // the prototypes of the supplier and receiver.
2692 from = mode === 1 || mode === 3 ? supplier.prototype : supplier;
2693 to = mode === 1 || mode === 4 ? receiver.prototype : receiver;
2695 // If either the supplier or receiver doesn't actually have a
2696 // prototype property, then we could end up with an undefined `from`
2697 // or `to`. If that happens, we abort and return the receiver.
2698 if (!from || !to) {
2699 return receiver;
2700 }
2701 } else {
2702 from = supplier;
2703 to = receiver;
2704 }
2706 // If `overwrite` is truthy and `merge` is falsy, then we can skip a
2707 // property existence check on each iteration and save some time.
2708 alwaysOverwrite = overwrite && !merge;
2710 if (whitelist) {
2711 for (i = 0, len = whitelist.length; i < len; ++i) {
2712 key = whitelist[i];
2714 // We call `Object.prototype.hasOwnProperty` instead of calling
2715 // `hasOwnProperty` on the object itself, since the object's
2716 // `hasOwnProperty` method may have been overridden or removed.
2717 // Also, some native objects don't implement a `hasOwnProperty`
2718 // method.
2719 if (!hasOwn.call(from, key)) {
2720 continue;
2721 }
2723 // The `key in to` check here is (sadly) intentional for backwards
2724 // compatibility reasons. It prevents undesired shadowing of
2725 // prototype members on `to`.
2726 exists = alwaysOverwrite ? false : key in to;
2728 if (merge && exists && isObject(to[key], true)
2729 && isObject(from[key], true)) {
2730 // If we're in merge mode, and the key is present on both
2731 // objects, and the value on both objects is either an object or
2732 // an array (but not a function), then we recurse to merge the
2733 // `from` value into the `to` value instead of overwriting it.
2734 //
2735 // Note: It's intentional that the whitelist isn't passed to the
2736 // recursive call here. This is legacy behavior that lots of
2737 // code still depends on.
2738 Y.mix(to[key], from[key], overwrite, null, 0, merge);
2739 } else if (overwrite || !exists) {
2740 // We're not in merge mode, so we'll only copy the `from` value
2741 // to the `to` value if we're in overwrite mode or if the
2742 // current key doesn't exist on the `to` object.
2743 to[key] = from[key];
2744 }
2745 }
2746 } else {
2747 for (key in from) {
2748 // The code duplication here is for runtime performance reasons.
2749 // Combining whitelist and non-whitelist operations into a single
2750 // loop or breaking the shared logic out into a function both result
2751 // in worse performance, and Y.mix is critical enough that the byte
2752 // tradeoff is worth it.
2753 if (!hasOwn.call(from, key)) {
2754 continue;
2755 }
2757 // The `key in to` check here is (sadly) intentional for backwards
2758 // compatibility reasons. It prevents undesired shadowing of
2759 // prototype members on `to`.
2760 exists = alwaysOverwrite ? false : key in to;
2762 if (merge && exists && isObject(to[key], true)
2763 && isObject(from[key], true)) {
2764 Y.mix(to[key], from[key], overwrite, null, 0, merge);
2765 } else if (overwrite || !exists) {
2766 to[key] = from[key];
2767 }
2768 }
2770 // If this is an IE browser with the JScript enumeration bug, force
2771 // enumeration of the buggy properties by making a recursive call with
2772 // the buggy properties as the whitelist.
2773 if (Y.Object._hasEnumBug) {
2774 Y.mix(to, from, overwrite, Y.Object._forceEnum, mode, merge);
2775 }
2776 }
2778 return receiver;
2779 };
2780 /**
2781 * The YUI module contains the components required for building the YUI
2782 * seed file. This includes the script loading mechanism, a simple queue,
2783 * and the core utilities for the library.
2784 * @module yui
2785 * @submodule yui-base
2786 */
2788 /**
2789 * Adds utilities to the YUI instance for working with objects.
2790 *
2791 * @class Object
2792 */
2794 var Lang = Y.Lang,
2795 hasOwn = Object.prototype.hasOwnProperty,
2797 UNDEFINED, // <-- Note the comma. We're still declaring vars.
2799 /**
2800 * Returns a new object that uses _obj_ as its prototype. This method wraps the
2801 * native ES5 `Object.create()` method if available, but doesn't currently
2802 * pass through `Object.create()`'s second argument (properties) in order to
2803 * ensure compatibility with older browsers.
2804 *
2805 * @method ()
2806 * @param {Object} obj Prototype object.
2807 * @return {Object} New object using _obj_ as its prototype.
2808 * @static
2809 */
2810 O = Y.Object = Lang._isNative(Object.create) ? function (obj) {
2811 // We currently wrap the native Object.create instead of simply aliasing it
2812 // to ensure consistency with our fallback shim, which currently doesn't
2813 // support Object.create()'s second argument (properties). Once we have a
2814 // safe fallback for the properties arg, we can stop wrapping
2815 // Object.create().
2816 return Object.create(obj);
2817 } : (function () {
2818 // Reusable constructor function for the Object.create() shim.
2819 function F() {}
2821 // The actual shim.
2822 return function (obj) {
2823 F.prototype = obj;
2824 return new F();
2825 };
2826 }()),
2828 /**
2829 * Property names that IE doesn't enumerate in for..in loops, even when they
2830 * should be enumerable. When `_hasEnumBug` is `true`, it's necessary to
2831 * manually enumerate these properties.
2832 *
2833 * @property _forceEnum
2834 * @type String[]
2835 * @protected
2836 * @static
2837 */
2838 forceEnum = O._forceEnum = [
2839 'hasOwnProperty',
2840 'isPrototypeOf',
2841 'propertyIsEnumerable',
2842 'toString',
2843 'toLocaleString',
2844 'valueOf'
2845 ],
2847 /**
2848 * `true` if this browser has the JScript enumeration bug that prevents
2849 * enumeration of the properties named in the `_forceEnum` array, `false`
2850 * otherwise.
2851 *
2852 * See:
2853 * - <https://developer.mozilla.org/en/ECMAScript_DontEnum_attribute#JScript_DontEnum_Bug>
2854 * - <http://whattheheadsaid.com/2010/10/a-safer-object-keys-compatibility-implementation>
2855 *
2856 * @property _hasEnumBug
2857 * @type Boolean
2858 * @protected
2859 * @static
2860 */
2861 hasEnumBug = O._hasEnumBug = !{valueOf: 0}.propertyIsEnumerable('valueOf'),
2863 /**
2864 * `true` if this browser incorrectly considers the `prototype` property of
2865 * functions to be enumerable. Currently known to affect Opera 11.50.
2866 *
2867 * @property _hasProtoEnumBug
2868 * @type Boolean
2869 * @protected
2870 * @static
2871 */
2872 hasProtoEnumBug = O._hasProtoEnumBug = (function () {}).propertyIsEnumerable('prototype'),
2874 /**
2875 * Returns `true` if _key_ exists on _obj_, `false` if _key_ doesn't exist or
2876 * exists only on _obj_'s prototype. This is essentially a safer version of
2877 * `obj.hasOwnProperty()`.
2878 *
2879 * @method owns
2880 * @param {Object} obj Object to test.
2881 * @param {String} key Property name to look for.
2882 * @return {Boolean} `true` if _key_ exists on _obj_, `false` otherwise.
2883 * @static
2884 */
2885 owns = O.owns = function (obj, key) {
2886 return !!obj && hasOwn.call(obj, key);
2887 }; // <-- End of var declarations.
2889 /**
2890 * Alias for `owns()`.
2891 *
2892 * @method hasKey
2893 * @param {Object} obj Object to test.
2894 * @param {String} key Property name to look for.
2895 * @return {Boolean} `true` if _key_ exists on _obj_, `false` otherwise.
2896 * @static
2897 */
2898 O.hasKey = owns;
2900 /**
2901 * Returns an array containing the object's enumerable keys. Does not include
2902 * prototype keys or non-enumerable keys.
2903 *
2904 * Note that keys are returned in enumeration order (that is, in the same order
2905 * that they would be enumerated by a `for-in` loop), which may not be the same
2906 * as the order in which they were defined.
2907 *
2908 * This method is an alias for the native ES5 `Object.keys()` method if
2909 * available.
2910 *
2911 * @example
2912 *
2913 * Y.Object.keys({a: 'foo', b: 'bar', c: 'baz'});
2914 * // => ['a', 'b', 'c']
2915 *
2916 * @method keys
2917 * @param {Object} obj An object.
2918 * @return {String[]} Array of keys.
2919 * @static
2920 */
2921 O.keys = Lang._isNative(Object.keys) ? Object.keys : function (obj) {
2922 if (!Lang.isObject(obj)) {
2923 throw new TypeError('Object.keys called on a non-object');
2924 }
2926 var keys = [],
2927 i, key, len;
2929 if (hasProtoEnumBug && typeof obj === 'function') {
2930 for (key in obj) {
2931 if (owns(obj, key) && key !== 'prototype') {
2932 keys.push(key);
2933 }
2934 }
2935 } else {
2936 for (key in obj) {
2937 if (owns(obj, key)) {
2938 keys.push(key);
2939 }
2940 }
2941 }
2943 if (hasEnumBug) {
2944 for (i = 0, len = forceEnum.length; i < len; ++i) {
2945 key = forceEnum[i];
2947 if (owns(obj, key)) {
2948 keys.push(key);
2949 }
2950 }
2951 }
2953 return keys;
2954 };
2956 /**
2957 * Returns an array containing the values of the object's enumerable keys.
2958 *
2959 * Note that values are returned in enumeration order (that is, in the same
2960 * order that they would be enumerated by a `for-in` loop), which may not be the
2961 * same as the order in which they were defined.
2962 *
2963 * @example
2964 *
2965 * Y.Object.values({a: 'foo', b: 'bar', c: 'baz'});
2966 * // => ['foo', 'bar', 'baz']
2967 *
2968 * @method values
2969 * @param {Object} obj An object.
2970 * @return {Array} Array of values.
2971 * @static
2972 */
2973 O.values = function (obj) {
2974 var keys = O.keys(obj),
2975 i = 0,
2976 len = keys.length,
2977 values = [];
2979 for (; i < len; ++i) {
2980 values.push(obj[keys[i]]);
2981 }
2983 return values;
2984 };
2986 /**
2987 * Returns the number of enumerable keys owned by an object.
2988 *
2989 * @method size
2990 * @param {Object} obj An object.
2991 * @return {Number} The object's size.
2992 * @static
2993 */
2994 O.size = function (obj) {
2995 try {
2996 return O.keys(obj).length;
2997 } catch (ex) {
2998 return 0; // Legacy behavior for non-objects.
2999 }
3000 };
3002 /**
3003 * Returns `true` if the object owns an enumerable property with the specified
3004 * value.
3005 *
3006 * @method hasValue
3007 * @param {Object} obj An object.
3008 * @param {any} value The value to search for.
3009 * @return {Boolean} `true` if _obj_ contains _value_, `false` otherwise.
3010 * @static
3011 */
3012 O.hasValue = function (obj, value) {
3013 return Y.Array.indexOf(O.values(obj), value) > -1;
3014 };
3016 /**
3017 * Executes a function on each enumerable property in _obj_. The function
3018 * receives the value, the key, and the object itself as parameters (in that
3019 * order).
3020 *
3021 * By default, only properties owned by _obj_ are enumerated. To include
3022 * prototype properties, set the _proto_ parameter to `true`.
3023 *
3024 * @method each
3025 * @param {Object} obj Object to enumerate.
3026 * @param {Function} fn Function to execute on each enumerable property.
3027 * @param {mixed} fn.value Value of the current property.
3028 * @param {String} fn.key Key of the current property.
3029 * @param {Object} fn.obj Object being enumerated.
3030 * @param {Object} [thisObj] `this` object to use when calling _fn_.
3031 * @param {Boolean} [proto=false] Include prototype properties.
3032 * @return {YUI} the YUI instance.
3033 * @chainable
3034 * @static
3035 */
3036 O.each = function (obj, fn, thisObj, proto) {
3037 var key;
3039 for (key in obj) {
3040 if (proto || owns(obj, key)) {
3041 fn.call(thisObj || Y, obj[key], key, obj);
3042 }
3043 }
3045 return Y;
3046 };
3048 /**
3049 * Executes a function on each enumerable property in _obj_, but halts if the
3050 * function returns a truthy value. The function receives the value, the key,
3051 * and the object itself as paramters (in that order).
3052 *
3053 * By default, only properties owned by _obj_ are enumerated. To include
3054 * prototype properties, set the _proto_ parameter to `true`.
3055 *
3056 * @method some
3057 * @param {Object} obj Object to enumerate.
3058 * @param {Function} fn Function to execute on each enumerable property.
3059 * @param {mixed} fn.value Value of the current property.
3060 * @param {String} fn.key Key of the current property.
3061 * @param {Object} fn.obj Object being enumerated.
3062 * @param {Object} [thisObj] `this` object to use when calling _fn_.
3063 * @param {Boolean} [proto=false] Include prototype properties.
3064 * @return {Boolean} `true` if any execution of _fn_ returns a truthy value,
3065 * `false` otherwise.
3066 * @static
3067 */
3068 O.some = function (obj, fn, thisObj, proto) {
3069 var key;
3071 for (key in obj) {
3072 if (proto || owns(obj, key)) {
3073 if (fn.call(thisObj || Y, obj[key], key, obj)) {
3074 return true;
3075 }
3076 }
3077 }
3079 return false;
3080 };
3082 /**
3083 * Retrieves the sub value at the provided path,
3084 * from the value object provided.
3085 *
3086 * @method getValue
3087 * @static
3088 * @param o The object from which to extract the property value.
3089 * @param path {Array} A path array, specifying the object traversal path
3090 * from which to obtain the sub value.
3091 * @return {Any} The value stored in the path, undefined if not found,
3092 * undefined if the source is not an object. Returns the source object
3093 * if an empty path is provided.
3094 */
3095 O.getValue = function(o, path) {
3096 if (!Lang.isObject(o)) {
3097 return UNDEFINED;
3098 }
3100 var i,
3101 p = Y.Array(path),
3102 l = p.length;
3104 for (i = 0; o !== UNDEFINED && i < l; i++) {
3105 o = o[p[i]];
3106 }
3108 return o;
3109 };
3111 /**
3112 * Sets the sub-attribute value at the provided path on the
3113 * value object. Returns the modified value object, or
3114 * undefined if the path is invalid.
3115 *
3116 * @method setValue
3117 * @static
3118 * @param o The object on which to set the sub value.
3119 * @param path {Array} A path array, specifying the object traversal path
3120 * at which to set the sub value.
3121 * @param val {Any} The new value for the sub-attribute.
3122 * @return {Object} The modified object, with the new sub value set, or
3123 * undefined, if the path was invalid.
3124 */
3125 O.setValue = function(o, path, val) {
3126 var i,
3127 p = Y.Array(path),
3128 leafIdx = p.length - 1,
3129 ref = o;
3131 if (leafIdx >= 0) {
3132 for (i = 0; ref !== UNDEFINED && i < leafIdx; i++) {
3133 ref = ref[p[i]];
3134 }
3136 if (ref !== UNDEFINED) {
3137 ref[p[i]] = val;
3138 } else {
3139 return UNDEFINED;
3140 }
3141 }
3143 return o;
3144 };
3146 /**
3147 * Returns `true` if the object has no enumerable properties of its own.
3148 *
3149 * @method isEmpty
3150 * @param {Object} obj An object.
3151 * @return {Boolean} `true` if the object is empty.
3152 * @static
3153 * @since 3.2.0
3154 */
3155 O.isEmpty = function (obj) {
3156 return !O.keys(Object(obj)).length;
3157 };
3158 /**
3159 * The YUI module contains the components required for building the YUI seed
3160 * file. This includes the script loading mechanism, a simple queue, and the
3161 * core utilities for the library.
3162 * @module yui
3163 * @submodule yui-base
3164 */
3166 /**
3167 * YUI user agent detection.
3168 * Do not fork for a browser if it can be avoided. Use feature detection when
3169 * you can. Use the user agent as a last resort. For all fields listed
3170 * as @type float, UA stores a version number for the browser engine,
3171 * 0 otherwise. This value may or may not map to the version number of
3172 * the browser using the engine. The value is presented as a float so
3173 * that it can easily be used for boolean evaluation as well as for
3174 * looking for a particular range of versions. Because of this,
3175 * some of the granularity of the version info may be lost. The fields that
3176 * are @type string default to null. The API docs list the values that
3177 * these fields can have.
3178 * @class UA
3179 * @static
3180 */
3182 /**
3183 * Static method on `YUI.Env` for parsing a UA string. Called at instantiation
3184 * to populate `Y.UA`.
3185 *
3186 * @static
3187 * @method parseUA
3188 * @param {String} [subUA=navigator.userAgent] UA string to parse
3189 * @return {Object} The Y.UA object
3190 */
3191 YUI.Env.parseUA = function(subUA) {
3193 var numberify = function(s) {
3194 var c = 0;
3195 return parseFloat(s.replace(/\./g, function() {
3196 return (c++ == 1) ? '' : '.';
3197 }));
3198 },
3200 win = Y.config.win,
3202 nav = win && win.navigator,
3204 o = {
3206 /**
3207 * Internet Explorer version number or 0. Example: 6
3208 * @property ie
3209 * @type float
3210 * @static
3211 */
3212 ie: 0,
3214 /**
3215 * Opera version number or 0. Example: 9.2
3216 * @property opera
3217 * @type float
3218 * @static
3219 */
3220 opera: 0,
3222 /**
3223 * Gecko engine revision number. Will evaluate to 1 if Gecko
3224 * is detected but the revision could not be found. Other browsers
3225 * will be 0. Example: 1.8
3226 * <pre>
3227 * Firefox 1.0.0.4: 1.7.8 <-- Reports 1.7
3228 * Firefox 1.5.0.9: 1.8.0.9 <-- 1.8
3229 * Firefox 2.0.0.3: 1.8.1.3 <-- 1.81
3230 * Firefox 3.0 <-- 1.9
3231 * Firefox 3.5 <-- 1.91
3232 * </pre>
3233 * @property gecko
3234 * @type float
3235 * @static
3236 */
3237 gecko: 0,
3239 /**
3240 * AppleWebKit version. KHTML browsers that are not WebKit browsers
3241 * will evaluate to 1, other browsers 0. Example: 418.9
3242 * <pre>
3243 * Safari 1.3.2 (312.6): 312.8.1 <-- Reports 312.8 -- currently the
3244 * latest available for Mac OSX 10.3.
3245 * Safari 2.0.2: 416 <-- hasOwnProperty introduced
3246 * Safari 2.0.4: 418 <-- preventDefault fixed
3247 * Safari 2.0.4 (419.3): 418.9.1 <-- One version of Safari may run
3248 * different versions of webkit
3249 * Safari 2.0.4 (419.3): 419 <-- Tiger installations that have been
3250 * updated, but not updated
3251 * to the latest patch.
3252 * Webkit 212 nightly: 522+ <-- Safari 3.0 precursor (with native
3253 * SVG and many major issues fixed).
3254 * Safari 3.0.4 (523.12) 523.12 <-- First Tiger release - automatic
3255 * update from 2.x via the 10.4.11 OS patch.
3256 * Webkit nightly 1/2008:525+ <-- Supports DOMContentLoaded event.
3257 * yahoo.com user agent hack removed.
3258 * </pre>
3259 * http://en.wikipedia.org/wiki/Safari_version_history
3260 * @property webkit
3261 * @type float
3262 * @static
3263 */
3264 webkit: 0,
3266 /**
3267 * Safari will be detected as webkit, but this property will also
3268 * be populated with the Safari version number
3269 * @property safari
3270 * @type float
3271 * @static
3272 */
3273 safari: 0,
3275 /**
3276 * Chrome will be detected as webkit, but this property will also
3277 * be populated with the Chrome version number
3278 * @property chrome
3279 * @type float
3280 * @static
3281 */
3282 chrome: 0,
3284 /**
3285 * The mobile property will be set to a string containing any relevant
3286 * user agent information when a modern mobile browser is detected.
3287 * Currently limited to Safari on the iPhone/iPod Touch, Nokia N-series
3288 * devices with the WebKit-based browser, and Opera Mini.
3289 * @property mobile
3290 * @type string
3291 * @default null
3292 * @static
3293 */
3294 mobile: null,
3296 /**
3297 * Adobe AIR version number or 0. Only populated if webkit is detected.
3298 * Example: 1.0
3299 * @property air
3300 * @type float
3301 */
3302 air: 0,
3303 /**
3304 * Detects Apple iPad's OS version
3305 * @property ipad
3306 * @type float
3307 * @static
3308 */
3309 ipad: 0,
3310 /**
3311 * Detects Apple iPhone's OS version
3312 * @property iphone
3313 * @type float
3314 * @static
3315 */
3316 iphone: 0,
3317 /**
3318 * Detects Apples iPod's OS version
3319 * @property ipod
3320 * @type float
3321 * @static
3322 */
3323 ipod: 0,
3324 /**
3325 * General truthy check for iPad, iPhone or iPod
3326 * @property ios
3327 * @type float
3328 * @default null
3329 * @static
3330 */
3331 ios: null,
3332 /**
3333 * Detects Googles Android OS version
3334 * @property android
3335 * @type float
3336 * @static
3337 */
3338 android: 0,
3339 /**
3340 * Detects Kindle Silk
3341 * @property silk
3342 * @type float
3343 * @static
3344 */
3345 silk: 0,
3346 /**
3347 * Detects Kindle Silk Acceleration
3348 * @property accel
3349 * @type Boolean
3350 * @static
3351 */
3352 accel: false,
3353 /**
3354 * Detects Palms WebOS version
3355 * @property webos
3356 * @type float
3357 * @static
3358 */
3359 webos: 0,
3361 /**
3362 * Google Caja version number or 0.
3363 * @property caja
3364 * @type float
3365 */
3366 caja: nav && nav.cajaVersion,
3368 /**
3369 * Set to true if the page appears to be in SSL
3370 * @property secure
3371 * @type boolean
3372 * @static
3373 */
3374 secure: false,
3376 /**
3377 * The operating system. Currently only detecting windows or macintosh
3378 * @property os
3379 * @type string
3380 * @default null
3381 * @static
3382 */
3383 os: null,
3385 /**
3386 * The Nodejs Version
3387 * @property nodejs
3388 * @type float
3389 * @default 0
3390 * @static
3391 */
3392 nodejs: 0
3393 },
3395 ua = subUA || nav && nav.userAgent,
3397 loc = win && win.location,
3399 href = loc && loc.href,
3401 m;
3403 /**
3404 * The User Agent string that was parsed
3405 * @property userAgent
3406 * @type String
3407 * @static
3408 */
3409 o.userAgent = ua;
3412 o.secure = href && (href.toLowerCase().indexOf('https') === 0);
3414 if (ua) {
3416 if ((/windows|win32/i).test(ua)) {
3417 o.os = 'windows';
3418 } else if ((/macintosh|mac_powerpc/i).test(ua)) {
3419 o.os = 'macintosh';
3420 } else if ((/android/i).test(ua)) {
3421 o.os = 'android';
3422 } else if ((/symbos/i).test(ua)) {
3423 o.os = 'symbos';
3424 } else if ((/linux/i).test(ua)) {
3425 o.os = 'linux';
3426 } else if ((/rhino/i).test(ua)) {
3427 o.os = 'rhino';
3428 }
3430 // Modern KHTML browsers should qualify as Safari X-Grade
3431 if ((/KHTML/).test(ua)) {
3432 o.webkit = 1;
3433 }
3434 if ((/IEMobile|XBLWP7/).test(ua)) {
3435 o.mobile = 'windows';
3436 }
3437 if ((/Fennec/).test(ua)) {
3438 o.mobile = 'gecko';
3439 }
3440 // Modern WebKit browsers are at least X-Grade
3441 m = ua.match(/AppleWebKit\/([^\s]*)/);
3442 if (m && m[1]) {
3443 o.webkit = numberify(m[1]);
3444 o.safari = o.webkit;
3446 // Mobile browser check
3447 if (/ Mobile\//.test(ua) || (/iPad|iPod|iPhone/).test(ua)) {
3448 o.mobile = 'Apple'; // iPhone or iPod Touch
3450 m = ua.match(/OS ([^\s]*)/);
3451 if (m && m[1]) {
3452 m = numberify(m[1].replace('_', '.'));
3453 }
3454 o.ios = m;
3455 o.os = 'ios';
3456 o.ipad = o.ipod = o.iphone = 0;
3458 m = ua.match(/iPad|iPod|iPhone/);
3459 if (m && m[0]) {
3460 o[m[0].toLowerCase()] = o.ios;
3461 }
3462 } else {
3463 m = ua.match(/NokiaN[^\/]*|webOS\/\d\.\d/);
3464 if (m) {
3465 // Nokia N-series, webOS, ex: NokiaN95
3466 o.mobile = m[0];
3467 }
3468 if (/webOS/.test(ua)) {
3469 o.mobile = 'WebOS';
3470 m = ua.match(/webOS\/([^\s]*);/);
3471 if (m && m[1]) {
3472 o.webos = numberify(m[1]);
3473 }
3474 }
3475 if (/ Android/.test(ua)) {
3476 if (/Mobile/.test(ua)) {
3477 o.mobile = 'Android';
3478 }
3479 m = ua.match(/Android ([^\s]*);/);
3480 if (m && m[1]) {
3481 o.android = numberify(m[1]);
3482 }
3484 }
3485 if (/Silk/.test(ua)) {
3486 m = ua.match(/Silk\/([^\s]*)\)/);
3487 if (m && m[1]) {
3488 o.silk = numberify(m[1]);
3489 }
3490 if (!o.android) {
3491 o.android = 2.34; //Hack for desktop mode in Kindle
3492 o.os = 'Android';
3493 }
3494 if (/Accelerated=true/.test(ua)) {
3495 o.accel = true;
3496 }
3497 }
3498 }
3500 m = ua.match(/(Chrome|CrMo)\/([^\s]*)/);
3501 if (m && m[1] && m[2]) {
3502 o.chrome = numberify(m[2]); // Chrome
3503 o.safari = 0; //Reset safari back to 0
3504 if (m[1] === 'CrMo') {
3505 o.mobile = 'chrome';
3506 }
3507 } else {
3508 m = ua.match(/AdobeAIR\/([^\s]*)/);
3509 if (m) {
3510 o.air = m[0]; // Adobe AIR 1.0 or better
3511 }
3512 }
3513 }
3515 if (!o.webkit) { // not webkit
3516 // @todo check Opera/8.01 (J2ME/MIDP; Opera Mini/2.0.4509/1316; fi; U; ssr)
3517 if (/Opera/.test(ua)) {
3518 m = ua.match(/Opera[\s\/]([^\s]*)/);
3519 if (m && m[1]) {
3520 o.opera = numberify(m[1]);
3521 }
3522 m = ua.match(/Version\/([^\s]*)/);
3523 if (m && m[1]) {
3524 o.opera = numberify(m[1]); // opera 10+
3525 }
3527 if (/Opera Mobi/.test(ua)) {
3528 o.mobile = 'opera';
3529 m = ua.replace('Opera Mobi', '').match(/Opera ([^\s]*)/);
3530 if (m && m[1]) {
3531 o.opera = numberify(m[1]);
3532 }
3533 }
3534 m = ua.match(/Opera Mini[^;]*/);
3536 if (m) {
3537 o.mobile = m[0]; // ex: Opera Mini/2.0.4509/1316
3538 }
3539 } else { // not opera or webkit
3540 m = ua.match(/MSIE\s([^;]*)/);
3541 if (m && m[1]) {
3542 o.ie = numberify(m[1]);
3543 } else { // not opera, webkit, or ie
3544 m = ua.match(/Gecko\/([^\s]*)/);
3545 if (m) {
3546 o.gecko = 1; // Gecko detected, look for revision
3547 m = ua.match(/rv:([^\s\)]*)/);
3548 if (m && m[1]) {
3549 o.gecko = numberify(m[1]);
3550 }
3551 }
3552 }
3553 }
3554 }
3555 }
3557 //It was a parsed UA, do not assign the global value.
3558 if (!subUA) {
3560 if (typeof process == 'object') {
3562 if (process.versions && process.versions.node) {
3563 //NodeJS
3564 o.os = process.platform;
3565 o.nodejs = process.versions.node;
3566 }
3567 }
3569 YUI.Env.UA = o;
3571 }
3573 return o;
3574 };
3577 Y.UA = YUI.Env.UA || YUI.Env.parseUA();
3579 /**
3580 Performs a simple comparison between two version numbers, accounting for
3581 standard versioning logic such as the fact that "535.8" is a lower version than
3582 "535.24", even though a simple numerical comparison would indicate that it's
3583 greater. Also accounts for cases such as "1.1" vs. "1.1.0", which are
3584 considered equivalent.
3586 Returns -1 if version _a_ is lower than version _b_, 0 if they're equivalent,
3587 1 if _a_ is higher than _b_.
3589 Versions may be numbers or strings containing numbers and dots. For example,
3590 both `535` and `"535.8.10"` are acceptable. A version string containing
3591 non-numeric characters, like `"535.8.beta"`, may produce unexpected results.
3593 @method compareVersions
3594 @param {Number|String} a First version number to compare.
3595 @param {Number|String} b Second version number to compare.
3596 @return -1 if _a_ is lower than _b_, 0 if they're equivalent, 1 if _a_ is
3597 higher than _b_.
3598 **/
3599 Y.UA.compareVersions = function (a, b) {
3600 var aPart, aParts, bPart, bParts, i, len;
3602 if (a === b) {
3603 return 0;
3604 }
3606 aParts = (a + '').split('.');
3607 bParts = (b + '').split('.');
3609 for (i = 0, len = Math.max(aParts.length, bParts.length); i < len; ++i) {
3610 aPart = parseInt(aParts[i], 10);
3611 bPart = parseInt(bParts[i], 10);
3613 isNaN(aPart) && (aPart = 0);
3614 isNaN(bPart) && (bPart = 0);
3616 if (aPart < bPart) {
3617 return -1;
3618 }
3620 if (aPart > bPart) {
3621 return 1;
3622 }
3623 }
3625 return 0;
3626 };
3627 YUI.Env.aliases = {
3628 "anim": ["anim-base","anim-color","anim-curve","anim-easing","anim-node-plugin","anim-scroll","anim-xy"],
3629 "app": ["app-base","app-transitions","model","model-list","router","view"],
3630 "attribute": ["attribute-base","attribute-complex"],
3631 "autocomplete": ["autocomplete-base","autocomplete-sources","autocomplete-list","autocomplete-plugin"],
3632 "base": ["base-base","base-pluginhost","base-build"],
3633 "cache": ["cache-base","cache-offline","cache-plugin"],
3634 "collection": ["array-extras","arraylist","arraylist-add","arraylist-filter","array-invoke"],
3635 "controller": ["router"],
3636 "dataschema": ["dataschema-base","dataschema-json","dataschema-xml","dataschema-array","dataschema-text"],
3637 "datasource": ["datasource-local","datasource-io","datasource-get","datasource-function","datasource-cache","datasource-jsonschema","datasource-xmlschema","datasource-arrayschema","datasource-textschema","datasource-polling"],
3638 "datatable": ["datatable-core","datatable-head","datatable-body","datatable-base","datatable-column-widths","datatable-message","datatable-mutable","datatable-sort","datatable-datasource"],
3639 "datatable-deprecated": ["datatable-base-deprecated","datatable-datasource-deprecated","datatable-sort-deprecated","datatable-scroll-deprecated"],
3640 "datatype": ["datatype-number","datatype-date","datatype-xml"],
3641 "datatype-date": ["datatype-date-parse","datatype-date-format"],
3642 "datatype-number": ["datatype-number-parse","datatype-number-format"],
3643 "datatype-xml": ["datatype-xml-parse","datatype-xml-format"],
3644 "dd": ["dd-ddm-base","dd-ddm","dd-ddm-drop","dd-drag","dd-proxy","dd-constrain","dd-drop","dd-scroll","dd-delegate"],
3645 "dom": ["dom-base","dom-screen","dom-style","selector-native","selector"],
3646 "editor": ["frame","editor-selection","exec-command","editor-base","editor-para","editor-br","editor-bidi","editor-tab","createlink-base"],
3647 "event": ["event-base","event-delegate","event-synthetic","event-mousewheel","event-mouseenter","event-key","event-focus","event-resize","event-hover","event-outside","event-touch","event-move","event-flick","event-valuechange"],
3648 "event-custom": ["event-custom-base","event-custom-complex"],
3649 "event-gestures": ["event-flick","event-move"],
3650 "handlebars": ["handlebars-compiler"],
3651 "highlight": ["highlight-base","highlight-accentfold"],
3652 "history": ["history-base","history-hash","history-hash-ie","history-html5"],
3653 "io": ["io-base","io-xdr","io-form","io-upload-iframe","io-queue"],
3654 "json": ["json-parse","json-stringify"],
3655 "loader": ["loader-base","loader-rollup","loader-yui3"],
3656 "node": ["node-base","node-event-delegate","node-pluginhost","node-screen","node-style"],
3657 "pluginhost": ["pluginhost-base","pluginhost-config"],
3658 "querystring": ["querystring-parse","querystring-stringify"],
3659 "recordset": ["recordset-base","recordset-sort","recordset-filter","recordset-indexer"],
3660 "resize": ["resize-base","resize-proxy","resize-constrain"],
3661 "slider": ["slider-base","slider-value-range","clickable-rail","range-slider"],
3662 "text": ["text-accentfold","text-wordbreak"],
3663 "widget": ["widget-base","widget-htmlparser","widget-skin","widget-uievents"]
3664 };
3667 }, '3.5.1' );
3668 YUI.add('get', function(Y) {
3670 /*jslint boss:true, expr:true, laxbreak: true */
3672 /**
3673 Provides dynamic loading of remote JavaScript and CSS resources.
3675 @module get
3676 @class Get
3677 @static
3678 **/
3680 var Lang = Y.Lang,
3682 CUSTOM_ATTRS, // defined lazily in Y.Get.Transaction._createNode()
3684 Get, Transaction;
3686 Y.Get = Get = {
3687 // -- Public Properties ----------------------------------------------------
3689 /**
3690 Default options for CSS requests. Options specified here will override
3691 global defaults for CSS requests.
3693 See the `options` property for all available options.
3695 @property cssOptions
3696 @type Object
3697 @static
3698 @since 3.5.0
3699 **/
3700 cssOptions: {
3701 attributes: {
3702 rel: 'stylesheet'
3703 },
3705 doc : Y.config.linkDoc || Y.config.doc,
3706 pollInterval: 50
3707 },
3709 /**
3710 Default options for JS requests. Options specified here will override global
3711 defaults for JS requests.
3713 See the `options` property for all available options.
3715 @property jsOptions
3716 @type Object
3717 @static
3718 @since 3.5.0
3719 **/
3720 jsOptions: {
3721 autopurge: true,
3722 doc : Y.config.scriptDoc || Y.config.doc
3723 },
3725 /**
3726 Default options to use for all requests.
3728 Note that while all available options are documented here for ease of
3729 discovery, some options (like callback functions) only make sense at the
3730 transaction level.
3732 Callback functions specified via the options object or the `options`
3733 parameter of the `css()`, `js()`, or `load()` methods will receive the
3734 transaction object as a parameter. See `Y.Get.Transaction` for details on
3735 the properties and methods available on transactions.
3737 @static
3738 @since 3.5.0
3739 @property {Object} options
3741 @property {Boolean} [options.async=false] Whether or not to load scripts
3742 asynchronously, meaning they're requested in parallel and execution
3743 order is not guaranteed. Has no effect on CSS, since CSS is always
3744 loaded asynchronously.
3746 @property {Object} [options.attributes] HTML attribute name/value pairs that
3747 should be added to inserted nodes. By default, the `charset` attribute
3748 will be set to "utf-8" and nodes will be given an auto-generated `id`
3749 attribute, but you can override these with your own values if desired.
3751 @property {Boolean} [options.autopurge] Whether or not to automatically
3752 purge inserted nodes after the purge threshold is reached. This is
3753 `true` by default for JavaScript, but `false` for CSS since purging a
3754 CSS node will also remove any styling applied by the referenced file.
3756 @property {Object} [options.context] `this` object to use when calling
3757 callback functions. Defaults to the transaction object.
3759 @property {Mixed} [options.data] Arbitrary data object to pass to "on*"
3760 callbacks.
3762 @property {Document} [options.doc] Document into which nodes should be
3763 inserted. By default, the current document is used.
3765 @property {HTMLElement|String} [options.insertBefore] HTML element or id
3766 string of an element before which all generated nodes should be
3767 inserted. If not specified, Get will automatically determine the best
3768 place to insert nodes for maximum compatibility.
3770 @property {Function} [options.onEnd] Callback to execute after a transaction
3771 is complete, regardless of whether it succeeded or failed.
3773 @property {Function} [options.onFailure] Callback to execute after a
3774 transaction fails, times out, or is aborted.
3776 @property {Function} [options.onProgress] Callback to execute after each
3777 individual request in a transaction either succeeds or fails.
3779 @property {Function} [options.onSuccess] Callback to execute after a
3780 transaction completes successfully with no errors. Note that in browsers
3781 that don't support the `error` event on CSS `<link>` nodes, a failed CSS
3782 request may still be reported as a success because in these browsers
3783 it can be difficult or impossible to distinguish between success and
3784 failure for CSS resources.
3786 @property {Function} [options.onTimeout] Callback to execute after a
3787 transaction times out.
3789 @property {Number} [options.pollInterval=50] Polling interval (in
3790 milliseconds) for detecting CSS load completion in browsers that don't
3791 support the `load` event on `<link>` nodes. This isn't used for
3792 JavaScript.
3794 @property {Number} [options.purgethreshold=20] Number of nodes to insert
3795 before triggering an automatic purge when `autopurge` is `true`.
3797 @property {Number} [options.timeout] Number of milliseconds to wait before
3798 aborting a transaction. When a timeout occurs, the `onTimeout` callback
3799 is called, followed by `onFailure` and finally `onEnd`. By default,
3800 there is no timeout.
3802 @property {String} [options.type] Resource type ("css" or "js"). This option
3803 is set automatically by the `css()` and `js()` functions and will be
3804 ignored there, but may be useful when using the `load()` function. If
3805 not specified, the type will be inferred from the URL, defaulting to
3806 "js" if the URL doesn't contain a recognizable file extension.
3807 **/
3808 options: {
3809 attributes: {
3810 charset: 'utf-8'
3811 },
3813 purgethreshold: 20
3814 },
3816 // -- Protected Properties -------------------------------------------------
3818 /**
3819 Regex that matches a CSS URL. Used to guess the file type when it's not
3820 specified.
3822 @property REGEX_CSS
3823 @type RegExp
3824 @final
3825 @protected
3826 @static
3827 @since 3.5.0
3828 **/
3829 REGEX_CSS: /\.css(?:[?;].*)?$/i,
3831 /**
3832 Regex that matches a JS URL. Used to guess the file type when it's not
3833 specified.
3835 @property REGEX_JS
3836 @type RegExp
3837 @final
3838 @protected
3839 @static
3840 @since 3.5.0
3841 **/
3842 REGEX_JS : /\.js(?:[?;].*)?$/i,
3844 /**
3845 Contains information about the current environment, such as what script and
3846 link injection features it supports.
3848 This object is created and populated the first time the `_getEnv()` method
3849 is called.
3851 @property _env
3852 @type Object
3853 @protected
3854 @static
3855 @since 3.5.0
3856 **/
3858 /**
3859 Mapping of document _yuid strings to <head> or <base> node references so we
3860 don't have to look the node up each time we want to insert a request node.
3862 @property _insertCache
3863 @type Object
3864 @protected
3865 @static
3866 @since 3.5.0
3867 **/
3868 _insertCache: {},
3870 /**
3871 Information about the currently pending transaction, if any.
3873 This is actually an object with two properties: `callback`, containing the
3874 optional callback passed to `css()`, `load()`, or `js()`; and `transaction`,
3875 containing the actual transaction instance.
3877 @property _pending
3878 @type Object
3879 @protected
3880 @static
3881 @since 3.5.0
3882 **/
3883 _pending: null,
3885 /**
3886 HTML nodes eligible to be purged next time autopurge is triggered.
3888 @property _purgeNodes
3889 @type HTMLElement[]
3890 @protected
3891 @static
3892 @since 3.5.0
3893 **/
3894 _purgeNodes: [],
3896 /**
3897 Queued transactions and associated callbacks.
3899 @property _queue
3900 @type Object[]
3901 @protected
3902 @static
3903 @since 3.5.0
3904 **/
3905 _queue: [],
3907 // -- Public Methods -------------------------------------------------------
3909 /**
3910 Aborts the specified transaction.
3912 This will cause the transaction's `onFailure` callback to be called and
3913 will prevent any new script and link nodes from being added to the document,
3914 but any resources that have already been requested will continue loading
3915 (there's no safe way to prevent this, unfortunately).
3917 *Note:* This method is deprecated as of 3.5.0, and will be removed in a
3918 future version of YUI. Use the transaction-level `abort()` method instead.
3920 @method abort
3921 @param {Get.Transaction} transaction Transaction to abort.
3922 @deprecated Use the `abort()` method on the transaction instead.
3923 @static
3924 **/
3925 abort: function (transaction) {
3926 var i, id, item, len, pending;
3929 if (!transaction.abort) {
3930 id = transaction;
3931 pending = this._pending;
3932 transaction = null;
3934 if (pending && pending.transaction.id === id) {
3935 transaction = pending.transaction;
3936 this._pending = null;
3937 } else {
3938 for (i = 0, len = this._queue.length; i < len; ++i) {
3939 item = this._queue[i].transaction;
3941 if (item.id === id) {
3942 transaction = item;
3943 this._queue.splice(i, 1);
3944 break;
3945 }
3946 }
3947 }
3948 }
3950 transaction && transaction.abort();
3951 },
3953 /**
3954 Loads one or more CSS files.
3956 The _urls_ parameter may be provided as a URL string, a request object,
3957 or an array of URL strings and/or request objects.
3959 A request object is just an object that contains a `url` property and zero
3960 or more options that should apply specifically to that request.
3961 Request-specific options take priority over transaction-level options and
3962 default options.
3964 URLs may be relative or absolute, and do not have to have the same origin
3965 as the current page.
3967 The `options` parameter may be omitted completely and a callback passed in
3968 its place, if desired.
3970 @example
3972 // Load a single CSS file and log a message on completion.
3973 Y.Get.css('foo.css', function (err) {
3974 if (err) {
3975 } else {
3976 }
3977 });
3979 // Load multiple CSS files and log a message when all have finished
3980 // loading.
3981 var urls = ['foo.css', 'http://example.com/bar.css', 'baz/quux.css'];
3983 Y.Get.css(urls, function (err) {
3984 if (err) {
3985 } else {
3986 }
3987 });
3989 // Specify transaction-level options, which will apply to all requests
3990 // within the transaction.
3991 Y.Get.css(urls, {
3992 attributes: {'class': 'my-css'},
3993 timeout : 5000
3994 });
3996 // Specify per-request options, which override transaction-level and
3997 // default options.
3998 Y.Get.css([
3999 {url: 'foo.css', attributes: {id: 'foo'}},
4000 {url: 'bar.css', attributes: {id: 'bar', charset: 'iso-8859-1'}}
4001 ]);
4003 @method css
4004 @param {String|Object|Array} urls URL string, request object, or array
4005 of URLs and/or request objects to load.
4006 @param {Object} [options] Options for this transaction. See the
4007 `Y.Get.options` property for a complete list of available options.
4008 @param {Function} [callback] Callback function to be called on completion.
4009 This is a general callback and will be called before any more granular
4010 callbacks (`onSuccess`, `onFailure`, etc.) specified in the `options`
4011 object.
4013 @param {Array|null} callback.err Array of errors that occurred during
4014 the transaction, or `null` on success.
4015 @param {Get.Transaction} callback.transaction Transaction object.
4017 @return {Get.Transaction} Transaction object.
4018 @static
4019 **/
4020 css: function (urls, options, callback) {
4021 return this._load('css', urls, options, callback);
4022 },
4024 /**
4025 Loads one or more JavaScript resources.
4027 The _urls_ parameter may be provided as a URL string, a request object,
4028 or an array of URL strings and/or request objects.
4030 A request object is just an object that contains a `url` property and zero
4031 or more options that should apply specifically to that request.
4032 Request-specific options take priority over transaction-level options and
4033 default options.
4035 URLs may be relative or absolute, and do not have to have the same origin
4036 as the current page.
4038 The `options` parameter may be omitted completely and a callback passed in
4039 its place, if desired.
4041 Scripts will be executed in the order they're specified unless the `async`
4042 option is `true`, in which case they'll be loaded in parallel and executed
4043 in whatever order they finish loading.
4045 @example
4047 // Load a single JS file and log a message on completion.
4048 Y.Get.js('foo.js', function (err) {
4049 if (err) {
4050 } else {
4051 }
4052 });
4054 // Load multiple JS files, execute them in order, and log a message when
4055 // all have finished loading.
4056 var urls = ['foo.js', 'http://example.com/bar.js', 'baz/quux.js'];
4058 Y.Get.js(urls, function (err) {
4059 if (err) {
4060 } else {
4061 }
4062 });
4064 // Specify transaction-level options, which will apply to all requests
4065 // within the transaction.
4066 Y.Get.js(urls, {
4067 attributes: {'class': 'my-js'},
4068 timeout : 5000
4069 });
4071 // Specify per-request options, which override transaction-level and
4072 // default options.
4073 Y.Get.js([
4074 {url: 'foo.js', attributes: {id: 'foo'}},
4075 {url: 'bar.js', attributes: {id: 'bar', charset: 'iso-8859-1'}}
4076 ]);
4078 @method js
4079 @param {String|Object|Array} urls URL string, request object, or array
4080 of URLs and/or request objects to load.
4081 @param {Object} [options] Options for this transaction. See the
4082 `Y.Get.options` property for a complete list of available options.
4083 @param {Function} [callback] Callback function to be called on completion.
4084 This is a general callback and will be called before any more granular
4085 callbacks (`onSuccess`, `onFailure`, etc.) specified in the `options`
4086 object.
4088 @param {Array|null} callback.err Array of errors that occurred during
4089 the transaction, or `null` on success.
4090 @param {Get.Transaction} callback.transaction Transaction object.
4092 @return {Get.Transaction} Transaction object.
4093 @since 3.5.0
4094 @static
4095 **/
4096 js: function (urls, options, callback) {
4097 return this._load('js', urls, options, callback);
4098 },
4100 /**
4101 Loads one or more CSS and/or JavaScript resources in the same transaction.
4103 Use this method when you want to load both CSS and JavaScript in a single
4104 transaction and be notified when all requested URLs have finished loading,
4105 regardless of type.
4107 Behavior and options are the same as for the `css()` and `js()` methods. If
4108 a resource type isn't specified in per-request options or transaction-level
4109 options, Get will guess the file type based on the URL's extension (`.css`
4110 or `.js`, with or without a following query string). If the file type can't
4111 be guessed from the URL, a warning will be logged and Get will assume the
4112 URL is a JavaScript resource.
4114 @example
4116 // Load both CSS and JS files in a single transaction, and log a message
4117 // when all files have finished loading.
4118 Y.Get.load(['foo.css', 'bar.js', 'baz.css'], function (err) {
4119 if (err) {
4120 } else {
4121 }
4122 });
4124 @method load
4125 @param {String|Object|Array} urls URL string, request object, or array
4126 of URLs and/or request objects to load.
4127 @param {Object} [options] Options for this transaction. See the
4128 `Y.Get.options` property for a complete list of available options.
4129 @param {Function} [callback] Callback function to be called on completion.
4130 This is a general callback and will be called before any more granular
4131 callbacks (`onSuccess`, `onFailure`, etc.) specified in the `options`
4132 object.
4134 @param {Array|null} err Array of errors that occurred during the
4135 transaction, or `null` on success.
4136 @param {Get.Transaction} Transaction object.
4138 @return {Get.Transaction} Transaction object.
4139 @since 3.5.0
4140 @static
4141 **/
4142 load: function (urls, options, callback) {
4143 return this._load(null, urls, options, callback);
4144 },
4146 // -- Protected Methods ----------------------------------------------------
4148 /**
4149 Triggers an automatic purge if the purge threshold has been reached.
4151 @method _autoPurge
4152 @param {Number} threshold Purge threshold to use, in milliseconds.
4153 @protected
4154 @since 3.5.0
4155 @static
4156 **/
4157 _autoPurge: function (threshold) {
4158 if (threshold && this._purgeNodes.length >= threshold) {
4159 this._purge(this._purgeNodes);
4160 }
4161 },
4163 /**
4164 Populates the `_env` property with information about the current
4165 environment.
4167 @method _getEnv
4168 @return {Object} Environment information.
4169 @protected
4170 @since 3.5.0
4171 @static
4172 **/
4173 _getEnv: function () {
4174 var doc = Y.config.doc,
4175 ua = Y.UA;
4177 // Note: some of these checks require browser sniffs since it's not
4178 // feasible to load test files on every pageview just to perform a
4179 // feature test. I'm sorry if this makes you sad.
4180 return (this._env = {
4181 // True if this is a browser that supports disabling async mode on
4182 // dynamically created script nodes. See
4183 // https://developer.mozilla.org/En/HTML/Element/Script#Attributes
4184 async: doc && doc.createElement('script').async === true,
4186 // True if this browser fires an event when a dynamically injected
4187 // link node fails to load. This is currently true for Firefox 9+
4188 // and WebKit 535.24+.
4189 cssFail: ua.gecko >= 9 || ua.compareVersions(ua.webkit, 535.24) >= 0,
4191 // True if this browser fires an event when a dynamically injected
4192 // link node finishes loading. This is currently true for IE, Opera,
4193 // Firefox 9+, and WebKit 535.24+. Note that IE versions <9 fire the
4194 // DOM 0 "onload" event, but not "load". All versions of IE fire
4195 // "onload".
4196 // davglass: Seems that Chrome on Android needs this to be false.
4197 cssLoad: (
4198 (!ua.gecko && !ua.webkit) || ua.gecko >= 9 ||
4199 ua.compareVersions(ua.webkit, 535.24) >= 0
4200 ) && !(ua.chrome && ua.chrome <= 18),
4202 // True if this browser preserves script execution order while
4203 // loading scripts in parallel as long as the script node's `async`
4204 // attribute is set to false to explicitly disable async execution.
4205 preservesScriptOrder: !!(ua.gecko || ua.opera)
4206 });
4207 },
4209 _getTransaction: function (urls, options) {
4210 var requests = [],
4211 i, len, req, url;
4213 if (!Lang.isArray(urls)) {
4214 urls = [urls];
4215 }
4217 options = Y.merge(this.options, options);
4219 // Clone the attributes object so we don't end up modifying it by ref.
4220 options.attributes = Y.merge(this.options.attributes,
4221 options.attributes);
4223 for (i = 0, len = urls.length; i < len; ++i) {
4224 url = urls[i];
4225 req = {attributes: {}};
4227 // If `url` is a string, we create a URL object for it, then mix in
4228 // global options and request-specific options. If it's an object
4229 // with a "url" property, we assume it's a request object containing
4230 // URL-specific options.
4231 if (typeof url === 'string') {
4232 req.url = url;
4233 } else if (url.url) {
4234 // URL-specific options override both global defaults and
4235 // request-specific options.
4236 Y.mix(req, url, false, null, 0, true);
4237 url = url.url; // Make url a string so we can use it later.
4238 } else {
4239 continue;
4240 }
4242 Y.mix(req, options, false, null, 0, true);
4244 // If we didn't get an explicit type for this URL either in the
4245 // request options or the URL-specific options, try to determine
4246 // one from the file extension.
4247 if (!req.type) {
4248 if (this.REGEX_CSS.test(url)) {
4249 req.type = 'css';
4250 } else {
4251 if (!this.REGEX_JS.test(url)) {
4252 }
4254 req.type = 'js';
4255 }
4256 }
4258 // Mix in type-specific default options, but don't overwrite any
4259 // options that have already been set.
4260 Y.mix(req, req.type === 'js' ? this.jsOptions : this.cssOptions,
4261 false, null, 0, true);
4263 // Give the node an id attribute if it doesn't already have one.
4264 req.attributes.id || (req.attributes.id = Y.guid());
4266 // Backcompat for <3.5.0 behavior.
4267 if (req.win) {
4268 req.doc = req.win.document;
4269 } else {
4270 req.win = req.doc.defaultView || req.doc.parentWindow;
4271 }
4273 if (req.charset) {
4274 req.attributes.charset = req.charset;
4275 }
4277 requests.push(req);
4278 }
4280 return new Transaction(requests, options);
4281 },
4283 _load: function (type, urls, options, callback) {
4284 var transaction;
4286 // Allow callback as third param.
4287 if (typeof options === 'function') {
4288 callback = options;
4289 options = {};
4290 }
4292 options || (options = {});
4293 options.type = type;
4295 if (!this._env) {
4296 this._getEnv();
4297 }
4299 transaction = this._getTransaction(urls, options);
4301 this._queue.push({
4302 callback : callback,
4303 transaction: transaction
4304 });
4306 this._next();
4308 return transaction;
4309 },
4311 _next: function () {
4312 var item;
4314 if (this._pending) {
4315 return;
4316 }
4318 item = this._queue.shift();
4320 if (item) {
4321 this._pending = item;
4323 item.transaction.execute(function () {
4324 item.callback && item.callback.apply(this, arguments);
4326 Get._pending = null;
4327 Get._next();
4328 });
4329 }
4330 },
4332 _purge: function (nodes) {
4333 var purgeNodes = this._purgeNodes,
4334 isTransaction = nodes !== purgeNodes,
4335 index, node;
4337 while (node = nodes.pop()) { // assignment
4338 // Don't purge nodes that haven't finished loading (or errored out),
4339 // since this can hang the transaction.
4340 if (!node._yuiget_finished) {
4341 continue;
4342 }
4344 node.parentNode && node.parentNode.removeChild(node);
4346 // If this is a transaction-level purge and this node also exists in
4347 // the Get-level _purgeNodes array, we need to remove it from
4348 // _purgeNodes to avoid creating a memory leak. The indexOf lookup
4349 // sucks, but until we get WeakMaps, this is the least troublesome
4350 // way to do this (we can't just hold onto node ids because they may
4351 // not be in the same document).
4352 if (isTransaction) {
4353 index = Y.Array.indexOf(purgeNodes, node);
4355 if (index > -1) {
4356 purgeNodes.splice(index, 1);
4357 }
4358 }
4359 }
4360 }
4361 };
4363 /**
4364 Alias for `js()`.
4366 @method script
4367 @static
4368 **/
4369 Get.script = Get.js;
4371 /**
4372 Represents a Get transaction, which may contain requests for one or more JS or
4373 CSS files.
4375 This class should not be instantiated manually. Instances will be created and
4376 returned as needed by Y.Get's `css()`, `js()`, and `load()` methods.
4378 @class Get.Transaction
4379 @constructor
4380 @since 3.5.0
4381 **/
4382 Get.Transaction = Transaction = function (requests, options) {
4383 var self = this;
4385 self.id = Transaction._lastId += 1;
4386 self.data = options.data;
4387 self.errors = [];
4388 self.nodes = [];
4389 self.options = options;
4390 self.requests = requests;
4392 self._callbacks = []; // callbacks to call after execution finishes
4393 self._queue = [];
4394 self._waiting = 0;
4396 // Deprecated pre-3.5.0 properties.
4397 self.tId = self.id; // Use `id` instead.
4398 self.win = options.win || Y.config.win;
4399 };
4401 /**
4402 Arbitrary data object associated with this transaction.
4404 This object comes from the options passed to `Get.css()`, `Get.js()`, or
4405 `Get.load()`, and will be `undefined` if no data object was specified.
4407 @property {Object} data
4408 **/
4410 /**
4411 Array of errors that have occurred during this transaction, if any.
4413 @since 3.5.0
4414 @property {Object[]} errors
4415 @property {String} errors.error Error message.
4416 @property {Object} errors.request Request object related to the error.
4417 **/
4419 /**
4420 Numeric id for this transaction, unique among all transactions within the same
4421 YUI sandbox in the current pageview.
4423 @property {Number} id
4424 @since 3.5.0
4425 **/
4427 /**
4428 HTMLElement nodes (native ones, not YUI Node instances) that have been inserted
4429 during the current transaction.
4431 @property {HTMLElement[]} nodes
4432 **/
4434 /**
4435 Options associated with this transaction.
4437 See `Get.options` for the full list of available options.
4439 @property {Object} options
4440 @since 3.5.0
4441 **/
4443 /**
4444 Request objects contained in this transaction. Each request object represents
4445 one CSS or JS URL that will be (or has been) requested and loaded into the page.
4447 @property {Object} requests
4448 @since 3.5.0
4449 **/
4451 /**
4452 Id of the most recent transaction.
4454 @property _lastId
4455 @type Number
4456 @protected
4457 @static
4458 **/
4459 Transaction._lastId = 0;
4461 Transaction.prototype = {
4462 // -- Public Properties ----------------------------------------------------
4464 /**
4465 Current state of this transaction. One of "new", "executing", or "done".
4467 @property _state
4468 @type String
4469 @protected
4470 **/
4471 _state: 'new', // "new", "executing", or "done"
4473 // -- Public Methods -------------------------------------------------------
4475 /**
4476 Aborts this transaction.
4478 This will cause the transaction's `onFailure` callback to be called and
4479 will prevent any new script and link nodes from being added to the document,
4480 but any resources that have already been requested will continue loading
4481 (there's no safe way to prevent this, unfortunately).
4483 @method abort
4484 @param {String} [msg="Aborted."] Optional message to use in the `errors`
4485 array describing why the transaction was aborted.
4486 **/
4487 abort: function (msg) {
4488 this._pending = null;
4489 this._pendingCSS = null;
4490 this._pollTimer = clearTimeout(this._pollTimer);
4491 this._queue = [];
4492 this._waiting = 0;
4494 this.errors.push({error: msg || 'Aborted'});
4495 this._finish();
4496 },
4498 /**
4499 Begins execting the transaction.
4501 There's usually no reason to call this manually, since Get will call it
4502 automatically when other pending transactions have finished. If you really
4503 want to execute your transaction before Get does, you can, but be aware that
4504 this transaction's scripts may end up executing before the scripts in other
4505 pending transactions.
4507 If the transaction is already executing, the specified callback (if any)
4508 will be queued and called after execution finishes. If the transaction has
4509 already finished, the callback will be called immediately (the transaction
4510 will not be executed again).
4512 @method execute
4513 @param {Function} callback Callback function to execute after all requests
4514 in the transaction are complete, or after the transaction is aborted.
4515 **/
4516 execute: function (callback) {
4517 var self = this,
4518 requests = self.requests,
4519 state = self._state,
4520 i, len, queue, req;
4522 if (state === 'done') {
4523 callback && callback(self.errors.length ? self.errors : null, self);
4524 return;
4525 } else {
4526 callback && self._callbacks.push(callback);
4528 if (state === 'executing') {
4529 return;
4530 }
4531 }
4533 self._state = 'executing';
4534 self._queue = queue = [];
4536 if (self.options.timeout) {
4537 self._timeout = setTimeout(function () {
4538 self.abort('Timeout');
4539 }, self.options.timeout);
4540 }
4542 for (i = 0, len = requests.length; i < len; ++i) {
4543 req = self.requests[i];
4545 if (req.async || req.type === 'css') {
4546 // No need to queue CSS or fully async JS.
4547 self._insert(req);
4548 } else {
4549 queue.push(req);
4550 }
4551 }
4553 self._next();
4554 },
4556 /**
4557 Manually purges any `<script>` or `<link>` nodes this transaction has
4558 created.
4560 Be careful when purging a transaction that contains CSS requests, since
4561 removing `<link>` nodes will also remove any styles they applied.
4563 @method purge
4564 **/
4565 purge: function () {
4566 Get._purge(this.nodes);
4567 },
4569 // -- Protected Methods ----------------------------------------------------
4570 _createNode: function (name, attrs, doc) {
4571 var node = doc.createElement(name),
4572 attr, testEl;
4574 if (!CUSTOM_ATTRS) {
4575 // IE6 and IE7 expect property names rather than attribute names for
4576 // certain attributes. Rather than sniffing, we do a quick feature
4577 // test the first time _createNode() runs to determine whether we
4578 // need to provide a workaround.
4579 testEl = doc.createElement('div');
4580 testEl.setAttribute('class', 'a');
4582 CUSTOM_ATTRS = testEl.className === 'a' ? {} : {
4583 'for' : 'htmlFor',
4584 'class': 'className'
4585 };
4586 }
4588 for (attr in attrs) {
4589 if (attrs.hasOwnProperty(attr)) {
4590 node.setAttribute(CUSTOM_ATTRS[attr] || attr, attrs[attr]);
4591 }
4592 }
4594 return node;
4595 },
4597 _finish: function () {
4598 var errors = this.errors.length ? this.errors : null,
4599 options = this.options,
4600 thisObj = options.context || this,
4601 data, i, len;
4603 if (this._state === 'done') {
4604 return;
4605 }
4607 this._state = 'done';
4609 for (i = 0, len = this._callbacks.length; i < len; ++i) {
4610 this._callbacks[i].call(thisObj, errors, this);
4611 }
4613 data = this._getEventData();
4615 if (errors) {
4616 if (options.onTimeout && errors[errors.length - 1].error === 'Timeout') {
4617 options.onTimeout.call(thisObj, data);
4618 }
4620 if (options.onFailure) {
4621 options.onFailure.call(thisObj, data);
4622 }
4623 } else if (options.onSuccess) {
4624 options.onSuccess.call(thisObj, data);
4625 }
4627 if (options.onEnd) {
4628 options.onEnd.call(thisObj, data);
4629 }
4630 },
4632 _getEventData: function (req) {
4633 if (req) {
4634 // This merge is necessary for backcompat. I hate it.
4635 return Y.merge(this, {
4636 abort : this.abort, // have to copy these because the prototype isn't preserved
4637 purge : this.purge,
4638 request: req,
4639 url : req.url,
4640 win : req.win
4641 });
4642 } else {
4643 return this;
4644 }
4645 },
4647 _getInsertBefore: function (req) {
4648 var doc = req.doc,
4649 el = req.insertBefore,
4650 cache, cachedNode, docStamp;
4652 if (el) {
4653 return typeof el === 'string' ? doc.getElementById(el) : el;
4654 }
4656 cache = Get._insertCache;
4657 docStamp = Y.stamp(doc);
4659 if ((el = cache[docStamp])) { // assignment
4660 return el;
4661 }
4663 // Inserting before a <base> tag apparently works around an IE bug
4664 // (according to a comment from pre-3.5.0 Y.Get), but I'm not sure what
4665 // bug that is, exactly. Better safe than sorry?
4666 if ((el = doc.getElementsByTagName('base')[0])) { // assignment
4667 return (cache[docStamp] = el);
4668 }
4670 // Look for a <head> element.
4671 el = doc.head || doc.getElementsByTagName('head')[0];
4673 if (el) {
4674 // Create a marker node at the end of <head> to use as an insertion
4675 // point. Inserting before this node will ensure that all our CSS
4676 // gets inserted in the correct order, to maintain style precedence.
4677 el.appendChild(doc.createTextNode(''));
4678 return (cache[docStamp] = el.lastChild);
4679 }
4681 // If all else fails, just insert before the first script node on the
4682 // page, which is virtually guaranteed to exist.
4683 return (cache[docStamp] = doc.getElementsByTagName('script')[0]);
4684 },
4686 _insert: function (req) {
4687 var env = Get._env,
4688 insertBefore = this._getInsertBefore(req),
4689 isScript = req.type === 'js',
4690 node = req.node,
4691 self = this,
4692 ua = Y.UA,
4693 cssTimeout, nodeType;
4695 if (!node) {
4696 if (isScript) {
4697 nodeType = 'script';
4698 } else if (!env.cssLoad && ua.gecko) {
4699 nodeType = 'style';
4700 } else {
4701 nodeType = 'link';
4702 }
4704 node = req.node = this._createNode(nodeType, req.attributes,
4705 req.doc);
4706 }
4708 function onError() {
4709 self._progress('Failed to load ' + req.url, req);
4710 }
4712 function onLoad() {
4713 if (cssTimeout) {
4714 clearTimeout(cssTimeout);
4715 }
4717 self._progress(null, req);
4718 }
4721 // Deal with script asynchronicity.
4722 if (isScript) {
4723 node.setAttribute('src', req.url);
4725 if (req.async) {
4726 // Explicitly indicate that we want the browser to execute this
4727 // script asynchronously. This is necessary for older browsers
4728 // like Firefox <4.
4729 node.async = true;
4730 } else {
4731 if (env.async) {
4732 // This browser treats injected scripts as async by default
4733 // (standard HTML5 behavior) but asynchronous loading isn't
4734 // desired, so tell the browser not to mark this script as
4735 // async.
4736 node.async = false;
4737 }
4739 // If this browser doesn't preserve script execution order based
4740 // on insertion order, we'll need to avoid inserting other
4741 // scripts until this one finishes loading.
4742 if (!env.preservesScriptOrder) {
4743 this._pending = req;
4744 }
4745 }
4746 } else {
4747 if (!env.cssLoad && ua.gecko) {
4748 // In Firefox <9, we can import the requested URL into a <style>
4749 // node and poll for the existence of node.sheet.cssRules. This
4750 // gives us a reliable way to determine CSS load completion that
4751 // also works for cross-domain stylesheets.
4752 //
4753 // Props to Zach Leatherman for calling my attention to this
4754 // technique.
4755 node.innerHTML = (req.attributes.charset ?
4756 '@charset "' + req.attributes.charset + '";' : '') +
4757 '@import "' + req.url + '";';
4758 } else {
4759 node.setAttribute('href', req.url);
4760 }
4761 }
4763 // Inject the node.
4764 if (isScript && ua.ie && ua.ie < 9) {
4765 // Script on IE6, 7, and 8.
4766 node.onreadystatechange = function () {
4767 if (/loaded|complete/.test(node.readyState)) {
4768 node.onreadystatechange = null;
4769 onLoad();
4770 }
4771 };
4772 } else if (!isScript && !env.cssLoad) {
4773 // CSS on Firefox <9 or WebKit.
4774 this._poll(req);
4775 } else {
4776 // Script or CSS on everything else. Using DOM 0 events because that
4777 // evens the playing field with older IEs.
4778 node.onerror = onError;
4779 node.onload = onLoad;
4781 // If this browser doesn't fire an event when CSS fails to load,
4782 // fail after a timeout to avoid blocking the transaction queue.
4783 if (!env.cssFail && !isScript) {
4784 cssTimeout = setTimeout(onError, req.timeout || 3000);
4785 }
4786 }
4788 this._waiting += 1;
4790 this.nodes.push(node);
4791 insertBefore.parentNode.insertBefore(node, insertBefore);
4792 },
4794 _next: function () {
4795 if (this._pending) {
4796 return;
4797 }
4799 // If there are requests in the queue, insert the next queued request.
4800 // Otherwise, if we're waiting on already-inserted requests to finish,
4801 // wait longer. If there are no queued requests and we're not waiting
4802 // for anything to load, then we're done!
4803 if (this._queue.length) {
4804 this._insert(this._queue.shift());
4805 } else if (!this._waiting) {
4806 this._finish();
4807 }
4808 },
4810 _poll: function (newReq) {
4811 var self = this,
4812 pendingCSS = self._pendingCSS,
4813 isWebKit = Y.UA.webkit,
4814 i, hasRules, j, nodeHref, req, sheets;
4816 if (newReq) {
4817 pendingCSS || (pendingCSS = self._pendingCSS = []);
4818 pendingCSS.push(newReq);
4820 if (self._pollTimer) {
4821 // A poll timeout is already pending, so no need to create a
4822 // new one.
4823 return;
4824 }
4825 }
4827 self._pollTimer = null;
4829 // Note: in both the WebKit and Gecko hacks below, a CSS URL that 404s
4830 // will still be treated as a success. There's no good workaround for
4831 // this.
4833 for (i = 0; i < pendingCSS.length; ++i) {
4834 req = pendingCSS[i];
4836 if (isWebKit) {
4837 // Look for a stylesheet matching the pending URL.
4838 sheets = req.doc.styleSheets;
4839 j = sheets.length;
4840 nodeHref = req.node.href;
4842 while (--j >= 0) {
4843 if (sheets[j].href === nodeHref) {
4844 pendingCSS.splice(i, 1);
4845 i -= 1;
4846 self._progress(null, req);
4847 break;
4848 }
4849 }
4850 } else {
4851 // Many thanks to Zach Leatherman for calling my attention to
4852 // the @import-based cross-domain technique used here, and to
4853 // Oleg Slobodskoi for an earlier same-domain implementation.
4854 //
4855 // See Zach's blog for more details:
4856 // http://www.zachleat.com/web/2010/07/29/load-css-dynamically/
4857 try {
4858 // We don't really need to store this value since we never
4859 // use it again, but if we don't store it, Closure Compiler
4860 // assumes the code is useless and removes it.
4861 hasRules = !!req.node.sheet.cssRules;
4863 // If we get here, the stylesheet has loaded.
4864 pendingCSS.splice(i, 1);
4865 i -= 1;
4866 self._progress(null, req);
4867 } catch (ex) {
4868 // An exception means the stylesheet is still loading.
4869 }
4870 }
4871 }
4873 if (pendingCSS.length) {
4874 self._pollTimer = setTimeout(function () {
4875 self._poll.call(self);
4876 }, self.options.pollInterval);
4877 }
4878 },
4880 _progress: function (err, req) {
4881 var options = this.options;
4883 if (err) {
4884 req.error = err;
4886 this.errors.push({
4887 error : err,
4888 request: req
4889 });
4891 }
4893 req.node._yuiget_finished = req.finished = true;
4895 if (options.onProgress) {
4896 options.onProgress.call(options.context || this,
4897 this._getEventData(req));
4898 }
4900 if (req.autopurge) {
4901 // Pre-3.5.0 Get always excludes the most recent node from an
4902 // autopurge. I find this odd, but I'm keeping that behavior for
4903 // the sake of backcompat.
4904 Get._autoPurge(this.options.purgethreshold);
4905 Get._purgeNodes.push(req.node);
4906 }
4908 if (this._pending === req) {
4909 this._pending = null;
4910 }
4912 this._waiting -= 1;
4913 this._next();
4914 }
4915 };
4918 }, '3.5.1' ,{requires:['yui-base']});
4919 YUI.add('features', function(Y) {
4921 var feature_tests = {};
4923 /**
4924 Contains the core of YUI's feature test architecture.
4925 @module features
4926 */
4928 /**
4929 * Feature detection
4930 * @class Features
4931 * @static
4932 */
4934 Y.mix(Y.namespace('Features'), {
4936 /**
4937 * Object hash of all registered feature tests
4938 * @property tests
4939 * @type Object
4940 */
4941 tests: feature_tests,
4943 /**
4944 * Add a test to the system
4945 *
4946 * ```
4947 * Y.Features.add("load", "1", {});
4948 * ```
4949 *
4950 * @method add
4951 * @param {String} cat The category, right now only 'load' is supported
4952 * @param {String} name The number sequence of the test, how it's reported in the URL or config: 1, 2, 3
4953 * @param {Object} o Object containing test properties
4954 * @param {String} o.name The name of the test
4955 * @param {Function} o.test The test function to execute, the only argument to the function is the `Y` instance
4956 * @param {String} o.trigger The module that triggers this test.
4957 */
4958 add: function(cat, name, o) {
4959 feature_tests[cat] = feature_tests[cat] || {};
4960 feature_tests[cat][name] = o;
4961 },
4962 /**
4963 * Execute all tests of a given category and return the serialized results
4964 *
4965 * ```
4966 * caps=1:1;2:1;3:0
4967 * ```
4968 * @method all
4969 * @param {String} cat The category to execute
4970 * @param {Array} args The arguments to pass to the test function
4971 * @return {String} A semi-colon separated string of tests and their success/failure: 1:1;2:1;3:0
4972 */
4973 all: function(cat, args) {
4974 var cat_o = feature_tests[cat],
4975 // results = {};
4976 result = [];
4977 if (cat_o) {
4978 Y.Object.each(cat_o, function(v, k) {
4979 result.push(k + ':' + (Y.Features.test(cat, k, args) ? 1 : 0));
4980 });
4981 }
4983 return (result.length) ? result.join(';') : '';
4984 },
4985 /**
4986 * Run a sepecific test and return a Boolean response.
4987 *
4988 * ```
4989 * Y.Features.test("load", "1");
4990 * ```
4991 *
4992 * @method test
4993 * @param {String} cat The category of the test to run
4994 * @param {String} name The name of the test to run
4995 * @param {Array} args The arguments to pass to the test function
4996 * @return {Boolean} True or false if the test passed/failed.
4997 */
4998 test: function(cat, name, args) {
4999 args = args || [];
5000 var result, ua, test,
5001 cat_o = feature_tests[cat],
5002 feature = cat_o && cat_o[name];
5004 if (!feature) {
5005 } else {
5007 result = feature.result;
5009 if (Y.Lang.isUndefined(result)) {
5011 ua = feature.ua;
5012 if (ua) {
5013 result = (Y.UA[ua]);
5014 }
5016 test = feature.test;
5017 if (test && ((!ua) || result)) {
5018 result = test.apply(Y, args);
5019 }
5021 feature.result = result;
5022 }
5023 }
5025 return result;
5026 }
5027 });
5029 // Y.Features.add("load", "1", {});
5030 // Y.Features.test("load", "1");
5031 // caps=1:1;2:0;3:1;
5033 /* This file is auto-generated by src/loader/scripts/meta_join.py */
5034 var add = Y.Features.add;
5035 // io-nodejs
5036 add('load', '0', {
5037 "name": "io-nodejs",
5038 "trigger": "io-base",
5039 "ua": "nodejs"
5040 });
5041 // graphics-canvas-default
5042 add('load', '1', {
5043 "name": "graphics-canvas-default",
5044 "test": function(Y) {
5045 var DOCUMENT = Y.config.doc,
5046 useCanvas = Y.config.defaultGraphicEngine && Y.config.defaultGraphicEngine == "canvas",
5047 canvas = DOCUMENT && DOCUMENT.createElement("canvas"),
5048 svg = (DOCUMENT && DOCUMENT.implementation.hasFeature("http://www.w3.org/TR/SVG11/feature#BasicStructure", "1.1"));
5049 return (!svg || useCanvas) && (canvas && canvas.getContext && canvas.getContext("2d"));
5050 },
5051 "trigger": "graphics"
5052 });
5053 // autocomplete-list-keys
5054 add('load', '2', {
5055 "name": "autocomplete-list-keys",
5056 "test": function (Y) {
5057 // Only add keyboard support to autocomplete-list if this doesn't appear to
5058 // be an iOS or Android-based mobile device.
5059 //
5060 // There's currently no feasible way to actually detect whether a device has
5061 // a hardware keyboard, so this sniff will have to do. It can easily be
5062 // overridden by manually loading the autocomplete-list-keys module.
5063 //
5064 // Worth noting: even though iOS supports bluetooth keyboards, Mobile Safari
5065 // doesn't fire the keyboard events used by AutoCompleteList, so there's
5066 // no point loading the -keys module even when a bluetooth keyboard may be
5067 // available.
5068 return !(Y.UA.ios || Y.UA.android);
5069 },
5070 "trigger": "autocomplete-list"
5071 });
5072 // graphics-svg
5073 add('load', '3', {
5074 "name": "graphics-svg",
5075 "test": function(Y) {
5076 var DOCUMENT = Y.config.doc,
5077 useSVG = !Y.config.defaultGraphicEngine || Y.config.defaultGraphicEngine != "canvas",
5078 canvas = DOCUMENT && DOCUMENT.createElement("canvas"),
5079 svg = (DOCUMENT && DOCUMENT.implementation.hasFeature("http://www.w3.org/TR/SVG11/feature#BasicStructure", "1.1"));
5081 return svg && (useSVG || !canvas);
5082 },
5083 "trigger": "graphics"
5084 });
5085 // editor-para-ie
5086 add('load', '4', {
5087 "name": "editor-para-ie",
5088 "trigger": "editor-para",
5089 "ua": "ie",
5090 "when": "instead"
5091 });
5092 // graphics-vml-default
5093 add('load', '5', {
5094 "name": "graphics-vml-default",
5095 "test": function(Y) {
5096 var DOCUMENT = Y.config.doc,
5097 canvas = DOCUMENT && DOCUMENT.createElement("canvas");
5098 return (DOCUMENT && !DOCUMENT.implementation.hasFeature("http://www.w3.org/TR/SVG11/feature#BasicStructure", "1.1") && (!canvas || !canvas.getContext || !canvas.getContext("2d")));
5099 },
5100 "trigger": "graphics"
5101 });
5102 // graphics-svg-default
5103 add('load', '6', {
5104 "name": "graphics-svg-default",
5105 "test": function(Y) {
5106 var DOCUMENT = Y.config.doc,
5107 useSVG = !Y.config.defaultGraphicEngine || Y.config.defaultGraphicEngine != "canvas",
5108 canvas = DOCUMENT && DOCUMENT.createElement("canvas"),
5109 svg = (DOCUMENT && DOCUMENT.implementation.hasFeature("http://www.w3.org/TR/SVG11/feature#BasicStructure", "1.1"));
5111 return svg && (useSVG || !canvas);
5112 },
5113 "trigger": "graphics"
5114 });
5115 // history-hash-ie
5116 add('load', '7', {
5117 "name": "history-hash-ie",
5118 "test": function (Y) {
5119 var docMode = Y.config.doc && Y.config.doc.documentMode;
5121 return Y.UA.ie && (!('onhashchange' in Y.config.win) ||
5122 !docMode || docMode < 8);
5123 },
5124 "trigger": "history-hash"
5125 });
5126 // transition-timer
5127 add('load', '8', {
5128 "name": "transition-timer",
5129 "test": function (Y) {
5130 var DOCUMENT = Y.config.doc,
5131 node = (DOCUMENT) ? DOCUMENT.documentElement: null,
5132 ret = true;
5134 if (node && node.style) {
5135 ret = !('MozTransition' in node.style || 'WebkitTransition' in node.style);
5136 }
5138 return ret;
5139 },
5140 "trigger": "transition"
5141 });
5142 // dom-style-ie
5143 add('load', '9', {
5144 "name": "dom-style-ie",
5145 "test": function (Y) {
5147 var testFeature = Y.Features.test,
5148 addFeature = Y.Features.add,
5149 WINDOW = Y.config.win,
5150 DOCUMENT = Y.config.doc,
5151 DOCUMENT_ELEMENT = 'documentElement',
5152 ret = false;
5154 addFeature('style', 'computedStyle', {
5155 test: function() {
5156 return WINDOW && 'getComputedStyle' in WINDOW;
5157 }
5158 });
5160 addFeature('style', 'opacity', {
5161 test: function() {
5162 return DOCUMENT && 'opacity' in DOCUMENT[DOCUMENT_ELEMENT].style;
5163 }
5164 });
5166 ret = (!testFeature('style', 'opacity') &&
5167 !testFeature('style', 'computedStyle'));
5169 return ret;
5170 },
5171 "trigger": "dom-style"
5172 });
5173 // selector-css2
5174 add('load', '10', {
5175 "name": "selector-css2",
5176 "test": function (Y) {
5177 var DOCUMENT = Y.config.doc,
5178 ret = DOCUMENT && !('querySelectorAll' in DOCUMENT);
5180 return ret;
5181 },
5182 "trigger": "selector"
5183 });
5184 // widget-base-ie
5185 add('load', '11', {
5186 "name": "widget-base-ie",
5187 "trigger": "widget-base",
5188 "ua": "ie"
5189 });
5190 // event-base-ie
5191 add('load', '12', {
5192 "name": "event-base-ie",
5193 "test": function(Y) {
5194 var imp = Y.config.doc && Y.config.doc.implementation;
5195 return (imp && (!imp.hasFeature('Events', '2.0')));
5196 },
5197 "trigger": "node-base"
5198 });
5199 // dd-gestures
5200 add('load', '13', {
5201 "name": "dd-gestures",
5202 "test": function(Y) {
5203 return ((Y.config.win && ("ontouchstart" in Y.config.win)) && !(Y.UA.chrome && Y.UA.chrome < 6));
5204 },
5205 "trigger": "dd-drag"
5206 });
5207 // scrollview-base-ie
5208 add('load', '14', {
5209 "name": "scrollview-base-ie",
5210 "trigger": "scrollview-base",
5211 "ua": "ie"
5212 });
5213 // app-transitions-native
5214 add('load', '15', {
5215 "name": "app-transitions-native",
5216 "test": function (Y) {
5217 var doc = Y.config.doc,
5218 node = doc ? doc.documentElement : null;
5220 if (node && node.style) {
5221 return ('MozTransition' in node.style || 'WebkitTransition' in node.style);
5222 }
5224 return false;
5225 },
5226 "trigger": "app-transitions"
5227 });
5228 // graphics-canvas
5229 add('load', '16', {
5230 "name": "graphics-canvas",
5231 "test": function(Y) {
5232 var DOCUMENT = Y.config.doc,
5233 useCanvas = Y.config.defaultGraphicEngine && Y.config.defaultGraphicEngine == "canvas",
5234 canvas = DOCUMENT && DOCUMENT.createElement("canvas"),
5235 svg = (DOCUMENT && DOCUMENT.implementation.hasFeature("http://www.w3.org/TR/SVG11/feature#BasicStructure", "1.1"));
5236 return (!svg || useCanvas) && (canvas && canvas.getContext && canvas.getContext("2d"));
5237 },
5238 "trigger": "graphics"
5239 });
5240 // graphics-vml
5241 add('load', '17', {
5242 "name": "graphics-vml",
5243 "test": function(Y) {
5244 var DOCUMENT = Y.config.doc,
5245 canvas = DOCUMENT && DOCUMENT.createElement("canvas");
5246 return (DOCUMENT && !DOCUMENT.implementation.hasFeature("http://www.w3.org/TR/SVG11/feature#BasicStructure", "1.1") && (!canvas || !canvas.getContext || !canvas.getContext("2d")));
5247 },
5248 "trigger": "graphics"
5249 });
5252 }, '3.5.1' ,{requires:['yui-base']});
5253 YUI.add('intl-base', function(Y) {
5255 /**
5256 * The Intl utility provides a central location for managing sets of
5257 * localized resources (strings and formatting patterns).
5258 *
5259 * @class Intl
5260 * @uses EventTarget
5261 * @static
5262 */
5264 var SPLIT_REGEX = /[, ]/;
5266 Y.mix(Y.namespace('Intl'), {
5268 /**
5269 * Returns the language among those available that
5270 * best matches the preferred language list, using the Lookup
5271 * algorithm of BCP 47.
5272 * If none of the available languages meets the user's preferences,
5273 * then "" is returned.
5274 * Extended language ranges are not supported.
5275 *
5276 * @method lookupBestLang
5277 * @param {String[] | String} preferredLanguages The list of preferred
5278 * languages in descending preference order, represented as BCP 47
5279 * language tags. A string array or a comma-separated list.
5280 * @param {String[]} availableLanguages The list of languages
5281 * that the application supports, represented as BCP 47 language
5282 * tags.
5283 *
5284 * @return {String} The available language that best matches the
5285 * preferred language list, or "".
5286 * @since 3.1.0
5287 */
5288 lookupBestLang: function(preferredLanguages, availableLanguages) {
5290 var i, language, result, index;
5292 // check whether the list of available languages contains language;
5293 // if so return it
5294 function scan(language) {
5295 var i;
5296 for (i = 0; i < availableLanguages.length; i += 1) {
5297 if (language.toLowerCase() ===
5298 availableLanguages[i].toLowerCase()) {
5299 return availableLanguages[i];
5300 }
5301 }
5302 }
5304 if (Y.Lang.isString(preferredLanguages)) {
5305 preferredLanguages = preferredLanguages.split(SPLIT_REGEX);
5306 }
5308 for (i = 0; i < preferredLanguages.length; i += 1) {
5309 language = preferredLanguages[i];
5310 if (!language || language === '*') {
5311 continue;
5312 }
5313 // check the fallback sequence for one language
5314 while (language.length > 0) {
5315 result = scan(language);
5316 if (result) {
5317 return result;
5318 } else {
5319 index = language.lastIndexOf('-');
5320 if (index >= 0) {
5321 language = language.substring(0, index);
5322 // one-character subtags get cut along with the
5323 // following subtag
5324 if (index >= 2 && language.charAt(index - 2) === '-') {
5325 language = language.substring(0, index - 2);
5326 }
5327 } else {
5328 // nothing available for this language
5329 break;
5330 }
5331 }
5332 }
5333 }
5335 return '';
5336 }
5337 });
5340 }, '3.5.1' ,{requires:['yui-base']});
5341 YUI.add('yui-log', function(Y) {
5343 /**
5344 * Provides console log capability and exposes a custom event for
5345 * console implementations. This module is a `core` YUI module, <a href="../classes/YUI.html#method_log">it's documentation is located under the YUI class</a>.
5346 *
5347 * @module yui
5348 * @submodule yui-log
5349 */
5351 var INSTANCE = Y,
5352 LOGEVENT = 'yui:log',
5353 UNDEFINED = 'undefined',
5354 LEVELS = { debug: 1,
5355 info: 1,
5356 warn: 1,
5357 error: 1 };
5359 /**
5360 * If the 'debug' config is true, a 'yui:log' event will be
5361 * dispatched, which the Console widget and anything else
5362 * can consume. If the 'useBrowserConsole' config is true, it will
5363 * write to the browser console if available. YUI-specific log
5364 * messages will only be present in the -debug versions of the
5365 * JS files. The build system is supposed to remove log statements
5366 * from the raw and minified versions of the files.
5367 *
5368 * @method log
5369 * @for YUI
5370 * @param {String} msg The message to log.
5371 * @param {String} cat The log category for the message. Default
5372 * categories are "info", "warn", "error", time".
5373 * Custom categories can be used as well. (opt).
5374 * @param {String} src The source of the the message (opt).
5375 * @param {boolean} silent If true, the log event won't fire.
5376 * @return {YUI} YUI instance.
5377 */
5378 INSTANCE.log = function(msg, cat, src, silent) {
5379 var bail, excl, incl, m, f,
5380 Y = INSTANCE,
5381 c = Y.config,
5382 publisher = (Y.fire) ? Y : YUI.Env.globalEvents;
5383 // suppress log message if the config is off or the event stack
5384 // or the event call stack contains a consumer of the yui:log event
5385 if (c.debug) {
5386 // apply source filters
5387 if (src) {
5388 excl = c.logExclude;
5389 incl = c.logInclude;
5390 if (incl && !(src in incl)) {
5391 bail = 1;
5392 } else if (incl && (src in incl)) {
5393 bail = !incl[src];
5394 } else if (excl && (src in excl)) {
5395 bail = excl[src];
5396 }
5397 }
5398 if (!bail) {
5399 if (c.useBrowserConsole) {
5400 m = (src) ? src + ': ' + msg : msg;
5401 if (Y.Lang.isFunction(c.logFn)) {
5402 c.logFn.call(Y, msg, cat, src);
5403 } else if (typeof console != UNDEFINED && console.log) {
5404 f = (cat && console[cat] && (cat in LEVELS)) ? cat : 'log';
5405 console[f](m);
5406 } else if (typeof opera != UNDEFINED) {
5407 opera.postError(m);
5408 }
5409 }
5411 if (publisher && !silent) {
5413 if (publisher == Y && (!publisher.getEvent(LOGEVENT))) {
5414 publisher.publish(LOGEVENT, {
5415 broadcast: 2
5416 });
5417 }
5419 publisher.fire(LOGEVENT, {
5420 msg: msg,
5421 cat: cat,
5422 src: src
5423 });
5424 }
5425 }
5426 }
5428 return Y;
5429 };
5431 /**
5432 * Write a system message. This message will be preserved in the
5433 * minified and raw versions of the YUI files, unlike log statements.
5434 * @method message
5435 * @for YUI
5436 * @param {String} msg The message to log.
5437 * @param {String} cat The log category for the message. Default
5438 * categories are "info", "warn", "error", time".
5439 * Custom categories can be used as well. (opt).
5440 * @param {String} src The source of the the message (opt).
5441 * @param {boolean} silent If true, the log event won't fire.
5442 * @return {YUI} YUI instance.
5443 */
5444 INSTANCE.message = function() {
5445 return INSTANCE.log.apply(INSTANCE, arguments);
5446 };
5449 }, '3.5.1' ,{requires:['yui-base']});
5450 YUI.add('yui-later', function(Y) {
5452 /**
5453 * Provides a setTimeout/setInterval wrapper. This module is a `core` YUI module, <a href="../classes/YUI.html#method_later">it's documentation is located under the YUI class</a>.
5454 *
5455 * @module yui
5456 * @submodule yui-later
5457 */
5459 var NO_ARGS = [];
5461 /**
5462 * Executes the supplied function in the context of the supplied
5463 * object 'when' milliseconds later. Executes the function a
5464 * single time unless periodic is set to true.
5465 * @for YUI
5466 * @method later
5467 * @param when {int} the number of milliseconds to wait until the fn
5468 * is executed.
5469 * @param o the context object.
5470 * @param fn {Function|String} the function to execute or the name of
5471 * the method in the 'o' object to execute.
5472 * @param data [Array] data that is provided to the function. This
5473 * accepts either a single item or an array. If an array is provided,
5474 * the function is executed with one parameter for each array item.
5475 * If you need to pass a single array parameter, it needs to be wrapped
5476 * in an array [myarray].
5477 *
5478 * Note: native methods in IE may not have the call and apply methods.
5479 * In this case, it will work, but you are limited to four arguments.
5480 *
5481 * @param periodic {boolean} if true, executes continuously at supplied
5482 * interval until canceled.
5483 * @return {object} a timer object. Call the cancel() method on this
5484 * object to stop the timer.
5485 */
5486 Y.later = function(when, o, fn, data, periodic) {
5487 when = when || 0;
5488 data = (!Y.Lang.isUndefined(data)) ? Y.Array(data) : NO_ARGS;
5489 o = o || Y.config.win || Y;
5491 var cancelled = false,
5492 method = (o && Y.Lang.isString(fn)) ? o[fn] : fn,
5493 wrapper = function() {
5494 // IE 8- may execute a setInterval callback one last time
5495 // after clearInterval was called, so in order to preserve
5496 // the cancel() === no more runny-run, we have to jump through
5497 // an extra hoop.
5498 if (!cancelled) {
5499 if (!method.apply) {
5500 method(data[0], data[1], data[2], data[3]);
5501 } else {
5502 method.apply(o, data || NO_ARGS);
5503 }
5504 }
5505 },
5506 id = (periodic) ? setInterval(wrapper, when) : setTimeout(wrapper, when);
5508 return {
5509 id: id,
5510 interval: periodic,
5511 cancel: function() {
5512 cancelled = true;
5513 if (this.interval) {
5514 clearInterval(id);
5515 } else {
5516 clearTimeout(id);
5517 }
5518 }
5519 };
5520 };
5522 Y.Lang.later = Y.later;
5526 }, '3.5.1' ,{requires:['yui-base']});
5529 YUI.add('yui', function(Y){}, '3.5.1' ,{use:['yui-base','get','features','intl-base','yui-log','yui-later']});