Roo/Element.js
[roojs1] / Roo / Element.js
1 /*
2  * Based on:
3  * Ext JS Library 1.1.1
4  * Copyright(c) 2006-2007, Ext JS, LLC.
5  *
6  * Originally Released Under LGPL - original licence link has changed is not relivant.
7  *
8  * Fork - LGPL
9  * <script type="text/javascript">
10  */
11
12  
13 // was in Composite Element!??!?!
14  
15 (function(){
16     var D = Roo.lib.Dom;
17     var E = Roo.lib.Event;
18     var A = Roo.lib.Anim;
19
20     // local style camelizing for speed
21     var propCache = {};
22     var camelRe = /(-[a-z])/gi;
23     var camelFn = function(m, a){ return a.charAt(1).toUpperCase(); };
24     var view = document.defaultView;
25
26 /**
27  * @class Roo.Element
28  * Represents an Element in the DOM.<br><br>
29  * Usage:<br>
30 <pre><code>
31 var el = Roo.get("my-div");
32
33 // or with getEl
34 var el = getEl("my-div");
35
36 // or with a DOM element
37 var el = Roo.get(myDivElement);
38 </code></pre>
39  * Using Roo.get() or getEl() instead of calling the constructor directly ensures you get the same object
40  * each call instead of constructing a new one.<br><br>
41  * <b>Animations</b><br />
42  * Many of the functions for manipulating an element have an optional "animate" parameter. The animate parameter
43  * should either be a boolean (true) or an object literal with animation options. The animation options are:
44 <pre>
45 Option    Default   Description
46 --------- --------  ---------------------------------------------
47 duration  .35       The duration of the animation in seconds
48 easing    easeOut   The YUI easing method
49 callback  none      A function to execute when the anim completes
50 scope     this      The scope (this) of the callback function
51 </pre>
52 * Also, the Anim object being used for the animation will be set on your options object as "anim", which allows you to stop or
53 * manipulate the animation. Here's an example:
54 <pre><code>
55 var el = Roo.get("my-div");
56
57 // no animation
58 el.setWidth(100);
59
60 // default animation
61 el.setWidth(100, true);
62
63 // animation with some options set
64 el.setWidth(100, {
65     duration: 1,
66     callback: this.foo,
67     scope: this
68 });
69
70 // using the "anim" property to get the Anim object
71 var opt = {
72     duration: 1,
73     callback: this.foo,
74     scope: this
75 };
76 el.setWidth(100, opt);
77 ...
78 if(opt.anim.isAnimated()){
79     opt.anim.stop();
80 }
81 </code></pre>
82 * <b> Composite (Collections of) Elements</b><br />
83  * For working with collections of Elements, see <a href="Roo.CompositeElement.html">Roo.CompositeElement</a>
84  * @constructor Create a new Element directly.
85  * @param {String/HTMLElement} element
86  * @param {Boolean} forceNew (optional) By default the constructor checks to see if there is already an instance of this element in the cache and if there is it returns the same instance. This will skip that check (useful for extending this class).
87  */
88     Roo.Element = function(element, forceNew){
89         var dom = typeof element == "string" ?
90                 document.getElementById(element) : element;
91         if(!dom){ // invalid id/element
92             return null;
93         }
94         var id = dom.id;
95         if(forceNew !== true && id && Roo.Element.cache[id]){ // element object already exists
96             return Roo.Element.cache[id];
97         }
98
99         /**
100          * The DOM element
101          * @type HTMLElement
102          */
103         this.dom = dom;
104
105         /**
106          * The DOM element ID
107          * @type String
108          */
109         this.id = id || Roo.id(dom);
110     };
111
112     var El = Roo.Element;
113
114     El.prototype = {
115         /**
116          * The element's default display mode  (defaults to "")
117          * @type String
118          */
119         originalDisplay : "",
120
121         visibilityMode : 1,
122         /**
123          * The default unit to append to CSS values where a unit isn't provided (defaults to px).
124          * @type String
125          */
126         defaultUnit : "px",
127         
128         /**
129          * Sets the element's visibility mode. When setVisible() is called it
130          * will use this to determine whether to set the visibility or the display property.
131          * @param visMode Element.VISIBILITY or Element.DISPLAY
132          * @return {Roo.Element} this
133          */
134         setVisibilityMode : function(visMode){
135             this.visibilityMode = visMode;
136             return this;
137         },
138         /**
139          * Convenience method for setVisibilityMode(Element.DISPLAY)
140          * @param {String} display (optional) What to set display to when visible
141          * @return {Roo.Element} this
142          */
143         enableDisplayMode : function(display){
144             this.setVisibilityMode(El.DISPLAY);
145             if(typeof display != "undefined") { this.originalDisplay = display; }
146             return this;
147         },
148
149         /**
150          * Looks at this node and then at parent nodes for a match of the passed simple selector (e.g. div.some-class or span:first-child)
151          * @param {String} selector The simple selector to test
152          * @param {Number/String/HTMLElement/Element} maxDepth (optional) The max depth to
153                 search as a number or element (defaults to 10 || document.body)
154          * @param {Boolean} returnEl (optional) True to return a Roo.Element object instead of DOM node
155          * @return {HTMLElement} The matching DOM node (or null if no match was found)
156          */
157         findParent : function(simpleSelector, maxDepth, returnEl){
158             var p = this.dom, b = document.body, depth = 0, dq = Roo.DomQuery, stopEl;
159             maxDepth = maxDepth || 50;
160             if(typeof maxDepth != "number"){
161                 stopEl = Roo.getDom(maxDepth);
162                 maxDepth = 10;
163             }
164             while(p && p.nodeType == 1 && depth < maxDepth && p != b && p != stopEl){
165                 if(dq.is(p, simpleSelector)){
166                     return returnEl ? Roo.get(p) : p;
167                 }
168                 depth++;
169                 p = p.parentNode;
170             }
171             return null;
172         },
173
174
175         /**
176          * Looks at parent nodes for a match of the passed simple selector (e.g. div.some-class or span:first-child)
177          * @param {String} selector The simple selector to test
178          * @param {Number/String/HTMLElement/Element} maxDepth (optional) The max depth to
179                 search as a number or element (defaults to 10 || document.body)
180          * @param {Boolean} returnEl (optional) True to return a Roo.Element object instead of DOM node
181          * @return {HTMLElement} The matching DOM node (or null if no match was found)
182          */
183         findParentNode : function(simpleSelector, maxDepth, returnEl){
184             var p = Roo.fly(this.dom.parentNode, '_internal');
185             return p ? p.findParent(simpleSelector, maxDepth, returnEl) : null;
186         },
187         
188         /**
189          * Looks at  the scrollable parent element
190          */
191         findScrollableParent : function()
192         {
193             var overflowRegex = /(auto|scroll)/;
194             
195             if(this.getStyle('position') === 'fixed'){
196                 return Roo.isAndroid ? Roo.get(document.documentElement) : Roo.get(document.body);
197             }
198             
199             var excludeStaticParent = this.getStyle('position') === "absolute";
200             
201             for (var parent = this; (parent = Roo.get(parent.dom.parentNode));){
202                 
203                 if (excludeStaticParent && parent.getStyle('position') === "static") {
204                     continue;
205                 }
206                 
207                 if (overflowRegex.test(parent.getStyle('overflow') + parent.getStyle('overflow-x') + parent.getStyle('overflow-y'))){
208                     return parent;
209                 }
210                 
211                 if(parent.dom.nodeName.toLowerCase() == 'body'){
212                     return Roo.isAndroid ? Roo.get(document.documentElement) : Roo.get(document.body);
213                 }
214             }
215             
216             alert('is android : ' + Roo.isAndroid);
217             alert('is ios : ' + Roo.isIOS);
218             
219             if(Roo.isAndroid){
220                 alert('Is Android');
221                 return Roo.get(document.documentElement);
222             }
223             
224             if(!Roo.isAndroid){
225                 alert('not android');
226             }
227             
228             return Roo.isAndroid ? Roo.get(document.documentElement) : Roo.get(document.body);
229         },
230
231         /**
232          * Walks up the dom looking for a parent node that matches the passed simple selector (e.g. div.some-class or span:first-child).
233          * This is a shortcut for findParentNode() that always returns an Roo.Element.
234          * @param {String} selector The simple selector to test
235          * @param {Number/String/HTMLElement/Element} maxDepth (optional) The max depth to
236                 search as a number or element (defaults to 10 || document.body)
237          * @return {Roo.Element} The matching DOM node (or null if no match was found)
238          */
239         up : function(simpleSelector, maxDepth){
240             return this.findParentNode(simpleSelector, maxDepth, true);
241         },
242
243
244
245         /**
246          * Returns true if this element matches the passed simple selector (e.g. div.some-class or span:first-child)
247          * @param {String} selector The simple selector to test
248          * @return {Boolean} True if this element matches the selector, else false
249          */
250         is : function(simpleSelector){
251             return Roo.DomQuery.is(this.dom, simpleSelector);
252         },
253
254         /**
255          * Perform animation on this element.
256          * @param {Object} args The YUI animation control args
257          * @param {Float} duration (optional) How long the animation lasts in seconds (defaults to .35)
258          * @param {Function} onComplete (optional) Function to call when animation completes
259          * @param {String} easing (optional) Easing method to use (defaults to 'easeOut')
260          * @param {String} animType (optional) 'run' is the default. Can also be 'color', 'motion', or 'scroll'
261          * @return {Roo.Element} this
262          */
263         animate : function(args, duration, onComplete, easing, animType){
264             this.anim(args, {duration: duration, callback: onComplete, easing: easing}, animType);
265             return this;
266         },
267
268         /*
269          * @private Internal animation call
270          */
271         anim : function(args, opt, animType, defaultDur, defaultEase, cb){
272             animType = animType || 'run';
273             opt = opt || {};
274             var anim = Roo.lib.Anim[animType](
275                 this.dom, args,
276                 (opt.duration || defaultDur) || .35,
277                 (opt.easing || defaultEase) || 'easeOut',
278                 function(){
279                     Roo.callback(cb, this);
280                     Roo.callback(opt.callback, opt.scope || this, [this, opt]);
281                 },
282                 this
283             );
284             opt.anim = anim;
285             return anim;
286         },
287
288         // private legacy anim prep
289         preanim : function(a, i){
290             return !a[i] ? false : (typeof a[i] == "object" ? a[i]: {duration: a[i+1], callback: a[i+2], easing: a[i+3]});
291         },
292
293         /**
294          * Removes worthless text nodes
295          * @param {Boolean} forceReclean (optional) By default the element
296          * keeps track if it has been cleaned already so
297          * you can call this over and over. However, if you update the element and
298          * need to force a reclean, you can pass true.
299          */
300         clean : function(forceReclean){
301             if(this.isCleaned && forceReclean !== true){
302                 return this;
303             }
304             var ns = /\S/;
305             var d = this.dom, n = d.firstChild, ni = -1;
306             while(n){
307                 var nx = n.nextSibling;
308                 if(n.nodeType == 3 && !ns.test(n.nodeValue)){
309                     d.removeChild(n);
310                 }else{
311                     n.nodeIndex = ++ni;
312                 }
313                 n = nx;
314             }
315             this.isCleaned = true;
316             return this;
317         },
318
319         // private
320         calcOffsetsTo : function(el){
321             el = Roo.get(el);
322             var d = el.dom;
323             var restorePos = false;
324             if(el.getStyle('position') == 'static'){
325                 el.position('relative');
326                 restorePos = true;
327             }
328             var x = 0, y =0;
329             var op = this.dom;
330             while(op && op != d && op.tagName != 'HTML'){
331                 x+= op.offsetLeft;
332                 y+= op.offsetTop;
333                 op = op.offsetParent;
334             }
335             if(restorePos){
336                 el.position('static');
337             }
338             return [x, y];
339         },
340
341         /**
342          * Scrolls this element into view within the passed container.
343          * @param {String/HTMLElement/Element} container (optional) The container element to scroll (defaults to document.body)
344          * @param {Boolean} hscroll (optional) False to disable horizontal scroll (defaults to true)
345          * @return {Roo.Element} this
346          */
347         scrollIntoView : function(container, hscroll){
348             var c = Roo.getDom(container) || document.body;
349             var el = this.dom;
350
351             var o = this.calcOffsetsTo(c),
352                 l = o[0],
353                 t = o[1],
354                 b = t+el.offsetHeight,
355                 r = l+el.offsetWidth;
356
357             var ch = c.clientHeight;
358             var ct = parseInt(c.scrollTop, 10);
359             var cl = parseInt(c.scrollLeft, 10);
360             var cb = ct + ch;
361             var cr = cl + c.clientWidth;
362
363             if(t < ct){
364                 c.scrollTop = t;
365             }else if(b > cb){
366                 c.scrollTop = b-ch;
367             }
368
369             if(hscroll !== false){
370                 if(l < cl){
371                     c.scrollLeft = l;
372                 }else if(r > cr){
373                     c.scrollLeft = r-c.clientWidth;
374                 }
375             }
376             return this;
377         },
378
379         // private
380         scrollChildIntoView : function(child, hscroll){
381             Roo.fly(child, '_scrollChildIntoView').scrollIntoView(this, hscroll);
382         },
383
384         /**
385          * Measures the element's content height and updates height to match. Note: this function uses setTimeout so
386          * the new height may not be available immediately.
387          * @param {Boolean} animate (optional) Animate the transition (defaults to false)
388          * @param {Float} duration (optional) Length of the animation in seconds (defaults to .35)
389          * @param {Function} onComplete (optional) Function to call when animation completes
390          * @param {String} easing (optional) Easing method to use (defaults to easeOut)
391          * @return {Roo.Element} this
392          */
393         autoHeight : function(animate, duration, onComplete, easing){
394             var oldHeight = this.getHeight();
395             this.clip();
396             this.setHeight(1); // force clipping
397             setTimeout(function(){
398                 var height = parseInt(this.dom.scrollHeight, 10); // parseInt for Safari
399                 if(!animate){
400                     this.setHeight(height);
401                     this.unclip();
402                     if(typeof onComplete == "function"){
403                         onComplete();
404                     }
405                 }else{
406                     this.setHeight(oldHeight); // restore original height
407                     this.setHeight(height, animate, duration, function(){
408                         this.unclip();
409                         if(typeof onComplete == "function") { onComplete(); }
410                     }.createDelegate(this), easing);
411                 }
412             }.createDelegate(this), 0);
413             return this;
414         },
415
416         /**
417          * Returns true if this element is an ancestor of the passed element
418          * @param {HTMLElement/String} el The element to check
419          * @return {Boolean} True if this element is an ancestor of el, else false
420          */
421         contains : function(el){
422             if(!el){return false;}
423             return D.isAncestor(this.dom, el.dom ? el.dom : el);
424         },
425
426         /**
427          * Checks whether the element is currently visible using both visibility and display properties.
428          * @param {Boolean} deep (optional) True to walk the dom and see if parent elements are hidden (defaults to false)
429          * @return {Boolean} True if the element is currently visible, else false
430          */
431         isVisible : function(deep) {
432             var vis = !(this.getStyle("visibility") == "hidden" || this.getStyle("display") == "none");
433             if(deep !== true || !vis){
434                 return vis;
435             }
436             var p = this.dom.parentNode;
437             while(p && p.tagName.toLowerCase() != "body"){
438                 if(!Roo.fly(p, '_isVisible').isVisible()){
439                     return false;
440                 }
441                 p = p.parentNode;
442             }
443             return true;
444         },
445
446         /**
447          * Creates a {@link Roo.CompositeElement} for child nodes based on the passed CSS selector (the selector should not contain an id).
448          * @param {String} selector The CSS selector
449          * @param {Boolean} unique (optional) True to create a unique Roo.Element for each child (defaults to false, which creates a single shared flyweight object)
450          * @return {CompositeElement/CompositeElementLite} The composite element
451          */
452         select : function(selector, unique){
453             return El.select(selector, unique, this.dom);
454         },
455
456         /**
457          * Selects child nodes based on the passed CSS selector (the selector should not contain an id).
458          * @param {String} selector The CSS selector
459          * @return {Array} An array of the matched nodes
460          */
461         query : function(selector, unique){
462             return Roo.DomQuery.select(selector, this.dom);
463         },
464
465         /**
466          * Selects a single child at any depth below this element based on the passed CSS selector (the selector should not contain an id).
467          * @param {String} selector The CSS selector
468          * @param {Boolean} returnDom (optional) True to return the DOM node instead of Roo.Element (defaults to false)
469          * @return {HTMLElement/Roo.Element} The child Roo.Element (or DOM node if returnDom = true)
470          */
471         child : function(selector, returnDom){
472             var n = Roo.DomQuery.selectNode(selector, this.dom);
473             return returnDom ? n : Roo.get(n);
474         },
475
476         /**
477          * Selects a single *direct* child based on the passed CSS selector (the selector should not contain an id).
478          * @param {String} selector The CSS selector
479          * @param {Boolean} returnDom (optional) True to return the DOM node instead of Roo.Element (defaults to false)
480          * @return {HTMLElement/Roo.Element} The child Roo.Element (or DOM node if returnDom = true)
481          */
482         down : function(selector, returnDom){
483             var n = Roo.DomQuery.selectNode(" > " + selector, this.dom);
484             return returnDom ? n : Roo.get(n);
485         },
486
487         /**
488          * Initializes a {@link Roo.dd.DD} drag drop object for this element.
489          * @param {String} group The group the DD object is member of
490          * @param {Object} config The DD config object
491          * @param {Object} overrides An object containing methods to override/implement on the DD object
492          * @return {Roo.dd.DD} The DD object
493          */
494         initDD : function(group, config, overrides){
495             var dd = new Roo.dd.DD(Roo.id(this.dom), group, config);
496             return Roo.apply(dd, overrides);
497         },
498
499         /**
500          * Initializes a {@link Roo.dd.DDProxy} object for this element.
501          * @param {String} group The group the DDProxy object is member of
502          * @param {Object} config The DDProxy config object
503          * @param {Object} overrides An object containing methods to override/implement on the DDProxy object
504          * @return {Roo.dd.DDProxy} The DDProxy object
505          */
506         initDDProxy : function(group, config, overrides){
507             var dd = new Roo.dd.DDProxy(Roo.id(this.dom), group, config);
508             return Roo.apply(dd, overrides);
509         },
510
511         /**
512          * Initializes a {@link Roo.dd.DDTarget} object for this element.
513          * @param {String} group The group the DDTarget object is member of
514          * @param {Object} config The DDTarget config object
515          * @param {Object} overrides An object containing methods to override/implement on the DDTarget object
516          * @return {Roo.dd.DDTarget} The DDTarget object
517          */
518         initDDTarget : function(group, config, overrides){
519             var dd = new Roo.dd.DDTarget(Roo.id(this.dom), group, config);
520             return Roo.apply(dd, overrides);
521         },
522
523         /**
524          * Sets the visibility of the element (see details). If the visibilityMode is set to Element.DISPLAY, it will use
525          * the display property to hide the element, otherwise it uses visibility. The default is to hide and show using the visibility property.
526          * @param {Boolean} visible Whether the element is visible
527          * @param {Boolean/Object} animate (optional) True for the default animation, or a standard Element animation config object
528          * @return {Roo.Element} this
529          */
530          setVisible : function(visible, animate){
531             if(!animate || !A){
532                 if(this.visibilityMode == El.DISPLAY){
533                     this.setDisplayed(visible);
534                 }else{
535                     this.fixDisplay();
536                     this.dom.style.visibility = visible ? "visible" : "hidden";
537                 }
538             }else{
539                 // closure for composites
540                 var dom = this.dom;
541                 var visMode = this.visibilityMode;
542                 if(visible){
543                     this.setOpacity(.01);
544                     this.setVisible(true);
545                 }
546                 this.anim({opacity: { to: (visible?1:0) }},
547                       this.preanim(arguments, 1),
548                       null, .35, 'easeIn', function(){
549                          if(!visible){
550                              if(visMode == El.DISPLAY){
551                                  dom.style.display = "none";
552                              }else{
553                                  dom.style.visibility = "hidden";
554                              }
555                              Roo.get(dom).setOpacity(1);
556                          }
557                      });
558             }
559             return this;
560         },
561
562         /**
563          * Returns true if display is not "none"
564          * @return {Boolean}
565          */
566         isDisplayed : function() {
567             return this.getStyle("display") != "none";
568         },
569
570         /**
571          * Toggles the element's visibility or display, depending on visibility mode.
572          * @param {Boolean/Object} animate (optional) True for the default animation, or a standard Element animation config object
573          * @return {Roo.Element} this
574          */
575         toggle : function(animate){
576             this.setVisible(!this.isVisible(), this.preanim(arguments, 0));
577             return this;
578         },
579
580         /**
581          * Sets the CSS display property. Uses originalDisplay if the specified value is a boolean true.
582          * @param {Boolean} value Boolean value to display the element using its default display, or a string to set the display directly
583          * @return {Roo.Element} this
584          */
585         setDisplayed : function(value) {
586             if(typeof value == "boolean"){
587                value = value ? this.originalDisplay : "none";
588             }
589             this.setStyle("display", value);
590             return this;
591         },
592
593         /**
594          * Tries to focus the element. Any exceptions are caught and ignored.
595          * @return {Roo.Element} this
596          */
597         focus : function() {
598             try{
599                 this.dom.focus();
600             }catch(e){}
601             return this;
602         },
603
604         /**
605          * Tries to blur the element. Any exceptions are caught and ignored.
606          * @return {Roo.Element} this
607          */
608         blur : function() {
609             try{
610                 this.dom.blur();
611             }catch(e){}
612             return this;
613         },
614
615         /**
616          * Adds one or more CSS classes to the element. Duplicate classes are automatically filtered out.
617          * @param {String/Array} className The CSS class to add, or an array of classes
618          * @return {Roo.Element} this
619          */
620         addClass : function(className){
621             if(className instanceof Array){
622                 for(var i = 0, len = className.length; i < len; i++) {
623                     this.addClass(className[i]);
624                 }
625             }else{
626                 if(className && !this.hasClass(className)){
627                     this.dom.className = this.dom.className + " " + className;
628                 }
629             }
630             return this;
631         },
632
633         /**
634          * Adds one or more CSS classes to this element and removes the same class(es) from all siblings.
635          * @param {String/Array} className The CSS class to add, or an array of classes
636          * @return {Roo.Element} this
637          */
638         radioClass : function(className){
639             var siblings = this.dom.parentNode.childNodes;
640             for(var i = 0; i < siblings.length; i++) {
641                 var s = siblings[i];
642                 if(s.nodeType == 1){
643                     Roo.get(s).removeClass(className);
644                 }
645             }
646             this.addClass(className);
647             return this;
648         },
649
650         /**
651          * Removes one or more CSS classes from the element.
652          * @param {String/Array} className The CSS class to remove, or an array of classes
653          * @return {Roo.Element} this
654          */
655         removeClass : function(className){
656             if(!className || !this.dom.className){
657                 return this;
658             }
659             if(className instanceof Array){
660                 for(var i = 0, len = className.length; i < len; i++) {
661                     this.removeClass(className[i]);
662                 }
663             }else{
664                 if(this.hasClass(className)){
665                     var re = this.classReCache[className];
666                     if (!re) {
667                        re = new RegExp('(?:^|\\s+)' + className + '(?:\\s+|$)', "g");
668                        this.classReCache[className] = re;
669                     }
670                     this.dom.className =
671                         this.dom.className.replace(re, " ");
672                 }
673             }
674             return this;
675         },
676
677         // private
678         classReCache: {},
679
680         /**
681          * Toggles the specified CSS class on this element (removes it if it already exists, otherwise adds it).
682          * @param {String} className The CSS class to toggle
683          * @return {Roo.Element} this
684          */
685         toggleClass : function(className){
686             if(this.hasClass(className)){
687                 this.removeClass(className);
688             }else{
689                 this.addClass(className);
690             }
691             return this;
692         },
693
694         /**
695          * Checks if the specified CSS class exists on this element's DOM node.
696          * @param {String} className The CSS class to check for
697          * @return {Boolean} True if the class exists, else false
698          */
699         hasClass : function(className){
700             return className && (' '+this.dom.className+' ').indexOf(' '+className+' ') != -1;
701         },
702
703         /**
704          * Replaces a CSS class on the element with another.  If the old name does not exist, the new name will simply be added.
705          * @param {String} oldClassName The CSS class to replace
706          * @param {String} newClassName The replacement CSS class
707          * @return {Roo.Element} this
708          */
709         replaceClass : function(oldClassName, newClassName){
710             this.removeClass(oldClassName);
711             this.addClass(newClassName);
712             return this;
713         },
714
715         /**
716          * Returns an object with properties matching the styles requested.
717          * For example, el.getStyles('color', 'font-size', 'width') might return
718          * {'color': '#FFFFFF', 'font-size': '13px', 'width': '100px'}.
719          * @param {String} style1 A style name
720          * @param {String} style2 A style name
721          * @param {String} etc.
722          * @return {Object} The style object
723          */
724         getStyles : function(){
725             var a = arguments, len = a.length, r = {};
726             for(var i = 0; i < len; i++){
727                 r[a[i]] = this.getStyle(a[i]);
728             }
729             return r;
730         },
731
732         /**
733          * Normalizes currentStyle and computedStyle. This is not YUI getStyle, it is an optimised version.
734          * @param {String} property The style property whose value is returned.
735          * @return {String} The current value of the style property for this element.
736          */
737         getStyle : function(){
738             return view && view.getComputedStyle ?
739                 function(prop){
740                     var el = this.dom, v, cs, camel;
741                     if(prop == 'float'){
742                         prop = "cssFloat";
743                     }
744                     if(el.style && (v = el.style[prop])){
745                         return v;
746                     }
747                     if(cs = view.getComputedStyle(el, "")){
748                         if(!(camel = propCache[prop])){
749                             camel = propCache[prop] = prop.replace(camelRe, camelFn);
750                         }
751                         return cs[camel];
752                     }
753                     return null;
754                 } :
755                 function(prop){
756                     var el = this.dom, v, cs, camel;
757                     if(prop == 'opacity'){
758                         if(typeof el.style.filter == 'string'){
759                             var m = el.style.filter.match(/alpha\(opacity=(.*)\)/i);
760                             if(m){
761                                 var fv = parseFloat(m[1]);
762                                 if(!isNaN(fv)){
763                                     return fv ? fv / 100 : 0;
764                                 }
765                             }
766                         }
767                         return 1;
768                     }else if(prop == 'float'){
769                         prop = "styleFloat";
770                     }
771                     if(!(camel = propCache[prop])){
772                         camel = propCache[prop] = prop.replace(camelRe, camelFn);
773                     }
774                     if(v = el.style[camel]){
775                         return v;
776                     }
777                     if(cs = el.currentStyle){
778                         return cs[camel];
779                     }
780                     return null;
781                 };
782         }(),
783
784         /**
785          * Wrapper for setting style properties, also takes single object parameter of multiple styles.
786          * @param {String/Object} property The style property to be set, or an object of multiple styles.
787          * @param {String} value (optional) The value to apply to the given property, or null if an object was passed.
788          * @return {Roo.Element} this
789          */
790         setStyle : function(prop, value){
791             if(typeof prop == "string"){
792                 
793                 if (prop == 'float') {
794                     this.setStyle(Roo.isIE ? 'styleFloat'  : 'cssFloat', value);
795                     return this;
796                 }
797                 
798                 var camel;
799                 if(!(camel = propCache[prop])){
800                     camel = propCache[prop] = prop.replace(camelRe, camelFn);
801                 }
802                 
803                 if(camel == 'opacity') {
804                     this.setOpacity(value);
805                 }else{
806                     this.dom.style[camel] = value;
807                 }
808             }else{
809                 for(var style in prop){
810                     if(typeof prop[style] != "function"){
811                        this.setStyle(style, prop[style]);
812                     }
813                 }
814             }
815             return this;
816         },
817
818         /**
819          * More flexible version of {@link #setStyle} for setting style properties.
820          * @param {String/Object/Function} styles A style specification string, e.g. "width:100px", or object in the form {width:"100px"}, or
821          * a function which returns such a specification.
822          * @return {Roo.Element} this
823          */
824         applyStyles : function(style){
825             Roo.DomHelper.applyStyles(this.dom, style);
826             return this;
827         },
828
829         /**
830           * Gets the current X position of the element based on page coordinates.  Element must be part of the DOM tree to have page coordinates (display:none or elements not appended return false).
831           * @return {Number} The X position of the element
832           */
833         getX : function(){
834             return D.getX(this.dom);
835         },
836
837         /**
838           * Gets the current Y position of the element based on page coordinates.  Element must be part of the DOM tree to have page coordinates (display:none or elements not appended return false).
839           * @return {Number} The Y position of the element
840           */
841         getY : function(){
842             return D.getY(this.dom);
843         },
844
845         /**
846           * Gets the current position of the element based on page coordinates.  Element must be part of the DOM tree to have page coordinates (display:none or elements not appended return false).
847           * @return {Array} The XY position of the element
848           */
849         getXY : function(){
850             return D.getXY(this.dom);
851         },
852
853         /**
854          * Sets the X position of the element based on page coordinates.  Element must be part of the DOM tree to have page coordinates (display:none or elements not appended return false).
855          * @param {Number} The X position of the element
856          * @param {Boolean/Object} animate (optional) True for the default animation, or a standard Element animation config object
857          * @return {Roo.Element} this
858          */
859         setX : function(x, animate){
860             if(!animate || !A){
861                 D.setX(this.dom, x);
862             }else{
863                 this.setXY([x, this.getY()], this.preanim(arguments, 1));
864             }
865             return this;
866         },
867
868         /**
869          * Sets the Y position of the element based on page coordinates.  Element must be part of the DOM tree to have page coordinates (display:none or elements not appended return false).
870          * @param {Number} The Y position of the element
871          * @param {Boolean/Object} animate (optional) True for the default animation, or a standard Element animation config object
872          * @return {Roo.Element} this
873          */
874         setY : function(y, animate){
875             if(!animate || !A){
876                 D.setY(this.dom, y);
877             }else{
878                 this.setXY([this.getX(), y], this.preanim(arguments, 1));
879             }
880             return this;
881         },
882
883         /**
884          * Sets the element's left position directly using CSS style (instead of {@link #setX}).
885          * @param {String} left The left CSS property value
886          * @return {Roo.Element} this
887          */
888         setLeft : function(left){
889             this.setStyle("left", this.addUnits(left));
890             return this;
891         },
892
893         /**
894          * Sets the element's top position directly using CSS style (instead of {@link #setY}).
895          * @param {String} top The top CSS property value
896          * @return {Roo.Element} this
897          */
898         setTop : function(top){
899             this.setStyle("top", this.addUnits(top));
900             return this;
901         },
902
903         /**
904          * Sets the element's CSS right style.
905          * @param {String} right The right CSS property value
906          * @return {Roo.Element} this
907          */
908         setRight : function(right){
909             this.setStyle("right", this.addUnits(right));
910             return this;
911         },
912
913         /**
914          * Sets the element's CSS bottom style.
915          * @param {String} bottom The bottom CSS property value
916          * @return {Roo.Element} this
917          */
918         setBottom : function(bottom){
919             this.setStyle("bottom", this.addUnits(bottom));
920             return this;
921         },
922
923         /**
924          * Sets the position of the element in page coordinates, regardless of how the element is positioned.
925          * The element must be part of the DOM tree to have page coordinates (display:none or elements not appended return false).
926          * @param {Array} pos Contains X & Y [x, y] values for new position (coordinates are page-based)
927          * @param {Boolean/Object} animate (optional) True for the default animation, or a standard Element animation config object
928          * @return {Roo.Element} this
929          */
930         setXY : function(pos, animate){
931             if(!animate || !A){
932                 D.setXY(this.dom, pos);
933             }else{
934                 this.anim({points: {to: pos}}, this.preanim(arguments, 1), 'motion');
935             }
936             return this;
937         },
938
939         /**
940          * Sets the position of the element in page coordinates, regardless of how the element is positioned.
941          * The element must be part of the DOM tree to have page coordinates (display:none or elements not appended return false).
942          * @param {Number} x X value for new position (coordinates are page-based)
943          * @param {Number} y Y value for new position (coordinates are page-based)
944          * @param {Boolean/Object} animate (optional) True for the default animation, or a standard Element animation config object
945          * @return {Roo.Element} this
946          */
947         setLocation : function(x, y, animate){
948             this.setXY([x, y], this.preanim(arguments, 2));
949             return this;
950         },
951
952         /**
953          * Sets the position of the element in page coordinates, regardless of how the element is positioned.
954          * The element must be part of the DOM tree to have page coordinates (display:none or elements not appended return false).
955          * @param {Number} x X value for new position (coordinates are page-based)
956          * @param {Number} y Y value for new position (coordinates are page-based)
957          * @param {Boolean/Object} animate (optional) True for the default animation, or a standard Element animation config object
958          * @return {Roo.Element} this
959          */
960         moveTo : function(x, y, animate){
961             this.setXY([x, y], this.preanim(arguments, 2));
962             return this;
963         },
964
965         /**
966          * Returns the region of the given element.
967          * The element must be part of the DOM tree to have a region (display:none or elements not appended return false).
968          * @return {Region} A Roo.lib.Region containing "top, left, bottom, right" member data.
969          */
970         getRegion : function(){
971             return D.getRegion(this.dom);
972         },
973
974         /**
975          * Returns the offset height of the element
976          * @param {Boolean} contentHeight (optional) true to get the height minus borders and padding
977          * @return {Number} The element's height
978          */
979         getHeight : function(contentHeight){
980             var h = this.dom.offsetHeight || 0;
981             return contentHeight !== true ? h : h-this.getBorderWidth("tb")-this.getPadding("tb");
982         },
983
984         /**
985          * Returns the offset width of the element
986          * @param {Boolean} contentWidth (optional) true to get the width minus borders and padding
987          * @return {Number} The element's width
988          */
989         getWidth : function(contentWidth){
990             var w = this.dom.offsetWidth || 0;
991             return contentWidth !== true ? w : w-this.getBorderWidth("lr")-this.getPadding("lr");
992         },
993
994         /**
995          * Returns either the offsetHeight or the height of this element based on CSS height adjusted by padding or borders
996          * when needed to simulate offsetHeight when offsets aren't available. This may not work on display:none elements
997          * if a height has not been set using CSS.
998          * @return {Number}
999          */
1000         getComputedHeight : function(){
1001             var h = Math.max(this.dom.offsetHeight, this.dom.clientHeight);
1002             if(!h){
1003                 h = parseInt(this.getStyle('height'), 10) || 0;
1004                 if(!this.isBorderBox()){
1005                     h += this.getFrameWidth('tb');
1006                 }
1007             }
1008             return h;
1009         },
1010
1011         /**
1012          * Returns either the offsetWidth or the width of this element based on CSS width adjusted by padding or borders
1013          * when needed to simulate offsetWidth when offsets aren't available. This may not work on display:none elements
1014          * if a width has not been set using CSS.
1015          * @return {Number}
1016          */
1017         getComputedWidth : function(){
1018             var w = Math.max(this.dom.offsetWidth, this.dom.clientWidth);
1019             if(!w){
1020                 w = parseInt(this.getStyle('width'), 10) || 0;
1021                 if(!this.isBorderBox()){
1022                     w += this.getFrameWidth('lr');
1023                 }
1024             }
1025             return w;
1026         },
1027
1028         /**
1029          * Returns the size of the element.
1030          * @param {Boolean} contentSize (optional) true to get the width/size minus borders and padding
1031          * @return {Object} An object containing the element's size {width: (element width), height: (element height)}
1032          */
1033         getSize : function(contentSize){
1034             return {width: this.getWidth(contentSize), height: this.getHeight(contentSize)};
1035         },
1036
1037         /**
1038          * Returns the width and height of the viewport.
1039          * @return {Object} An object containing the viewport's size {width: (viewport width), height: (viewport height)}
1040          */
1041         getViewSize : function(){
1042             var d = this.dom, doc = document, aw = 0, ah = 0;
1043             if(d == doc || d == doc.body){
1044                 return {width : D.getViewWidth(), height: D.getViewHeight()};
1045             }else{
1046                 return {
1047                     width : d.clientWidth,
1048                     height: d.clientHeight
1049                 };
1050             }
1051         },
1052
1053         /**
1054          * Returns the value of the "value" attribute
1055          * @param {Boolean} asNumber true to parse the value as a number
1056          * @return {String/Number}
1057          */
1058         getValue : function(asNumber){
1059             return asNumber ? parseInt(this.dom.value, 10) : this.dom.value;
1060         },
1061
1062         // private
1063         adjustWidth : function(width){
1064             if(typeof width == "number"){
1065                 if(this.autoBoxAdjust && !this.isBorderBox()){
1066                    width -= (this.getBorderWidth("lr") + this.getPadding("lr"));
1067                 }
1068                 if(width < 0){
1069                     width = 0;
1070                 }
1071             }
1072             return width;
1073         },
1074
1075         // private
1076         adjustHeight : function(height){
1077             if(typeof height == "number"){
1078                if(this.autoBoxAdjust && !this.isBorderBox()){
1079                    height -= (this.getBorderWidth("tb") + this.getPadding("tb"));
1080                }
1081                if(height < 0){
1082                    height = 0;
1083                }
1084             }
1085             return height;
1086         },
1087
1088         /**
1089          * Set the width of the element
1090          * @param {Number} width The new width
1091          * @param {Boolean/Object} animate (optional) true for the default animation or a standard Element animation config object
1092          * @return {Roo.Element} this
1093          */
1094         setWidth : function(width, animate){
1095             width = this.adjustWidth(width);
1096             if(!animate || !A){
1097                 this.dom.style.width = this.addUnits(width);
1098             }else{
1099                 this.anim({width: {to: width}}, this.preanim(arguments, 1));
1100             }
1101             return this;
1102         },
1103
1104         /**
1105          * Set the height of the element
1106          * @param {Number} height The new height
1107          * @param {Boolean/Object} animate (optional) true for the default animation or a standard Element animation config object
1108          * @return {Roo.Element} this
1109          */
1110          setHeight : function(height, animate){
1111             height = this.adjustHeight(height);
1112             if(!animate || !A){
1113                 this.dom.style.height = this.addUnits(height);
1114             }else{
1115                 this.anim({height: {to: height}}, this.preanim(arguments, 1));
1116             }
1117             return this;
1118         },
1119
1120         /**
1121          * Set the size of the element. If animation is true, both width an height will be animated concurrently.
1122          * @param {Number} width The new width
1123          * @param {Number} height The new height
1124          * @param {Boolean/Object} animate (optional) true for the default animation or a standard Element animation config object
1125          * @return {Roo.Element} this
1126          */
1127          setSize : function(width, height, animate){
1128             if(typeof width == "object"){ // in case of object from getSize()
1129                 height = width.height; width = width.width;
1130             }
1131             width = this.adjustWidth(width); height = this.adjustHeight(height);
1132             if(!animate || !A){
1133                 this.dom.style.width = this.addUnits(width);
1134                 this.dom.style.height = this.addUnits(height);
1135             }else{
1136                 this.anim({width: {to: width}, height: {to: height}}, this.preanim(arguments, 2));
1137             }
1138             return this;
1139         },
1140
1141         /**
1142          * Sets the element's position and size in one shot. If animation is true then width, height, x and y will be animated concurrently.
1143          * @param {Number} x X value for new position (coordinates are page-based)
1144          * @param {Number} y Y value for new position (coordinates are page-based)
1145          * @param {Number} width The new width
1146          * @param {Number} height The new height
1147          * @param {Boolean/Object} animate (optional) true for the default animation or a standard Element animation config object
1148          * @return {Roo.Element} this
1149          */
1150         setBounds : function(x, y, width, height, animate){
1151             if(!animate || !A){
1152                 this.setSize(width, height);
1153                 this.setLocation(x, y);
1154             }else{
1155                 width = this.adjustWidth(width); height = this.adjustHeight(height);
1156                 this.anim({points: {to: [x, y]}, width: {to: width}, height: {to: height}},
1157                               this.preanim(arguments, 4), 'motion');
1158             }
1159             return this;
1160         },
1161
1162         /**
1163          * Sets the element's position and size the the specified region. If animation is true then width, height, x and y will be animated concurrently.
1164          * @param {Roo.lib.Region} region The region to fill
1165          * @param {Boolean/Object} animate (optional) true for the default animation or a standard Element animation config object
1166          * @return {Roo.Element} this
1167          */
1168         setRegion : function(region, animate){
1169             this.setBounds(region.left, region.top, region.right-region.left, region.bottom-region.top, this.preanim(arguments, 1));
1170             return this;
1171         },
1172
1173         /**
1174          * Appends an event handler
1175          *
1176          * @param {String}   eventName     The type of event to append
1177          * @param {Function} fn        The method the event invokes
1178          * @param {Object} scope       (optional) The scope (this object) of the fn
1179          * @param {Object}   options   (optional)An object with standard {@link Roo.EventManager#addListener} options
1180          */
1181         addListener : function(eventName, fn, scope, options){
1182             if (this.dom) {
1183                 Roo.EventManager.on(this.dom,  eventName, fn, scope || this, options);
1184             }
1185         },
1186
1187         /**
1188          * Removes an event handler from this element
1189          * @param {String} eventName the type of event to remove
1190          * @param {Function} fn the method the event invokes
1191          * @return {Roo.Element} this
1192          */
1193         removeListener : function(eventName, fn){
1194             Roo.EventManager.removeListener(this.dom,  eventName, fn);
1195             return this;
1196         },
1197
1198         /**
1199          * Removes all previous added listeners from this element
1200          * @return {Roo.Element} this
1201          */
1202         removeAllListeners : function(){
1203             E.purgeElement(this.dom);
1204             return this;
1205         },
1206
1207         relayEvent : function(eventName, observable){
1208             this.on(eventName, function(e){
1209                 observable.fireEvent(eventName, e);
1210             });
1211         },
1212
1213         /**
1214          * Set the opacity of the element
1215          * @param {Float} opacity The new opacity. 0 = transparent, .5 = 50% visibile, 1 = fully visible, etc
1216          * @param {Boolean/Object} animate (optional) true for the default animation or a standard Element animation config object
1217          * @return {Roo.Element} this
1218          */
1219          setOpacity : function(opacity, animate){
1220             if(!animate || !A){
1221                 var s = this.dom.style;
1222                 if(Roo.isIE){
1223                     s.zoom = 1;
1224                     s.filter = (s.filter || '').replace(/alpha\([^\)]*\)/gi,"") +
1225                                (opacity == 1 ? "" : "alpha(opacity=" + opacity * 100 + ")");
1226                 }else{
1227                     s.opacity = opacity;
1228                 }
1229             }else{
1230                 this.anim({opacity: {to: opacity}}, this.preanim(arguments, 1), null, .35, 'easeIn');
1231             }
1232             return this;
1233         },
1234
1235         /**
1236          * Gets the left X coordinate
1237          * @param {Boolean} local True to get the local css position instead of page coordinate
1238          * @return {Number}
1239          */
1240         getLeft : function(local){
1241             if(!local){
1242                 return this.getX();
1243             }else{
1244                 return parseInt(this.getStyle("left"), 10) || 0;
1245             }
1246         },
1247
1248         /**
1249          * Gets the right X coordinate of the element (element X position + element width)
1250          * @param {Boolean} local True to get the local css position instead of page coordinate
1251          * @return {Number}
1252          */
1253         getRight : function(local){
1254             if(!local){
1255                 return this.getX() + this.getWidth();
1256             }else{
1257                 return (this.getLeft(true) + this.getWidth()) || 0;
1258             }
1259         },
1260
1261         /**
1262          * Gets the top Y coordinate
1263          * @param {Boolean} local True to get the local css position instead of page coordinate
1264          * @return {Number}
1265          */
1266         getTop : function(local) {
1267             if(!local){
1268                 return this.getY();
1269             }else{
1270                 return parseInt(this.getStyle("top"), 10) || 0;
1271             }
1272         },
1273
1274         /**
1275          * Gets the bottom Y coordinate of the element (element Y position + element height)
1276          * @param {Boolean} local True to get the local css position instead of page coordinate
1277          * @return {Number}
1278          */
1279         getBottom : function(local){
1280             if(!local){
1281                 return this.getY() + this.getHeight();
1282             }else{
1283                 return (this.getTop(true) + this.getHeight()) || 0;
1284             }
1285         },
1286
1287         /**
1288         * Initializes positioning on this element. If a desired position is not passed, it will make the
1289         * the element positioned relative IF it is not already positioned.
1290         * @param {String} pos (optional) Positioning to use "relative", "absolute" or "fixed"
1291         * @param {Number} zIndex (optional) The zIndex to apply
1292         * @param {Number} x (optional) Set the page X position
1293         * @param {Number} y (optional) Set the page Y position
1294         */
1295         position : function(pos, zIndex, x, y){
1296             if(!pos){
1297                if(this.getStyle('position') == 'static'){
1298                    this.setStyle('position', 'relative');
1299                }
1300             }else{
1301                 this.setStyle("position", pos);
1302             }
1303             if(zIndex){
1304                 this.setStyle("z-index", zIndex);
1305             }
1306             if(x !== undefined && y !== undefined){
1307                 this.setXY([x, y]);
1308             }else if(x !== undefined){
1309                 this.setX(x);
1310             }else if(y !== undefined){
1311                 this.setY(y);
1312             }
1313         },
1314
1315         /**
1316         * Clear positioning back to the default when the document was loaded
1317         * @param {String} value (optional) The value to use for the left,right,top,bottom, defaults to '' (empty string). You could use 'auto'.
1318         * @return {Roo.Element} this
1319          */
1320         clearPositioning : function(value){
1321             value = value ||'';
1322             this.setStyle({
1323                 "left": value,
1324                 "right": value,
1325                 "top": value,
1326                 "bottom": value,
1327                 "z-index": "",
1328                 "position" : "static"
1329             });
1330             return this;
1331         },
1332
1333         /**
1334         * Gets an object with all CSS positioning properties. Useful along with setPostioning to get
1335         * snapshot before performing an update and then restoring the element.
1336         * @return {Object}
1337         */
1338         getPositioning : function(){
1339             var l = this.getStyle("left");
1340             var t = this.getStyle("top");
1341             return {
1342                 "position" : this.getStyle("position"),
1343                 "left" : l,
1344                 "right" : l ? "" : this.getStyle("right"),
1345                 "top" : t,
1346                 "bottom" : t ? "" : this.getStyle("bottom"),
1347                 "z-index" : this.getStyle("z-index")
1348             };
1349         },
1350
1351         /**
1352          * Gets the width of the border(s) for the specified side(s)
1353          * @param {String} side Can be t, l, r, b or any combination of those to add multiple values. For example,
1354          * passing lr would get the border (l)eft width + the border (r)ight width.
1355          * @return {Number} The width of the sides passed added together
1356          */
1357         getBorderWidth : function(side){
1358             return this.addStyles(side, El.borders);
1359         },
1360
1361         /**
1362          * Gets the width of the padding(s) for the specified side(s)
1363          * @param {String} side Can be t, l, r, b or any combination of those to add multiple values. For example,
1364          * passing lr would get the padding (l)eft + the padding (r)ight.
1365          * @return {Number} The padding of the sides passed added together
1366          */
1367         getPadding : function(side){
1368             return this.addStyles(side, El.paddings);
1369         },
1370
1371         /**
1372         * Set positioning with an object returned by getPositioning().
1373         * @param {Object} posCfg
1374         * @return {Roo.Element} this
1375          */
1376         setPositioning : function(pc){
1377             this.applyStyles(pc);
1378             if(pc.right == "auto"){
1379                 this.dom.style.right = "";
1380             }
1381             if(pc.bottom == "auto"){
1382                 this.dom.style.bottom = "";
1383             }
1384             return this;
1385         },
1386
1387         // private
1388         fixDisplay : function(){
1389             if(this.getStyle("display") == "none"){
1390                 this.setStyle("visibility", "hidden");
1391                 this.setStyle("display", this.originalDisplay); // first try reverting to default
1392                 if(this.getStyle("display") == "none"){ // if that fails, default to block
1393                     this.setStyle("display", "block");
1394                 }
1395             }
1396         },
1397
1398         /**
1399          * Quick set left and top adding default units
1400          * @param {String} left The left CSS property value
1401          * @param {String} top The top CSS property value
1402          * @return {Roo.Element} this
1403          */
1404          setLeftTop : function(left, top){
1405             this.dom.style.left = this.addUnits(left);
1406             this.dom.style.top = this.addUnits(top);
1407             return this;
1408         },
1409
1410         /**
1411          * Move this element relative to its current position.
1412          * @param {String} direction Possible values are: "l","left" - "r","right" - "t","top","up" - "b","bottom","down".
1413          * @param {Number} distance How far to move the element in pixels
1414          * @param {Boolean/Object} animate (optional) true for the default animation or a standard Element animation config object
1415          * @return {Roo.Element} this
1416          */
1417          move : function(direction, distance, animate){
1418             var xy = this.getXY();
1419             direction = direction.toLowerCase();
1420             switch(direction){
1421                 case "l":
1422                 case "left":
1423                     this.moveTo(xy[0]-distance, xy[1], this.preanim(arguments, 2));
1424                     break;
1425                case "r":
1426                case "right":
1427                     this.moveTo(xy[0]+distance, xy[1], this.preanim(arguments, 2));
1428                     break;
1429                case "t":
1430                case "top":
1431                case "up":
1432                     this.moveTo(xy[0], xy[1]-distance, this.preanim(arguments, 2));
1433                     break;
1434                case "b":
1435                case "bottom":
1436                case "down":
1437                     this.moveTo(xy[0], xy[1]+distance, this.preanim(arguments, 2));
1438                     break;
1439             }
1440             return this;
1441         },
1442
1443         /**
1444          *  Store the current overflow setting and clip overflow on the element - use {@link #unclip} to remove
1445          * @return {Roo.Element} this
1446          */
1447         clip : function(){
1448             if(!this.isClipped){
1449                this.isClipped = true;
1450                this.originalClip = {
1451                    "o": this.getStyle("overflow"),
1452                    "x": this.getStyle("overflow-x"),
1453                    "y": this.getStyle("overflow-y")
1454                };
1455                this.setStyle("overflow", "hidden");
1456                this.setStyle("overflow-x", "hidden");
1457                this.setStyle("overflow-y", "hidden");
1458             }
1459             return this;
1460         },
1461
1462         /**
1463          *  Return clipping (overflow) to original clipping before clip() was called
1464          * @return {Roo.Element} this
1465          */
1466         unclip : function(){
1467             if(this.isClipped){
1468                 this.isClipped = false;
1469                 var o = this.originalClip;
1470                 if(o.o){this.setStyle("overflow", o.o);}
1471                 if(o.x){this.setStyle("overflow-x", o.x);}
1472                 if(o.y){this.setStyle("overflow-y", o.y);}
1473             }
1474             return this;
1475         },
1476
1477
1478         /**
1479          * Gets the x,y coordinates specified by the anchor position on the element.
1480          * @param {String} anchor (optional) The specified anchor position (defaults to "c").  See {@link #alignTo} for details on supported anchor positions.
1481          * @param {Object} size (optional) An object containing the size to use for calculating anchor position
1482          *                       {width: (target width), height: (target height)} (defaults to the element's current size)
1483          * @param {Boolean} local (optional) True to get the local (element top/left-relative) anchor position instead of page coordinates
1484          * @return {Array} [x, y] An array containing the element's x and y coordinates
1485          */
1486         getAnchorXY : function(anchor, local, s){
1487             //Passing a different size is useful for pre-calculating anchors,
1488             //especially for anchored animations that change the el size.
1489
1490             var w, h, vp = false;
1491             if(!s){
1492                 var d = this.dom;
1493                 if(d == document.body || d == document){
1494                     vp = true;
1495                     w = D.getViewWidth(); h = D.getViewHeight();
1496                 }else{
1497                     w = this.getWidth(); h = this.getHeight();
1498                 }
1499             }else{
1500                 w = s.width;  h = s.height;
1501             }
1502             var x = 0, y = 0, r = Math.round;
1503             switch((anchor || "tl").toLowerCase()){
1504                 case "c":
1505                     x = r(w*.5);
1506                     y = r(h*.5);
1507                 break;
1508                 case "t":
1509                     x = r(w*.5);
1510                     y = 0;
1511                 break;
1512                 case "l":
1513                     x = 0;
1514                     y = r(h*.5);
1515                 break;
1516                 case "r":
1517                     x = w;
1518                     y = r(h*.5);
1519                 break;
1520                 case "b":
1521                     x = r(w*.5);
1522                     y = h;
1523                 break;
1524                 case "tl":
1525                     x = 0;
1526                     y = 0;
1527                 break;
1528                 case "bl":
1529                     x = 0;
1530                     y = h;
1531                 break;
1532                 case "br":
1533                     x = w;
1534                     y = h;
1535                 break;
1536                 case "tr":
1537                     x = w;
1538                     y = 0;
1539                 break;
1540             }
1541             if(local === true){
1542                 return [x, y];
1543             }
1544             if(vp){
1545                 var sc = this.getScroll();
1546                 return [x + sc.left, y + sc.top];
1547             }
1548             //Add the element's offset xy
1549             var o = this.getXY();
1550             return [x+o[0], y+o[1]];
1551         },
1552
1553         /**
1554          * Gets the x,y coordinates to align this element with another element. See {@link #alignTo} for more info on the
1555          * supported position values.
1556          * @param {String/HTMLElement/Roo.Element} element The element to align to.
1557          * @param {String} position The position to align to.
1558          * @param {Array} offsets (optional) Offset the positioning by [x, y]
1559          * @return {Array} [x, y]
1560          */
1561         getAlignToXY : function(el, p, o){
1562             el = Roo.get(el);
1563             var d = this.dom;
1564             if(!el.dom){
1565                 throw "Element.alignTo with an element that doesn't exist";
1566             }
1567             var c = false; //constrain to viewport
1568             var p1 = "", p2 = "";
1569             o = o || [0,0];
1570
1571             if(!p){
1572                 p = "tl-bl";
1573             }else if(p == "?"){
1574                 p = "tl-bl?";
1575             }else if(p.indexOf("-") == -1){
1576                 p = "tl-" + p;
1577             }
1578             p = p.toLowerCase();
1579             var m = p.match(/^([a-z]+)-([a-z]+)(\?)?$/);
1580             if(!m){
1581                throw "Element.alignTo with an invalid alignment " + p;
1582             }
1583             p1 = m[1]; p2 = m[2]; c = !!m[3];
1584
1585             //Subtract the aligned el's internal xy from the target's offset xy
1586             //plus custom offset to get the aligned el's new offset xy
1587             var a1 = this.getAnchorXY(p1, true);
1588             var a2 = el.getAnchorXY(p2, false);
1589             var x = a2[0] - a1[0] + o[0];
1590             var y = a2[1] - a1[1] + o[1];
1591             if(c){
1592                 //constrain the aligned el to viewport if necessary
1593                 var w = this.getWidth(), h = this.getHeight(), r = el.getRegion();
1594                 // 5px of margin for ie
1595                 var dw = D.getViewWidth()-5, dh = D.getViewHeight()-5;
1596
1597                 //If we are at a viewport boundary and the aligned el is anchored on a target border that is
1598                 //perpendicular to the vp border, allow the aligned el to slide on that border,
1599                 //otherwise swap the aligned el to the opposite border of the target.
1600                 var p1y = p1.charAt(0), p1x = p1.charAt(p1.length-1);
1601                var p2y = p2.charAt(0), p2x = p2.charAt(p2.length-1);
1602                var swapY = ((p1y=="t" && p2y=="b") || (p1y=="b" && p2y=="t"));
1603                var swapX = ((p1x=="r" && p2x=="l") || (p1x=="l" && p2x=="r"));
1604
1605                var doc = document;
1606                var scrollX = (doc.documentElement.scrollLeft || doc.body.scrollLeft || 0)+5;
1607                var scrollY = (doc.documentElement.scrollTop || doc.body.scrollTop || 0)+5;
1608
1609                if((x+w) > dw + scrollX){
1610                     x = swapX ? r.left-w : dw+scrollX-w;
1611                 }
1612                if(x < scrollX){
1613                    x = swapX ? r.right : scrollX;
1614                }
1615                if((y+h) > dh + scrollY){
1616                     y = swapY ? r.top-h : dh+scrollY-h;
1617                 }
1618                if (y < scrollY){
1619                    y = swapY ? r.bottom : scrollY;
1620                }
1621             }
1622             return [x,y];
1623         },
1624
1625         // private
1626         getConstrainToXY : function(){
1627             var os = {top:0, left:0, bottom:0, right: 0};
1628
1629             return function(el, local, offsets, proposedXY){
1630                 el = Roo.get(el);
1631                 offsets = offsets ? Roo.applyIf(offsets, os) : os;
1632
1633                 var vw, vh, vx = 0, vy = 0;
1634                 if(el.dom == document.body || el.dom == document){
1635                     vw = Roo.lib.Dom.getViewWidth();
1636                     vh = Roo.lib.Dom.getViewHeight();
1637                 }else{
1638                     vw = el.dom.clientWidth;
1639                     vh = el.dom.clientHeight;
1640                     if(!local){
1641                         var vxy = el.getXY();
1642                         vx = vxy[0];
1643                         vy = vxy[1];
1644                     }
1645                 }
1646
1647                 var s = el.getScroll();
1648
1649                 vx += offsets.left + s.left;
1650                 vy += offsets.top + s.top;
1651
1652                 vw -= offsets.right;
1653                 vh -= offsets.bottom;
1654
1655                 var vr = vx+vw;
1656                 var vb = vy+vh;
1657
1658                 var xy = proposedXY || (!local ? this.getXY() : [this.getLeft(true), this.getTop(true)]);
1659                 var x = xy[0], y = xy[1];
1660                 var w = this.dom.offsetWidth, h = this.dom.offsetHeight;
1661
1662                 // only move it if it needs it
1663                 var moved = false;
1664
1665                 // first validate right/bottom
1666                 if((x + w) > vr){
1667                     x = vr - w;
1668                     moved = true;
1669                 }
1670                 if((y + h) > vb){
1671                     y = vb - h;
1672                     moved = true;
1673                 }
1674                 // then make sure top/left isn't negative
1675                 if(x < vx){
1676                     x = vx;
1677                     moved = true;
1678                 }
1679                 if(y < vy){
1680                     y = vy;
1681                     moved = true;
1682                 }
1683                 return moved ? [x, y] : false;
1684             };
1685         }(),
1686
1687         // private
1688         adjustForConstraints : function(xy, parent, offsets){
1689             return this.getConstrainToXY(parent || document, false, offsets, xy) ||  xy;
1690         },
1691
1692         /**
1693          * Aligns this element with another element relative to the specified anchor points. If the other element is the
1694          * document it aligns it to the viewport.
1695          * The position parameter is optional, and can be specified in any one of the following formats:
1696          * <ul>
1697          *   <li><b>Blank</b>: Defaults to aligning the element's top-left corner to the target's bottom-left corner ("tl-bl").</li>
1698          *   <li><b>One anchor (deprecated)</b>: The passed anchor position is used as the target element's anchor point.
1699          *       The element being aligned will position its top-left corner (tl) to that point.  <i>This method has been
1700          *       deprecated in favor of the newer two anchor syntax below</i>.</li>
1701          *   <li><b>Two anchors</b>: If two values from the table below are passed separated by a dash, the first value is used as the
1702          *       element's anchor point, and the second value is used as the target's anchor point.</li>
1703          * </ul>
1704          * In addition to the anchor points, the position parameter also supports the "?" character.  If "?" is passed at the end of
1705          * the position string, the element will attempt to align as specified, but the position will be adjusted to constrain to
1706          * the viewport if necessary.  Note that the element being aligned might be swapped to align to a different position than
1707          * that specified in order to enforce the viewport constraints.
1708          * Following are all of the supported anchor positions:
1709     <pre>
1710     Value  Description
1711     -----  -----------------------------
1712     tl     The top left corner (default)
1713     t      The center of the top edge
1714     tr     The top right corner
1715     l      The center of the left edge
1716     c      In the center of the element
1717     r      The center of the right edge
1718     bl     The bottom left corner
1719     b      The center of the bottom edge
1720     br     The bottom right corner
1721     </pre>
1722     Example Usage:
1723     <pre><code>
1724     // align el to other-el using the default positioning ("tl-bl", non-constrained)
1725     el.alignTo("other-el");
1726
1727     // align the top left corner of el with the top right corner of other-el (constrained to viewport)
1728     el.alignTo("other-el", "tr?");
1729
1730     // align the bottom right corner of el with the center left edge of other-el
1731     el.alignTo("other-el", "br-l?");
1732
1733     // align the center of el with the bottom left corner of other-el and
1734     // adjust the x position by -6 pixels (and the y position by 0)
1735     el.alignTo("other-el", "c-bl", [-6, 0]);
1736     </code></pre>
1737          * @param {String/HTMLElement/Roo.Element} element The element to align to.
1738          * @param {String} position The position to align to.
1739          * @param {Array} offsets (optional) Offset the positioning by [x, y]
1740          * @param {Boolean/Object} animate (optional) true for the default animation or a standard Element animation config object
1741          * @return {Roo.Element} this
1742          */
1743         alignTo : function(element, position, offsets, animate){
1744             var xy = this.getAlignToXY(element, position, offsets);
1745             this.setXY(xy, this.preanim(arguments, 3));
1746             return this;
1747         },
1748
1749         /**
1750          * Anchors an element to another element and realigns it when the window is resized.
1751          * @param {String/HTMLElement/Roo.Element} element The element to align to.
1752          * @param {String} position The position to align to.
1753          * @param {Array} offsets (optional) Offset the positioning by [x, y]
1754          * @param {Boolean/Object} animate (optional) True for the default animation or a standard Element animation config object
1755          * @param {Boolean/Number} monitorScroll (optional) True to monitor body scroll and reposition. If this parameter
1756          * is a number, it is used as the buffer delay (defaults to 50ms).
1757          * @param {Function} callback The function to call after the animation finishes
1758          * @return {Roo.Element} this
1759          */
1760         anchorTo : function(el, alignment, offsets, animate, monitorScroll, callback){
1761             var action = function(){
1762                 this.alignTo(el, alignment, offsets, animate);
1763                 Roo.callback(callback, this);
1764             };
1765             Roo.EventManager.onWindowResize(action, this);
1766             var tm = typeof monitorScroll;
1767             if(tm != 'undefined'){
1768                 Roo.EventManager.on(window, 'scroll', action, this,
1769                     {buffer: tm == 'number' ? monitorScroll : 50});
1770             }
1771             action.call(this); // align immediately
1772             return this;
1773         },
1774         /**
1775          * Clears any opacity settings from this element. Required in some cases for IE.
1776          * @return {Roo.Element} this
1777          */
1778         clearOpacity : function(){
1779             if (window.ActiveXObject) {
1780                 if(typeof this.dom.style.filter == 'string' && (/alpha/i).test(this.dom.style.filter)){
1781                     this.dom.style.filter = "";
1782                 }
1783             } else {
1784                 this.dom.style.opacity = "";
1785                 this.dom.style["-moz-opacity"] = "";
1786                 this.dom.style["-khtml-opacity"] = "";
1787             }
1788             return this;
1789         },
1790
1791         /**
1792          * Hide this element - Uses display mode to determine whether to use "display" or "visibility". See {@link #setVisible}.
1793          * @param {Boolean/Object} animate (optional) true for the default animation or a standard Element animation config object
1794          * @return {Roo.Element} this
1795          */
1796         hide : function(animate){
1797             this.setVisible(false, this.preanim(arguments, 0));
1798             return this;
1799         },
1800
1801         /**
1802         * Show this element - Uses display mode to determine whether to use "display" or "visibility". See {@link #setVisible}.
1803         * @param {Boolean/Object} animate (optional) true for the default animation or a standard Element animation config object
1804          * @return {Roo.Element} this
1805          */
1806         show : function(animate){
1807             this.setVisible(true, this.preanim(arguments, 0));
1808             return this;
1809         },
1810
1811         /**
1812          * @private Test if size has a unit, otherwise appends the default
1813          */
1814         addUnits : function(size){
1815             return Roo.Element.addUnits(size, this.defaultUnit);
1816         },
1817
1818         /**
1819          * Temporarily enables offsets (width,height,x,y) for an element with display:none, use endMeasure() when done.
1820          * @return {Roo.Element} this
1821          */
1822         beginMeasure : function(){
1823             var el = this.dom;
1824             if(el.offsetWidth || el.offsetHeight){
1825                 return this; // offsets work already
1826             }
1827             var changed = [];
1828             var p = this.dom, b = document.body; // start with this element
1829             while((!el.offsetWidth && !el.offsetHeight) && p && p.tagName && p != b){
1830                 var pe = Roo.get(p);
1831                 if(pe.getStyle('display') == 'none'){
1832                     changed.push({el: p, visibility: pe.getStyle("visibility")});
1833                     p.style.visibility = "hidden";
1834                     p.style.display = "block";
1835                 }
1836                 p = p.parentNode;
1837             }
1838             this._measureChanged = changed;
1839             return this;
1840
1841         },
1842
1843         /**
1844          * Restores displays to before beginMeasure was called
1845          * @return {Roo.Element} this
1846          */
1847         endMeasure : function(){
1848             var changed = this._measureChanged;
1849             if(changed){
1850                 for(var i = 0, len = changed.length; i < len; i++) {
1851                     var r = changed[i];
1852                     r.el.style.visibility = r.visibility;
1853                     r.el.style.display = "none";
1854                 }
1855                 this._measureChanged = null;
1856             }
1857             return this;
1858         },
1859
1860         /**
1861         * Update the innerHTML of this element, optionally searching for and processing scripts
1862         * @param {String} html The new HTML
1863         * @param {Boolean} loadScripts (optional) true to look for and process scripts
1864         * @param {Function} callback For async script loading you can be noticed when the update completes
1865         * @return {Roo.Element} this
1866          */
1867         update : function(html, loadScripts, callback){
1868             if(typeof html == "undefined"){
1869                 html = "";
1870             }
1871             if(loadScripts !== true){
1872                 this.dom.innerHTML = html;
1873                 if(typeof callback == "function"){
1874                     callback();
1875                 }
1876                 return this;
1877             }
1878             var id = Roo.id();
1879             var dom = this.dom;
1880
1881             html += '<span id="' + id + '"></span>';
1882
1883             E.onAvailable(id, function(){
1884                 var hd = document.getElementsByTagName("head")[0];
1885                 var re = /(?:<script([^>]*)?>)((\n|\r|.)*?)(?:<\/script>)/ig;
1886                 var srcRe = /\ssrc=([\'\"])(.*?)\1/i;
1887                 var typeRe = /\stype=([\'\"])(.*?)\1/i;
1888
1889                 var match;
1890                 while(match = re.exec(html)){
1891                     var attrs = match[1];
1892                     var srcMatch = attrs ? attrs.match(srcRe) : false;
1893                     if(srcMatch && srcMatch[2]){
1894                        var s = document.createElement("script");
1895                        s.src = srcMatch[2];
1896                        var typeMatch = attrs.match(typeRe);
1897                        if(typeMatch && typeMatch[2]){
1898                            s.type = typeMatch[2];
1899                        }
1900                        hd.appendChild(s);
1901                     }else if(match[2] && match[2].length > 0){
1902                         if(window.execScript) {
1903                            window.execScript(match[2]);
1904                         } else {
1905                             /**
1906                              * eval:var:id
1907                              * eval:var:dom
1908                              * eval:var:html
1909                              * 
1910                              */
1911                            window.eval(match[2]);
1912                         }
1913                     }
1914                 }
1915                 var el = document.getElementById(id);
1916                 if(el){el.parentNode.removeChild(el);}
1917                 if(typeof callback == "function"){
1918                     callback();
1919                 }
1920             });
1921             dom.innerHTML = html.replace(/(?:<script.*?>)((\n|\r|.)*?)(?:<\/script>)/ig, "");
1922             return this;
1923         },
1924
1925         /**
1926          * Direct access to the UpdateManager update() method (takes the same parameters).
1927          * @param {String/Function} url The url for this request or a function to call to get the url
1928          * @param {String/Object} params (optional) The parameters to pass as either a url encoded string "param1=1&amp;param2=2" or an object {param1: 1, param2: 2}
1929          * @param {Function} callback (optional) Callback when transaction is complete - called with signature (oElement, bSuccess)
1930          * @param {Boolean} discardUrl (optional) By default when you execute an update the defaultUrl is changed to the last used url. If true, it will not store the url.
1931          * @return {Roo.Element} this
1932          */
1933         load : function(){
1934             var um = this.getUpdateManager();
1935             um.update.apply(um, arguments);
1936             return this;
1937         },
1938
1939         /**
1940         * Gets this element's UpdateManager
1941         * @return {Roo.UpdateManager} The UpdateManager
1942         */
1943         getUpdateManager : function(){
1944             if(!this.updateManager){
1945                 this.updateManager = new Roo.UpdateManager(this);
1946             }
1947             return this.updateManager;
1948         },
1949
1950         /**
1951          * Disables text selection for this element (normalized across browsers)
1952          * @return {Roo.Element} this
1953          */
1954         unselectable : function(){
1955             this.dom.unselectable = "on";
1956             this.swallowEvent("selectstart", true);
1957             this.applyStyles("-moz-user-select:none;-khtml-user-select:none;");
1958             this.addClass("x-unselectable");
1959             return this;
1960         },
1961
1962         /**
1963         * Calculates the x, y to center this element on the screen
1964         * @return {Array} The x, y values [x, y]
1965         */
1966         getCenterXY : function(){
1967             return this.getAlignToXY(document, 'c-c');
1968         },
1969
1970         /**
1971         * Centers the Element in either the viewport, or another Element.
1972         * @param {String/HTMLElement/Roo.Element} centerIn (optional) The element in which to center the element.
1973         */
1974         center : function(centerIn){
1975             this.alignTo(centerIn || document, 'c-c');
1976             return this;
1977         },
1978
1979         /**
1980          * Tests various css rules/browsers to determine if this element uses a border box
1981          * @return {Boolean}
1982          */
1983         isBorderBox : function(){
1984             return noBoxAdjust[this.dom.tagName.toLowerCase()] || Roo.isBorderBox;
1985         },
1986
1987         /**
1988          * Return a box {x, y, width, height} that can be used to set another elements
1989          * size/location to match this element.
1990          * @param {Boolean} contentBox (optional) If true a box for the content of the element is returned.
1991          * @param {Boolean} local (optional) If true the element's left and top are returned instead of page x/y.
1992          * @return {Object} box An object in the format {x, y, width, height}
1993          */
1994         getBox : function(contentBox, local){
1995             var xy;
1996             if(!local){
1997                 xy = this.getXY();
1998             }else{
1999                 var left = parseInt(this.getStyle("left"), 10) || 0;
2000                 var top = parseInt(this.getStyle("top"), 10) || 0;
2001                 xy = [left, top];
2002             }
2003             var el = this.dom, w = el.offsetWidth, h = el.offsetHeight, bx;
2004             if(!contentBox){
2005                 bx = {x: xy[0], y: xy[1], 0: xy[0], 1: xy[1], width: w, height: h};
2006             }else{
2007                 var l = this.getBorderWidth("l")+this.getPadding("l");
2008                 var r = this.getBorderWidth("r")+this.getPadding("r");
2009                 var t = this.getBorderWidth("t")+this.getPadding("t");
2010                 var b = this.getBorderWidth("b")+this.getPadding("b");
2011                 bx = {x: xy[0]+l, y: xy[1]+t, 0: xy[0]+l, 1: xy[1]+t, width: w-(l+r), height: h-(t+b)};
2012             }
2013             bx.right = bx.x + bx.width;
2014             bx.bottom = bx.y + bx.height;
2015             return bx;
2016         },
2017
2018         /**
2019          * Returns the sum width of the padding and borders for the passed "sides". See getBorderWidth()
2020          for more information about the sides.
2021          * @param {String} sides
2022          * @return {Number}
2023          */
2024         getFrameWidth : function(sides, onlyContentBox){
2025             return onlyContentBox && Roo.isBorderBox ? 0 : (this.getPadding(sides) + this.getBorderWidth(sides));
2026         },
2027
2028         /**
2029          * Sets the element's box. Use getBox() on another element to get a box obj. If animate is true then width, height, x and y will be animated concurrently.
2030          * @param {Object} box The box to fill {x, y, width, height}
2031          * @param {Boolean} adjust (optional) Whether to adjust for box-model issues automatically
2032          * @param {Boolean/Object} animate (optional) true for the default animation or a standard Element animation config object
2033          * @return {Roo.Element} this
2034          */
2035         setBox : function(box, adjust, animate){
2036             var w = box.width, h = box.height;
2037             if((adjust && !this.autoBoxAdjust) && !this.isBorderBox()){
2038                w -= (this.getBorderWidth("lr") + this.getPadding("lr"));
2039                h -= (this.getBorderWidth("tb") + this.getPadding("tb"));
2040             }
2041             this.setBounds(box.x, box.y, w, h, this.preanim(arguments, 2));
2042             return this;
2043         },
2044
2045         /**
2046          * Forces the browser to repaint this element
2047          * @return {Roo.Element} this
2048          */
2049          repaint : function(){
2050             var dom = this.dom;
2051             this.addClass("x-repaint");
2052             setTimeout(function(){
2053                 Roo.get(dom).removeClass("x-repaint");
2054             }, 1);
2055             return this;
2056         },
2057
2058         /**
2059          * Returns an object with properties top, left, right and bottom representing the margins of this element unless sides is passed,
2060          * then it returns the calculated width of the sides (see getPadding)
2061          * @param {String} sides (optional) Any combination of l, r, t, b to get the sum of those sides
2062          * @return {Object/Number}
2063          */
2064         getMargins : function(side){
2065             if(!side){
2066                 return {
2067                     top: parseInt(this.getStyle("margin-top"), 10) || 0,
2068                     left: parseInt(this.getStyle("margin-left"), 10) || 0,
2069                     bottom: parseInt(this.getStyle("margin-bottom"), 10) || 0,
2070                     right: parseInt(this.getStyle("margin-right"), 10) || 0
2071                 };
2072             }else{
2073                 return this.addStyles(side, El.margins);
2074              }
2075         },
2076
2077         // private
2078         addStyles : function(sides, styles){
2079             var val = 0, v, w;
2080             for(var i = 0, len = sides.length; i < len; i++){
2081                 v = this.getStyle(styles[sides.charAt(i)]);
2082                 if(v){
2083                      w = parseInt(v, 10);
2084                      if(w){ val += w; }
2085                 }
2086             }
2087             return val;
2088         },
2089
2090         /**
2091          * Creates a proxy element of this element
2092          * @param {String/Object} config The class name of the proxy element or a DomHelper config object
2093          * @param {String/HTMLElement} renderTo (optional) The element or element id to render the proxy to (defaults to document.body)
2094          * @param {Boolean} matchBox (optional) True to align and size the proxy to this element now (defaults to false)
2095          * @return {Roo.Element} The new proxy element
2096          */
2097         createProxy : function(config, renderTo, matchBox){
2098             if(renderTo){
2099                 renderTo = Roo.getDom(renderTo);
2100             }else{
2101                 renderTo = document.body;
2102             }
2103             config = typeof config == "object" ?
2104                 config : {tag : "div", cls: config};
2105             var proxy = Roo.DomHelper.append(renderTo, config, true);
2106             if(matchBox){
2107                proxy.setBox(this.getBox());
2108             }
2109             return proxy;
2110         },
2111
2112         /**
2113          * Puts a mask over this element to disable user interaction. Requires core.css.
2114          * This method can only be applied to elements which accept child nodes.
2115          * @param {String} msg (optional) A message to display in the mask
2116          * @param {String} msgCls (optional) A css class to apply to the msg element
2117          * @return {Element} The mask  element
2118          */
2119         mask : function(msg, msgCls)
2120         {
2121             if(this.getStyle("position") == "static" && this.dom.tagName !== 'BODY'){
2122                 this.setStyle("position", "relative");
2123             }
2124             if(!this._mask){
2125                 this._mask = Roo.DomHelper.append(this.dom, {cls:"roo-el-mask"}, true);
2126             }
2127             this.addClass("x-masked");
2128             this._mask.setDisplayed(true);
2129             
2130             // we wander
2131             var z = 0;
2132             var dom = this.dom;
2133             while (dom && dom.style) {
2134                 if (!isNaN(parseInt(dom.style.zIndex))) {
2135                     z = Math.max(z, parseInt(dom.style.zIndex));
2136                 }
2137                 dom = dom.parentNode;
2138             }
2139             // if we are masking the body - then it hides everything..
2140             if (this.dom == document.body) {
2141                 z = 1000000;
2142                 this._mask.setWidth(Roo.lib.Dom.getDocumentWidth());
2143                 this._mask.setHeight(Roo.lib.Dom.getDocumentHeight());
2144             }
2145            
2146             if(typeof msg == 'string'){
2147                 if(!this._maskMsg){
2148                     this._maskMsg = Roo.DomHelper.append(this.dom, {cls:"roo-el-mask-msg", cn:{tag:'div'}}, true);
2149                 }
2150                 var mm = this._maskMsg;
2151                 mm.dom.className = msgCls ? "roo-el-mask-msg " + msgCls : "roo-el-mask-msg";
2152                 if (mm.dom.firstChild) { // weird IE issue?
2153                     mm.dom.firstChild.innerHTML = msg;
2154                 }
2155                 mm.setDisplayed(true);
2156                 mm.center(this);
2157                 mm.setStyle('z-index', z + 102);
2158             }
2159             if(Roo.isIE && !(Roo.isIE7 && Roo.isStrict) && this.getStyle('height') == 'auto'){ // ie will not expand full height automatically
2160                 this._mask.setHeight(this.getHeight());
2161             }
2162             this._mask.setStyle('z-index', z + 100);
2163             
2164             return this._mask;
2165         },
2166
2167         /**
2168          * Removes a previously applied mask. If removeEl is true the mask overlay is destroyed, otherwise
2169          * it is cached for reuse.
2170          */
2171         unmask : function(removeEl){
2172             if(this._mask){
2173                 if(removeEl === true){
2174                     this._mask.remove();
2175                     delete this._mask;
2176                     if(this._maskMsg){
2177                         this._maskMsg.remove();
2178                         delete this._maskMsg;
2179                     }
2180                 }else{
2181                     this._mask.setDisplayed(false);
2182                     if(this._maskMsg){
2183                         this._maskMsg.setDisplayed(false);
2184                     }
2185                 }
2186             }
2187             this.removeClass("x-masked");
2188         },
2189
2190         /**
2191          * Returns true if this element is masked
2192          * @return {Boolean}
2193          */
2194         isMasked : function(){
2195             return this._mask && this._mask.isVisible();
2196         },
2197
2198         /**
2199          * Creates an iframe shim for this element to keep selects and other windowed objects from
2200          * showing through.
2201          * @return {Roo.Element} The new shim element
2202          */
2203         createShim : function(){
2204             var el = document.createElement('iframe');
2205             el.frameBorder = 'no';
2206             el.className = 'roo-shim';
2207             if(Roo.isIE && Roo.isSecure){
2208                 el.src = Roo.SSL_SECURE_URL;
2209             }
2210             var shim = Roo.get(this.dom.parentNode.insertBefore(el, this.dom));
2211             shim.autoBoxAdjust = false;
2212             return shim;
2213         },
2214
2215         /**
2216          * Removes this element from the DOM and deletes it from the cache
2217          */
2218         remove : function(){
2219             if(this.dom.parentNode){
2220                 this.dom.parentNode.removeChild(this.dom);
2221             }
2222             delete El.cache[this.dom.id];
2223         },
2224
2225         /**
2226          * Sets up event handlers to add and remove a css class when the mouse is over this element
2227          * @param {String} className
2228          * @param {Boolean} preventFlicker (optional) If set to true, it prevents flickering by filtering
2229          * mouseout events for children elements
2230          * @return {Roo.Element} this
2231          */
2232         addClassOnOver : function(className, preventFlicker){
2233             this.on("mouseover", function(){
2234                 Roo.fly(this, '_internal').addClass(className);
2235             }, this.dom);
2236             var removeFn = function(e){
2237                 if(preventFlicker !== true || !e.within(this, true)){
2238                     Roo.fly(this, '_internal').removeClass(className);
2239                 }
2240             };
2241             this.on("mouseout", removeFn, this.dom);
2242             return this;
2243         },
2244
2245         /**
2246          * Sets up event handlers to add and remove a css class when this element has the focus
2247          * @param {String} className
2248          * @return {Roo.Element} this
2249          */
2250         addClassOnFocus : function(className){
2251             this.on("focus", function(){
2252                 Roo.fly(this, '_internal').addClass(className);
2253             }, this.dom);
2254             this.on("blur", function(){
2255                 Roo.fly(this, '_internal').removeClass(className);
2256             }, this.dom);
2257             return this;
2258         },
2259         /**
2260          * Sets up event handlers to add and remove a css class when the mouse is down and then up on this element (a click effect)
2261          * @param {String} className
2262          * @return {Roo.Element} this
2263          */
2264         addClassOnClick : function(className){
2265             var dom = this.dom;
2266             this.on("mousedown", function(){
2267                 Roo.fly(dom, '_internal').addClass(className);
2268                 var d = Roo.get(document);
2269                 var fn = function(){
2270                     Roo.fly(dom, '_internal').removeClass(className);
2271                     d.removeListener("mouseup", fn);
2272                 };
2273                 d.on("mouseup", fn);
2274             });
2275             return this;
2276         },
2277
2278         /**
2279          * Stops the specified event from bubbling and optionally prevents the default action
2280          * @param {String} eventName
2281          * @param {Boolean} preventDefault (optional) true to prevent the default action too
2282          * @return {Roo.Element} this
2283          */
2284         swallowEvent : function(eventName, preventDefault){
2285             var fn = function(e){
2286                 e.stopPropagation();
2287                 if(preventDefault){
2288                     e.preventDefault();
2289                 }
2290             };
2291             if(eventName instanceof Array){
2292                 for(var i = 0, len = eventName.length; i < len; i++){
2293                      this.on(eventName[i], fn);
2294                 }
2295                 return this;
2296             }
2297             this.on(eventName, fn);
2298             return this;
2299         },
2300
2301         /**
2302          * @private
2303          */
2304       fitToParentDelegate : Roo.emptyFn, // keep a reference to the fitToParent delegate
2305
2306         /**
2307          * Sizes this element to its parent element's dimensions performing
2308          * neccessary box adjustments.
2309          * @param {Boolean} monitorResize (optional) If true maintains the fit when the browser window is resized.
2310          * @param {String/HTMLElment/Element} targetParent (optional) The target parent, default to the parentNode.
2311          * @return {Roo.Element} this
2312          */
2313         fitToParent : function(monitorResize, targetParent) {
2314           Roo.EventManager.removeResizeListener(this.fitToParentDelegate); // always remove previous fitToParent delegate from onWindowResize
2315           this.fitToParentDelegate = Roo.emptyFn; // remove reference to previous delegate
2316           if (monitorResize === true && !this.dom.parentNode) { // check if this Element still exists
2317             return;
2318           }
2319           var p = Roo.get(targetParent || this.dom.parentNode);
2320           this.setSize(p.getComputedWidth() - p.getFrameWidth('lr'), p.getComputedHeight() - p.getFrameWidth('tb'));
2321           if (monitorResize === true) {
2322             this.fitToParentDelegate = this.fitToParent.createDelegate(this, [true, targetParent]);
2323             Roo.EventManager.onWindowResize(this.fitToParentDelegate);
2324           }
2325           return this;
2326         },
2327
2328         /**
2329          * Gets the next sibling, skipping text nodes
2330          * @return {HTMLElement} The next sibling or null
2331          */
2332         getNextSibling : function(){
2333             var n = this.dom.nextSibling;
2334             while(n && n.nodeType != 1){
2335                 n = n.nextSibling;
2336             }
2337             return n;
2338         },
2339
2340         /**
2341          * Gets the previous sibling, skipping text nodes
2342          * @return {HTMLElement} The previous sibling or null
2343          */
2344         getPrevSibling : function(){
2345             var n = this.dom.previousSibling;
2346             while(n && n.nodeType != 1){
2347                 n = n.previousSibling;
2348             }
2349             return n;
2350         },
2351
2352
2353         /**
2354          * Appends the passed element(s) to this element
2355          * @param {String/HTMLElement/Array/Element/CompositeElement} el
2356          * @return {Roo.Element} this
2357          */
2358         appendChild: function(el){
2359             el = Roo.get(el);
2360             el.appendTo(this);
2361             return this;
2362         },
2363
2364         /**
2365          * Creates the passed DomHelper config and appends it to this element or optionally inserts it before the passed child element.
2366          * @param {Object} config DomHelper element config object.  If no tag is specified (e.g., {tag:'input'}) then a div will be
2367          * automatically generated with the specified attributes.
2368          * @param {HTMLElement} insertBefore (optional) a child element of this element
2369          * @param {Boolean} returnDom (optional) true to return the dom node instead of creating an Element
2370          * @return {Roo.Element} The new child element
2371          */
2372         createChild: function(config, insertBefore, returnDom){
2373             config = config || {tag:'div'};
2374             if(insertBefore){
2375                 return Roo.DomHelper.insertBefore(insertBefore, config, returnDom !== true);
2376             }
2377             return Roo.DomHelper[!this.dom.firstChild ? 'overwrite' : 'append'](this.dom, config,  returnDom !== true);
2378         },
2379
2380         /**
2381          * Appends this element to the passed element
2382          * @param {String/HTMLElement/Element} el The new parent element
2383          * @return {Roo.Element} this
2384          */
2385         appendTo: function(el){
2386             el = Roo.getDom(el);
2387             el.appendChild(this.dom);
2388             return this;
2389         },
2390
2391         /**
2392          * Inserts this element before the passed element in the DOM
2393          * @param {String/HTMLElement/Element} el The element to insert before
2394          * @return {Roo.Element} this
2395          */
2396         insertBefore: function(el){
2397             el = Roo.getDom(el);
2398             el.parentNode.insertBefore(this.dom, el);
2399             return this;
2400         },
2401
2402         /**
2403          * Inserts this element after the passed element in the DOM
2404          * @param {String/HTMLElement/Element} el The element to insert after
2405          * @return {Roo.Element} this
2406          */
2407         insertAfter: function(el){
2408             el = Roo.getDom(el);
2409             el.parentNode.insertBefore(this.dom, el.nextSibling);
2410             return this;
2411         },
2412
2413         /**
2414          * Inserts (or creates) an element (or DomHelper config) as the first child of the this element
2415          * @param {String/HTMLElement/Element/Object} el The id or element to insert or a DomHelper config to create and insert
2416          * @return {Roo.Element} The new child
2417          */
2418         insertFirst: function(el, returnDom){
2419             el = el || {};
2420             if(typeof el == 'object' && !el.nodeType){ // dh config
2421                 return this.createChild(el, this.dom.firstChild, returnDom);
2422             }else{
2423                 el = Roo.getDom(el);
2424                 this.dom.insertBefore(el, this.dom.firstChild);
2425                 return !returnDom ? Roo.get(el) : el;
2426             }
2427         },
2428
2429         /**
2430          * Inserts (or creates) the passed element (or DomHelper config) as a sibling of this element
2431          * @param {String/HTMLElement/Element/Object} el The id or element to insert or a DomHelper config to create and insert
2432          * @param {String} where (optional) 'before' or 'after' defaults to before
2433          * @param {Boolean} returnDom (optional) True to return the raw DOM element instead of Roo.Element
2434          * @return {Roo.Element} the inserted Element
2435          */
2436         insertSibling: function(el, where, returnDom){
2437             where = where ? where.toLowerCase() : 'before';
2438             el = el || {};
2439             var rt, refNode = where == 'before' ? this.dom : this.dom.nextSibling;
2440
2441             if(typeof el == 'object' && !el.nodeType){ // dh config
2442                 if(where == 'after' && !this.dom.nextSibling){
2443                     rt = Roo.DomHelper.append(this.dom.parentNode, el, !returnDom);
2444                 }else{
2445                     rt = Roo.DomHelper[where == 'after' ? 'insertAfter' : 'insertBefore'](this.dom, el, !returnDom);
2446                 }
2447
2448             }else{
2449                 rt = this.dom.parentNode.insertBefore(Roo.getDom(el),
2450                             where == 'before' ? this.dom : this.dom.nextSibling);
2451                 if(!returnDom){
2452                     rt = Roo.get(rt);
2453                 }
2454             }
2455             return rt;
2456         },
2457
2458         /**
2459          * Creates and wraps this element with another element
2460          * @param {Object} config (optional) DomHelper element config object for the wrapper element or null for an empty div
2461          * @param {Boolean} returnDom (optional) True to return the raw DOM element instead of Roo.Element
2462          * @return {HTMLElement/Element} The newly created wrapper element
2463          */
2464         wrap: function(config, returnDom){
2465             if(!config){
2466                 config = {tag: "div"};
2467             }
2468             var newEl = Roo.DomHelper.insertBefore(this.dom, config, !returnDom);
2469             newEl.dom ? newEl.dom.appendChild(this.dom) : newEl.appendChild(this.dom);
2470             return newEl;
2471         },
2472
2473         /**
2474          * Replaces the passed element with this element
2475          * @param {String/HTMLElement/Element} el The element to replace
2476          * @return {Roo.Element} this
2477          */
2478         replace: function(el){
2479             el = Roo.get(el);
2480             this.insertBefore(el);
2481             el.remove();
2482             return this;
2483         },
2484
2485         /**
2486          * Inserts an html fragment into this element
2487          * @param {String} where Where to insert the html in relation to the this element - beforeBegin, afterBegin, beforeEnd, afterEnd.
2488          * @param {String} html The HTML fragment
2489          * @param {Boolean} returnEl True to return an Roo.Element
2490          * @return {HTMLElement/Roo.Element} The inserted node (or nearest related if more than 1 inserted)
2491          */
2492         insertHtml : function(where, html, returnEl){
2493             var el = Roo.DomHelper.insertHtml(where, this.dom, html);
2494             return returnEl ? Roo.get(el) : el;
2495         },
2496
2497         /**
2498          * Sets the passed attributes as attributes of this element (a style attribute can be a string, object or function)
2499          * @param {Object} o The object with the attributes
2500          * @param {Boolean} useSet (optional) false to override the default setAttribute to use expandos.
2501          * @return {Roo.Element} this
2502          */
2503         set : function(o, useSet){
2504             var el = this.dom;
2505             useSet = typeof useSet == 'undefined' ? (el.setAttribute ? true : false) : useSet;
2506             for(var attr in o){
2507                 if(attr == "style" || typeof o[attr] == "function")  { continue; }
2508                 if(attr=="cls"){
2509                     el.className = o["cls"];
2510                 }else{
2511                     if(useSet) {
2512                         el.setAttribute(attr, o[attr]);
2513                     } else {
2514                         el[attr] = o[attr];
2515                     }
2516                 }
2517             }
2518             if(o.style){
2519                 Roo.DomHelper.applyStyles(el, o.style);
2520             }
2521             return this;
2522         },
2523
2524         /**
2525          * Convenience method for constructing a KeyMap
2526          * @param {Number/Array/Object/String} key Either a string with the keys to listen for, the numeric key code, array of key codes or an object with the following options:
2527          *                                  {key: (number or array), shift: (true/false), ctrl: (true/false), alt: (true/false)}
2528          * @param {Function} fn The function to call
2529          * @param {Object} scope (optional) The scope of the function
2530          * @return {Roo.KeyMap} The KeyMap created
2531          */
2532         addKeyListener : function(key, fn, scope){
2533             var config;
2534             if(typeof key != "object" || key instanceof Array){
2535                 config = {
2536                     key: key,
2537                     fn: fn,
2538                     scope: scope
2539                 };
2540             }else{
2541                 config = {
2542                     key : key.key,
2543                     shift : key.shift,
2544                     ctrl : key.ctrl,
2545                     alt : key.alt,
2546                     fn: fn,
2547                     scope: scope
2548                 };
2549             }
2550             return new Roo.KeyMap(this, config);
2551         },
2552
2553         /**
2554          * Creates a KeyMap for this element
2555          * @param {Object} config The KeyMap config. See {@link Roo.KeyMap} for more details
2556          * @return {Roo.KeyMap} The KeyMap created
2557          */
2558         addKeyMap : function(config){
2559             return new Roo.KeyMap(this, config);
2560         },
2561
2562         /**
2563          * Returns true if this element is scrollable.
2564          * @return {Boolean}
2565          */
2566          isScrollable : function(){
2567             var dom = this.dom;
2568             return dom.scrollHeight > dom.clientHeight || dom.scrollWidth > dom.clientWidth;
2569         },
2570
2571         /**
2572          * Scrolls this element the specified scroll point. It does NOT do bounds checking so if you scroll to a weird value it will try to do it. For auto bounds checking, use scroll().
2573          * @param {String} side Either "left" for scrollLeft values or "top" for scrollTop values.
2574          * @param {Number} value The new scroll value
2575          * @param {Boolean/Object} animate (optional) true for the default animation or a standard Element animation config object
2576          * @return {Element} this
2577          */
2578
2579         scrollTo : function(side, value, animate){
2580             var prop = side.toLowerCase() == "left" ? "scrollLeft" : "scrollTop";
2581             if(!animate || !A){
2582                 this.dom[prop] = value;
2583             }else{
2584                 var to = prop == "scrollLeft" ? [value, this.dom.scrollTop] : [this.dom.scrollLeft, value];
2585                 this.anim({scroll: {"to": to}}, this.preanim(arguments, 2), 'scroll');
2586             }
2587             return this;
2588         },
2589
2590         /**
2591          * Scrolls this element the specified direction. Does bounds checking to make sure the scroll is
2592          * within this element's scrollable range.
2593          * @param {String} direction Possible values are: "l","left" - "r","right" - "t","top","up" - "b","bottom","down".
2594          * @param {Number} distance How far to scroll the element in pixels
2595          * @param {Boolean/Object} animate (optional) true for the default animation or a standard Element animation config object
2596          * @return {Boolean} Returns true if a scroll was triggered or false if the element
2597          * was scrolled as far as it could go.
2598          */
2599          scroll : function(direction, distance, animate){
2600              if(!this.isScrollable()){
2601                  return;
2602              }
2603              var el = this.dom;
2604              var l = el.scrollLeft, t = el.scrollTop;
2605              var w = el.scrollWidth, h = el.scrollHeight;
2606              var cw = el.clientWidth, ch = el.clientHeight;
2607              direction = direction.toLowerCase();
2608              var scrolled = false;
2609              var a = this.preanim(arguments, 2);
2610              switch(direction){
2611                  case "l":
2612                  case "left":
2613                      if(w - l > cw){
2614                          var v = Math.min(l + distance, w-cw);
2615                          this.scrollTo("left", v, a);
2616                          scrolled = true;
2617                      }
2618                      break;
2619                 case "r":
2620                 case "right":
2621                      if(l > 0){
2622                          var v = Math.max(l - distance, 0);
2623                          this.scrollTo("left", v, a);
2624                          scrolled = true;
2625                      }
2626                      break;
2627                 case "t":
2628                 case "top":
2629                 case "up":
2630                      if(t > 0){
2631                          var v = Math.max(t - distance, 0);
2632                          this.scrollTo("top", v, a);
2633                          scrolled = true;
2634                      }
2635                      break;
2636                 case "b":
2637                 case "bottom":
2638                 case "down":
2639                      if(h - t > ch){
2640                          var v = Math.min(t + distance, h-ch);
2641                          this.scrollTo("top", v, a);
2642                          scrolled = true;
2643                      }
2644                      break;
2645              }
2646              return scrolled;
2647         },
2648
2649         /**
2650          * Translates the passed page coordinates into left/top css values for this element
2651          * @param {Number/Array} x The page x or an array containing [x, y]
2652          * @param {Number} y The page y
2653          * @return {Object} An object with left and top properties. e.g. {left: (value), top: (value)}
2654          */
2655         translatePoints : function(x, y){
2656             if(typeof x == 'object' || x instanceof Array){
2657                 y = x[1]; x = x[0];
2658             }
2659             var p = this.getStyle('position');
2660             var o = this.getXY();
2661
2662             var l = parseInt(this.getStyle('left'), 10);
2663             var t = parseInt(this.getStyle('top'), 10);
2664
2665             if(isNaN(l)){
2666                 l = (p == "relative") ? 0 : this.dom.offsetLeft;
2667             }
2668             if(isNaN(t)){
2669                 t = (p == "relative") ? 0 : this.dom.offsetTop;
2670             }
2671
2672             return {left: (x - o[0] + l), top: (y - o[1] + t)};
2673         },
2674
2675         /**
2676          * Returns the current scroll position of the element.
2677          * @return {Object} An object containing the scroll position in the format {left: (scrollLeft), top: (scrollTop)}
2678          */
2679         getScroll : function(){
2680             var d = this.dom, doc = document;
2681             if(d == doc || d == doc.body){
2682                 var l = window.pageXOffset || doc.documentElement.scrollLeft || doc.body.scrollLeft || 0;
2683                 var t = window.pageYOffset || doc.documentElement.scrollTop || doc.body.scrollTop || 0;
2684                 return {left: l, top: t};
2685             }else{
2686                 return {left: d.scrollLeft, top: d.scrollTop};
2687             }
2688         },
2689
2690         /**
2691          * Return the CSS color for the specified CSS attribute. rgb, 3 digit (like #fff) and valid values
2692          * are convert to standard 6 digit hex color.
2693          * @param {String} attr The css attribute
2694          * @param {String} defaultValue The default value to use when a valid color isn't found
2695          * @param {String} prefix (optional) defaults to #. Use an empty string when working with
2696          * YUI color anims.
2697          */
2698         getColor : function(attr, defaultValue, prefix){
2699             var v = this.getStyle(attr);
2700             if(!v || v == "transparent" || v == "inherit") {
2701                 return defaultValue;
2702             }
2703             var color = typeof prefix == "undefined" ? "#" : prefix;
2704             if(v.substr(0, 4) == "rgb("){
2705                 var rvs = v.slice(4, v.length -1).split(",");
2706                 for(var i = 0; i < 3; i++){
2707                     var h = parseInt(rvs[i]).toString(16);
2708                     if(h < 16){
2709                         h = "0" + h;
2710                     }
2711                     color += h;
2712                 }
2713             } else {
2714                 if(v.substr(0, 1) == "#"){
2715                     if(v.length == 4) {
2716                         for(var i = 1; i < 4; i++){
2717                             var c = v.charAt(i);
2718                             color +=  c + c;
2719                         }
2720                     }else if(v.length == 7){
2721                         color += v.substr(1);
2722                     }
2723                 }
2724             }
2725             return(color.length > 5 ? color.toLowerCase() : defaultValue);
2726         },
2727
2728         /**
2729          * Wraps the specified element with a special markup/CSS block that renders by default as a gray container with a
2730          * gradient background, rounded corners and a 4-way shadow.
2731          * @param {String} class (optional) A base CSS class to apply to the containing wrapper element (defaults to 'x-box').
2732          * Note that there are a number of CSS rules that are dependent on this name to make the overall effect work,
2733          * so if you supply an alternate base class, make sure you also supply all of the necessary rules.
2734          * @return {Roo.Element} this
2735          */
2736         boxWrap : function(cls){
2737             cls = cls || 'x-box';
2738             var el = Roo.get(this.insertHtml('beforeBegin', String.format('<div class="{0}">'+El.boxMarkup+'</div>', cls)));
2739             el.child('.'+cls+'-mc').dom.appendChild(this.dom);
2740             return el;
2741         },
2742
2743         /**
2744          * Returns the value of a namespaced attribute from the element's underlying DOM node.
2745          * @param {String} namespace The namespace in which to look for the attribute
2746          * @param {String} name The attribute name
2747          * @return {String} The attribute value
2748          */
2749         getAttributeNS : Roo.isIE ? function(ns, name){
2750             var d = this.dom;
2751             var type = typeof d[ns+":"+name];
2752             if(type != 'undefined' && type != 'unknown'){
2753                 return d[ns+":"+name];
2754             }
2755             return d[name];
2756         } : function(ns, name){
2757             var d = this.dom;
2758             return d.getAttributeNS(ns, name) || d.getAttribute(ns+":"+name) || d.getAttribute(name) || d[name];
2759         },
2760         
2761         
2762         /**
2763          * Sets or Returns the value the dom attribute value
2764          * @param {String|Object} name The attribute name (or object to set multiple attributes)
2765          * @param {String} value (optional) The value to set the attribute to
2766          * @return {String} The attribute value
2767          */
2768         attr : function(name){
2769             if (arguments.length > 1) {
2770                 this.dom.setAttribute(name, arguments[1]);
2771                 return arguments[1];
2772             }
2773             if (typeof(name) == 'object') {
2774                 for(var i in name) {
2775                     this.attr(i, name[i]);
2776                 }
2777                 return name;
2778             }
2779             
2780             
2781             if (!this.dom.hasAttribute(name)) {
2782                 return undefined;
2783             }
2784             return this.dom.getAttribute(name);
2785         }
2786         
2787         
2788         
2789     };
2790
2791     var ep = El.prototype;
2792
2793     /**
2794      * Appends an event handler (Shorthand for addListener)
2795      * @param {String}   eventName     The type of event to append
2796      * @param {Function} fn        The method the event invokes
2797      * @param {Object} scope       (optional) The scope (this object) of the fn
2798      * @param {Object}   options   (optional)An object with standard {@link Roo.EventManager#addListener} options
2799      * @method
2800      */
2801     ep.on = ep.addListener;
2802         // backwards compat
2803     ep.mon = ep.addListener;
2804
2805     /**
2806      * Removes an event handler from this element (shorthand for removeListener)
2807      * @param {String} eventName the type of event to remove
2808      * @param {Function} fn the method the event invokes
2809      * @return {Roo.Element} this
2810      * @method
2811      */
2812     ep.un = ep.removeListener;
2813
2814     /**
2815      * true to automatically adjust width and height settings for box-model issues (default to true)
2816      */
2817     ep.autoBoxAdjust = true;
2818
2819     // private
2820     El.unitPattern = /\d+(px|em|%|en|ex|pt|in|cm|mm|pc)$/i;
2821
2822     // private
2823     El.addUnits = function(v, defaultUnit){
2824         if(v === "" || v == "auto"){
2825             return v;
2826         }
2827         if(v === undefined){
2828             return '';
2829         }
2830         if(typeof v == "number" || !El.unitPattern.test(v)){
2831             return v + (defaultUnit || 'px');
2832         }
2833         return v;
2834     };
2835
2836     // special markup used throughout Roo when box wrapping elements
2837     El.boxMarkup = '<div class="{0}-tl"><div class="{0}-tr"><div class="{0}-tc"></div></div></div><div class="{0}-ml"><div class="{0}-mr"><div class="{0}-mc"></div></div></div><div class="{0}-bl"><div class="{0}-br"><div class="{0}-bc"></div></div></div>';
2838     /**
2839      * Visibility mode constant - Use visibility to hide element
2840      * @static
2841      * @type Number
2842      */
2843     El.VISIBILITY = 1;
2844     /**
2845      * Visibility mode constant - Use display to hide element
2846      * @static
2847      * @type Number
2848      */
2849     El.DISPLAY = 2;
2850
2851     El.borders = {l: "border-left-width", r: "border-right-width", t: "border-top-width", b: "border-bottom-width"};
2852     El.paddings = {l: "padding-left", r: "padding-right", t: "padding-top", b: "padding-bottom"};
2853     El.margins = {l: "margin-left", r: "margin-right", t: "margin-top", b: "margin-bottom"};
2854
2855
2856
2857     /**
2858      * @private
2859      */
2860     El.cache = {};
2861
2862     var docEl;
2863
2864     /**
2865      * Static method to retrieve Element objects. Uses simple caching to consistently return the same object.
2866      * Automatically fixes if an object was recreated with the same id via AJAX or DOM.
2867      * @param {String/HTMLElement/Element} el The id of the node, a DOM Node or an existing Element.
2868      * @return {Element} The Element object
2869      * @static
2870      */
2871     El.get = function(el){
2872         var ex, elm, id;
2873         if(!el){ return null; }
2874         if(typeof el == "string"){ // element id
2875             if(!(elm = document.getElementById(el))){
2876                 return null;
2877             }
2878             if(ex = El.cache[el]){
2879                 ex.dom = elm;
2880             }else{
2881                 ex = El.cache[el] = new El(elm);
2882             }
2883             return ex;
2884         }else if(el.tagName){ // dom element
2885             if(!(id = el.id)){
2886                 id = Roo.id(el);
2887             }
2888             if(ex = El.cache[id]){
2889                 ex.dom = el;
2890             }else{
2891                 ex = El.cache[id] = new El(el);
2892             }
2893             return ex;
2894         }else if(el instanceof El){
2895             if(el != docEl){
2896                 el.dom = document.getElementById(el.id) || el.dom; // refresh dom element in case no longer valid,
2897                                                               // catch case where it hasn't been appended
2898                 El.cache[el.id] = el; // in case it was created directly with Element(), let's cache it
2899             }
2900             return el;
2901         }else if(el.isComposite){
2902             return el;
2903         }else if(el instanceof Array){
2904             return El.select(el);
2905         }else if(el == document){
2906             // create a bogus element object representing the document object
2907             if(!docEl){
2908                 var f = function(){};
2909                 f.prototype = El.prototype;
2910                 docEl = new f();
2911                 docEl.dom = document;
2912             }
2913             return docEl;
2914         }
2915         return null;
2916     };
2917
2918     // private
2919     El.uncache = function(el){
2920         for(var i = 0, a = arguments, len = a.length; i < len; i++) {
2921             if(a[i]){
2922                 delete El.cache[a[i].id || a[i]];
2923             }
2924         }
2925     };
2926
2927     // private
2928     // Garbage collection - uncache elements/purge listeners on orphaned elements
2929     // so we don't hold a reference and cause the browser to retain them
2930     El.garbageCollect = function(){
2931         if(!Roo.enableGarbageCollector){
2932             clearInterval(El.collectorThread);
2933             return;
2934         }
2935         for(var eid in El.cache){
2936             var el = El.cache[eid], d = el.dom;
2937             // -------------------------------------------------------
2938             // Determining what is garbage:
2939             // -------------------------------------------------------
2940             // !d
2941             // dom node is null, definitely garbage
2942             // -------------------------------------------------------
2943             // !d.parentNode
2944             // no parentNode == direct orphan, definitely garbage
2945             // -------------------------------------------------------
2946             // !d.offsetParent && !document.getElementById(eid)
2947             // display none elements have no offsetParent so we will
2948             // also try to look it up by it's id. However, check
2949             // offsetParent first so we don't do unneeded lookups.
2950             // This enables collection of elements that are not orphans
2951             // directly, but somewhere up the line they have an orphan
2952             // parent.
2953             // -------------------------------------------------------
2954             if(!d || !d.parentNode || (!d.offsetParent && !document.getElementById(eid))){
2955                 delete El.cache[eid];
2956                 if(d && Roo.enableListenerCollection){
2957                     E.purgeElement(d);
2958                 }
2959             }
2960         }
2961     }
2962     El.collectorThreadId = setInterval(El.garbageCollect, 30000);
2963
2964
2965     // dom is optional
2966     El.Flyweight = function(dom){
2967         this.dom = dom;
2968     };
2969     El.Flyweight.prototype = El.prototype;
2970
2971     El._flyweights = {};
2972     /**
2973      * Gets the globally shared flyweight Element, with the passed node as the active element. Do not store a reference to this element -
2974      * the dom node can be overwritten by other code.
2975      * @param {String/HTMLElement} el The dom node or id
2976      * @param {String} named (optional) Allows for creation of named reusable flyweights to
2977      *                                  prevent conflicts (e.g. internally Roo uses "_internal")
2978      * @static
2979      * @return {Element} The shared Element object
2980      */
2981     El.fly = function(el, named){
2982         named = named || '_global';
2983         el = Roo.getDom(el);
2984         if(!el){
2985             return null;
2986         }
2987         if(!El._flyweights[named]){
2988             El._flyweights[named] = new El.Flyweight();
2989         }
2990         El._flyweights[named].dom = el;
2991         return El._flyweights[named];
2992     };
2993
2994     /**
2995      * Static method to retrieve Element objects. Uses simple caching to consistently return the same object.
2996      * Automatically fixes if an object was recreated with the same id via AJAX or DOM.
2997      * Shorthand of {@link Roo.Element#get}
2998      * @param {String/HTMLElement/Element} el The id of the node, a DOM Node or an existing Element.
2999      * @return {Element} The Element object
3000      * @member Roo
3001      * @method get
3002      */
3003     Roo.get = El.get;
3004     /**
3005      * Gets the globally shared flyweight Element, with the passed node as the active element. Do not store a reference to this element -
3006      * the dom node can be overwritten by other code.
3007      * Shorthand of {@link Roo.Element#fly}
3008      * @param {String/HTMLElement} el The dom node or id
3009      * @param {String} named (optional) Allows for creation of named reusable flyweights to
3010      *                                  prevent conflicts (e.g. internally Roo uses "_internal")
3011      * @static
3012      * @return {Element} The shared Element object
3013      * @member Roo
3014      * @method fly
3015      */
3016     Roo.fly = El.fly;
3017
3018     // speedy lookup for elements never to box adjust
3019     var noBoxAdjust = Roo.isStrict ? {
3020         select:1
3021     } : {
3022         input:1, select:1, textarea:1
3023     };
3024     if(Roo.isIE || Roo.isGecko){
3025         noBoxAdjust['button'] = 1;
3026     }
3027
3028
3029     Roo.EventManager.on(window, 'unload', function(){
3030         delete El.cache;
3031         delete El._flyweights;
3032     });
3033 })();
3034
3035
3036
3037
3038 if(Roo.DomQuery){
3039     Roo.Element.selectorFunction = Roo.DomQuery.select;
3040 }
3041
3042 Roo.Element.select = function(selector, unique, root){
3043     var els;
3044     if(typeof selector == "string"){
3045         els = Roo.Element.selectorFunction(selector, root);
3046     }else if(selector.length !== undefined){
3047         els = selector;
3048     }else{
3049         throw "Invalid selector";
3050     }
3051     if(unique === true){
3052         return new Roo.CompositeElement(els);
3053     }else{
3054         return new Roo.CompositeElementLite(els);
3055     }
3056 };
3057 /**
3058  * Selects elements based on the passed CSS selector to enable working on them as 1.
3059  * @param {String/Array} selector The CSS selector or an array of elements
3060  * @param {Boolean} unique (optional) true to create a unique Roo.Element for each element (defaults to a shared flyweight object)
3061  * @param {HTMLElement/String} root (optional) The root element of the query or id of the root
3062  * @return {CompositeElementLite/CompositeElement}
3063  * @member Roo
3064  * @method select
3065  */
3066 Roo.select = Roo.Element.select;
3067
3068
3069
3070
3071
3072
3073
3074
3075
3076
3077
3078
3079
3080