Class Ext.CompositeElement

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

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

This class has no public properties.

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`	CompositeElement
	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`	CompositeElement
	each( `Function fn`, [`Object scope`] ) : CompositeElement Calls the passed function passing (el, this, index) for each element in this composite. Calls the passed function passing (el, this, index) for each element in this composite. Parameters: `fn` : Function The function to call `scope` : Object (optional) The this object (defaults to the element) Returns: `CompositeElement` this	CompositeElement
	fill( `String/Array els` ) : CompositeElement Clears this composite and adds the elements returned by the passed selector. Clears this composite and adds the elements returned by the passed selector. Parameters: `els` : String/Array A string CSS selector, an array of elements or an element Returns: `CompositeElement` this	CompositeElement
	filter( `String 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 A string CSS selector 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( `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.	CompositeElement
	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`	CompositeElement
	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	CompositeElement
	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	CompositeElement

Public Events

This class has no public events.