/static/scripts/ext-2.2.1/source/core/Ext.js
https://github.com/luisibanez/SahanaEden · JavaScript · 1060 lines · 873 code · 23 blank · 164 comment · 61 complexity · 7a491d6e4c76f3a64a1836a221b203e0 MD5 · raw file
- /*
- * Ext JS Library 2.2.1
- * Copyright(c) 2006-2009, Ext JS, LLC.
- * licensing@extjs.com
- *
- * http://extjs.com/license
- */
- Ext = {version: '2.2.1'};
- // for old browsers
- window["undefined"] = window["undefined"];
- /**
- * @class Ext
- * Ext core utilities and functions.
- * @singleton
- */
- /**
- * 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,
- isChrome = ua.indexOf("chrome") > -1,
- isSafari = !isChrome && (/webkit|khtml/).test(ua),
- isSafari3 = isSafari && ua.indexOf('webkit/5') != -1,
- isIE = !isOpera && ua.indexOf("msie") > -1,
- isIE7 = !isOpera && ua.indexOf("msie 7") > -1,
- isIE8 = !isOpera && ua.indexOf("msie 8") > -1,
- isGecko = !isSafari && !isChrome && ua.indexOf("gecko") > -1,
- isGecko3 = isGecko && ua.indexOf("rv:1.9") > -1,
- isBorderBox = isIE && !isStrict,
- isWindows = (ua.indexOf("windows") != -1 || ua.indexOf("win32") != -1),
- isMac = (ua.indexOf("macintosh") != -1 || ua.indexOf("mac os x") != -1),
- isAir = (ua.indexOf("adobeair") != -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 (standards-compliant) mode, as opposed to quirks 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",
- /**
- * A reusable empty function
- * @property
- * @type Function
- */
- 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 {Mixed} 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.
- * * <p>
- * This function also supports a 2-argument call in which the subclass's constructor is
- * not passed as an argument. In this form, the parameters are as follows:</p><p>
- * <div class="mdetail-params"><ul>
- * <li><code>superclass</code>
- * <div class="sub-desc">The class being extended</div></li>
- * <li><code>overrides</code>
- * <div class="sub-desc">A literal with members which are copied into the subclass's
- * prototype, and are therefore shared among all instances of the new class.<p>
- * This may contain a special member named <tt><b>constructor</b></tt>. This is used
- * to define the constructor of the new class, and is returned. If this property is
- * <i>not</i> specified, a constructor is generated and returned which just calls the
- * superclass's constructor passing on its parameters.</p></div></li>
- * </ul></div></p><p>
- * For example, to create a subclass of the Ext GridPanel:
- * <pre><code>
- MyGridPanel = Ext.extend(Ext.grid.GridPanel, {
- constructor: function(config) {
- // Your preprocessing here
- MyGridPanel.superclass.constructor.apply(this, arguments);
- // Your postprocessing here
- },
- yourMethod: function() {
- // etc.
- }
- });
- </code></pre>
- * </p>
- * @param {Function} subclass The class inheriting the functionality
- * @param {Function} superclass The class being extended
- * @param {Object} overrides (optional) A literal with members which are copied into the subclass's
- * prototype, and are therefore shared between all instances of the new class.
- * @return {Function} The subclass constructor.
- * @method extend
- */
- extend : function(){
- // inline overrides
- var io = function(o){
- for(var m in o){
- this[m] = o[m];
- }
- };
- var oc = Object.prototype.constructor;
- return function(sb, sp, overrides){
- if(typeof sp == 'object'){
- overrides = sp;
- sp = sb;
- sb = overrides.constructor != oc ? overrides.constructor : 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 == oc){
- spp.constructor=sp;
- }
- sb.override = function(o){
- Ext.override(sb, o);
- };
- sbp.override = io;
- Ext.override(sb, overrides);
- sb.extend = function(o){Ext.extend(sb, o);};
- 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];
- }
- if(Ext.isIE && overrides.toString != origclass.toString){
- p.toString = overrides.toString;
- }
- }
- },
- /**
- * Creates namespaces to be used for scoping variables and classes so that they are not global. Usage:
- * <pre><code>
- Ext.namespace('Company', 'Company.data');
- Company.Widget = function() { ... }
- Company.data.CustomStore = function(config) { ... }
- </code></pre>
- * @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], k = encodeURIComponent(key);
- var type = typeof ov;
- if(type == 'undefined'){
- buf.push(k, "=&");
- }else if(type != "function" && type != "object"){
- buf.push(k, "=", encodeURIComponent(ov), "&");
- }else if(Ext.isDate(ov)){
- var s = Ext.encode(ov).replace(/"/g, '');
- buf.push(k, "=", s, "&");
- }else if(Ext.isArray(ov)){
- if (ov.length) {
- for(var i = 0, len = ov.length; i < len; i++) {
- buf.push(k, "=", encodeURIComponent(ov[i] === undefined ? '' : ov[i]), "&");
- }
- } else {
- buf.push(k, "=&");
- }
- }
- }
- 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", false); 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(Ext.isArray(a)){
- 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 {Mixed} el
- * @return HTMLElement
- */
- getDom : function(el){
- if(!el || !document){
- return null;
- }
- return el.dom ? el.dom : (typeof el == 'string' ? document.getElementById(el) : el);
- },
- /**
- * Returns the current HTML document object as an {@link Ext.Element}.
- * @return Ext.Element The document
- */
- getDoc : function(){
- return Ext.get(document);
- },
- /**
- * Returns the current document body as an {@link Ext.Element}.
- * @return Ext.Element The document body
- */
- getBody : function(){
- return Ext.get(document.body || document.documentElement);
- },
- /**
- * Shorthand for {@link Ext.ComponentMgr#get}
- * @param {String} id
- * @return Ext.Component
- */
- getCmp : function(id){
- return Ext.ComponentMgr.get(id);
- },
- /**
- * Utility method for validating that a value is numeric, returning the specified default value if it is not.
- * @param {Mixed} value Should be a number, but any type will be handled appropriately
- * @param {Number} defaultValue The value to return if the original value is non-numeric
- * @return {Number} Value, if numeric, else defaultValue
- */
- num : function(v, defaultValue){
- if(typeof v != 'number' || isNaN(v)){
- return defaultValue;
- }
- return v;
- },
- /**
- * Attempts to destroy any objects passed to it by removing all event listeners, removing them from the
- * DOM (if applicable) and calling their destroy functions (if available). This method is primarily
- * intended for arguments of type {@link Ext.Element} and {@link Ext.Component}, but any subclass of
- * {@link Ext.util.Observable} can be passed in. Any number of elements and/or components can be
- * passed into this function in a single call as separate arguments.
- * @param {Mixed} arg1 An {@link Ext.Element} or {@link Ext.Component} to destroy
- * @param {Mixed} arg2 (optional)
- * @param {Mixed} etc... (optional)
- */
- destroy : function(){
- for(var i = 0, a = arguments, len = a.length; i < len; i++) {
- var as = a[i];
- if(as){
- if(typeof as.destroy == 'function'){
- as.destroy();
- }
- else if(as.dom){
- as.removeAllListeners();
- as.remove();
- }
- }
- }
- },
- /**
- * Removes a DOM node from the document. The body node will be ignored if passed in.
- * @param {HTMLElement} node The node to remove
- */
- removeNode : isIE ? function(){
- var d;
- return function(n){
- if(n && n.tagName != 'BODY'){
- d = d || document.createElement('div');
- d.appendChild(n);
- d.innerHTML = '';
- }
- }
- }() : function(n){
- if(n && n.parentNode && n.tagName != 'BODY'){
- n.parentNode.removeChild(n);
- }
- },
- // 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>date</b>: If the object passed is a Date object</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';
- case Date: return 'date';
- }
- 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.
- * @param {Mixed} value The value to test
- * @param {Boolean} allowBlank (optional) true to allow empty strings (defaults to false)
- * @return {Boolean}
- */
- isEmpty : function(v, allowBlank){
- return v === null || v === undefined || (!allowBlank ? v === '' : false);
- },
- /**
- * Utility method for validating that a value is non-empty (i.e. i) not null, ii) not undefined, and iii) not an empty string),
- * returning the specified default value if it is.
- * @param {Mixed} value The value to test
- * @param {Mixed} defaultValue The value to return if the original value is empty
- * @param {Boolean} allowBlank (optional) true to allow empty strings (defaults to false)
- * @return {Mixed} value, if non-empty, else defaultValue
- */
- value : function(v, defaultValue, allowBlank){
- return Ext.isEmpty(v, allowBlank) ? defaultValue : v;
- },
- /**
- * Returns true if the passed object is a JavaScript array, otherwise false.
- * @param {Object} The object to test
- * @return {Boolean}
- */
- isArray : function(v){
- return v && typeof v.length == 'number' && typeof v.splice == 'function';
- },
- /**
- * Returns true if the passed object is a JavaScript date object, otherwise false.
- * @param {Object} The object to test
- * @return {Boolean}
- */
- isDate : function(v){
- return v && typeof v.getFullYear == 'function';
- },
- /**
- * True if the detected browser is Opera.
- * @type Boolean
- */
- isOpera : isOpera,
- /**
- * True if the detected browser is Chrome.
- * @type Boolean
- */
- isChrome : isChrome,
- /**
- * True if the detected browser is Safari.
- * @type Boolean
- */
- isSafari : isSafari,
- /**
- * True if the detected browser is Safari 3.x.
- * @type Boolean
- */
- isSafari3 : isSafari3,
- /**
- * True if the detected browser is Safari 2.x.
- * @type Boolean
- */
- isSafari2 : isSafari && !isSafari3,
- /**
- * True if the detected browser is Internet Explorer.
- * @type Boolean
- */
- isIE : isIE,
- /**
- * True if the detected browser is Internet Explorer 6.x.
- * @type Boolean
- */
- isIE6 : isIE && !isIE7 && !isIE8,
- /**
- * True if the detected browser is Internet Explorer 7.x.
- * @type Boolean
- */
- isIE7 : isIE7,
- /**
- * True if the detected browser is Internet Explorer 8.x.
- * @type Boolean
- */
- isIE8 : isIE8,
- /**
- * True if the detected browser uses the Gecko layout engine (e.g. Mozilla, Firefox).
- * @type Boolean
- */
- isGecko : isGecko,
- /**
- * True if the detected browser uses a pre-Gecko 1.9 layout engine (e.g. Firefox 2.x).
- * @type Boolean
- */
- isGecko2 : isGecko && !isGecko3,
- /**
- * True if the detected browser uses a Gecko 1.9+ layout engine (e.g. Firefox 3.x).
- * @type Boolean
- */
- isGecko3 : isGecko3,
- /**
- * True if the detected browser is Internet Explorer running in non-strict mode.
- * @type Boolean
- */
- isBorderBox : isBorderBox,
- /**
- * True if the detected platform is Linux.
- * @type Boolean
- */
- isLinux : isLinux,
- /**
- * True if the detected platform is Windows.
- * @type Boolean
- */
- isWindows : isWindows,
- /**
- * True if the detected platform is Mac OS.
- * @type Boolean
- */
- isMac : isMac,
- /**
- * True if the detected platform is Adobe Air.
- * @type Boolean
- */
- isAir : isAir,
- /**
- * 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) || (isMac && isGecko && !isGecko3))
- });
- // in intellij using keyword "namespace" causes parsing errors
- Ext.ns = Ext.namespace;
- })();
- Ext.ns("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(arg1, arg2)</code>
- * Will create a function that is bound to those 2 args. <b>If a specific scope is required in the
- * callback, use {@link #createDelegate} instead.</b> The function returned by createCallback always
- * executes in the window scope.
- * <p>This method is required when you want to pass arguments to a callback function. If no arguments
- * are needed, you can simply pass a reference to the function as a callback (e.g., callback: myFn).
- * However, if you tried to pass a function with arguments (e.g., callback: myFn(arg1, arg2)) the function
- * would simply execute immediately when the code is parsed. Example usage:
- * <pre><code>
- var sayHi = function(name){
- alert('Hi, ' + name);
- }
- // clicking the button alerts "Hi, Fred"
- new Ext.Button({
- text: 'Say Hi',
- renderTo: Ext.getBody(),
- handler: sayHi.createCallback('Fred')
- });
- </code></pre>
- * @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, [arg1, arg2])</code>
- * Will create a function that is automatically scoped to obj so that the <tt>this</tt> variable inside the
- * callback points to obj. Example usage:
- * <pre><code>
- var sayHi = function(name){
- // Note this use of "this.text" here. This function expects to
- // execute within a scope that contains a text property. In this
- // example, the "this" variable is pointing to the btn object that
- // was passed in createDelegate below.
- alert('Hi, ' + name + '. You clicked the "' + this.text + '" button.');
- }
- var btn = new Ext.Button({
- text: 'Say Hi',
- renderTo: Ext.getBody()
- });
- // This callback will execute in the scope of the
- // button instance. Clicking the button alerts
- // "Hi, Fred. You clicked the "Say Hi" button."
- btn.on('click', sayHi.createDelegate(btn, ['Fred']));
- </code></pre>
- * @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, optionally in a specific scope. Example usage:
- * <pre><code>
- var sayHi = function(name){
- alert('Hi, ' + name);
- }
- // executes immediately:
- sayHi('Fred');
- // executes after 2 seconds:
- sayHi.defer(2000, this, ['Fred']);
- // this syntax is sometimes useful for deferring
- // execution of an anonymous function:
- (function(){
- alert('Anonymous');
- }).defer(100);
- </code></pre>
- * @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. Example usage:
- * <pre><code>
- var sayHi = function(name){
- alert('Hi, ' + name);
- }
- sayHi('Fred'); // alerts "Hi, Fred"
- var sayGoodbye = sayHi.createSequence(function(name){
- alert('Bye, ' + name);
- });
- sayGoodbye('Fred'); // both alerts show
- </code></pre>
- * @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. Example usage:
- * <pre><code>
- var sayHi = function(name){
- alert('Hi, ' + name);
- }
- sayHi('Fred'); // alerts "Hi, Fred"
- // create a new function that validates input without
- // directly modifying the original function:
- var sayHiToFriend = sayHi.createInterceptor(function(name){
- return name == 'Brian';
- });
- sayHiToFriend('Fred'); // no alert
- sayHiToFriend('Brian'); // alerts "Hi, Brian"
- </code></pre>
- * @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) {
- ch = " ";
- }
- while (result.length < size) {
- result = ch + result;
- }
- return result.toString();
- },
- /**
- * 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;
- };
- /**
- * Trims whitespace from either end of a string, leaving spaces within the string intact. Example:
- * <pre><code>
- var s = ' foo bar ';
- alert('-' + s + '-'); //alerts "- foo bar -"
- alert('-' + s.trim() + '-'); //alerts "-foo bar-"
- </code></pre>
- * @return {String} The trimmed string
- */
- String.prototype.trim = function(){
- var re = /^\s+|\s+$/g;
- return function(){ return this.replace(re, ""); };
- }();
- /**
- * @class Number
- */
- 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);
- }
- });
- /**
- * @class Array
- */
- 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
- * @return {Array} this array
- */
- remove : function(o){
- var index = this.indexOf(o);
- if(index != -1){
- this.splice(index, 1);
- }
- return this;
- }
- });
- /**
- 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());
- };