CompositeElementLite  CompositeElement

Class Ext.CompositeElement

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

Standard composite class. Creates a Ext.Element for every element in the collection.

NOTE: Although they are not listed, this class supports all of the set/update methods of Ext.Element. All Ext.Element actions will be performed on all the elements in this collection.

All methods return this and can be chained.

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

 var el = Ext.get('some-el');
 el.select('div.some-class', true);

 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 ... 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 CompositeElementLite 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.CompositeElementLite, { 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); } });`	CompositeElementLite

Public Methods

Method		Defined By
	add( `String/Array els` ) : CompositeElement Adds elements to this composite. Adds elements to this composite. Parameters: `els` : String/Array A string CSS selector, an array of elements or an element Returns: `CompositeElement` this	CompositeElement
	clear() : void Removes all elements. Removes all elements. Parameters: None. Returns: void	CompositeElementLite
	contains( `el {Mixed}` ) : Boolean Returns true if this composite contains the passed element Returns true if this composite contains the passed element Parameters: `{Mixed}` : el The id of an element, or an Ext.Element, or an HtmlElement to find within the composite collection. Returns: `Boolean`	CompositeElementLite
	each( `Function fn`, [`Object scope`] ) : CompositeElement Iterates each element in this composite calling the supplied function using Ext.each. Iterates each `element` in this `composite` calling the supplied function using Ext.each. Parameters: `fn` : Function The function to be called with each `element`. If the supplied function returns `false`, iteration stops. This function is called with the following arguments: `element` : Object The element at the current `index` in the `composite` `composite` : Object This composite. `index` : Number The current index within the `composite` `scope` : Object (optional) The scope to call the specified function. Defaults to the `element` at the current `index` within the composite. 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	CompositeElementLite
	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	CompositeElementLite
	first() : Ext.Element Returns the first Element Returns the first Element Parameters: None. Returns: `Ext.Element`	CompositeElementLite
	getCount() : Number Returns the number of elements in this Composite. Returns the number of elements in this Composite. Parameters: None. Returns: `Number`	CompositeElementLite
	indexOf( `el {Mixed}` ) : Number Find the index of the passed element within the composite collection. Find the index of the passed element within the composite collection. Parameters: `{Mixed}` : el 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.	CompositeElementLite
	item( `Number index` ) : Ext.Element Returns the Element object at the specified index Returns the 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`	CompositeElementLite
	removeElement( `Mixed el`, [`Boolean removeDom`] ) : CompositeElement Removes the specified element(s). Removes the specified element(s). Parameters: `el` : Mixed The id of an element, the Element itself, the index of the element in this composite or an array of any of those. `removeDom` : Boolean (optional) True to also remove the element from the document Returns: `CompositeElement` this	CompositeElementLite
	replaceElement( `Mixed el`, `Mixed replacement`, [`Boolean domReplace`] ) : CompositeElement Replaces the specified element with the passed element. Replaces the specified element with the passed element. Parameters: `el` : Mixed The id of an element, the Element itself, the index of the element in this composite to replace. `replacement` : Mixed The id of an element or the Element itself. `domReplace` : Boolean (Optional) True to remove and replace the element in the document too. Returns: `CompositeElement` this	CompositeElementLite

Public Events

This class has no public events.