3 * Copyright(c) 2006-2010 Sencha Inc.
5 * http://www.sencha.com/license
8 window.undefined = window.undefined;
12 * Ext core utilities and functions.
18 * The version of the framework
30 * Copies all the properties of config to obj.
31 * @param {Object} obj The receiver of the properties
32 * @param {Object} config The source of the properties
33 * @param {Object} defaults A different object that will also be applied for default values
34 * @return {Object} returns obj
37 Ext.apply = function(o, c, defaults){
38 // no "this" reference for friendly out of scope calls
40 Ext.apply(o, defaults);
42 if(o && c && typeof c == 'object'){
52 toString = Object.prototype.toString,
53 ua = navigator.userAgent.toLowerCase(),
58 docMode = DOC.documentMode,
59 isStrict = DOC.compatMode == "CSS1Compat",
60 isOpera = check(/opera/),
61 isChrome = check(/\bchrome\b/),
62 isWebKit = check(/webkit/),
63 isSafari = !isChrome && check(/safari/),
64 isSafari2 = isSafari && check(/applewebkit\/4/), // unique to Safari 2
65 isSafari3 = isSafari && check(/version\/3/),
66 isSafari4 = isSafari && check(/version\/4/),
67 isIE = !isOpera && check(/msie/),
68 isIE7 = isIE && (check(/msie 7/) || docMode == 7),
69 isIE8 = isIE && (check(/msie 8/) && docMode != 7),
70 isIE6 = isIE && !isIE7 && !isIE8,
71 isGecko = !isWebKit && check(/gecko/),
72 isGecko2 = isGecko && check(/rv:1\.8/),
73 isGecko3 = isGecko && check(/rv:1\.9/),
74 isBorderBox = isIE && !isStrict,
75 isWindows = check(/windows|win32/),
76 isMac = check(/macintosh|mac os x/),
77 isAir = check(/adobeair/),
78 isLinux = check(/linux/),
79 isSecure = /^https/i.test(window.location.protocol);
81 // remove css image flicker
84 DOC.execCommand("BackgroundImageCache", false, true);
90 * URL to a blank file used by Ext when in secure mode for iframe src and onReady src to prevent
91 * the IE insecure content warning (<tt>'about:blank'</tt>, except for IE in secure mode, which is <tt>'javascript:""'</tt>).
94 SSL_SECURE_URL : isSecure && isIE ? 'javascript:""' : 'about:blank',
96 * True if the browser is in strict (standards-compliant) mode, as opposed to quirks mode
101 * True if the page is running over SSL
106 * True when the document is fully initialized and ready for action
112 * True if the {@link Ext.Fx} Class is available
118 * HIGHLY EXPERIMENTAL
119 * True to force css based border-box model override and turning off javascript based adjustments. This is a
120 * runtime configuration and must be set before onReady.
123 enableForcedBoxModel : false,
126 * True to automatically uncache orphaned Ext.Elements periodically (defaults to true)
129 enableGarbageCollector : true,
132 * True to automatically purge event listeners during garbageCollection (defaults to false).
135 enableListenerCollection : false,
138 * EXPERIMENTAL - True to cascade listener removal to child elements when an element is removed.
139 * Currently not optimized for performance.
142 enableNestedListenerRemoval : false,
145 * Indicates whether to use native browser parsing for JSON methods.
146 * This option is ignored if the browser does not support native JSON methods.
147 * <b>Note: Native JSON methods will not work with objects that have functions.
148 * Also, property names must be quoted, otherwise the data will not parse.</b> (Defaults to false)
151 USE_NATIVE_JSON : false,
154 * Copies all the properties of config to obj if they don't already exist.
155 * @param {Object} obj The receiver of the properties
156 * @param {Object} config The source of the properties
157 * @return {Object} returns obj
159 applyIf : function(o, c){
162 if(!Ext.isDefined(o[p])){
171 * Generates unique ids. If the element already has an id, it is unchanged
172 * @param {Mixed} el (optional) The element to generate an id for
173 * @param {String} prefix (optional) Id prefix (defaults "ext-gen")
174 * @return {String} The generated Id.
176 id : function(el, prefix){
177 el = Ext.getDom(el, true) || {};
179 el.id = (prefix || "ext-gen") + (++idSeed);
185 * <p>Extends one class to create a subclass and optionally overrides members with the passed literal. This method
186 * also adds the function "override()" to the subclass that can be used to override members of the class.</p>
187 * For example, to create a subclass of Ext GridPanel:
189 MyGridPanel = Ext.extend(Ext.grid.GridPanel, {
190 constructor: function(config) {
192 // Create configuration for this Grid.
193 var store = new Ext.data.Store({...});
194 var colModel = new Ext.grid.ColumnModel({...});
196 // Create a new config object containing our computed properties
197 // *plus* whatever was in the config parameter.
203 MyGridPanel.superclass.constructor.call(this, config);
205 // Your postprocessing here
208 yourMethod: function() {
214 * <p>This function also supports a 3-argument call in which the subclass's constructor is
215 * passed as an argument. In this form, the parameters are as follows:</p>
216 * <div class="mdetail-params"><ul>
217 * <li><code>subclass</code> : Function <div class="sub-desc">The subclass constructor.</div></li>
218 * <li><code>superclass</code> : Function <div class="sub-desc">The constructor of class being extended</div></li>
219 * <li><code>overrides</code> : Object <div class="sub-desc">A literal with members which are copied into the subclass's
220 * prototype, and are therefore shared among all instances of the new class.</div></li>
223 * @param {Function} superclass The constructor of class being extended.
224 * @param {Object} overrides <p>A literal with members which are copied into the subclass's
225 * prototype, and are therefore shared between all instances of the new class.</p>
226 * <p>This may contain a special member named <tt><b>constructor</b></tt>. This is used
227 * to define the constructor of the new class, and is returned. If this property is
228 * <i>not</i> specified, a constructor is generated and returned which just calls the
229 * superclass's constructor passing on its parameters.</p>
230 * <p><b>It is essential that you call the superclass constructor in any provided constructor. See example code.</b></p>
231 * @return {Function} The subclass constructor from the <code>overrides</code> parameter, or a generated one if not provided.
235 var io = function(o){
240 var oc = Object.prototype.constructor;
242 return function(sb, sp, overrides){
243 if(typeof sp == 'object'){
246 sb = overrides.constructor != oc ? overrides.constructor : function(){sp.apply(this, arguments);};
248 var F = function(){},
253 sbp = sb.prototype = new F();
256 if(spp.constructor == oc){
259 sb.override = function(o){
262 sbp.superclass = sbp.supr = (function(){
266 Ext.override(sb, overrides);
267 sb.extend = function(o){return Ext.extend(sb, o);};
273 * Adds a list of functions to the prototype of an existing class, overwriting any existing methods with the same name.
275 Ext.override(MyClass, {
276 newMethod1: function(){
279 newMethod2: function(foo){
284 * @param {Object} origclass The class to override
285 * @param {Object} overrides The list of functions to add to origClass. This should be specified as an object literal
286 * containing one or more methods.
289 override : function(origclass, overrides){
291 var p = origclass.prototype;
292 Ext.apply(p, overrides);
293 if(Ext.isIE && overrides.hasOwnProperty('toString')){
294 p.toString = overrides.toString;
300 * Creates namespaces to be used for scoping variables and classes so that they are not global.
301 * Specifying the last node of a namespace implicitly creates all other nodes. Usage:
303 Ext.namespace('Company', 'Company.data');
304 Ext.namespace('Company.data'); // equivalent and preferable to above syntax
305 Company.Widget = function() { ... }
306 Company.data.CustomStore = function(config) { ... }
308 * @param {String} namespace1
309 * @param {String} namespace2
310 * @param {String} etc
311 * @return {Object} The namespace object. (If multiple arguments are passed, this will be the last namespace created)
314 namespace : function(){
316 Ext.each(arguments, function(v) {
318 o = window[d[0]] = window[d[0]] || {};
319 Ext.each(d.slice(1), function(v2){
320 o = o[v2] = o[v2] || {};
327 * Takes an object and converts it to an encoded URL. e.g. Ext.urlEncode({foo: 1, bar: 2}); would return "foo=1&bar=2". Optionally, property values can be arrays, instead of keys and the resulting string that's returned will contain a name/value pair for each array value.
329 * @param {String} pre (optional) A prefix to add to the url encoded string
332 urlEncode : function(o, pre){
335 e = encodeURIComponent;
337 Ext.iterate(o, function(key, item){
338 empty = Ext.isEmpty(item);
339 Ext.each(empty ? key : item, function(val){
340 buf.push('&', e(key), '=', (!Ext.isEmpty(val) && (val != key || !empty)) ? (Ext.isDate(val) ? Ext.encode(val).replace(/"/g, '') : e(val)) : '');
347 return pre + buf.join('');
351 * Takes an encoded URL and and converts it to an object. Example: <pre><code>
352 Ext.urlDecode("foo=1&bar=2"); // returns {foo: "1", bar: "2"}
353 Ext.urlDecode("foo=1&bar=2&bar=3&bar=4", false); // returns {foo: "1", bar: ["2", "3", "4"]}
355 * @param {String} string
356 * @param {Boolean} overwrite (optional) Items of the same name will overwrite previous values instead of creating an an array (Defaults to false).
357 * @return {Object} A literal with members
359 urlDecode : function(string, overwrite){
360 if(Ext.isEmpty(string)){
364 pairs = string.split('&'),
365 d = decodeURIComponent,
368 Ext.each(pairs, function(pair) {
369 pair = pair.split('=');
372 obj[name] = overwrite || !obj[name] ? value :
373 [].concat(obj[name]).concat(value);
379 * Appends content to the query string of a URL, handling logic for whether to place
380 * a question mark or ampersand.
381 * @param {String} url The URL to append to.
382 * @param {String} s The content to append to the URL.
383 * @return (String) The resulting URL
385 urlAppend : function(url, s){
387 return url + (url.indexOf('?') === -1 ? '?' : '&') + s;
393 * Converts any iterable (numeric indices and a length property) into a true array
394 * Don't use this on strings. IE doesn't support "abc"[0] which this implementation depends on.
395 * For strings, use this instead: "abc".match(/./g) => [a,b,c];
396 * @param {Iterable} the iterable object to be turned into a true Array.
397 * @return (Array) array
399 toArray : function(){
401 function(a, i, j, res){
403 for(var x = 0, len = a.length; x < len; x++) {
406 return res.slice(i || 0, j || res.length);
409 return Array.prototype.slice.call(a, i || 0, j || a.length);
413 isIterable : function(v){
414 //check for array or arguments
415 if(Ext.isArray(v) || v.callee){
418 //check for node list type
419 if(/NodeList|HTMLCollection/.test(toString.call(v))){
422 //NodeList has an item and length property
423 //IXMLDOMNodeList has nextNode method, needs to be checked first.
424 return ((typeof v.nextNode != 'undefined' || v.item) && Ext.isNumber(v.length));
428 * Iterates an array calling the supplied function.
429 * @param {Array/NodeList/Mixed} array The array to be iterated. If this
430 * argument is not really an array, the supplied function is called once.
431 * @param {Function} fn The function to be called with each item. If the
432 * supplied function returns false, iteration stops and this method returns
433 * the current <code>index</code>. This function is called with
434 * the following arguments:
435 * <div class="mdetail-params"><ul>
436 * <li><code>item</code> : <i>Mixed</i>
437 * <div class="sub-desc">The item at the current <code>index</code>
438 * in the passed <code>array</code></div></li>
439 * <li><code>index</code> : <i>Number</i>
440 * <div class="sub-desc">The current index within the array</div></li>
441 * <li><code>allItems</code> : <i>Array</i>
442 * <div class="sub-desc">The <code>array</code> passed as the first
443 * argument to <code>Ext.each</code>.</div></li>
445 * @param {Object} scope The scope (<code>this</code> reference) in which the specified function is executed.
446 * Defaults to the <code>item</code> at the current <code>index</code>
447 * within the passed <code>array</code>.
448 * @return See description for the fn parameter.
450 each : function(array, fn, scope){
451 if(Ext.isEmpty(array, true)){
454 if(!Ext.isIterable(array) || Ext.isPrimitive(array)){
457 for(var i = 0, len = array.length; i < len; i++){
458 if(fn.call(scope || array[i], array[i], i, array) === false){
465 * Iterates either the elements in an array, or each of the properties in an object.
466 * <b>Note</b>: If you are only iterating arrays, it is better to call {@link #each}.
467 * @param {Object/Array} object The object or array to be iterated
468 * @param {Function} fn The function to be called for each iteration.
469 * The iteration will stop if the supplied function returns false, or
470 * all array elements / object properties have been covered. The signature
471 * varies depending on the type of object being interated:
472 * <div class="mdetail-params"><ul>
473 * <li>Arrays : <tt>(Object item, Number index, Array allItems)</tt>
474 * <div class="sub-desc">
475 * When iterating an array, the supplied function is called with each item.</div></li>
476 * <li>Objects : <tt>(String key, Object value, Object)</tt>
477 * <div class="sub-desc">
478 * When iterating an object, the supplied function is called with each key-value pair in
479 * the object, and the iterated object</div></li>
481 * @param {Object} scope The scope (<code>this</code> reference) in which the specified function is executed. Defaults to
482 * the <code>object</code> being iterated.
484 iterate : function(obj, fn, scope){
485 if(Ext.isEmpty(obj)){
488 if(Ext.isIterable(obj)){
489 Ext.each(obj, fn, scope);
491 }else if(typeof obj == 'object'){
492 for(var prop in obj){
493 if(obj.hasOwnProperty(prop)){
494 if(fn.call(scope || obj, prop, obj[prop], obj) === false){
503 * Return the dom node for the passed String (id), dom node, or Ext.Element.
504 * Optional 'strict' flag is needed for IE since it can return 'name' and
505 * 'id' elements by using getElementById.
506 * Here are some examples:
508 // gets dom node based on id
509 var elDom = Ext.getDom('elId');
510 // gets dom node based on the dom node
511 var elDom1 = Ext.getDom(elDom);
513 // If we don't know if we are working with an
514 // Ext.Element or a dom node use Ext.getDom
516 var dom = Ext.getDom(el);
517 // do something with the dom node
520 * <b>Note</b>: the dom node to be found actually needs to exist (be rendered, etc)
521 * when this method is called to be successful.
523 * @return HTMLElement
525 getDom : function(el, strict){
532 if (typeof el == 'string') {
533 var e = DOC.getElementById(el);
534 // IE returns elements with the 'name' and 'id' attribute.
535 // we do a strict check to return the element with only the id attribute
536 if (e && isIE && strict) {
537 if (el == e.getAttribute('id')) {
551 * Returns the current document body as an {@link Ext.Element}.
552 * @return Ext.Element The document body
554 getBody : function(){
555 return Ext.get(DOC.body || DOC.documentElement);
559 * Returns the current document body as an {@link Ext.Element}.
560 * @return Ext.Element The document body
562 getHead : function() {
566 if (head == undefined) {
567 head = Ext.get(DOC.getElementsByTagName("head")[0]);
575 * Removes a DOM node from the document.
578 * <p>Removes this element from the document, removes all DOM event listeners, and deletes the cache reference.
579 * All DOM event listeners are removed from this element. If {@link Ext#enableNestedListenerRemoval} is
580 * <code>true</code>, then DOM event listeners are also removed from all child nodes. The body node
581 * will be ignored if passed in.</p>
582 * @param {HTMLElement} node The node to remove
584 removeNode : isIE && !isIE8 ? function(){
587 if(n && n.tagName != 'BODY'){
588 (Ext.enableNestedListenerRemoval) ? Ext.EventManager.purgeElement(n, true) : Ext.EventManager.removeAll(n);
589 d = d || DOC.createElement('div');
592 delete Ext.elCache[n.id];
596 if(n && n.parentNode && n.tagName != 'BODY'){
597 (Ext.enableNestedListenerRemoval) ? Ext.EventManager.purgeElement(n, true) : Ext.EventManager.removeAll(n);
598 n.parentNode.removeChild(n);
599 delete Ext.elCache[n.id];
604 * <p>Returns true if the passed value is empty.</p>
605 * <p>The value is deemed to be empty if it is<div class="mdetail-params"><ul>
608 * <li>an empty array</li>
609 * <li>a zero length string (Unless the <tt>allowBlank</tt> parameter is <tt>true</tt>)</li>
611 * @param {Mixed} value The value to test
612 * @param {Boolean} allowBlank (optional) true to allow empty strings (defaults to false)
615 isEmpty : function(v, allowBlank){
616 return v === null || v === undefined || ((Ext.isArray(v) && !v.length)) || (!allowBlank ? v === '' : false);
620 * Returns true if the passed value is a JavaScript array, otherwise false.
621 * @param {Mixed} value The value to test
624 isArray : function(v){
625 return toString.apply(v) === '[object Array]';
629 * Returns true if the passed object is a JavaScript date object, otherwise false.
630 * @param {Object} object The object to test
633 isDate : function(v){
634 return toString.apply(v) === '[object Date]';
638 * Returns true if the passed value is a JavaScript Object, otherwise false.
639 * @param {Mixed} value The value to test
642 isObject : function(v){
643 return !!v && Object.prototype.toString.call(v) === '[object Object]';
647 * Returns true if the passed value is a JavaScript 'primitive', a string, number or boolean.
648 * @param {Mixed} value The value to test
651 isPrimitive : function(v){
652 return Ext.isString(v) || Ext.isNumber(v) || Ext.isBoolean(v);
656 * Returns true if the passed value is a JavaScript Function, otherwise false.
657 * @param {Mixed} value The value to test
660 isFunction : function(v){
661 return toString.apply(v) === '[object Function]';
665 * Returns true if the passed value is a number. Returns false for non-finite numbers.
666 * @param {Mixed} value The value to test
669 isNumber : function(v){
670 return typeof v === 'number' && isFinite(v);
674 * Returns true if the passed value is a string.
675 * @param {Mixed} value The value to test
678 isString : function(v){
679 return typeof v === 'string';
683 * Returns true if the passed value is a boolean.
684 * @param {Mixed} value The value to test
687 isBoolean : function(v){
688 return typeof v === 'boolean';
692 * Returns true if the passed value is an HTMLElement
693 * @param {Mixed} value The value to test
696 isElement : function(v) {
697 return v ? !!v.tagName : false;
701 * Returns true if the passed value is not undefined.
702 * @param {Mixed} value The value to test
705 isDefined : function(v){
706 return typeof v !== 'undefined';
710 * True if the detected browser is Opera.
715 * True if the detected browser uses WebKit.
720 * True if the detected browser is Chrome.
725 * True if the detected browser is Safari.
730 * True if the detected browser is Safari 3.x.
733 isSafari3 : isSafari3,
735 * True if the detected browser is Safari 4.x.
738 isSafari4 : isSafari4,
740 * True if the detected browser is Safari 2.x.
743 isSafari2 : isSafari2,
745 * True if the detected browser is Internet Explorer.
750 * True if the detected browser is Internet Explorer 6.x.
755 * True if the detected browser is Internet Explorer 7.x.
760 * True if the detected browser is Internet Explorer 8.x.
765 * True if the detected browser uses the Gecko layout engine (e.g. Mozilla, Firefox).
770 * True if the detected browser uses a pre-Gecko 1.9 layout engine (e.g. Firefox 2.x).
775 * True if the detected browser uses a Gecko 1.9+ layout engine (e.g. Firefox 3.x).
780 * True if the detected browser is Internet Explorer running in non-strict mode.
783 isBorderBox : isBorderBox,
785 * True if the detected platform is Linux.
790 * True if the detected platform is Windows.
793 isWindows : isWindows,
795 * True if the detected platform is Mac OS.
800 * True if the detected platform is Adobe Air.
807 * Creates namespaces to be used for scoping variables and classes so that they are not global.
808 * Specifying the last node of a namespace implicitly creates all other nodes. Usage:
810 Ext.namespace('Company', 'Company.data');
811 Ext.namespace('Company.data'); // equivalent and preferable to above syntax
812 Company.Widget = function() { ... }
813 Company.data.CustomStore = function(config) { ... }
815 * @param {String} namespace1
816 * @param {String} namespace2
817 * @param {String} etc
818 * @return {Object} The namespace object. (If multiple arguments are passed, this will be the last namespace created)
821 Ext.ns = Ext.namespace;
824 Ext.ns('Ext.util', 'Ext.lib', 'Ext.data', 'Ext.supports');
830 * These functions are available on every Function object (any JavaScript function).
832 Ext.apply(Function.prototype, {
834 * Creates an interceptor function. The passed function is called before the original one. If it returns false,
835 * the original one is not called. The resulting function returns the results of the original function.
836 * The passed function is called with the parameters of the original function. Example usage:
838 var sayHi = function(name){
839 alert('Hi, ' + name);
842 sayHi('Fred'); // alerts "Hi, Fred"
844 // create a new function that validates input without
845 // directly modifying the original function:
846 var sayHiToFriend = sayHi.createInterceptor(function(name){
847 return name == 'Brian';
850 sayHiToFriend('Fred'); // no alert
851 sayHiToFriend('Brian'); // alerts "Hi, Brian"
853 * @param {Function} fcn The function to call before the original
854 * @param {Object} scope (optional) The scope (<code><b>this</b></code> reference) in which the passed function is executed.
855 * <b>If omitted, defaults to the scope in which the original function is called or the browser window.</b>
856 * @return {Function} The new function
858 createInterceptor : function(fcn, scope){
860 return !Ext.isFunction(fcn) ?
867 return (fcn.apply(scope || me || window, args) !== false) ?
868 method.apply(me || window, args) :
874 * Creates a callback that passes arguments[0], arguments[1], arguments[2], ...
875 * Call directly on any function. Example: <code>myFunction.createCallback(arg1, arg2)</code>
876 * Will create a function that is bound to those 2 args. <b>If a specific scope is required in the
877 * callback, use {@link #createDelegate} instead.</b> The function returned by createCallback always
878 * executes in the window scope.
879 * <p>This method is required when you want to pass arguments to a callback function. If no arguments
880 * are needed, you can simply pass a reference to the function as a callback (e.g., callback: myFn).
881 * However, if you tried to pass a function with arguments (e.g., callback: myFn(arg1, arg2)) the function
882 * would simply execute immediately when the code is parsed. Example usage:
884 var sayHi = function(name){
885 alert('Hi, ' + name);
888 // clicking the button alerts "Hi, Fred"
891 renderTo: Ext.getBody(),
892 handler: sayHi.createCallback('Fred')
895 * @return {Function} The new function
897 createCallback : function(/*args...*/){
898 // make args available, in function below
899 var args = arguments,
902 return method.apply(window, args);
907 * Creates a delegate (callback) that sets the scope to obj.
908 * Call directly on any function. Example: <code>this.myFunction.createDelegate(this, [arg1, arg2])</code>
909 * Will create a function that is automatically scoped to obj so that the <tt>this</tt> variable inside the
910 * callback points to obj. Example usage:
912 var sayHi = function(name){
913 // Note this use of "this.text" here. This function expects to
914 // execute within a scope that contains a text property. In this
915 // example, the "this" variable is pointing to the btn object that
916 // was passed in createDelegate below.
917 alert('Hi, ' + name + '. You clicked the "' + this.text + '" button.');
920 var btn = new Ext.Button({
922 renderTo: Ext.getBody()
925 // This callback will execute in the scope of the
926 // button instance. Clicking the button alerts
927 // "Hi, Fred. You clicked the "Say Hi" button."
928 btn.on('click', sayHi.createDelegate(btn, ['Fred']));
930 * @param {Object} scope (optional) The scope (<code><b>this</b></code> reference) in which the function is executed.
931 * <b>If omitted, defaults to the browser window.</b>
932 * @param {Array} args (optional) Overrides arguments for the call. (Defaults to the arguments passed by the caller)
933 * @param {Boolean/Number} appendArgs (optional) if True args are appended to call args instead of overriding,
934 * if a number the args are inserted at the specified position
935 * @return {Function} The new function
937 createDelegate : function(obj, args, appendArgs){
940 var callArgs = args || arguments;
941 if (appendArgs === true){
942 callArgs = Array.prototype.slice.call(arguments, 0);
943 callArgs = callArgs.concat(args);
944 }else if (Ext.isNumber(appendArgs)){
945 callArgs = Array.prototype.slice.call(arguments, 0); // copy arguments first
946 var applyArgs = [appendArgs, 0].concat(args); // create method call params
947 Array.prototype.splice.apply(callArgs, applyArgs); // splice them in
949 return method.apply(obj || window, callArgs);
954 * Calls this function after the number of millseconds specified, optionally in a specific scope. Example usage:
956 var sayHi = function(name){
957 alert('Hi, ' + name);
960 // executes immediately:
963 // executes after 2 seconds:
964 sayHi.defer(2000, this, ['Fred']);
966 // this syntax is sometimes useful for deferring
967 // execution of an anonymous function:
972 * @param {Number} millis The number of milliseconds for the setTimeout call (if less than or equal to 0 the function is executed immediately)
973 * @param {Object} scope (optional) The scope (<code><b>this</b></code> reference) in which the function is executed.
974 * <b>If omitted, defaults to the browser window.</b>
975 * @param {Array} args (optional) Overrides arguments for the call. (Defaults to the arguments passed by the caller)
976 * @param {Boolean/Number} appendArgs (optional) if True args are appended to call args instead of overriding,
977 * if a number the args are inserted at the specified position
978 * @return {Number} The timeout id that can be used with clearTimeout
980 defer : function(millis, obj, args, appendArgs){
981 var fn = this.createDelegate(obj, args, appendArgs);
983 return setTimeout(fn, millis);
992 * These functions are available on every String object.
994 Ext.applyIf(String, {
996 * Allows you to define a tokenized string and pass an arbitrary number of arguments to replace the tokens. Each
997 * token must be unique, and must increment in the format {0}, {1}, etc. Example usage:
999 var cls = 'my-class', text = 'Some text';
1000 var s = String.format('<div class="{0}">{1}</div>', cls, text);
1001 // s now contains the string: '<div class="my-class">Some text</div>'
1003 * @param {String} string The tokenized string to be formatted
1004 * @param {String} value1 The value to replace token {0}
1005 * @param {String} value2 Etc...
1006 * @return {String} The formatted string
1009 format : function(format){
1010 var args = Ext.toArray(arguments, 1);
1011 return format.replace(/\{(\d+)\}/g, function(m, i){
1020 Ext.applyIf(Array.prototype, {
1022 * Checks whether or not the specified object exists in the array.
1023 * @param {Object} o The object to check for
1024 * @param {Number} from (Optional) The index at which to begin the search
1025 * @return {Number} The index of o in the array (or -1 if it is not found)
1027 indexOf : function(o, from){
1028 var len = this.length;
1030 from += (from < 0) ? len : 0;
1031 for (; from < len; ++from){
1032 if(this[from] === o){
1040 * Removes the specified object from the array. If the object is not found nothing happens.
1041 * @param {Object} o The object to remove
1042 * @return {Array} this array
1044 remove : function(o){
1045 var index = this.indexOf(o);
1047 this.splice(index, 1);
1053 * @class Ext.util.TaskRunner
1054 * Provides the ability to execute one or more arbitrary tasks in a multithreaded
1055 * manner. Generally, you can use the singleton {@link Ext.TaskMgr} instead, but
1056 * if needed, you can create separate instances of TaskRunner. Any number of
1057 * separate tasks can be started at any time and will run independently of each
1058 * other. Example usage:
1060 // Start a simple clock task that updates a div once per second
1061 var updateClock = function(){
1062 Ext.fly('clock').update(new Date().format('g:i:s A'));
1066 interval: 1000 //1 second
1068 var runner = new Ext.util.TaskRunner();
1071 // equivalent using TaskMgr
1078 * <p>See the {@link #start} method for details about how to configure a task object.</p>
1079 * Also see {@link Ext.util.DelayedTask}.
1082 * @param {Number} interval (optional) The minimum precision in milliseconds supported by this TaskRunner instance
1085 Ext.util.TaskRunner = function(interval){
1086 interval = interval || 10;
1093 stopThread = function(){
1100 startThread = function(){
1103 id = setInterval(runTasks, interval);
1108 removeTask = function(t){
1109 removeQueue.push(t);
1111 t.onStop.apply(t.scope || t);
1116 runTasks = function(){
1117 var rqLen = removeQueue.length,
1118 now = new Date().getTime();
1121 for(var i = 0; i < rqLen; i++){
1122 tasks.remove(removeQueue[i]);
1125 if(tasks.length < 1){
1130 for(var i = 0, t, itime, rt, len = tasks.length; i < len; ++i){
1132 itime = now - t.taskRunTime;
1133 if(t.interval <= itime){
1134 rt = t.run.apply(t.scope || t, t.args || [++t.taskRunCount]);
1135 t.taskRunTime = now;
1136 if(rt === false || t.taskRunCount === t.repeat){
1141 if(t.duration && t.duration <= (now - t.taskStartTime)){
1148 * Starts a new task.
1150 * @param {Object} task <p>A config object that supports the following properties:<ul>
1151 * <li><code>run</code> : Function<div class="sub-desc"><p>The function to execute each time the task is invoked. The
1152 * function will be called at each interval and passed the <code>args</code> argument if specified, and the
1153 * current invocation count if not.</p>
1154 * <p>If a particular scope (<code>this</code> reference) is required, be sure to specify it using the <code>scope</code> argument.</p>
1155 * <p>Return <code>false</code> from this function to terminate the task.</p></div></li>
1156 * <li><code>interval</code> : Number<div class="sub-desc">The frequency in milliseconds with which the task
1157 * should be invoked.</div></li>
1158 * <li><code>args</code> : Array<div class="sub-desc">(optional) An array of arguments to be passed to the function
1159 * specified by <code>run</code>. If not specified, the current invocation count is passed.</div></li>
1160 * <li><code>scope</code> : Object<div class="sub-desc">(optional) The scope (<tt>this</tt> reference) in which to execute the
1161 * <code>run</code> function. Defaults to the task config object.</div></li>
1162 * <li><code>duration</code> : Number<div class="sub-desc">(optional) The length of time in milliseconds to invoke
1163 * the task before stopping automatically (defaults to indefinite).</div></li>
1164 * <li><code>repeat</code> : Number<div class="sub-desc">(optional) The number of times to invoke the task before
1165 * stopping automatically (defaults to indefinite).</div></li>
1167 * <p>Before each invocation, Ext injects the property <code>taskRunCount</code> into the task object so
1168 * that calculations based on the repeat count can be performed.</p>
1169 * @return {Object} The task
1171 this.start = function(task){
1173 task.taskStartTime = new Date().getTime();
1174 task.taskRunTime = 0;
1175 task.taskRunCount = 0;
1181 * Stops an existing running task.
1183 * @param {Object} task The task to stop
1184 * @return {Object} The task
1186 this.stop = function(task){
1192 * Stops all tasks that are currently running.
1195 this.stopAll = function(){
1197 for(var i = 0, len = tasks.length; i < len; i++){
1198 if(tasks[i].onStop){
1208 * @class Ext.TaskMgr
1209 * @extends Ext.util.TaskRunner
1210 * A static {@link Ext.util.TaskRunner} instance that can be used to start and stop arbitrary tasks. See
1211 * {@link Ext.util.TaskRunner} for supported methods and task config properties.
1213 // Start a simple clock task that updates a div once per second
1216 Ext.fly('clock').update(new Date().format('g:i:s A'));
1218 interval: 1000 //1 second
1220 Ext.TaskMgr.start(task);
1222 * <p>See the {@link #start} method for details about how to configure a task object.</p>
1225 Ext.TaskMgr = new Ext.util.TaskRunner();(function(){
1229 if (!libFlyweight) {
1230 libFlyweight = new Ext.Element.Flyweight();
1232 libFlyweight.dom = el;
1233 return libFlyweight;
1238 isCSS1 = doc.compatMode == "CSS1Compat",
1241 PARSEINT = parseInt;
1244 isAncestor : function(p, c) {
1251 return p.contains(c);
1252 } else if (p.compareDocumentPosition) {
1253 return !!(p.compareDocumentPosition(c) & 16);
1255 while (c = c.parentNode) {
1256 ret = c == p || ret;
1263 getViewWidth : function(full) {
1264 return full ? this.getDocumentWidth() : this.getViewportWidth();
1267 getViewHeight : function(full) {
1268 return full ? this.getDocumentHeight() : this.getViewportHeight();
1271 getDocumentHeight: function() {
1272 return MAX(!isCSS1 ? doc.body.scrollHeight : doc.documentElement.scrollHeight, this.getViewportHeight());
1275 getDocumentWidth: function() {
1276 return MAX(!isCSS1 ? doc.body.scrollWidth : doc.documentElement.scrollWidth, this.getViewportWidth());
1279 getViewportHeight: function(){
1281 (Ext.isStrict ? doc.documentElement.clientHeight : doc.body.clientHeight) :
1285 getViewportWidth : function() {
1286 return !Ext.isStrict && !Ext.isOpera ? doc.body.clientWidth :
1287 Ext.isIE ? doc.documentElement.clientWidth : self.innerWidth;
1290 getY : function(el) {
1291 return this.getXY(el)[1];
1294 getX : function(el) {
1295 return this.getXY(el)[0];
1298 getXY : function(el) {
1309 bd = (doc.body || doc.documentElement),
1312 el = Ext.getDom(el);
1315 if (el.getBoundingClientRect) {
1316 b = el.getBoundingClientRect();
1317 scroll = fly(document).getScroll();
1318 ret = [ROUND(b.left + scroll.left), ROUND(b.top + scroll.top)];
1321 hasAbsolute = fly(el).isStyle("position", "absolute");
1328 hasAbsolute = hasAbsolute || pe.isStyle("position", "absolute");
1331 y += bt = PARSEINT(pe.getStyle("borderTopWidth"), 10) || 0;
1332 x += bl = PARSEINT(pe.getStyle("borderLeftWidth"), 10) || 0;
1334 if (p != el && !pe.isStyle('overflow','visible')) {
1342 if (Ext.isSafari && hasAbsolute) {
1347 if (Ext.isGecko && !hasAbsolute) {
1349 x += PARSEINT(dbd.getStyle("borderLeftWidth"), 10) || 0;
1350 y += PARSEINT(dbd.getStyle("borderTopWidth"), 10) || 0;
1354 while (p && p != bd) {
1355 if (!Ext.isOpera || (p.tagName != 'TR' && !fly(p).isStyle("display", "inline"))) {
1367 setXY : function(el, xy) {
1368 (el = Ext.fly(el, '_setXY')).position();
1370 var pts = el.translatePoints(xy),
1371 style = el.dom.style,
1375 if (!isNaN(pts[pos])) {
1376 style[pos] = pts[pos] + "px";
1381 setX : function(el, x) {
1382 this.setXY(el, [x, false]);
1385 setY : function(el, y) {
1386 this.setXY(el, [false, y]);
1389 })();Ext.lib.Event = function() {
1390 var loadComplete = false,
1391 unloadListeners = {},
1406 SCROLLLEFT = 'scrollLeft',
1407 SCROLLTOP = 'scrollTop',
1409 MOUSEOVER = 'mouseover',
1410 MOUSEOUT = 'mouseout',
1412 doAdd = function() {
1414 if (win.addEventListener) {
1415 ret = function(el, eventName, fn, capture) {
1416 if (eventName == 'mouseenter') {
1417 fn = fn.createInterceptor(checkRelatedTarget);
1418 el.addEventListener(MOUSEOVER, fn, (capture));
1419 } else if (eventName == 'mouseleave') {
1420 fn = fn.createInterceptor(checkRelatedTarget);
1421 el.addEventListener(MOUSEOUT, fn, (capture));
1423 el.addEventListener(eventName, fn, (capture));
1427 } else if (win.attachEvent) {
1428 ret = function(el, eventName, fn, capture) {
1429 el.attachEvent("on" + eventName, fn);
1438 doRemove = function(){
1440 if (win.removeEventListener) {
1441 ret = function (el, eventName, fn, capture) {
1442 if (eventName == 'mouseenter') {
1443 eventName = MOUSEOVER;
1444 } else if (eventName == 'mouseleave') {
1445 eventName = MOUSEOUT;
1447 el.removeEventListener(eventName, fn, (capture));
1449 } else if (win.detachEvent) {
1450 ret = function (el, eventName, fn) {
1451 el.detachEvent("on" + eventName, fn);
1459 function checkRelatedTarget(e) {
1460 return !elContains(e.currentTarget, pub.getRelatedTarget(e));
1463 function elContains(parent, child) {
1464 if(parent && parent.firstChild){
1466 if(child === parent) {
1469 child = child.parentNode;
1470 if(child && (child.nodeType != 1)) {
1479 function _tryPreloadAttach() {
1482 element, i, v, override,
1483 tryAgain = !loadComplete || (retryCount > 0);
1488 for(i = 0; i < onAvailStack.length; ++i){
1489 v = onAvailStack[i];
1490 if(v && (element = doc.getElementById(v.id))){
1491 if(!v.checkReady || loadComplete || element.nextSibling || (doc && doc.body)) {
1492 override = v.override;
1493 element = override ? (override === true ? v.obj : override) : element;
1494 v.fn.call(element, v.obj);
1495 onAvailStack.remove(v);
1503 retryCount = (notAvail.length === 0) ? 0 : retryCount - 1;
1508 clearInterval(_interval);
1511 ret = !(locked = false);
1517 function startInterval() {
1519 var callback = function() {
1520 _tryPreloadAttach();
1522 _interval = setInterval(callback, POLL_INTERVAL);
1527 function getScroll() {
1528 var dd = doc.documentElement,
1530 if(dd && (dd[SCROLLTOP] || dd[SCROLLLEFT])){
1531 return [dd[SCROLLLEFT], dd[SCROLLTOP]];
1533 return [db[SCROLLLEFT], db[SCROLLTOP]];
1540 function getPageCoord (ev, xy) {
1541 ev = ev.browserEvent || ev;
1542 var coord = ev['page' + xy];
1543 if (!coord && coord !== 0) {
1544 coord = ev['client' + xy] || 0;
1547 coord += getScroll()[xy == "X" ? 0 : 1];
1556 onAvailable : function(p_id, p_fn, p_obj, p_override) {
1561 override: p_override,
1562 checkReady: false });
1564 retryCount = POLL_RETRYS;
1568 // This function should ALWAYS be called from Ext.EventManager
1569 addListener: function(el, eventName, fn) {
1570 el = Ext.getDom(el);
1572 if (eventName == UNLOAD) {
1573 if (unloadListeners[el.id] === undefined) {
1574 unloadListeners[el.id] = [];
1576 unloadListeners[el.id].push([eventName, fn]);
1579 return doAdd(el, eventName, fn, false);
1584 // This function should ALWAYS be called from Ext.EventManager
1585 removeListener: function(el, eventName, fn) {
1586 el = Ext.getDom(el);
1587 var i, len, li, lis;
1589 if(eventName == UNLOAD){
1590 if((lis = unloadListeners[el.id]) !== undefined){
1591 for(i = 0, len = lis.length; i < len; i++){
1592 if((li = lis[i]) && li[TYPE] == eventName && li[FN] == fn){
1593 unloadListeners[el.id].splice(i, 1);
1599 doRemove(el, eventName, fn, false);
1603 getTarget : function(ev) {
1604 ev = ev.browserEvent || ev;
1605 return this.resolveTextNode(ev.target || ev.srcElement);
1608 resolveTextNode : Ext.isGecko ? function(node){
1612 // work around firefox bug, https://bugzilla.mozilla.org/show_bug.cgi?id=101197
1613 var s = HTMLElement.prototype.toString.call(node);
1614 if(s == '[xpconnect wrapped native prototype]' || s == '[object XULElement]'){
1617 return node.nodeType == 3 ? node.parentNode : node;
1619 return node && node.nodeType == 3 ? node.parentNode : node;
1622 getRelatedTarget : function(ev) {
1623 ev = ev.browserEvent || ev;
1624 return this.resolveTextNode(ev.relatedTarget ||
1625 (/(mouseout|mouseleave)/.test(ev.type) ? ev.toElement :
1626 /(mouseover|mouseenter)/.test(ev.type) ? ev.fromElement : null));
1629 getPageX : function(ev) {
1630 return getPageCoord(ev, "X");
1633 getPageY : function(ev) {
1634 return getPageCoord(ev, "Y");
1638 getXY : function(ev) {
1639 return [this.getPageX(ev), this.getPageY(ev)];
1642 stopEvent : function(ev) {
1643 this.stopPropagation(ev);
1644 this.preventDefault(ev);
1647 stopPropagation : function(ev) {
1648 ev = ev.browserEvent || ev;
1649 if (ev.stopPropagation) {
1650 ev.stopPropagation();
1652 ev.cancelBubble = true;
1656 preventDefault : function(ev) {
1657 ev = ev.browserEvent || ev;
1658 if (ev.preventDefault) {
1659 ev.preventDefault();
1661 ev.returnValue = false;
1665 getEvent : function(e) {
1668 var c = this.getEvent.caller;
1671 if (e && Event == e.constructor) {
1680 getCharCode : function(ev) {
1681 ev = ev.browserEvent || ev;
1682 return ev.charCode || ev.keyCode || 0;
1685 //clearCache: function() {},
1686 // deprecated, call from EventManager
1687 getListeners : function(el, eventName) {
1688 Ext.EventManager.getListeners(el, eventName);
1691 // deprecated, call from EventManager
1692 purgeElement : function(el, recurse, eventName) {
1693 Ext.EventManager.purgeElement(el, recurse, eventName);
1696 _load : function(e) {
1697 loadComplete = true;
1699 if (Ext.isIE && e !== true) {
1700 // IE8 complains that _load is null or not an object
1701 // so lets remove self via arguments.callee
1702 doRemove(win, "load", arguments.callee);
1706 _unload : function(e) {
1707 var EU = Ext.lib.Event,
1708 i, v, ul, id, len, scope;
1710 for (id in unloadListeners) {
1711 ul = unloadListeners[id];
1712 for (i = 0, len = ul.length; i < len; i++) {
1716 scope = v[ADJ_SCOPE] ? (v[ADJ_SCOPE] === true ? v[OBJ] : v[ADJ_SCOPE]) : win;
1717 v[FN].call(scope, EU.getEvent(e), v[OBJ]);
1723 Ext.EventManager._unload();
1725 doRemove(win, UNLOAD, EU._unload);
1729 // Initialize stuff.
1730 pub.on = pub.addListener;
1731 pub.un = pub.removeListener;
1732 if (doc && doc.body) {
1735 doAdd(win, "load", pub._load);
1737 doAdd(win, UNLOAD, pub._unload);
1738 _tryPreloadAttach();
1743 * Portions of this file are based on pieces of Yahoo User Interface Library
1744 * Copyright (c) 2007, Yahoo! Inc. All rights reserved.
1745 * YUI licensed under the BSD License:
1746 * http://developer.yahoo.net/yui/license.txt
1748 Ext.lib.Ajax = function() {
1749 var activeX = ['Msxml2.XMLHTTP.6.0',
1750 'Msxml2.XMLHTTP.3.0',
1752 CONTENTTYPE = 'Content-Type';
1755 function setHeader(o) {
1760 function setTheHeaders(conn, headers){
1761 for (prop in headers) {
1762 if (headers.hasOwnProperty(prop)) {
1763 conn.setRequestHeader(prop, headers[prop]);
1768 Ext.apply(headers, pub.headers, pub.defaultHeaders);
1769 setTheHeaders(conn, headers);
1774 function createExceptionObject(tId, callbackArg, isAbort, isTimeout) {
1777 status : isAbort ? -1 : 0,
1778 statusText : isAbort ? 'transaction aborted' : 'communication failure',
1780 isTimeout: isTimeout,
1781 argument : callbackArg
1786 function initHeader(label, value) {
1787 (pub.headers = pub.headers || {})[label] = value;
1791 function createResponseObject(o, callbackArg) {
1797 // see: https://prototype.lighthouseapp.com/projects/8886/tickets/129-ie-mangles-http-response-status-code-204-to-1223
1798 isBrokenStatus = conn.status == 1223;
1801 headerStr = o.conn.getAllResponseHeaders();
1802 Ext.each(headerStr.replace(/\r\n/g, '\n').split('\n'), function(v){
1805 s = v.substr(0, t).toLowerCase();
1806 if(v.charAt(t + 1) == ' '){
1809 headerObj[s] = v.substr(t + 1);
1816 // Normalize the status and statusText when IE returns 1223, see the above link.
1817 status : isBrokenStatus ? 204 : conn.status,
1818 statusText : isBrokenStatus ? 'No Content' : conn.statusText,
1819 getResponseHeader : function(header){return headerObj[header.toLowerCase()];},
1820 getAllResponseHeaders : function(){return headerStr;},
1821 responseText : conn.responseText,
1822 responseXML : conn.responseXML,
1823 argument : callbackArg
1828 function releaseObject(o) {
1830 pub.conn[o.tId] = null;
1837 function handleTransactionResponse(o, callback, isAbort, isTimeout) {
1843 var httpStatus, responseObject;
1846 if (o.conn.status !== undefined && o.conn.status != 0) {
1847 httpStatus = o.conn.status;
1857 if ((httpStatus >= 200 && httpStatus < 300) || (Ext.isIE && httpStatus == 1223)) {
1858 responseObject = createResponseObject(o, callback.argument);
1859 if (callback.success) {
1860 if (!callback.scope) {
1861 callback.success(responseObject);
1864 callback.success.apply(callback.scope, [responseObject]);
1869 switch (httpStatus) {
1876 responseObject = createExceptionObject(o.tId, callback.argument, (isAbort ? isAbort : false), isTimeout);
1877 if (callback.failure) {
1878 if (!callback.scope) {
1879 callback.failure(responseObject);
1882 callback.failure.apply(callback.scope, [responseObject]);
1887 responseObject = createResponseObject(o, callback.argument);
1888 if (callback.failure) {
1889 if (!callback.scope) {
1890 callback.failure(responseObject);
1893 callback.failure.apply(callback.scope, [responseObject]);
1900 responseObject = null;
1903 function checkResponse(o, callback, conn, tId, poll, cbTimeout){
1904 if (conn && conn.readyState == 4) {
1905 clearInterval(poll[tId]);
1909 clearTimeout(pub.timeout[tId]);
1910 pub.timeout[tId] = null;
1912 handleTransactionResponse(o, callback);
1916 function checkTimeout(o, callback){
1917 pub.abort(o, callback, true);
1922 function handleReadyState(o, callback){
1923 callback = callback || {};
1927 cbTimeout = callback.timeout || null;
1930 pub.conn[tId] = conn;
1931 pub.timeout[tId] = setTimeout(checkTimeout.createCallback(o, callback), cbTimeout);
1933 poll[tId] = setInterval(checkResponse.createCallback(o, callback, conn, tId, poll, cbTimeout), pub.pollInterval);
1937 function asyncRequest(method, uri, callback, postData) {
1938 var o = getConnectionObject() || null;
1941 o.conn.open(method, uri, true);
1943 if (pub.useDefaultXhrHeader) {
1944 initHeader('X-Requested-With', pub.defaultXhrHeader);
1947 if(postData && pub.useDefaultHeader && (!pub.headers || !pub.headers[CONTENTTYPE])){
1948 initHeader(CONTENTTYPE, pub.defaultPostHeader);
1951 if (pub.defaultHeaders || pub.headers) {
1955 handleReadyState(o, callback);
1956 o.conn.send(postData || null);
1962 function getConnectionObject() {
1966 if (o = createXhrObject(pub.transactionId)) {
1967 pub.transactionId++;
1976 function createXhrObject(transactionId) {
1980 http = new XMLHttpRequest();
1982 for (var i = 0; i < activeX.length; ++i) {
1984 http = new ActiveXObject(activeX[i]);
1989 return {conn : http, tId : transactionId};
1994 request : function(method, uri, cb, data, options) {
1997 xmlData = options.xmlData,
1998 jsonData = options.jsonData,
2001 Ext.applyIf(me, options);
2003 if(xmlData || jsonData){
2005 if(!hs || !hs[CONTENTTYPE]){
2006 initHeader(CONTENTTYPE, xmlData ? 'text/xml' : 'application/json');
2008 data = xmlData || (!Ext.isPrimitive(jsonData) ? Ext.encode(jsonData) : jsonData);
2011 return asyncRequest(method || options.method || "POST", uri, cb, data);
2014 serializeForm : function(form) {
2015 var fElements = form.elements || (document.forms[form] || Ext.getDom(form)).elements,
2017 encoder = encodeURIComponent,
2023 Ext.each(fElements, function(element){
2024 name = element.name;
2025 type = element.type;
2027 if (!element.disabled && name) {
2028 if (/select-(one|multiple)/i.test(type)) {
2029 Ext.each(element.options, function(opt){
2031 hasValue = opt.hasAttribute ? opt.hasAttribute('value') : opt.getAttributeNode('value').specified;
2032 data += String.format("{0}={1}&", encoder(name), encoder(hasValue ? opt.value : opt.text));
2035 } else if (!(/file|undefined|reset|button/i.test(type))) {
2036 if (!(/radio|checkbox/i.test(type) && !element.checked) && !(type == 'submit' && hasSubmit)) {
2037 data += encoder(name) + '=' + encoder(element.value) + '&';
2038 hasSubmit = /submit/i.test(type);
2043 return data.substr(0, data.length - 1);
2046 useDefaultHeader : true,
2047 defaultPostHeader : 'application/x-www-form-urlencoded; charset=UTF-8',
2048 useDefaultXhrHeader : true,
2049 defaultXhrHeader : 'XMLHttpRequest',
2056 // This is never called - Is it worth exposing this?
2057 // setProgId : function(id) {
2058 // activeX.unshift(id);
2061 // This is never called - Is it worth exposing this?
2062 // setDefaultPostHeader : function(b) {
2063 // this.useDefaultHeader = b;
2066 // This is never called - Is it worth exposing this?
2067 // setDefaultXhrHeader : function(b) {
2068 // this.useDefaultXhrHeader = b;
2071 // This is never called - Is it worth exposing this?
2072 // setPollingInterval : function(i) {
2073 // if (typeof i == 'number' && isFinite(i)) {
2074 // this.pollInterval = i;
2078 // This is never called - Is it worth exposing this?
2079 // resetDefaultHeaders : function() {
2080 // this.defaultHeaders = null;
2083 abort : function(o, callback, isTimeout) {
2088 if (me.isCallInProgress(o)) {
2090 clearInterval(me.poll[tId]);
2091 me.poll[tId] = null;
2092 clearTimeout(pub.timeout[tId]);
2093 me.timeout[tId] = null;
2095 handleTransactionResponse(o, callback, (isAbort = true), isTimeout);
2100 isCallInProgress : function(o) {
2101 // if there is a connection and readyState is not 0 or 4
2102 return o.conn && !{0:true,4:true}[o.conn.readyState];
2107 var EXTLIB = Ext.lib,
2108 noNegatives = /width|height|opacity|padding/i,
2109 offsetAttribute = /^((width|height)|(top|left))$/,
2110 defaultUnit = /width|height|top$|bottom$|left$|right$/i,
2111 offsetUnit = /\d+(em|%|en|ex|pt|in|cm|mm|pc)$/i,
2112 isset = function(v){
2113 return typeof v !== 'undefined';
2120 motion : function(el, args, duration, easing, cb, scope) {
2121 return this.run(el, args, duration, easing, cb, scope, Ext.lib.Motion);
2124 run : function(el, args, duration, easing, cb, scope, type) {
2125 type = type || Ext.lib.AnimBase;
2126 if (typeof easing == "string") {
2127 easing = Ext.lib.Easing[easing];
2129 var anim = new type(el, args, duration, easing);
2130 anim.animateX(function() {
2131 if(Ext.isFunction(cb)){
2139 EXTLIB.AnimBase = function(el, attributes, duration, method) {
2141 this.init(el, attributes, duration, method);
2145 EXTLIB.AnimBase.prototype = {
2146 doMethod: function(attr, start, end) {
2148 return me.method(me.curFrame, start, end - start, me.totalFrames);
2152 setAttr: function(attr, val, unit) {
2153 if (noNegatives.test(attr) && val < 0) {
2156 Ext.fly(this.el, '_anim').setStyle(attr, val + unit);
2160 getAttr: function(attr) {
2161 var el = Ext.fly(this.el),
2162 val = el.getStyle(attr),
2163 a = offsetAttribute.exec(attr) || [];
2165 if (val !== 'auto' && !offsetUnit.test(val)) {
2166 return parseFloat(val);
2169 return (!!(a[2]) || (el.getStyle('position') == 'absolute' && !!(a[3]))) ? el.dom['offset' + a[0].charAt(0).toUpperCase() + a[0].substr(1)] : 0;
2173 getDefaultUnit: function(attr) {
2174 return defaultUnit.test(attr) ? 'px' : '';
2177 animateX : function(callback, scope) {
2180 me.onComplete.removeListener(f);
2181 if (Ext.isFunction(callback)) {
2182 callback.call(scope || me, me);
2185 me.onComplete.addListener(f, me);
2190 setRunAttr: function(attr) {
2192 a = this.attributes[attr],
2197 ra = (this.runAttrs[attr] = {}),
2200 if (!isset(to) && !isset(by)){
2204 var start = isset(from) ? from : me.getAttr(attr);
2207 }else if(isset(by)) {
2208 if (Ext.isArray(start)){
2210 for(var i=0,len=start.length; i<len; i++) {
2211 end[i] = start[i] + by[i];
2221 unit: isset(unit) ? unit : me.getDefaultUnit(attr)
2226 init: function(el, attributes, duration, method) {
2229 mgr = EXTLIB.AnimMgr;
2235 attributes: attributes || {},
2236 duration: duration || 1,
2237 method: method || EXTLIB.Easing.easeNone,
2240 totalFrames: mgr.fps,
2242 animate: function(){
2251 me.totalFrames = me.useSec ? Math.ceil(mgr.fps * d) : d;
2252 mgr.registerElement(me);
2255 stop: function(finish){
2259 me.curFrame = me.totalFrames;
2266 var onStart = function(){
2272 for(attr in this.attributes){
2273 this.setRunAttr(attr);
2276 me.isAnimated = true;
2277 me.startTime = now();
2282 var onTween = function(){
2286 duration: now() - me.startTime,
2287 curFrame: me.curFrame
2290 var ra = me.runAttrs;
2291 for (var attr in ra) {
2292 this.setAttr(attr, me.doMethod(attr, ra[attr].start, ra[attr].end), ra[attr].unit);
2298 var onComplete = function() {
2300 actual = (now() - me.startTime) / 1000,
2303 frames: actualFrames,
2304 fps: actualFrames / actual
2307 me.isAnimated = false;
2309 me.onComplete.fire(data);
2312 me.onStart = new Ext.util.Event(me);
2313 me.onTween = new Ext.util.Event(me);
2314 me.onComplete = new Ext.util.Event(me);
2315 (me._onStart = new Ext.util.Event(me)).addListener(onStart);
2316 (me._onTween = new Ext.util.Event(me)).addListener(onTween);
2317 (me._onComplete = new Ext.util.Event(me)).addListener(onComplete);
2322 Ext.lib.AnimMgr = new function() {
2332 registerElement: function(tween){
2335 tween._onStart.fire();
2339 unRegister: function(tween, index){
2340 tween._onComplete.fire();
2341 index = index || getIndex(tween);
2343 queue.splice(index, 1);
2346 if (--tweenCount <= 0) {
2352 if(thread === null){
2353 thread = setInterval(me.run, me.delay);
2357 stop: function(tween){
2359 clearInterval(thread);
2360 for(var i = 0, len = queue.length; i < len; ++i){
2361 if(queue[0].isAnimated){
2362 me.unRegister(queue[0], 0);
2370 me.unRegister(tween);
2375 var tf, i, len, tween;
2376 for(i = 0, len = queue.length; i<len; i++) {
2378 if(tween && tween.isAnimated){
2379 tf = tween.totalFrames;
2380 if(tween.curFrame < tf || tf === null){
2383 correctFrame(tween);
2385 tween._onTween.fire();
2394 var getIndex = function(anim) {
2396 for(i = 0, len = queue.length; i<len; i++) {
2397 if(queue[i] === anim) {
2404 var correctFrame = function(tween) {
2405 var frames = tween.totalFrames,
2406 frame = tween.curFrame,
2407 duration = tween.duration,
2408 expected = (frame * duration * 1000 / frames),
2409 elapsed = (now() - tween.startTime),
2412 if(elapsed < duration * 1000){
2413 tweak = Math.round((elapsed / expected - 1) * frame);
2415 tweak = frames - (frame + 1);
2417 if(tweak > 0 && isFinite(tweak)){
2418 if(tween.curFrame + tweak >= frames){
2419 tweak = frames - (frame + 1);
2421 tween.curFrame += tweak;
2426 EXTLIB.Bezier = new function() {
2428 this.getPosition = function(points, t) {
2429 var n = points.length,
2435 for (i = 0; i < n; ++i) {
2436 tmp[i] = [points[i][0], points[i][1]];
2439 for (j = 1; j < n; ++j) {
2440 for (i = 0; i < n - j; ++i) {
2441 tmp[i][0] = c * tmp[i][0] + t * tmp[parseInt(i + 1, 10)][0];
2442 tmp[i][1] = c * tmp[i][1] + t * tmp[parseInt(i + 1, 10)][1];
2446 return [ tmp[0][0], tmp[0][1] ];
2453 easeNone: function (t, b, c, d) {
2454 return c * t / d + b;
2458 easeIn: function (t, b, c, d) {
2459 return c * (t /= d) * t + b;
2463 easeOut: function (t, b, c, d) {
2464 return -c * (t /= d) * (t - 2) + b;
2469 EXTLIB.Motion = function(el, attributes, duration, method) {
2471 EXTLIB.Motion.superclass.constructor.call(this, el, attributes, duration, method);
2475 Ext.extend(EXTLIB.Motion, Ext.lib.AnimBase);
2477 var superclass = EXTLIB.Motion.superclass,
2478 pointsRe = /^points$/i;
2480 Ext.apply(EXTLIB.Motion.prototype, {
2481 setAttr: function(attr, val, unit){
2483 setAttr = superclass.setAttr;
2485 if (pointsRe.test(attr)) {
2486 unit = unit || 'px';
2487 setAttr.call(me, 'left', val[0], unit);
2488 setAttr.call(me, 'top', val[1], unit);
2490 setAttr.call(me, attr, val, unit);
2494 getAttr: function(attr){
2496 getAttr = superclass.getAttr;
2498 return pointsRe.test(attr) ? [getAttr.call(me, 'left'), getAttr.call(me, 'top')] : getAttr.call(me, attr);
2501 doMethod: function(attr, start, end){
2504 return pointsRe.test(attr)
2505 ? EXTLIB.Bezier.getPosition(me.runAttrs[attr], me.method(me.curFrame, 0, 100, me.totalFrames) / 100)
2506 : superclass.doMethod.call(me, attr, start, end);
2509 setRunAttr: function(attr){
2510 if(pointsRe.test(attr)){
2514 points = this.attributes.points,
2515 control = points.control || [],
2527 if(control.length > 0 && !Ext.isArray(control[0])){
2528 control = [control];
2532 for (i = 0,len = control.length; i < len; ++i) {
2533 tmp[i] = control[i];
2539 Ext.fly(el, '_anim').position();
2540 DOM.setXY(el, isset(from) ? from : DOM.getXY(el));
2541 start = me.getAttr('points');
2545 end = translateValues.call(me, to, start);
2546 for (i = 0,len = control.length; i < len; ++i) {
2547 control[i] = translateValues.call(me, control[i], start);
2549 } else if (isset(by)) {
2550 end = [start[0] + by[0], start[1] + by[1]];
2552 for (i = 0,len = control.length; i < len; ++i) {
2553 control[i] = [ start[0] + control[i][0], start[1] + control[i][1] ];
2557 ra = this.runAttrs[attr] = [start];
2558 if (control.length > 0) {
2559 ra = ra.concat(control);
2562 ra[ra.length] = end;
2564 superclass.setRunAttr.call(this, attr);
2569 var translateValues = function(val, start) {
2570 var pageXY = EXTLIB.Dom.getXY(this.el);
2571 return [val[0] - pageXY[0] + start[0], val[1] - pageXY[1] + start[1]];
2574 })();// Easing functions
2576 // shortcuts to aid compression
2584 Ext.apply(EXTLIB.Easing, {
2586 easeBoth: function (t, b, c, d) {
2587 return ((t /= d / 2) < 1) ? c / 2 * t * t + b : -c / 2 * ((--t) * (t - 2) - 1) + b;
2590 easeInStrong: function (t, b, c, d) {
2591 return c * (t /= d) * t * t * t + b;
2594 easeOutStrong: function (t, b, c, d) {
2595 return -c * ((t = t / d - 1) * t * t * t - 1) + b;
2598 easeBothStrong: function (t, b, c, d) {
2599 return ((t /= d / 2) < 1) ? c / 2 * t * t * t * t + b : -c / 2 * ((t -= 2) * t * t * t - 2) + b;
2602 elasticIn: function (t, b, c, d, a, p) {
2603 if (t == 0 || (t /= d) == 1) {
2604 return t == 0 ? b : b + c;
2610 s = p / (2 * pi) * asin(c / a);
2616 return -(a * pow(2, 10 * (t -= 1)) * sin((t * d - s) * (2 * pi) / p)) + b;
2620 elasticOut: function (t, b, c, d, a, p) {
2621 if (t == 0 || (t /= d) == 1) {
2622 return t == 0 ? b : b + c;
2628 s = p / (2 * pi) * asin(c / a);
2634 return a * pow(2, -10 * t) * sin((t * d - s) * (2 * pi) / p) + c + b;
2637 elasticBoth: function (t, b, c, d, a, p) {
2638 if (t == 0 || (t /= d / 2) == 2) {
2639 return t == 0 ? b : b + c;
2642 p = p || (d * (.3 * 1.5));
2646 s = p / (2 * pi) * asin(c / a);
2653 -.5 * (a * pow(2, 10 * (t -= 1)) * sin((t * d - s) * (2 * pi) / p)) + b :
2654 a * pow(2, -10 * (t -= 1)) * sin((t * d - s) * (2 * pi) / p) * .5 + c + b;
2657 backIn: function (t, b, c, d, s) {
2659 return c * (t /= d) * t * ((s + 1) * t - s) + b;
2663 backOut: function (t, b, c, d, s) {
2667 return c * ((t = t / d - 1) * t * ((s + 1) * t + s) + 1) + b;
2671 backBoth: function (t, b, c, d, s) {
2674 return ((t /= d / 2 ) < 1) ?
2675 c / 2 * (t * t * (((s *= (1.525)) + 1) * t - s)) + b :
2676 c / 2 * ((t -= 2) * t * (((s *= (1.525)) + 1) * t + s) + 2) + b;
2680 bounceIn: function (t, b, c, d) {
2681 return c - EXTLIB.Easing.bounceOut(d - t, 0, c, d) + b;
2685 bounceOut: function (t, b, c, d) {
2686 if ((t /= d) < (1 / 2.75)) {
2687 return c * (7.5625 * t * t) + b;
2688 } else if (t < (2 / 2.75)) {
2689 return c * (7.5625 * (t -= (1.5 / 2.75)) * t + .75) + b;
2690 } else if (t < (2.5 / 2.75)) {
2691 return c * (7.5625 * (t -= (2.25 / 2.75)) * t + .9375) + b;
2693 return c * (7.5625 * (t -= (2.625 / 2.75)) * t + .984375) + b;
2697 bounceBoth: function (t, b, c, d) {
2698 return (t < d / 2) ?
2699 EXTLIB.Easing.bounceIn(t * 2, 0, c, d) * .5 + b :
2700 EXTLIB.Easing.bounceOut(t * 2 - d, 0, c, d) * .5 + c * .5 + b;
2706 var EXTLIB = Ext.lib;
2708 EXTLIB.Anim.color = function(el, args, duration, easing, cb, scope) {
2709 return EXTLIB.Anim.run(el, args, duration, easing, cb, scope, EXTLIB.ColorAnim);
2712 EXTLIB.ColorAnim = function(el, attributes, duration, method) {
2713 EXTLIB.ColorAnim.superclass.constructor.call(this, el, attributes, duration, method);
2716 Ext.extend(EXTLIB.ColorAnim, EXTLIB.AnimBase);
2718 var superclass = EXTLIB.ColorAnim.superclass,
2719 colorRE = /color$/i,
2720 transparentRE = /^transparent|rgba\(0, 0, 0, 0\)$/,
2721 rgbRE = /^rgb\(([0-9]+)\s*,\s*([0-9]+)\s*,\s*([0-9]+)\)$/i,
2722 hexRE= /^#?([0-9A-F]{2})([0-9A-F]{2})([0-9A-F]{2})$/i,
2723 hex3RE = /^#?([0-9A-F]{1})([0-9A-F]{1})([0-9A-F]{1})$/i,
2724 isset = function(v){
2725 return typeof v !== 'undefined';
2729 function parseColor(s) {
2735 if (s.length == 3) {
2739 Ext.each([hexRE, rgbRE, hex3RE], function(re, idx){
2740 base = (idx % 2 == 0) ? 16 : 10;
2742 if(c && c.length == 4){
2743 out = [pi(c[1], base), pi(c[2], base), pi(c[3], base)];
2750 Ext.apply(EXTLIB.ColorAnim.prototype, {
2751 getAttr : function(attr) {
2755 if(colorRE.test(attr)){
2756 while(el && transparentRE.test(val = Ext.fly(el).getStyle(attr))){
2761 val = superclass.getAttr.call(me, attr);
2766 doMethod : function(attr, start, end) {
2774 if(colorRE.test(attr)){
2778 for(i = 0, len = start.length; i < len; i++) {
2780 val[i] = superclass.doMethod.call(me, attr, v, end[i]);
2782 val = 'rgb(' + floor(val[0]) + ',' + floor(val[1]) + ',' + floor(val[2]) + ')';
2784 val = superclass.doMethod.call(me, attr, start, end);
2789 setRunAttr : function(attr) {
2791 a = me.attributes[attr],
2796 superclass.setRunAttr.call(me, attr);
2797 ra = me.runAttrs[attr];
2798 if(colorRE.test(attr)){
2799 var start = parseColor(ra.start),
2800 end = parseColor(ra.end);
2802 if(!isset(to) && isset(by)){
2803 end = parseColor(by);
2804 for(var i=0,len=start.length; i<len; i++) {
2805 end[i] = start[i] + end[i];
2818 var EXTLIB = Ext.lib;
2819 EXTLIB.Anim.scroll = function(el, args, duration, easing, cb, scope) {
2820 return EXTLIB.Anim.run(el, args, duration, easing, cb, scope, EXTLIB.Scroll);
2823 EXTLIB.Scroll = function(el, attributes, duration, method) {
2825 EXTLIB.Scroll.superclass.constructor.call(this, el, attributes, duration, method);
2829 Ext.extend(EXTLIB.Scroll, EXTLIB.ColorAnim);
2831 var superclass = EXTLIB.Scroll.superclass,
2834 Ext.apply(EXTLIB.Scroll.prototype, {
2836 doMethod : function(attr, start, end) {
2839 curFrame = me.curFrame,
2840 totalFrames = me.totalFrames;
2843 val = [me.method(curFrame, start[0], end[0] - start[0], totalFrames),
2844 me.method(curFrame, start[1], end[1] - start[1], totalFrames)];
2846 val = superclass.doMethod.call(me, attr, start, end);
2851 getAttr : function(attr) {
2854 if (attr == SCROLL) {
2855 return [me.el.scrollLeft, me.el.scrollTop];
2857 return superclass.getAttr.call(me, attr);
2861 setAttr : function(attr, val, unit) {
2865 me.el.scrollLeft = val[0];
2866 me.el.scrollTop = val[1];
2868 superclass.setAttr.call(me, attr, val, unit);
2874 function fnCleanUp() {
2875 var p = Function.prototype;
2876 delete p.createSequence;
2878 delete p.createDelegate;
2879 delete p.createCallback;
2880 delete p.createInterceptor;
2882 window.detachEvent("onunload", fnCleanUp);
2884 window.attachEvent("onunload", fnCleanUp);