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