Class Ext.CompositeElement

Package:	Ext
Defined In:	CompositeElement.js
Class:	CompositeElement
Extends:	Object

This class encapsulates a collection of DOM elements, providing methods to filter members, or to perform collective actions upon the whole set.

Example:

var els = Ext.select("#some-el div.some-class");
// or select directly from an existing element
var el = Ext.get('some-el');
el.select('div.some-class');

els.setWidth(100); // all elements become 100 width
els.hide(true); // all elements fade out and hide
// or
els.setWidth(100).hide(true);

Public Properties

Property		Defined By
	elements : Array The Array of DOM elements which this CompositeElement encapsulates. Read-only. This will not usually be accessed in d... The Array of DOM elements which this CompositeElement encapsulates. Read-only. This will not usually be accessed in developers' code, but developers wishing to augment the capabilities of the CompositeElement class may use it when adding methods to the class. For example to add the `nextAll` method to the class to add all following siblings of selected elements, the code would be `Ext.override(Ext.CompositeElement, { nextAll: function() { var els = this.elements, i, l = els.length, n, r = [], ri = -1; // Loop through all elements in this Composite, accumulating // an Array of all siblings. for (i = 0; i < l; i++) { for (n = els[i].nextSibling; n; n = n.nextSibling) { r[++ri] = n; } } // Add all found siblings to this Composite return this.add(r); } });`	CompositeElement

Public Methods

Method		Defined By
	add( `Mixed els` ) : CompositeElement Adds elements to this Composite object. Adds elements to this Composite object. Parameters: `els` : Mixed Either an Array of DOM elements to add, or another Composite object who's elements should be added. Returns: `CompositeElement` This Composite object.	CompositeElement
	clear() : void Removes all elements. Removes all elements. Parameters: None. Returns: void	CompositeElement
	contains( `Mixed el` ) : Boolean Returns true if this composite contains the passed element Returns true if this composite contains the passed element Parameters: `el` : Mixed The id of an element, or an Ext.Element, or an HtmlElement to find within the composite collection. Returns: `Boolean`	CompositeElement
	each( `Function fn`, [`Object scope`] ) : CompositeElement Calls the passed function for each element in this composite. Calls the passed function for each element in this composite. Parameters: `fn` : Function The function to call. The function is passed the following parameters: el : Element The current Element in the iteration. This is the flyweight (shared) Ext.Element instance, so if you require a a reference to the dom node, use el.dom. c : Composite This Composite object. idx : Number The zero-based index in the iteration. `scope` : Object (optional) The scope (this reference) in which the function is executed. (defaults to the Element) Returns: `CompositeElement` this	CompositeElement
	fill( `Mixed els` ) : CompositeElement Clears this Composite and adds the elements passed. Clears this Composite and adds the elements passed. Parameters: `els` : Mixed Either an array of DOM elements, or another Composite from which to fill this Composite. Returns: `CompositeElement` this	CompositeElement
	filter( `String/Function selector` ) : CompositeElement Filters this composite to only elements that match the passed selector. Filters this composite to only elements that match the passed selector. Parameters: `selector` : String/Function A string CSS selector or a comparison function. The comparison function will be called with the following arguments: `el` : Ext.Element The current DOM element. `index` : Number The current index within the collection. Returns: `CompositeElement` this	CompositeElement
	first() : Ext.Element Returns the first Element Returns the first Element Parameters: None. Returns: `Ext.Element`	CompositeElement
	getCount() : Number Returns the number of elements in this Composite. Returns the number of elements in this Composite. Parameters: None. Returns: `Number`	CompositeElement
	indexOf( `Mixed el` ) : Number Find the index of the passed element within the composite collection. Find the index of the passed element within the composite collection. Parameters: `el` : Mixed The id of an element, or an Ext.Element, or an HtmlElement to find within the composite collection. Returns: `Number` The index of the passed Ext.Element in the composite collection, or -1 if not found.	CompositeElement
	item( `Number index` ) : Ext.Element Returns a flyweight Element of the dom element object at the specified index Returns a flyweight Element of the dom element object at the specified index Parameters: `index` : Number Returns: `Ext.Element`	CompositeElement
	last() : Ext.Element Returns the last Element Returns the last Element Parameters: None. Returns: `Ext.Element`	CompositeElement

Public Events

This class has no public events.