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