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