This class encapsulates a collection of DOM elements, providing methods to filter -members, or to perform collective actions upon the whole set.
- - -Although they are not listed, this class supports all of the methods of Ext.core.Element and -Ext.fx.Anim. The methods from these classes will be performed on all the elements in this collection.
- - -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);
-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);
- }
-});
-
-
-
-Adds elements to this Composite object.
-Adds elements to this Composite object.
-Either an Array of DOM elements to add, or another Composite object who's elements should be added.
-This Composite object.
-Returns true if this composite contains the passed element
-Returns true if this composite contains the passed element
-{Mixed} The id of an element, or an Ext.core.Element, or an HtmlElement to find within the composite collection.
-Boolean
-Calls the passed function for each element in this composite.
- -Calls the passed function for each element in this composite.
- -The function to call. The function is passed the following parameters:
(optional) The scope (this reference) in which the function is executed. (defaults to the Element)
-this
-Clears this Composite and adds the elements passed.
-Clears this Composite and adds the elements passed.
-Either an array of DOM elements, or another Composite from which to fill this Composite.
-this
-Filters this composite to only elements that match the passed selector.
-Filters this composite to only elements that match the passed selector.
-A string CSS selector or a comparison function. -The comparison function will be called with the following arguments:
el : Ext.core.Elementindex : Numberthis
-Returns the number of elements in this Composite.
-Returns the number of elements in this Composite.
-Number
-Find the index of the passed element within the composite collection.
-Find the index of the passed element within the composite collection.
-{Mixed} The id of an element, or an Ext.core.Element, or an HtmlElement to find within the composite collection.
-Number The index of the passed Ext.core.Element in the composite collection, or -1 if not found.
-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
-Removes the specified element(s).
-Removes the specified element(s).
-The id of an element, the Element itself, the index of the element in this composite -or an array of any of those.
-(optional) True to also remove the element from the document
-this
-Replaces the specified element with the passed element.
-Replaces the specified element with the passed element.
-The id of an element, the Element itself, the index of the element in this composite -to replace.
-The id of an element or the Element itself.
-(Optional) True to remove and replace the element in the document too.
-this
-