Upgrade to ExtJS 3.1.0 - Released 12/16/2009
[extjs.git] / docs / source / yui-bridge.html
1 <html>\r
2 <head>\r
3   <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />    \r
4   <title>The source code</title>\r
5     <link href="../resources/prettify/prettify.css" type="text/css" rel="stylesheet" />\r
6     <script type="text/javascript" src="../resources/prettify/prettify.js"></script>\r
7 </head>\r
8 <body  onload="prettyPrint();">\r
9     <pre class="prettyprint lang-js">if(typeof YAHOO == "undefined"){
10     throw "Unable to load Ext, core YUI utilities (yahoo, dom, event) not found.";
11 }
12
13 (function(){
14     var E = YAHOO.util.Event,
15         D = YAHOO.util.Dom,
16         CN = YAHOO.util.Connect,
17         ES = YAHOO.util.Easing,
18         A = YAHOO.util.Anim,
19         libFlyweight,
20         version = YAHOO.env.getVersion('yahoo').version.split('.'),
21         mouseEnterSupported = parseInt(version[0]) >= 3,
22         mouseCache = {},
23         elContains = function(parent, child){
24             if(parent && parent.firstChild){
25                 while(child){
26                     if(child === parent){
27                         return true;
28                     }
29                     child = child.parentNode;
30                     if(child && (child.nodeType != 1)){
31                         child = null;
32                     }
33                 }
34             }
35             return false;
36         }, checkRelatedTarget = function(e){
37             return !elContains(e.currentTarget, Ext.lib.Event.getRelatedTarget(e));
38         };
39
40 Ext.lib.Dom = {
41     getViewWidth : function(full){
42         return full ? D.getDocumentWidth() : D.getViewportWidth();
43     },
44
45     getViewHeight : function(full){
46         return full ? D.getDocumentHeight() : D.getViewportHeight();
47     },
48
49     isAncestor : function(haystack, needle){
50         return D.isAncestor(haystack, needle);
51     },
52
53     getRegion : function(el){
54         return D.getRegion(el);
55     },
56
57     getY : function(el){
58         return this.getXY(el)[1];
59     },
60
61     getX : function(el){
62         return this.getXY(el)[0];
63     },
64
65     // original version based on YahooUI getXY
66     // this version fixes several issues in Safari and FF
67     // and boosts performance by removing the batch overhead, repetitive dom lookups and array index calls
68     getXY : function(el){
69         var p, pe, b, scroll, bd = (document.body || document.documentElement);
70         el = Ext.getDom(el);
71
72         if(el == bd){
73             return [0, 0];
74         }
75
76         if (el.getBoundingClientRect) {
77             b = el.getBoundingClientRect();
78             scroll = fly(document).getScroll();
79             return [Math.round(b.left + scroll.left), Math.round(b.top + scroll.top)];
80         }
81         var x = 0, y = 0;
82
83         p = el;
84
85         var hasAbsolute = fly(el).getStyle("position") == "absolute";
86
87         while (p) {
88
89             x += p.offsetLeft;
90             y += p.offsetTop;
91
92             if (!hasAbsolute && fly(p).getStyle("position") == "absolute") {
93                 hasAbsolute = true;
94             }
95
96             if (Ext.isGecko) {
97                 pe = fly(p);
98
99                 var bt = parseInt(pe.getStyle("borderTopWidth"), 10) || 0;
100                 var bl = parseInt(pe.getStyle("borderLeftWidth"), 10) || 0;
101
102
103                 x += bl;
104                 y += bt;
105
106
107                 if (p != el && pe.getStyle('overflow') != 'visible') {
108                     x += bl;
109                     y += bt;
110                 }
111             }
112             p = p.offsetParent;
113         }
114
115         if (Ext.isSafari && hasAbsolute) {
116             x -= bd.offsetLeft;
117             y -= bd.offsetTop;
118         }
119
120         if (Ext.isGecko && !hasAbsolute) {
121             var dbd = fly(bd);
122             x += parseInt(dbd.getStyle("borderLeftWidth"), 10) || 0;
123             y += parseInt(dbd.getStyle("borderTopWidth"), 10) || 0;
124         }
125
126         p = el.parentNode;
127         while (p && p != bd) {
128             if (!Ext.isOpera || (p.tagName != 'TR' && fly(p).getStyle("display") != "inline")) {
129                 x -= p.scrollLeft;
130                 y -= p.scrollTop;
131             }
132             p = p.parentNode;
133         }
134         return [x, y];
135     },
136
137     setXY : function(el, xy){
138         el = Ext.fly(el, '_setXY');
139         el.position();
140         var pts = el.translatePoints(xy);
141         if(xy[0] !== false){
142             el.dom.style.left = pts.left + "px";
143         }
144         if(xy[1] !== false){
145             el.dom.style.top = pts.top + "px";
146         }
147     },
148
149     setX : function(el, x){
150         this.setXY(el, [x, false]);
151     },
152
153     setY : function(el, y){
154         this.setXY(el, [false, y]);
155     }
156 };
157
158 Ext.lib.Event = {
159     getPageX : function(e){
160         return E.getPageX(e.browserEvent || e);
161     },
162
163     getPageY : function(e){
164         return E.getPageY(e.browserEvent || e);
165     },
166
167     getXY : function(e){
168         return E.getXY(e.browserEvent || e);
169     },
170
171     getTarget : function(e){
172         return E.getTarget(e.browserEvent || e);
173     },
174
175     getRelatedTarget : function(e){
176         return E.getRelatedTarget(e.browserEvent || e);
177     },
178
179     on : function(el, eventName, fn, scope, override){
180         if((eventName == 'mouseenter' || eventName == 'mouseleave') && !mouseEnterSupported){
181             var item = mouseCache[el.id] || (mouseCache[el.id] = {});
182             item[eventName] = fn;
183             fn = fn.createInterceptor(checkRelatedTarget);
184             eventName = (eventName == 'mouseenter') ? 'mouseover' : 'mouseout';
185         }
186         E.on(el, eventName, fn, scope, override);
187     },
188
189     un : function(el, eventName, fn){
190         if((eventName == 'mouseenter' || eventName == 'mouseleave') && !mouseEnterSupported){
191             var item = mouseCache[el.id], 
192                 ev = item && item[eventName];
193
194             if(ev){
195                 fn = ev.fn;
196                 delete item[eventName];
197                 eventName = (eventName == 'mouseenter') ? 'mouseover' : 'mouseout';
198             }
199         }
200         E.removeListener(el, eventName, fn);;
201     },
202
203     purgeElement : function(el){
204         E.purgeElement(el);
205     },
206
207     preventDefault : function(e){
208         E.preventDefault(e.browserEvent || e);
209     },
210
211     stopPropagation : function(e){
212         E.stopPropagation(e.browserEvent || e);
213     },
214
215     stopEvent : function(e){
216         E.stopEvent(e.browserEvent || e);
217     },
218
219     onAvailable : function(el, fn, scope, override){
220         return E.onAvailable(el, fn, scope, override);
221     }
222 };
223
224 Ext.lib.Ajax = {
225     request : function(method, uri, cb, data, options){
226         if(options){
227             var hs = options.headers;
228             if(hs){
229                 for(var h in hs){
230                     if(hs.hasOwnProperty(h)){
231                         CN.initHeader(h, hs[h], false);
232                     }
233                 }
234             }
235             if(options.xmlData){
236                 if (!hs || !hs['Content-Type']){
237                     CN.initHeader('Content-Type', 'text/xml', false);
238                 }
239                 method = (method ? method : (options.method ? options.method : 'POST'));
240                 data = options.xmlData;
241             }else if(options.jsonData){
242                 if (!hs || !hs['Content-Type']){
243                     CN.initHeader('Content-Type', 'application/json', false);
244                 }
245                 method = (method ? method : (options.method ? options.method : 'POST'));
246                 data = typeof options.jsonData == 'object' ? Ext.encode(options.jsonData) : options.jsonData;
247             }
248         }
249         return CN.asyncRequest(method, uri, cb, data);
250     },
251
252     formRequest : function(form, uri, cb, data, isUpload, sslUri){
253         CN.setForm(form, isUpload, sslUri);
254         return CN.asyncRequest(Ext.getDom(form).method ||'POST', uri, cb, data);
255     },
256
257     isCallInProgress : function(trans){
258         return CN.isCallInProgress(trans);
259     },
260
261     abort : function(trans){
262         return CN.abort(trans);
263     },
264
265     serializeForm : function(form){
266         var d = CN.setForm(form.dom || form);
267         CN.resetFormState();
268         return d;
269     }
270 };
271
272 Ext.lib.Region = YAHOO.util.Region;
273 Ext.lib.Point = YAHOO.util.Point;
274
275
276 Ext.lib.Anim = {
277     scroll : function(el, args, duration, easing, cb, scope){
278         this.run(el, args, duration, easing, cb, scope, YAHOO.util.Scroll);
279     },
280
281     motion : function(el, args, duration, easing, cb, scope){
282         this.run(el, args, duration, easing, cb, scope, YAHOO.util.Motion);
283     },
284
285     color : function(el, args, duration, easing, cb, scope){
286         this.run(el, args, duration, easing, cb, scope, YAHOO.util.ColorAnim);
287     },
288
289     run : function(el, args, duration, easing, cb, scope, type){
290         type = type || YAHOO.util.Anim;
291         if(typeof easing == "string"){
292             easing = YAHOO.util.Easing[easing];
293         }
294         var anim = new type(el, args, duration, easing);
295         anim.animateX(function(){
296             Ext.callback(cb, scope);
297         });
298         return anim;
299     }
300 };
301
302 // all lib flyweight calls use their own flyweight to prevent collisions with developer flyweights
303 function fly(el){
304     if(!libFlyweight){
305         libFlyweight = new Ext.Element.Flyweight();
306     }
307     libFlyweight.dom = el;
308     return libFlyweight;
309 }
310
311 // prevent IE leaks
312 if(Ext.isIE) {
313     function fnCleanUp() {
314         var p = Function.prototype;
315         delete p.createSequence;
316         delete p.defer;
317         delete p.createDelegate;
318         delete p.createCallback;
319         delete p.createInterceptor;
320
321         window.detachEvent("onunload", fnCleanUp);
322     }
323     window.attachEvent("onunload", fnCleanUp);
324 }
325 // various overrides
326
327 // add ability for callbacks with animations
328 if(YAHOO.util.Anim){
329     YAHOO.util.Anim.prototype.animateX = function(callback, scope){
330         var f = function(){
331             this.onComplete.unsubscribe(f);
332             if(typeof callback == "function"){
333                 callback.call(scope || this, this);
334             }
335         };
336         this.onComplete.subscribe(f, this, true);
337         this.animate();
338     };
339 }
340
341 if(YAHOO.util.DragDrop && Ext.dd.DragDrop){
342     YAHOO.util.DragDrop.defaultPadding = Ext.dd.DragDrop.defaultPadding;
343     YAHOO.util.DragDrop.constrainTo = Ext.dd.DragDrop.constrainTo;
344 }
345
346 YAHOO.util.Dom.getXY = function(el) {
347     var f = function(el) {
348         return Ext.lib.Dom.getXY(el);
349     };
350     return YAHOO.util.Dom.batch(el, f, YAHOO.util.Dom, true);
351 };
352
353
354 // workaround for Safari anim duration speed problems
355 if(YAHOO.util.AnimMgr){
356     YAHOO.util.AnimMgr.fps = 1000;
357 }
358
359 YAHOO.util.Region.prototype.adjust = function(t, l, b, r){
360     this.top += t;
361     this.left += l;
362     this.right += r;
363     this.bottom += b;
364     return this;
365 };
366     
367 YAHOO.util.Region.prototype.constrainTo = function(r) {
368     this.top = this.top.constrain(r.top, r.bottom);
369     this.bottom = this.bottom.constrain(r.top, r.bottom);
370     this.left = this.left.constrain(r.left, r.right);
371     this.right = this.right.constrain(r.left, r.right);
372     return this;
373 };
374
375
376 })();</pre>    \r
377 </body>\r
378 </html>