/*
|
This file is part of Ext JS 4.2
|
|
Copyright (c) 2011-2013 Sencha Inc
|
|
Contact: http://www.sencha.com/contact
|
|
GNU General Public License Usage
|
This file may be used under the terms of the GNU General Public License version 3.0 as
|
published by the Free Software Foundation and appearing in the file LICENSE included in the
|
packaging of this file.
|
|
Please review the following information to ensure the GNU General Public License version 3.0
|
requirements will be met: http://www.gnu.org/copyleft/gpl.html.
|
|
If you are unsure which license is appropriate for your use, please contact the sales department
|
at http://www.sencha.com/contact.
|
|
Build date: 2013-05-16 14:36:50 (f9be68accb407158ba2b1be2c226a6ce1f649314)
|
*/
|
// @tag dom,core
|
/**
|
* @class Ext.dom.CompositeElement
|
* <p>This class encapsulates a <i>collection</i> of DOM elements, providing methods to filter
|
* members, or to perform collective actions upon the whole set.</p>
|
* <p>Although they are not listed, this class supports all of the methods of {@link Ext.dom.Element} and
|
* {@link Ext.fx.Anim}. The methods from these classes will be performed on all the elements in this collection.</p>
|
* <p>All methods return <i>this</i> and can be chained.</p>
|
* Usage:
|
<pre><code>
|
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);
|
</code></pre>
|
*/
|
Ext.define('Ext.dom.CompositeElement', {
|
alternateClassName: 'Ext.CompositeElement',
|
|
extend: 'Ext.dom.CompositeElementLite',
|
|
// private
|
getElement: function(el) {
|
// In this case just return it, since we already have a reference to it
|
return el;
|
},
|
|
// private
|
transformElement: function(el) {
|
return Ext.get(el);
|
}
|
|
}, function() {
|
/**
|
* Selects elements based on the passed CSS selector to enable {@link Ext.Element Element} methods
|
* to be applied to many related elements in one statement through the returned {@link Ext.CompositeElement CompositeElement} or
|
* {@link Ext.CompositeElementLite CompositeElementLite} object.
|
* @param {String/HTMLElement[]} selector The CSS selector or an array of elements
|
* @param {Boolean} [unique] true to create a unique Ext.Element for each element (defaults to a shared flyweight object)
|
* @param {HTMLElement/String} [root] The root element of the query or id of the root
|
* @return {Ext.CompositeElementLite/Ext.CompositeElement}
|
* @member Ext.dom.Element
|
* @method select
|
* @static
|
*/
|
|
Ext.dom.Element.select = function(selector, unique, root) {
|
var elements;
|
|
if (typeof selector == "string") {
|
elements = Ext.dom.Element.selectorFunction(selector, root);
|
}
|
else if (selector.length !== undefined) {
|
elements = selector;
|
}
|
else {
|
//<debug>
|
throw new Error("[Ext.select] Invalid selector specified: " + selector);
|
//</debug>
|
}
|
return (unique === true) ? new Ext.CompositeElement(elements) : new Ext.CompositeElementLite(elements);
|
};
|
});
|
|
/**
|
* Shorthand of {@link Ext.Element#method-select}.
|
* @member Ext
|
* @method select
|
* @inheritdoc Ext.Element#select
|
*/
|
Ext.select = Ext.Element.select;
|
