Class Ext

Applies event listeners to elements by selectors when the document is ready. The event name is specified with an @ suffix.

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
    }
});

Copies all the properties of config to obj.

Copies all the properties of config to obj if they don't already exist.

Creates a copy of the passed Array with falsy values removed.

Copies a set of named properties fom the source object to the destination object.

example:

ImageComponent = Ext.extend(Ext.BoxComponent, {
    initComponent: function() {
        this.autoEl = { tag: 'img' };
        MyComponent.superclass.initComponent.apply(this, arguments);
        this.initialBox = Ext.copyTo({}, this.initialConfig, 'x,y,width,height');
    }
});

Shorthand for Ext.util.JSON.decode

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 Ext.Element and Ext.Component, but any subclass of 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.

Attempts to destroy and then remove a set of named properties of the passed object.

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).

Shorthand for Ext.util.JSON.encode

Escapes the passed string for use in a regular expression

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.

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:

For example, to create a subclass of the Ext GridPanel:

MyGridPanel = Ext.extend(Ext.grid.GridPanel, {
    constructor: function(config) {
        // Your preprocessing here

        MyGridPanel.superclass.constructor.apply(this, arguments);
        // Your postprocessing here

    },

    yourMethod: function() {
        // etc.

    }
});

Recursively flattens into 1-d Array. Injects Arrays inline.

Gets the globally shared flyweight Element, with the passed node as the active element. Do not store a reference to this element - the dom node can be overwritten by other code. Shorthand of Ext.Element.fly

Use this to make one-time references to DOM elements which are not going to be accessed again either by application code, or by Ext's classes. If accessing an element which will be processed regularly, then Ext.get will be more appropriate to take advantage of the caching provided by the Ext.Element class.

Retrieves Ext.Element objects.

This method does not retrieve Components. This method retrieves Ext.Element objects which encapsulate DOM elements. To retrieve a Component by its ID, use Ext.ComponentMgr.get.

Uses simple caching to consistently return the same object. Automatically fixes if an object was recreated with the same id via AJAX or DOM.

Shorthand of Ext.Element.get

Returns the current document body as an Ext.Element.

This is shorthand reference to Ext.ComponentMgr.get. Looks up an existing Component by id

Returns the current HTML document object as an Ext.Element.

Return the dom node for the passed String (id), dom node, or Ext.Element. Here are some examples:

// gets dom node based on id

var elDom = Ext.getDom('elId');
// gets dom node based on the dom node

var elDom1 = Ext.getDom(elDom);

// If we don't know if we are working with an

// Ext.Element or a dom node use Ext.getDom

function(el){
    var dom = Ext.getDom(el);
    // do something with the dom node

}

Note: the dom node to be found actually needs to exist (be rendered, etc) when this method is called to be successful.

Generates unique ids. If the element already has an id, it is unchanged

Invokes a method on each item in an Array.

// Example:
Ext.invoke(Ext.query("p"), "getAttribute", "id");
// [el1.getAttribute("id"), el2.getAttribute("id"), ..., elN.getAttribute("id")]

Returns true if the passed object is a JavaScript array, otherwise false.

Returns true if the passed object is a boolean.

Returns true if the passed object is a JavaScript date object, otherwise false.

Returns true if the passed object is not undefined.

Returns true if the passed value is empty.

The value is deemed to be empty if it is

Returns true if the passed object is a JavaScript Function, otherwise false.

Returns true if the passed object is a number. Returns false for non-finite numbers.

Returns true if the passed object is a JavaScript Object, otherwise false.

Returns true if the passed object is a JavaScript 'primitive', a string, number or boolean.

Returns true if the passed object is a string.

Iterates either the elements in an array, or each of the properties in an object. Note: If you are only iterating arrays, it is better to call each.

Returns the maximum value in the Array

Calculates the mean of the Array

Returns the minimum value in the Array.

Creates namespaces to be used for scoping variables and classes so that they are not global. Specifying the last node of a namespace implicitly creates all other nodes. Usage:

Ext.namespace('Company', 'Company.data');
Ext.namespace('Company.data'); // equivalent and preferable to above syntax

Company.Widget = function() { ... }
Company.data.CustomStore = function(config) { ... }

Utility method for validating that a value is numeric, returning the specified default value if it is not.

Fires when the document is ready (before onload and before images are loaded). Shorthand of Ext.EventManager.onDocumentReady.

Adds a list of functions to the prototype of an existing class, overwriting any existing methods with the same name. Usage:

Ext.override(MyClass, {
    newMethod1: function(){
        // etc.

    },
    newMethod2: function(foo){
        // etc.

    }
});

Partitions the set into two sets: a true set and a false set. Example: Example2:

// Example 1:
Ext.partition([true, false, true, true, false]); // [[true, true, true], [false, false]]

// Example 2:
Ext.partition(
    Ext.query("p"),
    function(val){
        return val.className == "class1"
    }
);
// true are those paragraph elements with a className of "class1",
// false set are those that do not have that className.

Plucks the value of a property from each item in the Array

// Example:
Ext.pluck(Ext.query("p"), "className"); // [el1.className, el2.className, ..., elN.className]

Shorthand for Ext.ComponentMgr.registerPlugin

Selects an array of DOM nodes by CSS/XPath selector. Shorthand of Ext.DomQuery.select

Shorthand for Ext.ComponentMgr.registerType

Removes a DOM node from the document. The body node will be ignored if passed in.

Selects elements based on the passed CSS selector to enable Element methods to be applied to many related elements in one statement through the returned CompositeElement or CompositeElementLite object.

Calculates the sum of the Array

Converts any iterable (numeric indices and a length property) into a true array Don't use this on strings. IE doesn't support "abc"[0] which this implementation depends on. For strings, use this instead: "abc".match(/./g) => [a,b,c];

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:

Creates a copy of the passed Array, filtered to contain only unique values.

Appends content to the query string of a URL, which handles logic for whether to place a question mark or ampersand.

Takes an encoded URL and and converts it to an object. Example:

Ext.urlDecode("foo=1&bar=2"); // returns {foo: "1", bar: "2"}

Ext.urlDecode("foo=1&bar=2&bar=3&bar=4", false); // returns {foo: "1", bar: ["2", "3", "4"]}

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.

Utility method for returning a default value if the passed value is empty.

The value is deemed to be empty if it is

Zips N sets together.

// Example 1:
Ext.zip([1,2,3],[4,5,6]); // [[1,4],[2,5],[3,6]]
// Example 2:
Ext.zip(
    [ "+", "-", "+"],
    [  12,  10,  22],
    [  43,  15,  96],
    function(a, b, c){
        return "$" + a + "" + b + "." + c
    }
); // ["$+12.43", "$-10.15", "$+22.96"]