Ext JS 4.1.3 Sencha Docs

Ext.util.MixedCollection

Hierarchy

Mixins

Inherited mixins

Subclasses

Files

Represents a collection of a set of key and value pairs. Each key in the MixedCollection must be unique, the same key cannot exist twice. This collection is ordered, items in the collection can be accessed by index or via the key. Newly added items are added to the end of the collection. This class is similar to Ext.util.HashMap however it is heavier and provides more functionality. Sample usage:

var coll = new Ext.util.MixedCollection();
coll.add('key1', 'val1');
coll.add('key2', 'val2');
coll.add('key3', 'val3');

console.log(coll.get('key1')); // prints 'val1'
console.log(coll.indexOfKey('key3')); // prints 2

The MixedCollection also has support for sorting and filtering of the values in the collection.

var coll = new Ext.util.MixedCollection();
coll.add('key1', 100);
coll.add('key2', -100);
coll.add('key3', 17);
coll.add('key4', 0);
var biggerThanZero = coll.filterBy(function(value){
    return value > 0;
});
console.log(biggerThanZero.getCount()); // prints 2

Available since: 1.1.0

Defined By

Config options

Specify true if the addAll function should add function references to the collection. ...

Specify true if the addAll function should add function references to the collection. Defaults to false.

Defaults to: false

Available since: 3.4.0

The default sort direction to use if one is not specified. ...

The default sort direction to use if one is not specified.

Defaults to: "ASC"

Available since: Ext JS 4.1.3

A config object containing one or more event handlers to be added to this object during initialization. ...

A config object containing one or more event handlers to be added to this object during initialization. This should be a valid listeners config object as specified in the addListener example for attaching multiple handlers at once.

DOM events from Ext JS Components

While some Ext JS Component classes export selected DOM events (e.g. "click", "mouseover" etc), this is usually only done when extra value can be added. For example the DataView's itemclick event passing the node clicked on. To access DOM events directly from a child element of a Component, we need to specify the element option to identify the Component property to add a DOM listener to:

new Ext.panel.Panel({
    width: 400,
    height: 200,
    dockedItems: [{
        xtype: 'toolbar'
    }],
    listeners: {
        click: {
            element: 'el', //bind to the underlying el property on the panel
            fn: function(){ console.log('click el'); }
        },
        dblclick: {
            element: 'body', //bind to the underlying body property on the panel
            fn: function(){ console.log('dblclick body'); }
        }
    }
});

Available since: 1.1.0

The property in each item that contains the data to sort.

The property in each item that contains the data to sort.

Available since: Ext JS 4.1.3

The initial set of Sorters

The initial set of Sorters

Available since: Ext JS 4.1.3

Properties

Defined By

Instance properties

...

Defaults to: 'Ext.Base'

Available since: 4.1.1

...

Defaults to: {}

Available since: 4.1.1

Initial suspended call count. ...

Initial suspended call count. Incremented when suspendEvents is called, decremented when resumeEvents is called.

Defaults to: 0

Available since: 4.1.1

Mutation counter which is incremented upon add and remove. ...

Mutation counter which is incremented upon add and remove.

Defaults to: 0

Available since: 4.1.0

This object holds a key for any event that has a listener. ...

This object holds a key for any event that has a listener. The listener may be set directly on the instance, or on its class or a super class (via observe) or on the MVC EventBus. The values of this object are truthy (a non-zero number) and falsy (0 or undefined). They do not represent an exact count of listeners. The value for an event is truthy if the event must be fired and is falsy if there is no need to fire the event.

The intended use of this property is to avoid the expense of fireEvent calls when there are no listeners. This can be particularly helpful when one would otherwise have to call fireEvent hundreds or thousands of times. It is used like this:

 if (this.hasListeners.foo) {
     this.fireEvent('foo', this, arg1);
 }

Available since: 4.1.0

...

Defaults to: []

Available since: 4.1.1

...

Defaults to: {}

Available since: 4.1.1

...

Defaults to: true

Available since: 4.1.1

true in this class to identify an object as an instantiated MixedCollection, or subclass thereof. ...

true in this class to identify an object as an instantiated MixedCollection, or subclass thereof.

Defaults to: true

Available since: 4.1.0

true in this class to identify an object as an instantiated Observable, or subclass thereof. ...

true in this class to identify an object as an instantiated Observable, or subclass thereof.

Defaults to: true

Available since: 4.0.0

true in this class to identify an object as an instantiated Sortable, or subclass thereof. ...

true in this class to identify an object as an instantiated Sortable, or subclass thereof.

Defaults to: true

Available since: 4.0.0

Get the reference to the current class from which this object was instantiated. ...

Get the reference to the current class from which this object was instantiated. Unlike statics, this.self is scope-dependent and it's meant to be used for dynamic inheritance. See statics for a detailed comparison

Ext.define('My.Cat', {
    statics: {
        speciesName: 'Cat' // My.Cat.speciesName = 'Cat'
    },

    constructor: function() {
        alert(this.self.speciesName); // dependent on 'this'
    },

    clone: function() {
        return new this.self();
    }
});


Ext.define('My.SnowLeopard', {
    extend: 'My.Cat',
    statics: {
        speciesName: 'Snow Leopard'         // My.SnowLeopard.speciesName = 'Snow Leopard'
    }
});

var cat = new My.Cat();                     // alerts 'Cat'
var snowLeopard = new My.SnowLeopard();     // alerts 'Snow Leopard'

var clone = snowLeopard.clone();
alert(Ext.getClassName(clone));             // alerts 'My.SnowLeopard'

Available since: 4.0.0

The collection of Sorters currently applied to this Store

The collection of Sorters currently applied to this Store

Available since: 4.0.0

Defined By

Static properties

...

Defaults to: []

Available since: 4.1.1

Methods

Defined By

Instance methods

Ext.util.MixedCollection
view source
new( allowFunctions, keyFn ) : Ext.util.MixedCollection
Creates new MixedCollection. ...

Creates new MixedCollection.

Available since: 1.1.0

Parameters

  • allowFunctions : Boolean

    Specify true if the addAll function should add function references to the collection. Defaults to false.

  • keyFn : Function

    A function that can accept an item of the type(s) stored in this MixedCollection and return the key value for that item. This is used when available to look up the key on items that were passed without an explicit key parameter to a MixedCollection method. Passing this parameter is equivalent to providing an implementation for the getKey method.

Returns

Fires

    Overrides: Ext.util.AbstractMixedCollection.constructor, Ext.util.MixedCollection.constructor, Ext.draw.CompositeSprite.constructor

    Ext.util.MixedCollection
    view source
    ( property, [dir], [fn] )private
    Performs the actual sorting based on a direction and a sorting function. ...

    Performs the actual sorting based on a direction and a sorting function. Internally, this creates a temporary array of all items in the MixedCollection, sorts it and then writes the sorted array data back into this.items and this.keys

    Available since: 3.4.0

    Parameters

    • property : String

      Property to sort by ('key', 'value', or 'index')

    • dir : String (optional)

      Direction to sort 'ASC' or 'DESC'. Defaults to 'ASC'.

    • fn : Function (optional)

      Comparison function that defines the sort order. Defaults to sorting by numeric value.

    Fires

    • sort
    Adds an item to the collection. ...

    Adds an item to the collection. Fires the add event when complete.

    Available since: 1.1.0

    Parameters

    • key : String/Object

      The key to associate with the item, or the new item.

      If a getKey implementation was specified for this MixedCollection, or if the key of the stored items is in a property called id, the MixedCollection will be able to derive the key for the new item. In this case just pass the new item in this parameter.

    • o : Object (optional)

      The item to add.

    Returns

    Fires

    Adds all elements of an Array or an Object to the collection. ...

    Adds all elements of an Array or an Object to the collection.

    Available since: 1.1.0

    Parameters

    • objs : Object/Array

      An Object containing properties which will be added to the collection, or an Array of values, each of which are added to the collection. Functions references will be added to the collection if allowFunctions has been set to true.

    Fires

    Adds the specified events to the list of events which this Observable may fire. ...

    Adds the specified events to the list of events which this Observable may fire.

    Available since: 1.1.0

    Parameters

    • eventNames : Object/String...

      Either an object with event names as properties with a value of true. For example:

      this.addEvents({
          storeloaded: true,
          storecleared: true
      });
      

      Or any number of event names as separate parameters. For example:

      this.addEvents('storeloaded', 'storecleared');
      
    ( eventName, [fn], [scope], [options] ) : Object
    Appends an event handler to this object. ...

    Appends an event handler to this object. For example:

    myGridPanel.on("mouseover", this.onMouseOver, this);
    

    The method also allows for a single argument to be passed which is a config object containing properties which specify multiple events. For example:

    myGridPanel.on({
        cellClick: this.onCellClick,
        mouseover: this.onMouseOver,
        mouseout: this.onMouseOut,
        scope: this // Important. Ensure "this" is correct during handler execution
    });
    

    One can also specify options for each event handler separately:

    myGridPanel.on({
        cellClick: {fn: this.onCellClick, scope: this, single: true},
        mouseover: {fn: panel.onMouseOver, scope: panel}
    });
    

    Names of methods in a specified scope may also be used. Note that scope MUST be specified to use this option:

    myGridPanel.on({
        cellClick: {fn: 'onCellClick', scope: this, single: true},
        mouseover: {fn: 'onMouseOver', scope: panel}
    });
    

    Available since: 1.1.0

    Parameters

    • eventName : String/Object

      The name of the event to listen for. May also be an object who's property names are event names.

    • fn : Function (optional)

      The method the event invokes, or if scope is specified, the name* of the method within the specified scope. Will be called with arguments given to fireEvent plus the options parameter described below.

    • scope : Object (optional)

      The scope (this reference) in which the handler function is executed. If omitted, defaults to the object which fired the event.

    • options : Object (optional)

      An object containing handler configuration.

      Note: Unlike in ExtJS 3.x, the options object will also be passed as the last argument to every event handler.

      This object may contain any of the following properties:

      • scope : Object

        The scope (this reference) in which the handler function is executed. If omitted, defaults to the object which fired the event.

      • delay : Number

        The number of milliseconds to delay the invocation of the handler after the event fires.

      • single : Boolean

        True to add a handler to handle just the next firing of the event, and then remove itself.

      • buffer : Number

        Causes the handler to be scheduled to run in an Ext.util.DelayedTask delayed by the specified number of milliseconds. If the event fires again within that time, the original handler is not invoked, but the new handler is scheduled in its place.

      • target : Ext.util.Observable

        Only call the handler if the event was fired on the target Observable, not if the event was bubbled up from a child Observable.

      • element : String

        This option is only valid for listeners bound to Components. The name of a Component property which references an element to add a listener to.

        This option is useful during Component construction to add DOM event listeners to elements of Components which will exist only after the Component is rendered. For example, to add a click listener to a Panel's body:

          new Ext.panel.Panel({
              title: 'The title',
              listeners: {
                  click: this.handlePanelClick,
                  element: 'body'
              }
          });
        
      • destroyable : Boolean (optional)

        When specified as true, the function returns A Destroyable object. An object which implements the destroy method which removes all listeners added in this call.

        Combining Options

        Using the options argument, it is possible to combine different types of listeners:

        A delayed, one-time listener.

        myPanel.on('hide', this.handleClick, this, {
            single: true,
            delay: 100
        });
        

        Defaults to: false

    Returns

    • Object

      Only when the destroyable option is specified.

      A Destroyable object. An object which implements the destroy method which removes all listeners added in this call. For example:

      this.btnListeners =  = myButton.on({
          destroyable: true
          mouseover:   function() { console.log('mouseover'); },
          mouseout:    function() { console.log('mouseout'); },
          click:       function() { console.log('click'); }
      });
      

      And when those listeners need to be removed:

      Ext.destroy(this.btnListeners);
      

      or

      this.btnListeners.destroy();
      

    Fires

      Overrides: Ext.AbstractComponent.addListener

      ( item, ename, [fn], [scope], [options] ) : Object
      Adds listeners to any Observable object (or Ext.Element) which are automatically removed when this Component is destr...

      Adds listeners to any Observable object (or Ext.Element) which are automatically removed when this Component is destroyed.

      Available since: 4.0.0

      Parameters

      • item : Ext.util.Observable/Ext.Element

        The item to which to add a listener/listeners.

      • ename : Object/String

        The event name, or an object containing event name properties.

      • fn : Function (optional)

        If the ename parameter was an event name, this is the handler function.

      • scope : Object (optional)

        If the ename parameter was an event name, this is the scope (this reference) in which the handler function is executed.

      • options : Object (optional)

        If the ename parameter was an event name, this is the addListener options.

      Returns

      • Object

        Only when the destroyable option is specified.

        A Destroyable object. An object which implements the destroy method which removes all listeners added in this call. For example:

        this.btnListeners =  = myButton.mon({
            destroyable: true
            mouseover:   function() { console.log('mouseover'); },
            mouseout:    function() { console.log('mouseout'); },
            click:       function() { console.log('click'); }
        });
        

        And when those listeners need to be removed:

        Ext.destroy(this.btnListeners);
        

        or

        this.btnListeners.destroy();
        

      Fires

        ( args ) : Objectdeprecatedprotected
        Call the original method that was previously overridden with override Ext.define('My.Cat', { constructor: functi...

        Call the original method that was previously overridden with override

        Ext.define('My.Cat', {
            constructor: function() {
                alert("I'm a cat!");
            }
        });
        
        My.Cat.override({
            constructor: function() {
                alert("I'm going to be a cat!");
        
                this.callOverridden();
        
                alert("Meeeeoooowwww");
            }
        });
        
        var kitty = new My.Cat(); // alerts "I'm going to be a cat!"
                                  // alerts "I'm a cat!"
                                  // alerts "Meeeeoooowwww"
        

        Available since: 4.0.0

        This method has been deprecated

        as of 4.1. Use callParent instead.

        Parameters

        • args : Array/Arguments

          The arguments, either an array or the arguments object from the current method, for example: this.callOverridden(arguments)

        Returns

        • Object

          Returns the result of calling the overridden method

        Call the "parent" method of the current method. ...

        Call the "parent" method of the current method. That is the method previously overridden by derivation or by an override (see Ext.define).

         Ext.define('My.Base', {
             constructor: function (x) {
                 this.x = x;
             },
        
             statics: {
                 method: function (x) {
                     return x;
                 }
             }
         });
        
         Ext.define('My.Derived', {
             extend: 'My.Base',
        
             constructor: function () {
                 this.callParent([21]);
             }
         });
        
         var obj = new My.Derived();
        
         alert(obj.x);  // alerts 21
        

        This can be used with an override as follows:

         Ext.define('My.DerivedOverride', {
             override: 'My.Derived',
        
             constructor: function (x) {
                 this.callParent([x*2]); // calls original My.Derived constructor
             }
         });
        
         var obj = new My.Derived();
        
         alert(obj.x);  // now alerts 42
        

        This also works with static methods.

         Ext.define('My.Derived2', {
             extend: 'My.Base',
        
             statics: {
                 method: function (x) {
                     return this.callParent([x*2]); // calls My.Base.method
                 }
             }
         });
        
         alert(My.Base.method(10);     // alerts 10
         alert(My.Derived2.method(10); // alerts 20
        

        Lastly, it also works with overridden static methods.

         Ext.define('My.Derived2Override', {
             override: 'My.Derived2',
        
             statics: {
                 method: function (x) {
                     return this.callParent([x*2]); // calls My.Derived2.method
                 }
             }
         });
        
         alert(My.Derived2.method(10); // now alerts 40
        

        To override a method and replace it and also call the superclass method, use callSuper. This is often done to patch a method to fix a bug.

        Available since: 4.0.0

        Parameters

        • args : Array/Arguments

          The arguments, either an array or the arguments object from the current method, for example: this.callParent(arguments)

        Returns

        • Object

          Returns the result of calling the parent method

        ( args ) : Objectprotected
        This method is used by an override to call the superclass method but bypass any overridden method. ...

        This method is used by an override to call the superclass method but bypass any overridden method. This is often done to "patch" a method that contains a bug but for whatever reason cannot be fixed directly.

        Consider:

         Ext.define('Ext.some.Class', {
             method: function () {
                 console.log('Good');
             }
         });
        
         Ext.define('Ext.some.DerivedClass', {
             method: function () {
                 console.log('Bad');
        
                 // ... logic but with a bug ...
        
                 this.callParent();
             }
         });
        

        To patch the bug in DerivedClass.method, the typical solution is to create an override:

         Ext.define('App.paches.DerivedClass', {
             override: 'Ext.some.DerivedClass',
        
             method: function () {
                 console.log('Fixed');
        
                 // ... logic but with bug fixed ...
        
                 this.callSuper();
             }
         });
        

        The patch method cannot use callParent to call the superclass method since that would call the overridden method containing the bug. In other words, the above patch would only produce "Fixed" then "Good" in the console log, whereas, using callParent would produce "Fixed" then "Bad" then "Good".

        Available since: Ext JS 4.1.3

        Parameters

        • args : Array/Arguments

          The arguments, either an array or the arguments object from the current method, for example: this.callSuper(arguments)

        Returns

        • Object

          Returns the result of calling the superclass method

        Removes all items from the collection. ...

        Removes all items from the collection. Fires the clear event when complete.

        Available since: 1.1.0

        Fires

        Removes all listeners for this object including the managed listeners ...

        Removes all listeners for this object including the managed listeners

        Available since: 4.0.0

        Fires

          Removes all managed listeners for this object. ...

          Removes all managed listeners for this object.

          Available since: 4.0.0

          Fires

            Creates a shallow copy of this collection ...

            Creates a shallow copy of this collection

            Available since: 1.1.0

            Returns

            ( property, [root], [allowBlank] ) : Array
            Collects unique values of a particular property in this MixedCollection ...

            Collects unique values of a particular property in this MixedCollection

            Available since: 4.0.0

            Parameters

            • property : String

              The property to collect on

            • root : String (optional)

              'root' property to extract the first argument from. This is used mainly when summing fields in records, where the fields are all stored inside the 'data' object

            • allowBlank : Boolean (optional)

              Pass true to allow null, undefined or empty string values

            Returns

            Fires

              ...

              Available since: 4.1.1

              Returns true if the collection contains the passed Object as an item. ...

              Returns true if the collection contains the passed Object as an item.

              Available since: 1.1.0

              Parameters

              • o : Object

                The Object to look for in the collection.

              Returns

              • Boolean

                True if the collection contains the Object as an item.

              Fires

                Returns true if the collection contains the passed Object as a key. ...

                Returns true if the collection contains the passed Object as a key.

                Available since: 1.1.0

                Parameters

                • key : String

                  The key to look for in the collection.

                Returns

                • Boolean

                  True if the collection contains the Object as a key.

                ( eventName, args, bubbles )private
                Continue to fire event. ...

                Continue to fire event.

                Available since: 4.0.7

                Parameters

                Fires

                  Creates an event handling function which refires the event from this object as the passed event name. ...

                  Creates an event handling function which refires the event from this object as the passed event name.

                  Available since: 4.0.0

                  Parameters

                  • newName : Object
                  • beginEnd : Array (optional)

                    The caller can specify on which indices to slice

                  Returns

                  ( value, anyMatch, caseSensitive, exactMatch )private
                  Returns a regular expression based on the given value and matching options. ...

                  Returns a regular expression based on the given value and matching options. This is used internally for finding and filtering, and by Ext.data.Store.filter

                  Available since: 3.4.0

                  Parameters

                  • value : String

                    The value to create the regex for. This is escaped using Ext.escapeRe

                  • anyMatch : Boolean

                    True to allow any match - no regex start/end line anchors will be added. Defaults to false

                  • caseSensitive : Boolean

                    True to make the regex case sensitive (adds 'i' switch to regex). Defaults to false.

                  • exactMatch : Boolean

                    True to force exact match (^ and $ characters added to the regex). Defaults to false. Ignored if anyMatch is true.

                  Normalizes an array of sorter objects, ensuring that they are all Ext.util.Sorter instances ...

                  Normalizes an array of sorter objects, ensuring that they are all Ext.util.Sorter instances

                  Available since: 4.0.0

                  Parameters

                  • sorters : Object[]

                    The sorters array

                  Returns

                  Ext.util.MixedCollection
                  view source
                  ( sorterFn )private
                  ...

                  Available since: 4.0.0

                  Parameters

                  Fires

                  • sort
                  Executes the specified function once for every item in the collection. ...

                  Executes the specified function once for every item in the collection. The function should return a boolean value. Returning false from the function will stop the iteration.

                  Available since: 1.1.0

                  Parameters

                  • fn : Function

                    The function to execute for each item.

                    Parameters

                    • item : Mixed

                      The collection item.

                    • index : Number

                      The index of item.

                    • len : Number

                      Total length of collection.

                  • scope : Object (optional)

                    The scope (this reference) in which the function is executed. Defaults to the current item in the iteration.

                  Executes the specified function once for every key in the collection, passing each key, and its associated item as th...

                  Executes the specified function once for every key in the collection, passing each key, and its associated item as the first two parameters.

                  Available since: 1.1.0

                  Parameters

                  • fn : Function

                    The function to execute for each item.

                    Parameters

                    • key : String

                      The key of collection item.

                    • item : Mixed

                      The collection item.

                    • index : Number

                      The index of item.

                    • len : Number

                      Total length of collection.

                  • scope : Object (optional)

                    The scope (this reference) in which the function is executed. Defaults to the browser window.

                  ...

                  Available since: 4.1.0

                  Enables events fired by this Observable to bubble up an owner hierarchy by calling this.getBubbleTarget() if present. ...

                  Enables events fired by this Observable to bubble up an owner hierarchy by calling this.getBubbleTarget() if present. There is no implementation in the Observable base class.

                  This is commonly used by Ext.Components to bubble events to owner Containers. See Ext.Component.getBubbleTarget. The default implementation in Ext.Component returns the Component's immediate owner. But if a known target is required, this can be overridden to access the required target more quickly.

                  Example:

                  Ext.define('Ext.overrides.form.field.Base', {
                      override: 'Ext.form.field.Base',
                  
                      //  Add functionality to Field's initComponent to enable the change event to bubble
                      initComponent: function () {
                          this.callParent();
                          this.enableBubble('change');
                      }
                  });
                  
                  var myForm = Ext.create('Ext.form.Panel', {
                      title: 'User Details',
                      items: [{
                          ...
                      }],
                      listeners: {
                          change: function() {
                              // Title goes red if form has been modified.
                              myForm.header.setStyle('color', 'red');
                          }
                      }
                  });
                  

                  Available since: 3.4.0

                  Parameters

                  • eventNames : String/String[]

                    The event name to bubble, or an Array of event names.

                  Extracts all of the given property values from the items in the MC. ...

                  Extracts all of the given property values from the items in the MC. Mainly used as a supporting method for functions like sum and collect.

                  Available since: 4.0.0

                  Parameters

                  • property : String

                    The property to extract

                  • root : String (optional)

                    'root' property to extract the first argument from. This is used mainly when extracting field data from Model instances, where the fields are stored inside the 'data' object

                  Returns

                  • Array

                    The extracted values

                  ( property, value, [anyMatch], [caseSensitive] ) : Ext.util.MixedCollection
                  Filters the objects in this collection by a set of Filters, or by a single property/value pair with optional paramete...

                  Filters the objects in this collection by a set of Filters, or by a single property/value pair with optional parameters for substring matching and case sensitivity. See Filter for an example of using Filter objects (preferred). Alternatively, MixedCollection can be easily filtered by property like this:

                  //create a simple store with a few people defined
                  var people = new Ext.util.MixedCollection();
                  people.addAll([
                      {id: 1, age: 25, name: 'Ed'},
                      {id: 2, age: 24, name: 'Tommy'},
                      {id: 3, age: 24, name: 'Arne'},
                      {id: 4, age: 26, name: 'Aaron'}
                  ]);
                  
                  //a new MixedCollection containing only the items where age == 24
                  var middleAged = people.filter('age', 24);
                  

                  Available since: 1.1.0

                  Parameters

                  • property : Ext.util.Filter[]/String

                    A property on your objects, or an array of Filter objects

                  • value : String/RegExp

                    Either string that the property values should start with or a RegExp to test against the property

                  • anyMatch : Boolean (optional)

                    True to match any part of the string, not just the beginning

                    Defaults to: false

                  • caseSensitive : Boolean (optional)

                    True for case sensitive comparison.

                    Defaults to: false

                  Returns

                  Fires

                    Filter by a function. ...

                    Filter by a function. Returns a new collection that has been filtered. The passed function will be called with each object in the collection. If the function returns true, the value is included otherwise it is filtered.

                    Available since: 1.1.0

                    Parameters

                    • fn : Function

                      The function to be called.

                      Parameters

                      • item : Mixed

                        The collection item.

                      • key : String

                        The key of collection item.

                    • scope : Object (optional)

                      The scope (this reference) in which the function is executed. Defaults to this MixedCollection.

                    Returns

                    Returns the first item in the collection which elicits a true return value from the passed selection function. ...

                    Returns the first item in the collection which elicits a true return value from the passed selection function.

                    Available since: 1.1.0

                    This method has been deprecated since 4.0

                    Use findBy instead.

                    Returns the first item in the collection which elicits a true return value from the passed selection function. ...

                    Returns the first item in the collection which elicits a true return value from the passed selection function.

                    Available since: 4.0.0

                    Parameters

                    • fn : Function

                      The selection function to execute for each item.

                      Parameters

                      • item : Mixed

                        The collection item.

                      • key : String

                        The key of collection item.

                    • scope : Object (optional)

                      The scope (this reference) in which the function is executed. Defaults to the browser window.

                    Returns

                    • Object

                      The first item in the collection which returned true from the selection function, or null if none was found.

                    ( property, value, [start], [anyMatch], [caseSensitive] ) : Number
                    Finds the index of the first matching object in this collection by a specific property/value. ...

                    Finds the index of the first matching object in this collection by a specific property/value.

                    Available since: 2.3.0

                    Parameters

                    • property : String

                      The name of a property on your objects.

                    • value : String/RegExp

                      A string that the property values should start with or a RegExp to test against the property.

                    • start : Number (optional)

                      The index to start searching at.

                      Defaults to: 0

                    • anyMatch : Boolean (optional)

                      True to match any part of the string, not just the beginning.

                      Defaults to: false

                    • caseSensitive : Boolean (optional)

                      True for case sensitive comparison.

                      Defaults to: false

                    Returns

                    • Number

                      The matched index or -1

                    Fires

                      Find the index of the first matching object in this collection by a function. ...

                      Find the index of the first matching object in this collection by a function. If the function returns true it is considered a match.

                      Available since: 2.3.0

                      Parameters

                      • fn : Function

                        The function to be called.

                        Parameters

                        • item : Mixed

                          The collection item.

                        • key : String

                          The key of collection item.

                      • scope : Object (optional)

                        The scope (this reference) in which the function is executed. Defaults to this MixedCollection.

                      • start : Number (optional)

                        The index to start searching at.

                        Defaults to: 0

                      Returns

                      • Number

                        The matched index or -1

                      Ext.util.MixedCollection
                      view source
                      ( newItem, [sorterFn] ) : Number
                      Calculates the insertion index of the new item based upon the comparison function passed, or the current sort order. ...

                      Calculates the insertion index of the new item based upon the comparison function passed, or the current sort order.

                      Available since: 4.1.0

                      Parameters

                      • newItem : Object

                        The new object to find the insertion position of.

                      • sorterFn : Function (optional)

                        The function to sort by. This is the same as the sorting function passed to sortBy. It accepts 2 items from this MixedCollection, and returns -1 0, or 1 depending on the relative sort positions of the 2 compared items.

                        If omitted, a function generated from the currently defined set of sorters will be used.

                      Returns

                      • Number

                        The insertion point to add the new item into this MixedCollection at using insert

                      Fires

                        Fires the specified event with the passed parameters (minus the event name, plus the options object passed to addList...

                        Fires the specified event with the passed parameters (minus the event name, plus the options object passed to addListener).

                        An event may be set to bubble up an Observable parent hierarchy (See Ext.Component.getBubbleTarget) by calling enableBubble.

                        Available since: 1.1.0

                        Parameters

                        • eventName : String

                          The name of the event to fire.

                        • args : Object...

                          Variable number of parameters are passed to handlers.

                        Returns

                        • Boolean

                          returns false if any of the handlers return false otherwise it returns true.

                        Fires

                          Returns the first item in the collection. ...

                          Returns the first item in the collection.

                          Available since: 1.1.0

                          Returns

                          • Object

                            the first item in the collection..

                          Returns a comparator function which compares two items and returns -1, 0, or 1 depending on the currently defined set...

                          Returns a comparator function which compares two items and returns -1, 0, or 1 depending on the currently defined set of sorters.

                          If there are no sorters defined, it returns a function which returns 0 meaning that no sorting will occur.

                          Available since: 4.1.0

                          Fires

                            Returns the item associated with the passed key OR index. ...

                            Returns the item associated with the passed key OR index. Key has priority over index. This is the equivalent of calling getByKey first, then if nothing matched calling getAt.

                            Available since: 1.1.0

                            Parameters

                            Returns

                            • Object

                              If the item is found, returns the item. If the item was not found, returns undefined. If an item was found, but is a Class, returns null.

                            Returns the item at the specified index. ...

                            Returns the item at the specified index.

                            Available since: 4.0.0

                            Parameters

                            • index : Number

                              The index of the item.

                            Returns

                            • Object

                              The item at the specified index.

                            Gets the bubbling parent for an Observable ...

                            Gets the bubbling parent for an Observable

                            Available since: 4.0.7

                            Returns

                            Fires

                              Returns the item associated with the passed key. ...

                              Returns the item associated with the passed key.

                              Available since: 4.0.0

                              Parameters

                              Returns

                              • Object

                                The item associated with the passed key.

                              ...

                              Available since: 4.1.0

                              Parameters

                              Returns the number of items in the collection. ...

                              Returns the number of items in the collection.

                              Available since: 1.1.0

                              Returns

                              • Number

                                the number of items in the collection.

                              Gets the first sorter from the sorters collection, excluding any groupers that may be in place ...

                              Gets the first sorter from the sorters collection, excluding any groupers that may be in place

                              Available since: 4.1.1

                              Returns

                              Returns the initial configuration passed to constructor when instantiating this class. ...

                              Returns the initial configuration passed to constructor when instantiating this class.

                              Available since: 4.1.0

                              Parameters

                              • name : String (optional)

                                Name of the config option to return.

                              Returns

                              • Object/Mixed

                                The full config object or a single config value when name parameter specified.

                              MixedCollection has a generic way to fetch keys if you implement getKey. ...

                              MixedCollection has a generic way to fetch keys if you implement getKey. The default implementation simply returns item.id but you can provide your own implementation to return a different value as in the following examples:

                              // normal way
                              var mc = new Ext.util.MixedCollection();
                              mc.add(someEl.dom.id, someEl);
                              mc.add(otherEl.dom.id, otherEl);
                              //and so on
                              
                              // using getKey
                              var mc = new Ext.util.MixedCollection();
                              mc.getKey = function(el){
                                 return el.dom.id;
                              };
                              mc.add(someEl);
                              mc.add(otherEl);
                              
                              // or via the constructor
                              var mc = new Ext.util.MixedCollection(false, function(el){
                                 return el.dom.id;
                              });
                              mc.add(someEl);
                              mc.add(otherEl);
                              

                              Available since: 1.1.0

                              Parameters

                              • item : Object

                                The item for which to find the key.

                              Returns

                              • Object

                                The key for the passed item.

                              Returns a range of items in this collection ...

                              Returns a range of items in this collection

                              Available since: 1.1.0

                              Parameters

                              • startIndex : Number (optional)

                                The starting index. Defaults to 0.

                              • endIndex : Number (optional)

                                The ending index. Defaults to the last item.

                              Returns

                              ...

                              Available since: 4.0.0

                              ...

                              Available since: 4.1.0

                              Parameters

                              Checks to see if this object has any listeners for a specified event, or whether the event bubbles. ...

                              Checks to see if this object has any listeners for a specified event, or whether the event bubbles. The answer indicates whether the event needs firing or not.

                              Available since: 1.1.0

                              Parameters

                              • eventName : String

                                The name of the event to check for

                              Returns

                              • Boolean

                                true if the event is being listened for or bubbles, else false

                              Returns index within the collection of the passed Object. ...

                              Returns index within the collection of the passed Object.

                              Available since: 1.1.0

                              Parameters

                              • o : Object

                                The item to find the index of.

                              Returns

                              • Number

                                index of the item. Returns -1 if not found.

                              Returns index within the collection of the passed key. ...

                              Returns index within the collection of the passed key.

                              Available since: 1.1.0

                              Parameters

                              • key : String

                                The key to find the index of.

                              Returns

                              ( config ) : Ext.Basechainableprotected
                              Initialize configuration for this class. ...

                              Initialize configuration for this class. a typical example:

                              Ext.define('My.awesome.Class', {
                                  // The default config
                                  config: {
                                      name: 'Awesome',
                                      isAwesome: true
                                  },
                              
                                  constructor: function(config) {
                                      this.initConfig(config);
                                  }
                              });
                              
                              var awesome = new My.awesome.Class({
                                  name: 'Super Awesome'
                              });
                              
                              alert(awesome.getName()); // 'Super Awesome'
                              

                              Available since: 4.0.0

                              Parameters

                              Returns

                              Performs initialization of this mixin. ...

                              Performs initialization of this mixin. Component classes using this mixin should call this method during their own initialization.

                              Available since: 4.0.0

                              Fires

                                Inserts an item at the specified index in the collection. ...

                                Inserts an item at the specified index in the collection. Fires the add event when complete.

                                Available since: 1.1.0

                                Parameters

                                • index : Number

                                  The index to insert the item at.

                                • key : String

                                  The key to associate with the new item, or the item itself.

                                • o : Object (optional)

                                  If the second parameter was a key, the new item.

                                Returns

                                Fires

                                Returns the last item in the collection. ...

                                Returns the last item in the collection.

                                Available since: 1.1.0

                                Returns

                                • Object

                                  the last item in the collection..

                                ( item, ename, [fn], [scope], [options] ) : Object
                                Shorthand for addManagedListener. ...

                                Shorthand for addManagedListener.

                                Available since: 4.0.2

                                Parameters

                                • item : Ext.util.Observable/Ext.Element

                                  The item to which to add a listener/listeners.

                                • ename : Object/String

                                  The event name, or an object containing event name properties.

                                • fn : Function (optional)

                                  If the ename parameter was an event name, this is the handler function.

                                • scope : Object (optional)

                                  If the ename parameter was an event name, this is the scope (this reference) in which the handler function is executed.

                                • options : Object (optional)

                                  If the ename parameter was an event name, this is the addListener options.

                                Returns

                                • Object

                                  Only when the destroyable option is specified.

                                  A Destroyable object. An object which implements the destroy method which removes all listeners added in this call. For example:

                                  this.btnListeners =  = myButton.mon({
                                      destroyable: true
                                      mouseover:   function() { console.log('mouseover'); },
                                      mouseout:    function() { console.log('mouseout'); },
                                      click:       function() { console.log('click'); }
                                  });
                                  

                                  And when those listeners need to be removed:

                                  Ext.destroy(this.btnListeners);
                                  

                                  or

                                  this.btnListeners.destroy();
                                  
                                ( item, ename, [fn], [scope] )
                                Shorthand for removeManagedListener. ...

                                Shorthand for removeManagedListener.

                                Available since: 4.0.2

                                Parameters

                                • item : Ext.util.Observable/Ext.Element

                                  The item from which to remove a listener/listeners.

                                • ename : Object/String

                                  The event name, or an object containing event name properties.

                                • fn : Function (optional)

                                  If the ename parameter was an event name, this is the handler function.

                                • scope : Object (optional)

                                  If the ename parameter was an event name, this is the scope (this reference) in which the handler function is executed.

                                ( eventName, [fn], [scope], [options] ) : Object
                                Shorthand for addListener. ...

                                Shorthand for addListener.

                                Available since: 1.1.0

                                Parameters

                                • eventName : String/Object

                                  The name of the event to listen for. May also be an object who's property names are event names.

                                • fn : Function (optional)

                                  The method the event invokes, or if scope is specified, the name* of the method within the specified scope. Will be called with arguments given to fireEvent plus the options parameter described below.

                                • scope : Object (optional)

                                  The scope (this reference) in which the handler function is executed. If omitted, defaults to the object which fired the event.

                                • options : Object (optional)

                                  An object containing handler configuration.

                                  Note: Unlike in ExtJS 3.x, the options object will also be passed as the last argument to every event handler.

                                  This object may contain any of the following properties:

                                  • scope : Object

                                    The scope (this reference) in which the handler function is executed. If omitted, defaults to the object which fired the event.

                                  • delay : Number

                                    The number of milliseconds to delay the invocation of the handler after the event fires.

                                  • single : Boolean

                                    True to add a handler to handle just the next firing of the event, and then remove itself.

                                  • buffer : Number

                                    Causes the handler to be scheduled to run in an Ext.util.DelayedTask delayed by the specified number of milliseconds. If the event fires again within that time, the original handler is not invoked, but the new handler is scheduled in its place.

                                  • target : Ext.util.Observable

                                    Only call the handler if the event was fired on the target Observable, not if the event was bubbled up from a child Observable.

                                  • element : String

                                    This option is only valid for listeners bound to Components. The name of a Component property which references an element to add a listener to.

                                    This option is useful during Component construction to add DOM event listeners to elements of Components which will exist only after the Component is rendered. For example, to add a click listener to a Panel's body:

                                      new Ext.panel.Panel({
                                          title: 'The title',
                                          listeners: {
                                              click: this.handlePanelClick,
                                              element: 'body'
                                          }
                                      });
                                    
                                  • destroyable : Boolean (optional)

                                    When specified as true, the function returns A Destroyable object. An object which implements the destroy method which removes all listeners added in this call.

                                    Combining Options

                                    Using the options argument, it is possible to combine different types of listeners:

                                    A delayed, one-time listener.

                                    myPanel.on('hide', this.handleClick, this, {
                                        single: true,
                                        delay: 100
                                    });
                                    

                                    Defaults to: false

                                Returns

                                • Object

                                  Only when the destroyable option is specified.

                                  A Destroyable object. An object which implements the destroy method which removes all listeners added in this call. For example:

                                  this.btnListeners =  = myButton.on({
                                      destroyable: true
                                      mouseover:   function() { console.log('mouseover'); },
                                      mouseout:    function() { console.log('mouseout'); },
                                      click:       function() { console.log('click'); }
                                  });
                                  

                                  And when those listeners need to be removed:

                                  Ext.destroy(this.btnListeners);
                                  

                                  or

                                  this.btnListeners.destroy();
                                  
                                ...

                                Available since: 4.0.0

                                ( names, callback, scope )private
                                ...

                                Available since: 4.1.0

                                Parameters

                                Prepares a given class for observable instances. ...

                                Prepares a given class for observable instances. This method is called when a class derives from this class or uses this class as a mixin.

                                Available since: 4.1.2

                                Parameters

                                • T : Function

                                  The class constructor to prepare.

                                Relays selected events from the specified Observable as if the events were fired by this. ...

                                Relays selected events from the specified Observable as if the events were fired by this.

                                For example if you are extending Grid, you might decide to forward some events from store. So you can do this inside your initComponent:

                                this.relayEvents(this.getStore(), ['load']);
                                

                                The grid instance will then have an observable 'load' event which will be passed the parameters of the store's load event and any function fired with the grid's load event would have access to the grid using the this keyword.

                                Available since: 2.3.0

                                Parameters

                                • origin : Object

                                  The Observable whose events this object is to relay.

                                • events : String[]

                                  Array of event names to relay.

                                • prefix : String (optional)

                                  A common prefix to prepend to the event names. For example:

                                  this.relayEvents(this.getStore(), ['load', 'clear'], 'store');
                                  

                                  Now the grid will forward 'load' and 'clear' events of store as 'storeload' and 'storeclear'.

                                Returns

                                • Object

                                  A Destroyable object. An object which implements the destroy method which, when destroyed, removes all relayers. For example:

                                  this.storeRelayers = this.relayEvents(this.getStore(), ['load', 'clear'], 'store');
                                  

                                  Can be undone by calling

                                  Ext.destroy(this.storeRelayers);
                                  

                                  or

                                  this.store.relayers.destroy();
                                  

                                Fires

                                  Remove an item from the collection. ...

                                  Remove an item from the collection.

                                  Available since: 1.1.0

                                  Parameters

                                  • o : Object

                                    The item to remove.

                                  Returns

                                  • Object

                                    The item removed or false if no item was removed.

                                  Fires

                                  Remove all items in the passed array from the collection. ...

                                  Remove all items in the passed array from the collection.

                                  Available since: 4.0.0

                                  Parameters

                                  • items : Array

                                    An array of items to be removed.

                                  Returns

                                  Fires

                                  Remove an item from a specified index in the collection. ...

                                  Remove an item from a specified index in the collection. Fires the remove event when complete.

                                  Available since: 1.1.0

                                  Parameters

                                  • index : Number

                                    The index within the collection of the item to remove.

                                  Returns

                                  • Object

                                    The item removed or false if no item was removed.

                                  Fires

                                  Removed an item associated with the passed key fom the collection. ...

                                  Removed an item associated with the passed key fom the collection.

                                  Available since: 4.0.0

                                  Parameters

                                  • key : String

                                    The key of the item to remove.

                                  Returns

                                  • Object

                                    The item removed or false if no item was removed.

                                  Fires

                                  Removes an event handler. ...

                                  Removes an event handler.

                                  Available since: 1.1.0

                                  Parameters

                                  • eventName : String

                                    The type of event the handler was associated with.

                                  • fn : Function

                                    The handler to remove. This must be a reference to the function passed into the addListener call.

                                  • scope : Object (optional)

                                    The scope originally specified for the handler. It must be the same as the scope argument specified in the original call to addListener or the listener will not be removed.

                                  Fires

                                    Removes listeners that were added by the mon method. ...

                                    Removes listeners that were added by the mon method.

                                    Available since: 4.0.0

                                    Parameters

                                    • item : Ext.util.Observable/Ext.Element

                                      The item from which to remove a listener/listeners.

                                    • ename : Object/String

                                      The event name, or an object containing event name properties.

                                    • fn : Function (optional)

                                      If the ename parameter was an event name, this is the handler function.

                                    • scope : Object (optional)

                                      If the ename parameter was an event name, this is the scope (this reference) in which the handler function is executed.

                                    Fires

                                      Remove a single managed listener item ...

                                      Remove a single managed listener item

                                      Available since: 4.0.1

                                      Parameters

                                      • isClear : Boolean

                                        True if this is being called during a clear

                                      • managedListener : Object

                                        The managed listener item See removeManagedListener for other args

                                      Overrides: Ext.AbstractComponent.removeManagedListenerItem

                                      Ext.util.MixedCollection
                                      view source
                                      ( mapping )
                                      Reorders each of the items based on a mapping from old index to new index. ...

                                      Reorders each of the items based on a mapping from old index to new index. Internally this just translates into a sort. The 'sort' event is fired whenever reordering has occured.

                                      Available since: 3.4.0

                                      Parameters

                                      • mapping : Object

                                        Mapping from old item index to new item index

                                      Fires

                                      Replaces an item in the collection. ...

                                      Replaces an item in the collection. Fires the replace event when complete.

                                      Available since: 1.1.0

                                      Parameters

                                      • key : String

                                        The key associated with the item to replace, or the replacement item.

                                        If you supplied a getKey implementation for this MixedCollection, or if the key of your stored items is in a property called id, then the MixedCollection will be able to derive the key of the replacement item. If you want to replace an item with one having the same key value, then just pass the replacement item in this parameter.

                                      • o : Object

                                        {Object} o (optional) If the first parameter passed was a key, the item to associate with that key.

                                      Returns

                                      Fires

                                      Resumes firing events (see suspendEvents). ...

                                      Resumes firing events (see suspendEvents).

                                      If events were suspended using the queueSuspended parameter, then all events fired during event suspension will be sent to any listeners now.

                                      Available since: 2.3.0

                                      ( config, applyIfNotSet ) : Ext.Basechainableprivate
                                      ...

                                      Available since: 4.0.0

                                      Parameters

                                      Returns

                                      Sorts the data in the Store by one or more of its properties. ...

                                      Sorts the data in the Store by one or more of its properties. Example usage:

                                      //sort by a single field
                                      myStore.sort('myField', 'DESC');
                                      
                                      //sorting by multiple fields
                                      myStore.sort([
                                          {
                                              property : 'age',
                                              direction: 'ASC'
                                          },
                                          {
                                              property : 'name',
                                              direction: 'DESC'
                                          }
                                      ]);
                                      

                                      Internally, Store converts the passed arguments into an array of Ext.util.Sorter instances, and delegates the actual sorting to its internal Ext.util.MixedCollection.

                                      When passing a single string argument to sort, Store maintains a ASC/DESC toggler per field, so this code:

                                      store.sort('myField');
                                      store.sort('myField');
                                      

                                      Is equivalent to this code, because Store handles the toggling automatically:

                                      store.sort('myField', 'ASC');
                                      store.sort('myField', 'DESC');
                                      

                                      Available since: 4.0.0

                                      Parameters

                                      • sorters : String/Ext.util.Sorter[] (optional)

                                        Either a string name of one of the fields in this Store's configured Model, or an array of sorter configurations.

                                      • direction : String (optional)

                                        The overall direction to sort the data by.

                                        Defaults to: "ASC"

                                      Returns

                                      Fires

                                      • beforeload
                                      • beforesort
                                      • datachanged
                                      • refresh
                                      • sort
                                      Ext.util.MixedCollection
                                      view source
                                      ( sorterFn )
                                      Sorts the collection by a single sorter function ...

                                      Sorts the collection by a single sorter function

                                      Available since: 4.0.0

                                      Parameters

                                      • sorterFn : Function

                                        The function to sort by

                                      Fires

                                      • sort
                                      Ext.util.MixedCollection
                                      view source
                                      ( [direction], [fn] )
                                      Sorts this collection by keys. ...

                                      Sorts this collection by keys.

                                      Available since: 4.0.0

                                      Parameters

                                      • direction : String (optional)

                                        'ASC' or 'DESC'. Defaults to 'ASC'.

                                      • fn : Function (optional)

                                        Comparison function that defines the sort order. Defaults to sorting by case insensitive string.

                                      Fires

                                      • sort
                                      Get the reference to the class from which this object was instantiated. ...

                                      Get the reference to the class from which this object was instantiated. Note that unlike self, this.statics() is scope-independent and it always returns the class from which it was called, regardless of what this points to during run-time

                                      Ext.define('My.Cat', {
                                          statics: {
                                              totalCreated: 0,
                                              speciesName: 'Cat' // My.Cat.speciesName = 'Cat'
                                          },
                                      
                                          constructor: function() {
                                              var statics = this.statics();
                                      
                                              alert(statics.speciesName);     // always equals to 'Cat' no matter what 'this' refers to
                                                                              // equivalent to: My.Cat.speciesName
                                      
                                              alert(this.self.speciesName);   // dependent on 'this'
                                      
                                              statics.totalCreated++;
                                          },
                                      
                                          clone: function() {
                                              var cloned = new this.self;                      // dependent on 'this'
                                      
                                              cloned.groupName = this.statics().speciesName;   // equivalent to: My.Cat.speciesName
                                      
                                              return cloned;
                                          }
                                      });
                                      
                                      
                                      Ext.define('My.SnowLeopard', {
                                          extend: 'My.Cat',
                                      
                                          statics: {
                                              speciesName: 'Snow Leopard'     // My.SnowLeopard.speciesName = 'Snow Leopard'
                                          },
                                      
                                          constructor: function() {
                                              this.callParent();
                                          }
                                      });
                                      
                                      var cat = new My.Cat();                 // alerts 'Cat', then alerts 'Cat'
                                      
                                      var snowLeopard = new My.SnowLeopard(); // alerts 'Cat', then alerts 'Snow Leopard'
                                      
                                      var clone = snowLeopard.clone();
                                      alert(Ext.getClassName(clone));         // alerts 'My.SnowLeopard'
                                      alert(clone.groupName);                 // alerts 'Cat'
                                      
                                      alert(My.Cat.totalCreated);             // alerts 3
                                      

                                      Available since: 4.0.0

                                      Returns

                                      ( property, [root], [start], [end] ) : Number
                                      Collects all of the values of the given property and returns their sum ...

                                      Collects all of the values of the given property and returns their sum

                                      Available since: 4.0.0

                                      Parameters

                                      • property : String

                                        The property to sum by

                                      • root : String (optional)

                                        'root' property to extract the first argument from. This is used mainly when summing fields in records, where the fields are all stored inside the 'data' object

                                      • start : Number (optional)

                                        The record index to start at

                                        Defaults to: 0

                                      • end : Number (optional)

                                        The record index to end at

                                        Defaults to: -1

                                      Returns

                                      Fires

                                        Suspends the firing of all events. ...

                                        Suspends the firing of all events. (see resumeEvents)

                                        Available since: 2.3.0

                                        Parameters

                                        • queueSuspended : Boolean

                                          Pass as true to queue up suspended events to be fired after the resumeEvents call instead of discarding all suspended events.

                                        ( eventName, fn, [scope] )
                                        Shorthand for removeListener. ...

                                        Shorthand for removeListener.

                                        Available since: 1.1.0

                                        Parameters

                                        • eventName : String

                                          The type of event the handler was associated with.

                                        • fn : Function

                                          The handler to remove. This must be a reference to the function passed into the addListener call.

                                        • scope : Object (optional)

                                          The scope originally specified for the handler. It must be the same as the scope argument specified in the original call to addListener or the listener will not be removed.

                                        Defined By

                                        Static methods

                                        ( config )privatestatic
                                        ...

                                        Available since: 4.1.1

                                        Parameters

                                        ( members )chainableprivatestatic
                                        ...

                                        Available since: 4.1.1

                                        Parameters

                                        ( name, member )chainableprivatestatic
                                        ...

                                        Available since: 4.1.1

                                        Parameters

                                        ( members )chainablestatic
                                        Add methods / properties to the prototype of this class. ...

                                        Add methods / properties to the prototype of this class.

                                        Ext.define('My.awesome.Cat', {
                                            constructor: function() {
                                                ...
                                            }
                                        });
                                        
                                         My.awesome.Cat.addMembers({
                                             meow: function() {
                                                alert('Meowww...');
                                             }
                                         });
                                        
                                         var kitty = new My.awesome.Cat;
                                         kitty.meow();
                                        

                                        Available since: 4.1.0

                                        Parameters

                                        ( members ) : Ext.Basechainablestatic
                                        Add / override static properties of this class. ...

                                        Add / override static properties of this class.

                                        Ext.define('My.cool.Class', {
                                            ...
                                        });
                                        
                                        My.cool.Class.addStatics({
                                            someProperty: 'someValue',      // My.cool.Class.someProperty = 'someValue'
                                            method1: function() { ... },    // My.cool.Class.method1 = function() { ... };
                                            method2: function() { ... }     // My.cool.Class.method2 = function() { ... };
                                        });
                                        

                                        Available since: 4.0.2

                                        Parameters

                                        Returns

                                        ( xtype )chainableprivatestatic
                                        ...

                                        Available since: 4.1.1

                                        Parameters

                                        ( fromClass, members ) : Ext.Basechainableprivatestatic
                                        Borrow another class' members to the prototype of this class. ...

                                        Borrow another class' members to the prototype of this class.

                                        Ext.define('Bank', {
                                            money: '$$$',
                                            printMoney: function() {
                                                alert('$$$$$$$');
                                            }
                                        });
                                        
                                        Ext.define('Thief', {
                                            ...
                                        });
                                        
                                        Thief.borrow(Bank, ['money', 'printMoney']);
                                        
                                        var steve = new Thief();
                                        
                                        alert(steve.money); // alerts '$$$'
                                        steve.printMoney(); // alerts '$$$$$$$'
                                        

                                        Available since: 4.0.2

                                        Parameters

                                        • fromClass : Ext.Base

                                          The class to borrow members from

                                        • members : Array/String

                                          The names of the members to borrow

                                        Returns

                                        Create a new instance of this Class. ...

                                        Create a new instance of this Class.

                                        Ext.define('My.cool.Class', {
                                            ...
                                        });
                                        
                                        My.cool.Class.create({
                                            someConfig: true
                                        });
                                        

                                        All parameters are passed to the constructor of the class.

                                        Available since: 4.0.2

                                        Returns

                                        Overrides: Ext.layout.Layout.create

                                        ( alias, origin )static
                                        Create aliases for existing prototype methods. ...

                                        Create aliases for existing prototype methods. Example:

                                        Ext.define('My.cool.Class', {
                                            method1: function() { ... },
                                            method2: function() { ... }
                                        });
                                        
                                        var test = new My.cool.Class();
                                        
                                        My.cool.Class.createAlias({
                                            method3: 'method1',
                                            method4: 'method2'
                                        });
                                        
                                        test.method3(); // test.method1()
                                        
                                        My.cool.Class.createAlias('method5', 'method3');
                                        
                                        test.method5(); // test.method3() -> test.method1()
                                        

                                        Available since: 4.0.2

                                        Parameters

                                        ( config )privatestatic
                                        ...

                                        Available since: 4.1.1

                                        Parameters

                                        Get the current class' name in string format. ...

                                        Get the current class' name in string format.

                                        Ext.define('My.cool.Class', {
                                            constructor: function() {
                                                alert(this.self.getName()); // alerts 'My.cool.Class'
                                            }
                                        });
                                        
                                        My.cool.Class.getName(); // 'My.cool.Class'
                                        

                                        Available since: 4.0.4

                                        Returns

                                        ( )deprecatedstatic
                                        Adds members to class. ...

                                        Adds members to class.

                                        Available since: 4.0.2

                                        This method has been deprecated since 4.1

                                        Use addMembers instead.

                                        ( name, mixinClass )chainableprivatestatic
                                        Used internally by the mixins pre-processor ...

                                        Used internally by the mixins pre-processor

                                        Available since: 4.1.1

                                        Parameters

                                        ( fn, scope )chainableprivatestatic
                                        ...

                                        Available since: 4.1.1

                                        Parameters

                                        ( members ) : Ext.Basechainabledeprecatedstatic
                                        Override members of this class. ...

                                        Override members of this class. Overridden methods can be invoked via callParent.

                                        Ext.define('My.Cat', {
                                            constructor: function() {
                                                alert("I'm a cat!");
                                            }
                                        });
                                        
                                        My.Cat.override({
                                            constructor: function() {
                                                alert("I'm going to be a cat!");
                                        
                                                this.callParent(arguments);
                                        
                                                alert("Meeeeoooowwww");
                                            }
                                        });
                                        
                                        var kitty = new My.Cat(); // alerts "I'm going to be a cat!"
                                                                  // alerts "I'm a cat!"
                                                                  // alerts "Meeeeoooowwww"
                                        

                                        As of 4.1, direct use of this method is deprecated. Use Ext.define instead:

                                        Ext.define('My.CatOverride', {
                                            override: 'My.Cat',
                                            constructor: function() {
                                                alert("I'm going to be a cat!");
                                        
                                                this.callParent(arguments);
                                        
                                                alert("Meeeeoooowwww");
                                            }
                                        });
                                        

                                        The above accomplishes the same result but can be managed by the Ext.Loader which can properly order the override and its target class and the build process can determine whether the override is needed based on the required state of the target class (My.Cat).

                                        Available since: 4.0.2

                                        This method has been deprecated since 4.1.0

                                        Use Ext.define instead

                                        Parameters

                                        • members : Object

                                          The properties to add to this class. This should be specified as an object literal containing one or more properties.

                                        Returns

                                        ...

                                        Available since: 4.1.1

                                        Defined By

                                        Events

                                        Fires when an item is added to the collection. ...

                                        Fires when an item is added to the collection.

                                        Available since: 1.1.0

                                        Parameters

                                        Fires when the collection is cleared. ...

                                        Fires when the collection is cleared.

                                        Available since: 1.1.0

                                        Parameters

                                        Fires when an item is removed from the collection. ...

                                        Fires when an item is removed from the collection.

                                        Available since: 1.1.0

                                        Parameters

                                        Fires when an item is replaced in the collection. ...

                                        Fires when an item is replaced in the collection.

                                        Available since: 1.1.0

                                        Parameters