# Ext.js

    Ext = {};

    // for old browsers
    window["undefined"] = window["undefined"];

    /**
     * @class Ext
     * Ext core utilities and functions.
     * @singleton
     */
    // holder
    /***
     * Copies all the properties of config to obj.
     * @param {Object} obj The receiver of the properties
     * @param {Object} config The source of the properties
     * @param {Object} defaults A different object that will also be applied for default values
     * @return {Object} returns obj
     * @member Ext apply
     */
    Ext.apply = function(o, c, defaults){
        if(defaults){
            // no "this" reference for friendly out of scope calls
            Ext.apply(o, defaults);
        }
        if(o && c && typeof c == 'object'){
            for(var p in c){
                o[p] = c[p];
            }
        }
        return o;
    };

    (function(){
        var idSeed = 0;
        var ua = navigator.userAgent.toLowerCase();

        var isStrict = document.compatMode == "CSS1Compat",
            isOpera = ua.indexOf("opera") > -1,
            isSafari = (/webkit|khtml/).test(ua),
            isIE = ua.indexOf("msie") > -1,
            isIE7 = ua.indexOf("msie 7") > -1,
            isGecko = !isSafari && ua.indexOf("gecko") > -1,
            isBorderBox = isIE && !isStrict,
            isWindows = (ua.indexOf("windows") != -1 || ua.indexOf("win32") != -1),
            isMac = (ua.indexOf("macintosh") != -1 || ua.indexOf("mac os x") != -1),
            isLinux = (ua.indexOf("linux") != -1),
            isSecure = window.location.href.toLowerCase().indexOf("https") === 0;

        // remove css image flicker
    	if(isIE && !isIE7){
            try{
                document.execCommand("BackgroundImageCache", false, true);
            }catch(e){}
        }

        Ext.apply(Ext, {
            /**
             * True if the browser is in strict mode
             * @type Boolean
             */
            isStrict : isStrict,
            /**
             * True if the page is running over SSL
             * @type Boolean
             */
            isSecure : isSecure,
            /**
             * True when the document is fully initialized and ready for action
             * @type Boolean
             */
            isReady : false,

            /**
             * True to automatically uncache orphaned Ext.Elements periodically (defaults to true)
             * @type Boolean
             */
            enableGarbageCollector : true,

            /**
             * True to automatically purge event listeners after uncaching an element (defaults to false).
             * Note: this only happens if enableGarbageCollector is true.
             * @type Boolean
             */
            enableListenerCollection:false,

            /**
             * URL to a blank file used by Ext when in secure mode for iframe src and onReady src to prevent
             * the IE insecure content warning (defaults to javascript:false).
             * @type String
             */
            SSL_SECURE_URL : "javascript:false",

            /**
             * URL to a 1x1 transparent gif image used by Ext to create inline icons with CSS background images. (Defaults to
             * "http://extjs.com/s.gif" and you should change this to a URL on your server).
             * @type String
             */
            BLANK_IMAGE_URL : "http:/"+"/extjs.com/s.gif",

            emptyFn : function(){},

            /**
             * Copies all the properties of config to obj if they don't already exist.
             * @param {Object} obj The receiver of the properties
             * @param {Object} config The source of the properties
             * @return {Object} returns obj
             */
            applyIf : function(o, c){
                if(o && c){
                    for(var p in c){
                        if(typeof o[p] == "undefined"){ o[p] = c[p]; }
                    }
                }
                return o;
            },

            /**
             * Applies event listeners to elements by selectors when the document is ready.
             * The event name is specified with an @ suffix.
    <pre><code>
    Ext.addBehaviors({
       // add a listener for click on all anchors in element with id foo
       '#foo a@click' : function(e, t){
           // do something
       },

       // add the same listener to multiple selectors (separated by comma BEFORE the @)
       '#foo a, #bar span.some-class@mouseover' : function(){
           // do something
       }
    });
    </code></pre>
             * @param {Object} obj The list of behaviors to apply
             */
            addBehaviors : function(o){
                if(!Ext.isReady){
                    Ext.onReady(function(){
                        Ext.addBehaviors(o);
                    });
                    return;
                }
                var cache = {}; // simple cache for applying multiple behaviors to same selector does query multiple times
                for(var b in o){
                    var parts = b.split('@');
                    if(parts[1]){ // for Object prototype breakers
                        var s = parts[0];
                        if(!cache[s]){
                            cache[s] = Ext.select(s);
                        }
                        cache[s].on(parts[1], o[b]);
                    }
                }
                cache = null;
            },

            /**
             * Generates unique ids. If the element already has an id, it is unchanged
             * @param {String/HTMLElement/Element} el (optional) The element to generate an id for
             * @param {String} prefix (optional) Id prefix (defaults "ext-gen")
             * @return {String} The generated Id.
             */
            id : function(el, prefix){
                prefix = prefix || "ext-gen";
                el = Ext.getDom(el);
                var id = prefix + (++idSeed);
                return el ? (el.id ? el.id : (el.id = id)) : id;
            },

            /**
             * Extends one class with another class and optionally overrides members with the passed literal. This class
             * also adds the function "override()" to the class that can be used to override
             * members on an instance.
             * @param {Object} subclass The class inheriting the functionality
             * @param {Object} superclass The class being extended
             * @param {Object} overrides (optional) A literal with members
             * @method extend
             */
            extend : function(){
                // inline overrides
                var io = function(o){
                    for(var m in o){
                        this[m] = o[m];
                    }
                };
                return function(sb, sp, overrides){
                    if(typeof sp == 'object'){
                        overrides = sp;
                        sp = sb;
                        sb = function(){sp.apply(this, arguments);};
                    }
                    var F = function(){}, sbp, spp = sp.prototype;
                    F.prototype = spp;
                    sbp = sb.prototype = new F();
                    sbp.constructor=sb;
                    sb.superclass=spp;
                    if(spp.constructor == Object.prototype.constructor){
                        spp.constructor=sp;
                    }
                    sb.override = function(o){
                        Ext.override(sb, o);
                    };
                    sbp.override = io;
                    Ext.override(sb, overrides);
                    return sb;
                };
            }(),

            /**
             * Adds a list of functions to the prototype of an existing class, overwriting any existing methods with the same name.
             * Usage:<pre><code>
    Ext.override(MyClass, {
        newMethod1: function(){
            // etc.
        },
        newMethod2: function(foo){
            // etc.
        }
    });
     </code></pre>
             * @param {Object} origclass The class to override
             * @param {Object} overrides The list of functions to add to origClass.  This should be specified as an object literal
             * containing one or more methods.
             * @method override
             */
            override : function(origclass, overrides){
                if(overrides){
                    var p = origclass.prototype;
                    for(var method in overrides){
                        p[method] = overrides[method];
                    }
                }
            },
            /**
             * Creates namespaces but does not assume YAHOO is the root.
             * @param {String} namespace1
             * @param {String} namespace2
             * @param {String} etc
             * @method namespace
             */
            namespace : function(){
                var a=arguments, o=null, i, j, d, rt;
                for (i=0; i<a.length; ++i) {
                    d=a[i].split(".");
                    rt = d[0];
                    eval('if (typeof ' + rt + ' == "undefined"){' + rt + ' = {};} o = ' + rt + ';');
                    for (j=1; j<d.length; ++j) {
                        o[d[j]]=o[d[j]] || {};
                        o=o[d[j]];
                    }
                }
            },

            /**
             * 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.
             * @param {Object} o
             * @return {String}
             */
            urlEncode : function(o){
                if(!o){
                    return "";
                }
                var buf = [];
                for(var key in o){
                    var ov = o[key];
                    var type = typeof ov;
                    if(type == 'undefined'){
                        buf.push(encodeURIComponent(key), "=&");
                    }else if(type != "function" && type != "object"){
                        buf.push(encodeURIComponent(key), "=", encodeURIComponent(ov), "&");
                    }else if(ov instanceof Array){
                        for(var i = 0, len = ov.length; i < len; i++) {
                            buf.push(encodeURIComponent(key), "=", encodeURIComponent(ov[i] === undefined ? '' : ov[i]), "&");
                        }
                    }
                }
                buf.pop();
                return buf.join("");
            },

            /**
             * Takes an encoded URL and and converts it to an object. e.g. Ext.urlDecode("foo=1&bar=2"); would return {foo: 1, bar: 2} or Ext.urlDecode("foo=1&bar=2&bar=3&bar=4", true); would return {foo: 1, bar: [2, 3, 4]}.
             * @param {String} string
             * @param {Boolean} overwrite (optional) Items of the same name will overwrite previous values instead of creating an an array (Defaults to false).
             * @return {Object} A literal with members
             */
            urlDecode : function(string, overwrite){
                if(!string || !string.length){
                    return {};
                }
                var obj = {};
                var pairs = string.split('&');
                var pair, name, value;
                for(var i = 0, len = pairs.length; i < len; i++){
                    pair = pairs[i].split('=');
                    name = decodeURIComponent(pair[0]);
                    value = decodeURIComponent(pair[1]);
                    if(overwrite !== true){
                        if(typeof obj[name] == "undefined"){
                            obj[name] = value;
                        }else if(typeof obj[name] == "string"){
                            obj[name] = [obj[name]];
                            obj[name].push(value);
                        }else{
                            obj[name].push(value);
                        }
                    }else{
                        obj[name] = value;
                    }
                }
                return obj;
            },

            /**
             * Iterates an array calling the passed function with each item, stopping if your function returns false. If the
             * passed array is not really an array, your function is called once with it.
             * The supplied function is called with (Object item, Number index, Array allItems).
             * @param {Array/NodeList/Mixed} array
             * @param {Function} fn
             * @param {Object} scope
             */
            each : function(array, fn, scope){
                if(typeof array.length == "undefined" || typeof array == "string"){
                    array = [array];
                }
                for(var i = 0, len = array.length; i < len; i++){
                    if(fn.call(scope || array[i], array[i], i, array) === false){ return i; };
                }
            },

            // deprecated
            combine : function(){
                var as = arguments, l = as.length, r = [];
                for(var i = 0; i < l; i++){
                    var a = as[i];
                    if(a instanceof Array){
                        r = r.concat(a);
                    }else if(a.length !== undefined && !a.substr){
                        r = r.concat(Array.prototype.slice.call(a, 0));
                    }else{
                        r.push(a);
                    }
                }
                return r;
            },

            /**
             * Escapes the passed string for use in a regular expression
             * @param {String} str
             * @return {String}
             */
            escapeRe : function(s) {
                return s.replace(/([.*+?^${}()|[\]\/\\])/g, "\\$1");
            },

            // internal
            callback : function(cb, scope, args, delay){
                if(typeof cb == "function"){
                    if(delay){
                        cb.defer(delay, scope, args || []);
                    }else{
                        cb.apply(scope, args || []);
                    }
                }
            },

            /**
             * Return the dom node for the passed string (id), dom node, or Ext.Element
             * @param {String/HTMLElement/Ext.Element} el
             * @return HTMLElement
             */
            getDom : function(el){
                if(!el){
                    return null;
                }
                return el.dom ? el.dom : (typeof el == 'string' ? document.getElementById(el) : el);
            },

            /**
            * Shorthand for {@link Ext.ComponentMgr#get}
            * @param {String} id
            * @return Ext.Component
            */
            getCmp : function(id){
                return Ext.ComponentMgr.get(id);
            },

            num : function(v, defaultValue){
                if(typeof v != 'number'){
                    return defaultValue;
                }
                return v;
            },

            destroy : function(){
                for(var i = 0, a = arguments, len = a.length; i < len; i++) {
                    var as = a[i];
                    if(as){
                        if(as.dom){
                            as.removeAllListeners();
                            as.remove();
                            continue;
                        }
                        if(typeof as.purgeListeners == 'function'){
                            as.purgeListeners();
                        }
                        if(typeof as.destroy == 'function'){
                            as.destroy();
                        }
                    }
                }
            },

            // inpired by a similar function in mootools library
            /**
             * Returns the type of object that is passed in. If the object passed in is null or undefined it
             * return false otherwise it returns one of the following values:<ul>
             * <li><b>string</b>: If the object passed is a string</li>
             * <li><b>number</b>: If the object passed is a number</li>
             * <li><b>boolean</b>: If the object passed is a boolean value</li>
             * <li><b>function</b>: If the object passed is a function reference</li>
             * <li><b>object</b>: If the object passed is an object</li>
             * <li><b>array</b>: If the object passed is an array</li>
             * <li><b>regexp</b>: If the object passed is a regular expression</li>
             * <li><b>element</b>: If the object passed is a DOM Element</li>
             * <li><b>nodelist</b>: If the object passed is a DOM NodeList</li>
             * <li><b>textnode</b>: If the object passed is a DOM text node and contains something other than whitespace</li>
             * <li><b>whitespace</b>: If the object passed is a DOM text node and contains only whitespace</li>
             * @param {Mixed} object
             * @return {String}
             */
            type : function(o){
                if(o === undefined || o === null){
                    return false;
                }
                if(o.htmlElement){
                    return 'element';
                }
                var t = typeof o;
                if(t == 'object' && o.nodeName) {
                    switch(o.nodeType) {
                        case 1: return 'element';
                        case 3: return (/\S/).test(o.nodeValue) ? 'textnode' : 'whitespace';
                    }
                }
                if(t == 'object' || t == 'function') {
                    switch(o.constructor) {
                        case Array: return 'array';
                        case RegExp: return 'regexp';
                    }
                    if(typeof o.length == 'number' && typeof o.item == 'function') {
                        return 'nodelist';
                    }
                }
                return t;
            },

            /**
             * Returns true if the passed value is null, undefined or an empty string (optional).
             * @param {Mixed} value The value to test
             * @param {Boolean} allowBlank (optional) Pass true if an empty string is not considered empty
             * @return {Boolean}
             */
            isEmpty : function(v, allowBlank){
                return v === null || v === undefined || (!allowBlank ? v === '' : false);
            },

            /** @type Boolean */
            isOpera : isOpera,
            /** @type Boolean */
            isSafari : isSafari,
            /** @type Boolean */
            isIE : isIE,
            /** @type Boolean */
            isIE7 : isIE7,
            /** @type Boolean */
            isGecko : isGecko,
            /** @type Boolean */
            isBorderBox : isBorderBox,
            /** @type Boolean */
            isWindows : isWindows,
            /** @type Boolean */
            isLinux : isLinux,
            /** @type Boolean */
            isMac : isMac,

        /**
         By default, Ext intelligently decides whether floating elements should be shimmed. If you are using flash,
         you may want to set this to true.
         @type Boolean
         */
            useShims : ((isIE && !isIE7) || (isGecko && isMac))
        });

    })();

    Ext.namespace("Ext", "Ext.util", "Ext.grid", "Ext.dd", "Ext.tree", "Ext.data",
                    "Ext.form", "Ext.menu", "Ext.state", "Ext.lib", "Ext.layout", "Ext.app", "Ext.ux");

    /**
     * @class Function
     * These functions are available on every Function object (any JavaScript function).
     */
    Ext.apply(Function.prototype, {
         /**
         * Creates a callback that passes arguments[0], arguments[1], arguments[2], ...
         * Call directly on any function. Example: <code>myFunction.createCallback(myarg, myarg2)</code>
         * Will create a function that is bound to those 2 args.
         * @return {Function} The new function
        */
        createCallback : function(/*args...*/){
            // make args available, in function below
            var args = arguments;
            var method = this;
            return function() {
                return method.apply(window, args);
            };
        },

        /**
         * Creates a delegate (callback) that sets the scope to obj.
         * Call directly on any function. Example: <code>this.myFunction.createDelegate(this)</code>
         * Will create a function that is automatically scoped to this.
         * @param {Object} obj (optional) The object for which the scope is set
         * @param {Array} args (optional) Overrides arguments for the call. (Defaults to the arguments passed by the caller)
         * @param {Boolean/Number} appendArgs (optional) if True args are appended to call args instead of overriding,
         *                                             if a number the args are inserted at the specified position
         * @return {Function} The new function
         */
        createDelegate : function(obj, args, appendArgs){
            var method = this;
            return function() {
                var callArgs = args || arguments;
                if(appendArgs === true){
                    callArgs = Array.prototype.slice.call(arguments, 0);
                    callArgs = callArgs.concat(args);
                }else if(typeof appendArgs == "number"){
                    callArgs = Array.prototype.slice.call(arguments, 0); // copy arguments first
                    var applyArgs = [appendArgs, 0].concat(args); // create method call params
                    Array.prototype.splice.apply(callArgs, applyArgs); // splice them in
                }
                return method.apply(obj || window, callArgs);
            };
        },

        /**
         * Calls this function after the number of millseconds specified.
         * @param {Number} millis The number of milliseconds for the setTimeout call (if 0 the function is executed immediately)
         * @param {Object} obj (optional) The object for which the scope is set
         * @param {Array} args (optional) Overrides arguments for the call. (Defaults to the arguments passed by the caller)
         * @param {Boolean/Number} appendArgs (optional) if True args are appended to call args instead of overriding,
         *                                             if a number the args are inserted at the specified position
         * @return {Number} The timeout id that can be used with clearTimeout
         */
        defer : function(millis, obj, args, appendArgs){
            var fn = this.createDelegate(obj, args, appendArgs);
            if(millis){
                return setTimeout(fn, millis);
            }
            fn();
            return 0;
        },
        /**
         * Create a combined function call sequence of the original function + the passed function.
         * The resulting function returns the results of the original function.
         * The passed fcn is called with the parameters of the original function
         * @param {Function} fcn The function to sequence
         * @param {Object} scope (optional) The scope of the passed fcn (Defaults to scope of original function or window)
         * @return {Function} The new function
         */
        createSequence : function(fcn, scope){
            if(typeof fcn != "function"){
                return this;
            }
            var method = this;
            return function() {
                var retval = method.apply(this || window, arguments);
                fcn.apply(scope || this || window, arguments);
                return retval;
            };
        },

        /**
         * Creates an interceptor function. The passed fcn is called before the original one. If it returns false, the original one is not called.
         * The resulting function returns the results of the original function.
         * The passed fcn is called with the parameters of the original function.
         * @addon
         * @param {Function} fcn The function to call before the original
         * @param {Object} scope (optional) The scope of the passed fcn (Defaults to scope of original function or window)
         * @return {Function} The new function
         */
        createInterceptor : function(fcn, scope){
            if(typeof fcn != "function"){
                return this;
            }
            var method = this;
            return function() {
                fcn.target = this;
                fcn.method = method;
                if(fcn.apply(scope || this || window, arguments) === false){
                    return;
                }
                return method.apply(this || window, arguments);
            };
        }
    });

    /**
     * @class String
     * These functions are available as static methods on the JavaScript String object.
     */
    Ext.applyIf(String, {

        /**
         * Escapes the passed string for ' and \
         * @param {String} string The string to escape
         * @return {String} The escaped string
         * @static
         */
        escape : function(string) {
            return string.replace(/('|\\)/g, "\\$1");
        },

        /**
         * Pads the left side of a string with a specified character.  This is especially useful
         * for normalizing number and date strings.  Example usage:
         * <pre><code>
    var s = String.leftPad('123', 5, '0');
    // s now contains the string: '00123'
    </code></pre>
         * @param {String} string The original string
         * @param {Number} size The total length of the output string
         * @param {String} char (optional) The character with which to pad the original string (defaults to empty string " ")
         * @return {String} The padded string
         * @static
         */
        leftPad : function (val, size, ch) {
            var result = new String(val);
            if(ch === null || ch === undefined || ch === '') {
                ch = " ";
            }
            while (result.length < size) {
                result = ch + result;
            }
            return result;
        },

        /**
         * Allows you to define a tokenized string and pass an arbitrary number of arguments to replace the tokens.  Each
         * token must be unique, and must increment in the format {0}, {1}, etc.  Example usage:
         * <pre><code>
    var cls = 'my-class', text = 'Some text';
    var s = String.format('<div class="{0}">{1}</div>', cls, text);
    // s now contains the string: '<div class="my-class">Some text</div>'
    </code></pre>
         * @param {String} string The tokenized string to be formatted
         * @param {String} value1 The value to replace token {0}
         * @param {String} value2 Etc...
         * @return {String} The formatted string
         * @static
         */
        format : function(format){
            var args = Array.prototype.slice.call(arguments, 1);
            return format.replace(/\{(\d+)\}/g, function(m, i){
                return args[i];
            });
        }
    });

    /**
     * Utility function that allows you to easily switch a string between two alternating values.  The passed value
     * is compared to the current string, and if they are equal, the other value that was passed in is returned.  If
     * they are already different, the first value passed in is returned.  Note that this method returns the new value
     * but does not change the current string.
     * <pre><code>
    // alternate sort directions
    sort = sort.toggle('ASC', 'DESC');

    // instead of conditional logic:
    sort = (sort == 'ASC' ? 'DESC' : 'ASC');
    </code></pre>
     * @param {String} value The value to compare to the current string
     * @param {String} other The new value to use if the string already equals the first value passed in
     * @return {String} The new value
     */
    String.prototype.toggle = function(value, other){
        return this == value ? other : value;
    };

    Ext.applyIf(Number.prototype, {
        /**
         * Checks whether or not the current number is within a desired range.  If the number is already within the
         * range it is returned, otherwise the min or max value is returned depending on which side of the range is
         * exceeded.  Note that this method returns the constrained value but does not change the current number.
         * @param {Number} min The minimum number in the range
         * @param {Number} max The maximum number in the range
         * @return {Number} The constrained value if outside the range, otherwise the current value
         */
        constrain : function(min, max){
            return Math.min(Math.max(this, min), max);
        }
    });

    Ext.applyIf(Array.prototype, {
        /**
         * Checks whether or not the specified object exists in the array.
         * @param {Object} o The object to check for
         * @return {Number} The index of o in the array (or -1 if it is not found)
         */
        indexOf : function(o){
           for (var i = 0, len = this.length; i < len; i++){
     	      if(this[i] == o) return i;
           }
     	   return -1;
        },

        /**
         * Removes the specified object from the array.  If the object is not found nothing happens.
         * @param {Object} o The object to remove
         */
        remove : function(o){
           var index = this.indexOf(o);
           if(index != -1){
               this.splice(index, 1);
           }
        }
    });

    /**
     Returns the number of milliseconds between this date and date
     @param {Date} date (optional) Defaults to now
     @return {Number} The diff in milliseconds
     @member Date getElapsed
     */
    Date.prototype.getElapsed = function(date) {
    	return Math.abs((date || new Date()).getTime()-this.getTime());
    };

Ext - Copyright © 2006-2007 Ext JS, LLC
All rights reserved.