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