Ext.js
上传用户:dawnssy
上传日期:2022-08-06
资源大小:9345k
文件大小:36k
源码类别:

JavaScript

开发平台:

JavaScript

  1. /*!
  2.  * Ext JS Library 3.1.0
  3.  * Copyright(c) 2006-2009 Ext JS, LLC
  4.  * licensing@extjs.com
  5.  * http://www.extjs.com/license
  6.  */
  7. // for old browsers
  8. window.undefined = window.undefined;
  9. /**
  10.  * @class Ext
  11.  * Ext core utilities and functions.
  12.  * @singleton
  13.  */
  14. Ext = {
  15.     /**
  16.      * The version of the framework
  17.      * @type String
  18.      */
  19.     version : '3.1.0'
  20. };
  21. /**
  22.  * Copies all the properties of config to obj.
  23.  * @param {Object} obj The receiver of the properties
  24.  * @param {Object} config The source of the properties
  25.  * @param {Object} defaults A different object that will also be applied for default values
  26.  * @return {Object} returns obj
  27.  * @member Ext apply
  28.  */
  29. Ext.apply = function(o, c, defaults){
  30.     // no "this" reference for friendly out of scope calls
  31.     if(defaults){
  32.         Ext.apply(o, defaults);
  33.     }
  34.     if(o && c && typeof c == 'object'){
  35.         for(var p in c){
  36.             o[p] = c[p];
  37.         }
  38.     }
  39.     return o;
  40. };
  41. (function(){
  42.     var idSeed = 0,
  43.         toString = Object.prototype.toString,
  44.         ua = navigator.userAgent.toLowerCase(),
  45.         check = function(r){
  46.             return r.test(ua);
  47.         },
  48.         DOC = document,
  49.         isStrict = DOC.compatMode == "CSS1Compat",
  50.         isOpera = check(/opera/),
  51.         isChrome = check(/chrome/),
  52.         isWebKit = check(/webkit/),
  53.         isSafari = !isChrome && check(/safari/),
  54.         isSafari2 = isSafari && check(/applewebkit/4/), // unique to Safari 2
  55.         isSafari3 = isSafari && check(/version/3/),
  56.         isSafari4 = isSafari && check(/version/4/),
  57.         isIE = !isOpera && check(/msie/),
  58.         isIE7 = isIE && check(/msie 7/),
  59.         isIE8 = isIE && check(/msie 8/),
  60.         isIE6 = isIE && !isIE7 && !isIE8,
  61.         isGecko = !isWebKit && check(/gecko/),
  62.         isGecko2 = isGecko && check(/rv:1.8/),
  63.         isGecko3 = isGecko && check(/rv:1.9/),
  64.         isBorderBox = isIE && !isStrict,
  65.         isWindows = check(/windows|win32/),
  66.         isMac = check(/macintosh|mac os x/),
  67.         isAir = check(/adobeair/),
  68.         isLinux = check(/linux/),
  69.         isSecure = /^https/i.test(window.location.protocol);
  70.     // remove css image flicker
  71.     if(isIE6){
  72.         try{
  73.             DOC.execCommand("BackgroundImageCache", false, true);
  74.         }catch(e){}
  75.     }
  76.     Ext.apply(Ext, {
  77.         /**
  78.          * URL to a blank file used by Ext when in secure mode for iframe src and onReady src to prevent
  79.          * the IE insecure content warning (<tt>'about:blank'</tt>, except for IE in secure mode, which is <tt>'javascript:""'</tt>).
  80.          * @type String
  81.          */
  82.         SSL_SECURE_URL : isSecure && isIE ? 'javascript:""' : 'about:blank',
  83.         /**
  84.          * True if the browser is in strict (standards-compliant) mode, as opposed to quirks mode
  85.          * @type Boolean
  86.          */
  87.         isStrict : isStrict,
  88.         /**
  89.          * True if the page is running over SSL
  90.          * @type Boolean
  91.          */
  92.         isSecure : isSecure,
  93.         /**
  94.          * True when the document is fully initialized and ready for action
  95.          * @type Boolean
  96.          */
  97.         isReady : false,
  98.         /**
  99.          * True if the {@link Ext.Fx} Class is available
  100.          * @type Boolean
  101.          * @property enableFx
  102.          */
  103.         /**
  104.          * True to automatically uncache orphaned Ext.Elements periodically (defaults to true)
  105.          * @type Boolean
  106.          */
  107.         enableGarbageCollector : true,
  108.         /**
  109.          * True to automatically purge event listeners during garbageCollection (defaults to false).
  110.          * @type Boolean
  111.          */
  112.         enableListenerCollection : false,
  113.         /**
  114.          * EXPERIMENTAL - True to cascade listener removal to child elements when an element is removed.
  115.          * Currently not optimized for performance.
  116.          * @type Boolean
  117.          */
  118.         enableNestedListenerRemoval : false,
  119.         /**
  120.          * Indicates whether to use native browser parsing for JSON methods.
  121.          * This option is ignored if the browser does not support native JSON methods.
  122.          * <b>Note: Native JSON methods will not work with objects that have functions.
  123.          * Also, property names must be quoted, otherwise the data will not parse.</b> (Defaults to false)
  124.          * @type Boolean
  125.          */
  126.         USE_NATIVE_JSON : false,
  127.         /**
  128.          * Copies all the properties of config to obj if they don't already exist.
  129.          * @param {Object} obj The receiver of the properties
  130.          * @param {Object} config The source of the properties
  131.          * @return {Object} returns obj
  132.          */
  133.         applyIf : function(o, c){
  134.             if(o){
  135.                 for(var p in c){
  136.                     if(!Ext.isDefined(o[p])){
  137.                         o[p] = c[p];
  138.                     }
  139.                 }
  140.             }
  141.             return o;
  142.         },
  143.         /**
  144.          * Generates unique ids. If the element already has an id, it is unchanged
  145.          * @param {Mixed} el (optional) The element to generate an id for
  146.          * @param {String} prefix (optional) Id prefix (defaults "ext-gen")
  147.          * @return {String} The generated Id.
  148.          */
  149.         id : function(el, prefix){
  150.             return (el = Ext.getDom(el) || {}).id = el.id || (prefix || "ext-gen") + (++idSeed);
  151.         },
  152.         /**
  153.          * <p>Extends one class to create a subclass and optionally overrides members with the passed literal. This method
  154.          * also adds the function "override()" to the subclass that can be used to override members of the class.</p>
  155.          * For example, to create a subclass of Ext GridPanel:
  156.          * <pre><code>
  157. MyGridPanel = Ext.extend(Ext.grid.GridPanel, {
  158.     constructor: function(config) {
  159. //      Create configuration for this Grid.
  160.         var store = new Ext.data.Store({...});
  161.         var colModel = new Ext.grid.ColumnModel({...});
  162. //      Create a new config object containing our computed properties
  163. //      *plus* whatever was in the config parameter.
  164.         config = Ext.apply({
  165.             store: store,
  166.             colModel: colModel
  167.         }, config);
  168.         MyGridPanel.superclass.constructor.call(this, config);
  169. //      Your postprocessing here
  170.     },
  171.     yourMethod: function() {
  172.         // etc.
  173.     }
  174. });
  175. </code></pre>
  176.          *
  177.          * <p>This function also supports a 3-argument call in which the subclass's constructor is
  178.          * passed as an argument. In this form, the parameters are as follows:</p>
  179.          * <div class="mdetail-params"><ul>
  180.          * <li><code>subclass</code> : Function <div class="sub-desc">The subclass constructor.</div></li>
  181.          * <li><code>superclass</code> : Function <div class="sub-desc">The constructor of class being extended</div></li>
  182.          * <li><code>overrides</code> : Object <div class="sub-desc">A literal with members which are copied into the subclass's
  183.          * prototype, and are therefore shared among all instances of the new class.</div></li>
  184.          * </ul></div>
  185.          *
  186.          * @param {Function} superclass The constructor of class being extended.
  187.          * @param {Object} overrides <p>A literal with members which are copied into the subclass's
  188.          * prototype, and are therefore shared between all instances of the new class.</p>
  189.          * <p>This may contain a special member named <tt><b>constructor</b></tt>. This is used
  190.          * to define the constructor of the new class, and is returned. If this property is
  191.          * <i>not</i> specified, a constructor is generated and returned which just calls the
  192.          * superclass's constructor passing on its parameters.</p>
  193.          * <p><b>It is essential that you call the superclass constructor in any provided constructor. See example code.</b></p>
  194.          * @return {Function} The subclass constructor from the <code>overrides</code> parameter, or a generated one if not provided.
  195.          */
  196.         extend : function(){
  197.             // inline overrides
  198.             var io = function(o){
  199.                 for(var m in o){
  200.                     this[m] = o[m];
  201.                 }
  202.             };
  203.             var oc = Object.prototype.constructor;
  204.             return function(sb, sp, overrides){
  205.                 if(Ext.isObject(sp)){
  206.                     overrides = sp;
  207.                     sp = sb;
  208.                     sb = overrides.constructor != oc ? overrides.constructor : function(){sp.apply(this, arguments);};
  209.                 }
  210.                 var F = function(){},
  211.                     sbp,
  212.                     spp = sp.prototype;
  213.                 F.prototype = spp;
  214.                 sbp = sb.prototype = new F();
  215.                 sbp.constructor=sb;
  216.                 sb.superclass=spp;
  217.                 if(spp.constructor == oc){
  218.                     spp.constructor=sp;
  219.                 }
  220.                 sb.override = function(o){
  221.                     Ext.override(sb, o);
  222.                 };
  223.                 sbp.superclass = sbp.supr = (function(){
  224.                     return spp;
  225.                 });
  226.                 sbp.override = io;
  227.                 Ext.override(sb, overrides);
  228.                 sb.extend = function(o){return Ext.extend(sb, o);};
  229.                 return sb;
  230.             };
  231.         }(),
  232.         /**
  233.          * Adds a list of functions to the prototype of an existing class, overwriting any existing methods with the same name.
  234.          * Usage:<pre><code>
  235. Ext.override(MyClass, {
  236.     newMethod1: function(){
  237.         // etc.
  238.     },
  239.     newMethod2: function(foo){
  240.         // etc.
  241.     }
  242. });
  243. </code></pre>
  244.          * @param {Object} origclass The class to override
  245.          * @param {Object} overrides The list of functions to add to origClass.  This should be specified as an object literal
  246.          * containing one or more methods.
  247.          * @method override
  248.          */
  249.         override : function(origclass, overrides){
  250.             if(overrides){
  251.                 var p = origclass.prototype;
  252.                 Ext.apply(p, overrides);
  253.                 if(Ext.isIE && overrides.hasOwnProperty('toString')){
  254.                     p.toString = overrides.toString;
  255.                 }
  256.             }
  257.         },
  258.         /**
  259.          * Creates namespaces to be used for scoping variables and classes so that they are not global.
  260.          * Specifying the last node of a namespace implicitly creates all other nodes. Usage:
  261.          * <pre><code>
  262. Ext.namespace('Company', 'Company.data');
  263. Ext.namespace('Company.data'); // equivalent and preferable to above syntax
  264. Company.Widget = function() { ... }
  265. Company.data.CustomStore = function(config) { ... }
  266. </code></pre>
  267.          * @param {String} namespace1
  268.          * @param {String} namespace2
  269.          * @param {String} etc
  270.          * @return {Object} The namespace object. (If multiple arguments are passed, this will be the last namespace created)
  271.          * @method namespace
  272.          */
  273.         namespace : function(){
  274.             var o, d;
  275.             Ext.each(arguments, function(v) {
  276.                 d = v.split(".");
  277.                 o = window[d[0]] = window[d[0]] || {};
  278.                 Ext.each(d.slice(1), function(v2){
  279.                     o = o[v2] = o[v2] || {};
  280.                 });
  281.             });
  282.             return o;
  283.         },
  284.         /**
  285.          * 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.
  286.          * @param {Object} o
  287.          * @param {String} pre (optional) A prefix to add to the url encoded string
  288.          * @return {String}
  289.          */
  290.         urlEncode : function(o, pre){
  291.             var empty,
  292.                 buf = [],
  293.                 e = encodeURIComponent;
  294.             Ext.iterate(o, function(key, item){
  295.                 empty = Ext.isEmpty(item);
  296.                 Ext.each(empty ? key : item, function(val){
  297.                     buf.push('&', e(key), '=', (!Ext.isEmpty(val) && (val != key || !empty)) ? (Ext.isDate(val) ? Ext.encode(val).replace(/"/g, '') : e(val)) : '');
  298.                 });
  299.             });
  300.             if(!pre){
  301.                 buf.shift();
  302.                 pre = '';
  303.             }
  304.             return pre + buf.join('');
  305.         },
  306.         /**
  307.          * Takes an encoded URL and and converts it to an object. Example: <pre><code>
  308. Ext.urlDecode("foo=1&bar=2"); // returns {foo: "1", bar: "2"}
  309. Ext.urlDecode("foo=1&bar=2&bar=3&bar=4", false); // returns {foo: "1", bar: ["2", "3", "4"]}
  310. </code></pre>
  311.          * @param {String} string
  312.          * @param {Boolean} overwrite (optional) Items of the same name will overwrite previous values instead of creating an an array (Defaults to false).
  313.          * @return {Object} A literal with members
  314.          */
  315.         urlDecode : function(string, overwrite){
  316.             if(Ext.isEmpty(string)){
  317.                 return {};
  318.             }
  319.             var obj = {},
  320.                 pairs = string.split('&'),
  321.                 d = decodeURIComponent,
  322.                 name,
  323.                 value;
  324.             Ext.each(pairs, function(pair) {
  325.                 pair = pair.split('=');
  326.                 name = d(pair[0]);
  327.                 value = d(pair[1]);
  328.                 obj[name] = overwrite || !obj[name] ? value :
  329.                             [].concat(obj[name]).concat(value);
  330.             });
  331.             return obj;
  332.         },
  333.         /**
  334.          * Appends content to the query string of a URL, handling logic for whether to place
  335.          * a question mark or ampersand.
  336.          * @param {String} url The URL to append to.
  337.          * @param {String} s The content to append to the URL.
  338.          * @return (String) The resulting URL
  339.          */
  340.         urlAppend : function(url, s){
  341.             if(!Ext.isEmpty(s)){
  342.                 return url + (url.indexOf('?') === -1 ? '?' : '&') + s;
  343.             }
  344.             return url;
  345.         },
  346.         /**
  347.          * Converts any iterable (numeric indices and a length property) into a true array
  348.          * Don't use this on strings. IE doesn't support "abc"[0] which this implementation depends on.
  349.          * For strings, use this instead: "abc".match(/./g) => [a,b,c];
  350.          * @param {Iterable} the iterable object to be turned into a true Array.
  351.          * @return (Array) array
  352.          */
  353.          toArray : function(){
  354.              return isIE ?
  355.                  function(a, i, j, res){
  356.                      res = [];
  357.                      for(var x = 0, len = a.length; x < len; x++) {
  358.                          res.push(a[x]);
  359.                      }
  360.                      return res.slice(i || 0, j || res.length);
  361.                  } :
  362.                  function(a, i, j){
  363.                      return Array.prototype.slice.call(a, i || 0, j || a.length);
  364.                  }
  365.          }(),
  366.         isIterable : function(v){
  367.             //check for array or arguments
  368.             if(Ext.isArray(v) || v.callee){
  369.                 return true;
  370.             }
  371.             //check for node list type
  372.             if(/NodeList|HTMLCollection/.test(toString.call(v))){
  373.                 return true;
  374.             }
  375.             //NodeList has an item and length property
  376.             //IXMLDOMNodeList has nextNode method, needs to be checked first.
  377.             return ((v.nextNode || v.item) && Ext.isNumber(v.length));
  378.         },
  379.         /**
  380.          * Iterates an array calling the supplied function.
  381.          * @param {Array/NodeList/Mixed} array The array to be iterated. If this
  382.          * argument is not really an array, the supplied function is called once.
  383.          * @param {Function} fn The function to be called with each item. If the
  384.          * supplied function returns false, iteration stops and this method returns
  385.          * the current <code>index</code>. This function is called with
  386.          * the following arguments:
  387.          * <div class="mdetail-params"><ul>
  388.          * <li><code>item</code> : <i>Mixed</i>
  389.          * <div class="sub-desc">The item at the current <code>index</code>
  390.          * in the passed <code>array</code></div></li>
  391.          * <li><code>index</code> : <i>Number</i>
  392.          * <div class="sub-desc">The current index within the array</div></li>
  393.          * <li><code>allItems</code> : <i>Array</i>
  394.          * <div class="sub-desc">The <code>array</code> passed as the first
  395.          * argument to <code>Ext.each</code>.</div></li>
  396.          * </ul></div>
  397.          * @param {Object} scope The scope (<code>this</code> reference) in which the specified function is executed.
  398.          * Defaults to the <code>item</code> at the current <code>index</code>
  399.          * within the passed <code>array</code>.
  400.          * @return See description for the fn parameter.
  401.          */
  402.         each : function(array, fn, scope){
  403.             if(Ext.isEmpty(array, true)){
  404.                 return;
  405.             }
  406.             if(!Ext.isIterable(array) || Ext.isPrimitive(array)){
  407.                 array = [array];
  408.             }
  409.             for(var i = 0, len = array.length; i < len; i++){
  410.                 if(fn.call(scope || array[i], array[i], i, array) === false){
  411.                     return i;
  412.                 };
  413.             }
  414.         },
  415.         /**
  416.          * Iterates either the elements in an array, or each of the properties in an object.
  417.          * <b>Note</b>: If you are only iterating arrays, it is better to call {@link #each}.
  418.          * @param {Object/Array} object The object or array to be iterated
  419.          * @param {Function} fn The function to be called for each iteration.
  420.          * The iteration will stop if the supplied function returns false, or
  421.          * all array elements / object properties have been covered. The signature
  422.          * varies depending on the type of object being interated:
  423.          * <div class="mdetail-params"><ul>
  424.          * <li>Arrays : <tt>(Object item, Number index, Array allItems)</tt>
  425.          * <div class="sub-desc">
  426.          * When iterating an array, the supplied function is called with each item.</div></li>
  427.          * <li>Objects : <tt>(String key, Object value, Object)</tt>
  428.          * <div class="sub-desc">
  429.          * When iterating an object, the supplied function is called with each key-value pair in
  430.          * the object, and the iterated object</div></li>
  431.          * </ul></div>
  432.          * @param {Object} scope The scope (<code>this</code> reference) in which the specified function is executed. Defaults to
  433.          * the <code>object</code> being iterated.
  434.          */
  435.         iterate : function(obj, fn, scope){
  436.             if(Ext.isEmpty(obj)){
  437.                 return;
  438.             }
  439.             if(Ext.isIterable(obj)){
  440.                 Ext.each(obj, fn, scope);
  441.                 return;
  442.             }else if(Ext.isObject(obj)){
  443.                 for(var prop in obj){
  444.                     if(obj.hasOwnProperty(prop)){
  445.                         if(fn.call(scope || obj, prop, obj[prop], obj) === false){
  446.                             return;
  447.                         };
  448.                     }
  449.                 }
  450.             }
  451.         },
  452.         /**
  453.          * Return the dom node for the passed String (id), dom node, or Ext.Element.
  454.          * Here are some examples:
  455.          * <pre><code>
  456. // gets dom node based on id
  457. var elDom = Ext.getDom('elId');
  458. // gets dom node based on the dom node
  459. var elDom1 = Ext.getDom(elDom);
  460. // If we don&#39;t know if we are working with an
  461. // Ext.Element or a dom node use Ext.getDom
  462. function(el){
  463.     var dom = Ext.getDom(el);
  464.     // do something with the dom node
  465. }
  466.          * </code></pre>
  467.          * <b>Note</b>: the dom node to be found actually needs to exist (be rendered, etc)
  468.          * when this method is called to be successful.
  469.          * @param {Mixed} el
  470.          * @return HTMLElement
  471.          */
  472.         getDom : function(el){
  473.             if(!el || !DOC){
  474.                 return null;
  475.             }
  476.             return el.dom ? el.dom : (Ext.isString(el) ? DOC.getElementById(el) : el);
  477.         },
  478.         /**
  479.          * Returns the current document body as an {@link Ext.Element}.
  480.          * @return Ext.Element The document body
  481.          */
  482.         getBody : function(){
  483.             return Ext.get(DOC.body || DOC.documentElement);
  484.         },
  485.         /**
  486.          * Removes a DOM node from the document.
  487.          */
  488.         /**
  489.          * <p>Removes this element from the document, removes all DOM event listeners, and deletes the cache reference.
  490.          * All DOM event listeners are removed from this element. If {@link Ext#enableNestedListenerRemoval} is
  491.          * <code>true</code>, then DOM event listeners are also removed from all child nodes. The body node
  492.          * will be ignored if passed in.</p>
  493.          * @param {HTMLElement} node The node to remove
  494.          */
  495.         removeNode : isIE && !isIE8 ? function(){
  496.             var d;
  497.             return function(n){
  498.                 if(n && n.tagName != 'BODY'){
  499.                     (Ext.enableNestedListenerRemoval) ? Ext.EventManager.purgeElement(n, true) : Ext.EventManager.removeAll(n);
  500.                     d = d || DOC.createElement('div');
  501.                     d.appendChild(n);
  502.                     d.innerHTML = '';
  503.                     delete Ext.elCache[n.id];
  504.                 }
  505.             }
  506.         }() : function(n){
  507.             if(n && n.parentNode && n.tagName != 'BODY'){
  508.                 (Ext.enableNestedListenerRemoval) ? Ext.EventManager.purgeElement(n, true) : Ext.EventManager.removeAll(n);
  509.                 n.parentNode.removeChild(n);
  510.                 delete Ext.elCache[n.id];
  511.             }
  512.         },
  513.         /**
  514.          * <p>Returns true if the passed value is empty.</p>
  515.          * <p>The value is deemed to be empty if it is<div class="mdetail-params"><ul>
  516.          * <li>null</li>
  517.          * <li>undefined</li>
  518.          * <li>an empty array</li>
  519.          * <li>a zero length string (Unless the <tt>allowBlank</tt> parameter is <tt>true</tt>)</li>
  520.          * </ul></div>
  521.          * @param {Mixed} value The value to test
  522.          * @param {Boolean} allowBlank (optional) true to allow empty strings (defaults to false)
  523.          * @return {Boolean}
  524.          */
  525.         isEmpty : function(v, allowBlank){
  526.             return v === null || v === undefined || ((Ext.isArray(v) && !v.length)) || (!allowBlank ? v === '' : false);
  527.         },
  528.         /**
  529.          * Returns true if the passed value is a JavaScript array, otherwise false.
  530.          * @param {Mixed} value The value to test
  531.          * @return {Boolean}
  532.          */
  533.         isArray : function(v){
  534.             return toString.apply(v) === '[object Array]';
  535.         },
  536.         /**
  537.          * Returns true if the passed object is a JavaScript date object, otherwise false.
  538.          * @param {Object} object The object to test
  539.          * @return {Boolean}
  540.          */
  541.         isDate : function(v){
  542.             return toString.apply(v) === '[object Date]';
  543.         },
  544.         /**
  545.          * Returns true if the passed value is a JavaScript Object, otherwise false.
  546.          * @param {Mixed} value The value to test
  547.          * @return {Boolean}
  548.          */
  549.         isObject : function(v){
  550.             return !!v && Object.prototype.toString.call(v) === '[object Object]';
  551.         },
  552.         /**
  553.          * Returns true if the passed value is a JavaScript 'primitive', a string, number or boolean.
  554.          * @param {Mixed} value The value to test
  555.          * @return {Boolean}
  556.          */
  557.         isPrimitive : function(v){
  558.             return Ext.isString(v) || Ext.isNumber(v) || Ext.isBoolean(v);
  559.         },
  560.         /**
  561.          * Returns true if the passed value is a JavaScript Function, otherwise false.
  562.          * @param {Mixed} value The value to test
  563.          * @return {Boolean}
  564.          */
  565.         isFunction : function(v){
  566.             return toString.apply(v) === '[object Function]';
  567.         },
  568.         /**
  569.          * Returns true if the passed value is a number. Returns false for non-finite numbers.
  570.          * @param {Mixed} value The value to test
  571.          * @return {Boolean}
  572.          */
  573.         isNumber : function(v){
  574.             return typeof v === 'number' && isFinite(v);
  575.         },
  576.         /**
  577.          * Returns true if the passed value is a string.
  578.          * @param {Mixed} value The value to test
  579.          * @return {Boolean}
  580.          */
  581.         isString : function(v){
  582.             return typeof v === 'string';
  583.         },
  584.         /**
  585.          * Returns true if the passed value is a boolean.
  586.          * @param {Mixed} value The value to test
  587.          * @return {Boolean}
  588.          */
  589.         isBoolean : function(v){
  590.             return typeof v === 'boolean';
  591.         },
  592.         /**
  593.          * Returns true if the passed value is an HTMLElement
  594.          * @param {Mixed} value The value to test
  595.          * @return {Boolean}
  596.          */
  597.         isElement : function(v) {
  598.             return !!v && v.tagName;
  599.         },
  600.         /**
  601.          * Returns true if the passed value is not undefined.
  602.          * @param {Mixed} value The value to test
  603.          * @return {Boolean}
  604.          */
  605.         isDefined : function(v){
  606.             return typeof v !== 'undefined';
  607.         },
  608.         /**
  609.          * True if the detected browser is Opera.
  610.          * @type Boolean
  611.          */
  612.         isOpera : isOpera,
  613.         /**
  614.          * True if the detected browser uses WebKit.
  615.          * @type Boolean
  616.          */
  617.         isWebKit : isWebKit,
  618.         /**
  619.          * True if the detected browser is Chrome.
  620.          * @type Boolean
  621.          */
  622.         isChrome : isChrome,
  623.         /**
  624.          * True if the detected browser is Safari.
  625.          * @type Boolean
  626.          */
  627.         isSafari : isSafari,
  628.         /**
  629.          * True if the detected browser is Safari 3.x.
  630.          * @type Boolean
  631.          */
  632.         isSafari3 : isSafari3,
  633.         /**
  634.          * True if the detected browser is Safari 4.x.
  635.          * @type Boolean
  636.          */
  637.         isSafari4 : isSafari4,
  638.         /**
  639.          * True if the detected browser is Safari 2.x.
  640.          * @type Boolean
  641.          */
  642.         isSafari2 : isSafari2,
  643.         /**
  644.          * True if the detected browser is Internet Explorer.
  645.          * @type Boolean
  646.          */
  647.         isIE : isIE,
  648.         /**
  649.          * True if the detected browser is Internet Explorer 6.x.
  650.          * @type Boolean
  651.          */
  652.         isIE6 : isIE6,
  653.         /**
  654.          * True if the detected browser is Internet Explorer 7.x.
  655.          * @type Boolean
  656.          */
  657.         isIE7 : isIE7,
  658.         /**
  659.          * True if the detected browser is Internet Explorer 8.x.
  660.          * @type Boolean
  661.          */
  662.         isIE8 : isIE8,
  663.         /**
  664.          * True if the detected browser uses the Gecko layout engine (e.g. Mozilla, Firefox).
  665.          * @type Boolean
  666.          */
  667.         isGecko : isGecko,
  668.         /**
  669.          * True if the detected browser uses a pre-Gecko 1.9 layout engine (e.g. Firefox 2.x).
  670.          * @type Boolean
  671.          */
  672.         isGecko2 : isGecko2,
  673.         /**
  674.          * True if the detected browser uses a Gecko 1.9+ layout engine (e.g. Firefox 3.x).
  675.          * @type Boolean
  676.          */
  677.         isGecko3 : isGecko3,
  678.         /**
  679.          * True if the detected browser is Internet Explorer running in non-strict mode.
  680.          * @type Boolean
  681.          */
  682.         isBorderBox : isBorderBox,
  683.         /**
  684.          * True if the detected platform is Linux.
  685.          * @type Boolean
  686.          */
  687.         isLinux : isLinux,
  688.         /**
  689.          * True if the detected platform is Windows.
  690.          * @type Boolean
  691.          */
  692.         isWindows : isWindows,
  693.         /**
  694.          * True if the detected platform is Mac OS.
  695.          * @type Boolean
  696.          */
  697.         isMac : isMac,
  698.         /**
  699.          * True if the detected platform is Adobe Air.
  700.          * @type Boolean
  701.          */
  702.         isAir : isAir
  703.     });
  704.     /**
  705.      * Creates namespaces to be used for scoping variables and classes so that they are not global.
  706.      * Specifying the last node of a namespace implicitly creates all other nodes. Usage:
  707.      * <pre><code>
  708. Ext.namespace('Company', 'Company.data');
  709. Ext.namespace('Company.data'); // equivalent and preferable to above syntax
  710. Company.Widget = function() { ... }
  711. Company.data.CustomStore = function(config) { ... }
  712. </code></pre>
  713.      * @param {String} namespace1
  714.      * @param {String} namespace2
  715.      * @param {String} etc
  716.      * @return {Object} The namespace object. (If multiple arguments are passed, this will be the last namespace created)
  717.      * @method ns
  718.      */
  719.     Ext.ns = Ext.namespace;
  720. })();
  721. Ext.ns("Ext.util", "Ext.lib", "Ext.data");
  722. Ext.elCache = {};
  723. /**
  724.  * @class Function
  725.  * These functions are available on every Function object (any JavaScript function).
  726.  */
  727. Ext.apply(Function.prototype, {
  728.      /**
  729.      * Creates an interceptor function. The passed function is called before the original one. If it returns false,
  730.      * the original one is not called. The resulting function returns the results of the original function.
  731.      * The passed function is called with the parameters of the original function. Example usage:
  732.      * <pre><code>
  733. var sayHi = function(name){
  734.     alert('Hi, ' + name);
  735. }
  736. sayHi('Fred'); // alerts "Hi, Fred"
  737. // create a new function that validates input without
  738. // directly modifying the original function:
  739. var sayHiToFriend = sayHi.createInterceptor(function(name){
  740.     return name == 'Brian';
  741. });
  742. sayHiToFriend('Fred');  // no alert
  743. sayHiToFriend('Brian'); // alerts "Hi, Brian"
  744. </code></pre>
  745.      * @param {Function} fcn The function to call before the original
  746.      * @param {Object} scope (optional) The scope (<code><b>this</b></code> reference) in which the passed function is executed.
  747.      * <b>If omitted, defaults to the scope in which the original function is called or the browser window.</b>
  748.      * @return {Function} The new function
  749.      */
  750.     createInterceptor : function(fcn, scope){
  751.         var method = this;
  752.         return !Ext.isFunction(fcn) ?
  753.                 this :
  754.                 function() {
  755.                     var me = this,
  756.                         args = arguments;
  757.                     fcn.target = me;
  758.                     fcn.method = method;
  759.                     return (fcn.apply(scope || me || window, args) !== false) ?
  760.                             method.apply(me || window, args) :
  761.                             null;
  762.                 };
  763.     },
  764.      /**
  765.      * Creates a callback that passes arguments[0], arguments[1], arguments[2], ...
  766.      * Call directly on any function. Example: <code>myFunction.createCallback(arg1, arg2)</code>
  767.      * Will create a function that is bound to those 2 args. <b>If a specific scope is required in the
  768.      * callback, use {@link #createDelegate} instead.</b> The function returned by createCallback always
  769.      * executes in the window scope.
  770.      * <p>This method is required when you want to pass arguments to a callback function.  If no arguments
  771.      * are needed, you can simply pass a reference to the function as a callback (e.g., callback: myFn).
  772.      * However, if you tried to pass a function with arguments (e.g., callback: myFn(arg1, arg2)) the function
  773.      * would simply execute immediately when the code is parsed. Example usage:
  774.      * <pre><code>
  775. var sayHi = function(name){
  776.     alert('Hi, ' + name);
  777. }
  778. // clicking the button alerts "Hi, Fred"
  779. new Ext.Button({
  780.     text: 'Say Hi',
  781.     renderTo: Ext.getBody(),
  782.     handler: sayHi.createCallback('Fred')
  783. });
  784. </code></pre>
  785.      * @return {Function} The new function
  786.     */
  787.     createCallback : function(/*args...*/){
  788.         // make args available, in function below
  789.         var args = arguments,
  790.             method = this;
  791.         return function() {
  792.             return method.apply(window, args);
  793.         };
  794.     },
  795.     /**
  796.      * Creates a delegate (callback) that sets the scope to obj.
  797.      * Call directly on any function. Example: <code>this.myFunction.createDelegate(this, [arg1, arg2])</code>
  798.      * Will create a function that is automatically scoped to obj so that the <tt>this</tt> variable inside the
  799.      * callback points to obj. Example usage:
  800.      * <pre><code>
  801. var sayHi = function(name){
  802.     // Note this use of "this.text" here.  This function expects to
  803.     // execute within a scope that contains a text property.  In this
  804.     // example, the "this" variable is pointing to the btn object that
  805.     // was passed in createDelegate below.
  806.     alert('Hi, ' + name + '. You clicked the "' + this.text + '" button.');
  807. }
  808. var btn = new Ext.Button({
  809.     text: 'Say Hi',
  810.     renderTo: Ext.getBody()
  811. });
  812. // This callback will execute in the scope of the
  813. // button instance. Clicking the button alerts
  814. // "Hi, Fred. You clicked the "Say Hi" button."
  815. btn.on('click', sayHi.createDelegate(btn, ['Fred']));
  816. </code></pre>
  817.      * @param {Object} scope (optional) The scope (<code><b>this</b></code> reference) in which the function is executed.
  818.      * <b>If omitted, defaults to the browser window.</b>
  819.      * @param {Array} args (optional) Overrides arguments for the call. (Defaults to the arguments passed by the caller)
  820.      * @param {Boolean/Number} appendArgs (optional) if True args are appended to call args instead of overriding,
  821.      * if a number the args are inserted at the specified position
  822.      * @return {Function} The new function
  823.      */
  824.     createDelegate : function(obj, args, appendArgs){
  825.         var method = this;
  826.         return function() {
  827.             var callArgs = args || arguments;
  828.             if (appendArgs === true){
  829.                 callArgs = Array.prototype.slice.call(arguments, 0);
  830.                 callArgs = callArgs.concat(args);
  831.             }else if (Ext.isNumber(appendArgs)){
  832.                 callArgs = Array.prototype.slice.call(arguments, 0); // copy arguments first
  833.                 var applyArgs = [appendArgs, 0].concat(args); // create method call params
  834.                 Array.prototype.splice.apply(callArgs, applyArgs); // splice them in
  835.             }
  836.             return method.apply(obj || window, callArgs);
  837.         };
  838.     },
  839.     /**
  840.      * Calls this function after the number of millseconds specified, optionally in a specific scope. Example usage:
  841.      * <pre><code>
  842. var sayHi = function(name){
  843.     alert('Hi, ' + name);
  844. }
  845. // executes immediately:
  846. sayHi('Fred');
  847. // executes after 2 seconds:
  848. sayHi.defer(2000, this, ['Fred']);
  849. // this syntax is sometimes useful for deferring
  850. // execution of an anonymous function:
  851. (function(){
  852.     alert('Anonymous');
  853. }).defer(100);
  854. </code></pre>
  855.      * @param {Number} millis The number of milliseconds for the setTimeout call (if less than or equal to 0 the function is executed immediately)
  856.      * @param {Object} scope (optional) The scope (<code><b>this</b></code> reference) in which the function is executed.
  857.      * <b>If omitted, defaults to the browser window.</b>
  858.      * @param {Array} args (optional) Overrides arguments for the call. (Defaults to the arguments passed by the caller)
  859.      * @param {Boolean/Number} appendArgs (optional) if True args are appended to call args instead of overriding,
  860.      * if a number the args are inserted at the specified position
  861.      * @return {Number} The timeout id that can be used with clearTimeout
  862.      */
  863.     defer : function(millis, obj, args, appendArgs){
  864.         var fn = this.createDelegate(obj, args, appendArgs);
  865.         if(millis > 0){
  866.             return setTimeout(fn, millis);
  867.         }
  868.         fn();
  869.         return 0;
  870.     }
  871. });
  872. /**
  873.  * @class String
  874.  * These functions are available on every String object.
  875.  */
  876. Ext.applyIf(String, {
  877.     /**
  878.      * Allows you to define a tokenized string and pass an arbitrary number of arguments to replace the tokens.  Each
  879.      * token must be unique, and must increment in the format {0}, {1}, etc.  Example usage:
  880.      * <pre><code>
  881. var cls = 'my-class', text = 'Some text';
  882. var s = String.format('&lt;div class="{0}">{1}&lt;/div>', cls, text);
  883. // s now contains the string: '&lt;div class="my-class">Some text&lt;/div>'
  884.      * </code></pre>
  885.      * @param {String} string The tokenized string to be formatted
  886.      * @param {String} value1 The value to replace token {0}
  887.      * @param {String} value2 Etc...
  888.      * @return {String} The formatted string
  889.      * @static
  890.      */
  891.     format : function(format){
  892.         var args = Ext.toArray(arguments, 1);
  893.         return format.replace(/{(d+)}/g, function(m, i){
  894.             return args[i];
  895.         });
  896.     }
  897. });
  898. /**
  899.  * @class Array
  900.  */
  901. Ext.applyIf(Array.prototype, {
  902.     /**
  903.      * Checks whether or not the specified object exists in the array.
  904.      * @param {Object} o The object to check for
  905.      * @param {Number} from (Optional) The index at which to begin the search
  906.      * @return {Number} The index of o in the array (or -1 if it is not found)
  907.      */
  908.     indexOf : function(o, from){
  909.         var len = this.length;
  910.         from = from || 0;
  911.         from += (from < 0) ? len : 0;
  912.         for (; from < len; ++from){
  913.             if(this[from] === o){
  914.                 return from;
  915.             }
  916.         }
  917.         return -1;
  918.     },
  919.     /**
  920.      * Removes the specified object from the array.  If the object is not found nothing happens.
  921.      * @param {Object} o The object to remove
  922.      * @return {Array} this array
  923.      */
  924.     remove : function(o){
  925.         var index = this.indexOf(o);
  926.         if(index != -1){
  927.             this.splice(index, 1);
  928.         }
  929.         return this;
  930.     }
  931. });