4 * Copyright(c) 2006-2007, Ext JS, LLC.
6 * Originally Released Under LGPL - original licence link has changed is not relivant.
9 * <script type="text/javascript">
17 window["undefined"] = window["undefined"];
21 * Roo core utilities and functions.
26 * Copies all the properties of config to obj.
27 * @param {Object} obj The receiver of the properties
28 * @param {Object} config The source of the properties
29 * @param {Object} defaults A different object that will also be applied for default values
30 * @return {Object} returns obj
35 Roo.apply = function(o, c, defaults){
37 // no "this" reference for friendly out of scope calls
38 Roo.apply(o, defaults);
40 if(o && c && typeof c == 'object'){
51 var ua = navigator.userAgent.toLowerCase();
53 var isStrict = document.compatMode == "CSS1Compat",
54 isOpera = ua.indexOf("opera") > -1,
55 isSafari = (/webkit|khtml/).test(ua),
56 isIE = ua.indexOf("msie") > -1,
57 isIE7 = ua.indexOf("msie 7") > -1,
58 isGecko = !isSafari && ua.indexOf("gecko") > -1,
59 isBorderBox = isIE && !isStrict,
60 isWindows = (ua.indexOf("windows") != -1 || ua.indexOf("win32") != -1),
61 isMac = (ua.indexOf("macintosh") != -1 || ua.indexOf("mac os x") != -1),
62 isLinux = (ua.indexOf("linux") != -1),
63 isSecure = window.location.href.toLowerCase().indexOf("https") === 0,
64 isTouch = 'ontouchstart' in window || window.DocumentTouch && document instanceof DocumentTouch;
65 // remove css image flicker
68 document.execCommand("BackgroundImageCache", false, true);
74 * True if the browser is in strict mode
79 * True if the page is running over SSL
84 * True when the document is fully initialized and ready for action
89 * Turn on debugging output (currently only the factory uses this)
96 * True to automatically uncache orphaned Roo.Elements periodically (defaults to true)
99 enableGarbageCollector : true,
102 * True to automatically purge event listeners after uncaching an element (defaults to false).
103 * Note: this only happens if enableGarbageCollector is true.
106 enableListenerCollection:false,
109 * URL to a blank file used by Roo when in secure mode for iframe src and onReady src to prevent
110 * the IE insecure content warning (defaults to javascript:false).
113 SSL_SECURE_URL : "javascript:false",
116 * URL to a 1x1 transparent gif image used by Roo to create inline icons with CSS background images. (Defaults to
117 * "http://Roojs.com/s.gif" and you should change this to a URL on your server).
120 BLANK_IMAGE_URL : "http:/"+"/localhost/s.gif",
122 emptyFn : function(){},
125 * Copies all the properties of config to obj if they don't already exist.
126 * @param {Object} obj The receiver of the properties
127 * @param {Object} config The source of the properties
128 * @return {Object} returns obj
130 applyIf : function(o, c){
133 if(typeof o[p] == "undefined"){ o[p] = c[p]; }
140 * Applies event listeners to elements by selectors when the document is ready.
141 * The event name is specified with an @ suffix.
144 // add a listener for click on all anchors in element with id foo
145 '#foo a@click' : function(e, t){
149 // add the same listener to multiple selectors (separated by comma BEFORE the @)
150 '#foo a, #bar span.some-class@mouseover' : function(){
155 * @param {Object} obj The list of behaviors to apply
157 addBehaviors : function(o){
159 Roo.onReady(function(){
164 var cache = {}; // simple cache for applying multiple behaviors to same selector does query multiple times
166 var parts = b.split('@');
167 if(parts[1]){ // for Object prototype breakers
170 cache[s] = Roo.select(s);
172 cache[s].on(parts[1], o[b]);
179 * Generates unique ids. If the element already has an id, it is unchanged
180 * @param {String/HTMLElement/Element} el (optional) The element to generate an id for
181 * @param {String} prefix (optional) Id prefix (defaults "Roo-gen")
182 * @return {String} The generated Id.
184 id : function(el, prefix){
185 prefix = prefix || "roo-gen";
187 var id = prefix + (++idSeed);
188 return el ? (el.id ? el.id : (el.id = id)) : id;
193 * Extends one class with another class and optionally overrides members with the passed literal. This class
194 * also adds the function "override()" to the class that can be used to override
195 * members on an instance.
196 * @param {Object} subclass The class inheriting the functionality
197 * @param {Object} superclass The class being extended
198 * @param {Object} overrides (optional) A literal with members
203 var io = function(o){
208 return function(sb, sp, overrides){
209 if(typeof sp == 'object'){ // eg. prototype, rather than function constructor..
212 sb = function(){sp.apply(this, arguments);};
214 var F = function(){}, sbp, spp = sp.prototype;
216 sbp = sb.prototype = new F();
220 if(spp.constructor == Object.prototype.constructor){
225 sb.override = function(o){
229 Roo.override(sb, overrides);
235 * Adds a list of functions to the prototype of an existing class, overwriting any existing methods with the same name.
237 Roo.override(MyClass, {
238 newMethod1: function(){
241 newMethod2: function(foo){
246 * @param {Object} origclass The class to override
247 * @param {Object} overrides The list of functions to add to origClass. This should be specified as an object literal
248 * containing one or more methods.
251 override : function(origclass, overrides){
253 var p = origclass.prototype;
254 for(var method in overrides){
255 p[method] = overrides[method];
260 * Creates namespaces to be used for scoping variables and classes so that they are not global. Usage:
262 Roo.namespace('Company', 'Company.data');
263 Company.Widget = function() { ... }
264 Company.data.CustomStore = function(config) { ... }
266 * @param {String} namespace1
267 * @param {String} namespace2
268 * @param {String} etc
271 namespace : function(){
272 var a=arguments, o=null, i, j, d, rt;
273 for (i=0; i<a.length; ++i) {
277 eval('if (typeof ' + rt + ' == "undefined"){' + rt + ' = {};} o = ' + rt + ';');
278 for (j=1; j<d.length; ++j) {
279 o[d[j]]=o[d[j]] || {};
285 * Creates namespaces to be used for scoping variables and classes so that they are not global. Usage:
287 Roo.factory({ xns: Roo.data, xtype : 'Store', .....});
288 Roo.factory(conf, Roo.data);
290 * @param {String} classname
291 * @param {String} namespace (optional)
295 factory : function(c, ns)
297 // no xtype, no ns or c.xns - or forced off by c.xns
298 if (!c.xtype || (!ns && !c.xns) || (c.xns === false)) { // not enough info...
301 ns = c.xns ? c.xns : ns; // if c.xns is set, then use that..
302 if (c.constructor == ns[c.xtype]) {// already created...
306 if (Roo.debug) Roo.log("Roo.Factory(" + c.xtype + ")");
307 var ret = new ns[c.xtype](c);
311 c.xns = false; // prevent recursion..
315 * Logs to console if it can.
317 * @param {String|Object} string
322 if ((typeof(console) == 'undefined') || (typeof(console.log) == 'undefined')) {
329 * Takes an object and converts it to an encoded URL. e.g. Roo.urlEncode({foo: 1, bar: 2}); would return "foo=1&bar=2". Optionally, property values can be arrays, instead of keys and the resulting string that's returned will contain a name/value pair for each array value.
333 urlEncode : function(o){
339 var ov = o[key], k = Roo.encodeURIComponent(key);
340 var type = typeof ov;
341 if(type == 'undefined'){
343 }else if(type != "function" && type != "object"){
344 buf.push(k, "=", Roo.encodeURIComponent(ov), "&");
345 }else if(ov instanceof Array){
347 for(var i = 0, len = ov.length; i < len; i++) {
348 buf.push(k, "=", Roo.encodeURIComponent(ov[i] === undefined ? '' : ov[i]), "&");
359 * Safe version of encodeURIComponent
360 * @param {String} data
364 encodeURIComponent : function (data)
367 return encodeURIComponent(data);
368 } catch(e) {} // should be an uri encode error.
370 if (data == '' || data == null){
373 // http://stackoverflow.com/questions/2596483/unicode-and-uri-encoding-decoding-and-escaping-in-javascript
374 function nibble_to_hex(nibble){
375 var chars = '0123456789ABCDEF';
376 return chars.charAt(nibble);
378 data = data.toString();
380 for(var i=0; i<data.length; i++){
381 var c = data.charCodeAt(i);
382 var bs = new Array();
385 bs[0] = 0xF0 | ((c & 0x1C0000) >>> 18);
386 bs[1] = 0x80 | ((c & 0x3F000) >>> 12);
387 bs[2] = 0x80 | ((c & 0xFC0) >>> 6);
388 bs[3] = 0x80 | (c & 0x3F);
389 }else if (c > 0x800){
391 bs[0] = 0xE0 | ((c & 0xF000) >>> 12);
392 bs[1] = 0x80 | ((c & 0xFC0) >>> 6);
393 bs[2] = 0x80 | (c & 0x3F);
396 bs[0] = 0xC0 | ((c & 0x7C0) >>> 6);
397 bs[1] = 0x80 | (c & 0x3F);
402 for(var j=0; j<bs.length; j++){
404 var hex = nibble_to_hex((b & 0xF0) >>> 4)
405 + nibble_to_hex(b &0x0F);
414 * Takes an encoded URL and and converts it to an object. e.g. Roo.urlDecode("foo=1&bar=2"); would return {foo: 1, bar: 2} or Roo.urlDecode("foo=1&bar=2&bar=3&bar=4", true); would return {foo: 1, bar: [2, 3, 4]}.
415 * @param {String} string
416 * @param {Boolean} overwrite (optional) Items of the same name will overwrite previous values instead of creating an an array (Defaults to false).
417 * @return {Object} A literal with members
419 urlDecode : function(string, overwrite){
420 if(!string || !string.length){
424 var pairs = string.split('&');
425 var pair, name, value;
426 for(var i = 0, len = pairs.length; i < len; i++){
427 pair = pairs[i].split('=');
428 name = decodeURIComponent(pair[0]);
429 value = decodeURIComponent(pair[1]);
430 if(overwrite !== true){
431 if(typeof obj[name] == "undefined"){
433 }else if(typeof obj[name] == "string"){
434 obj[name] = [obj[name]];
435 obj[name].push(value);
437 obj[name].push(value);
447 * Iterates an array calling the passed function with each item, stopping if your function returns false. If the
448 * passed array is not really an array, your function is called once with it.
449 * The supplied function is called with (Object item, Number index, Array allItems).
450 * @param {Array/NodeList/Mixed} array
451 * @param {Function} fn
452 * @param {Object} scope
454 each : function(array, fn, scope){
455 if(typeof array.length == "undefined" || typeof array == "string"){
458 for(var i = 0, len = array.length; i < len; i++){
459 if(fn.call(scope || array[i], array[i], i, array) === false){ return i; };
464 combine : function(){
465 var as = arguments, l = as.length, r = [];
466 for(var i = 0; i < l; i++){
468 if(a instanceof Array){
470 }else if(a.length !== undefined && !a.substr){
471 r = r.concat(Array.prototype.slice.call(a, 0));
480 * Escapes the passed string for use in a regular expression
481 * @param {String} str
484 escapeRe : function(s) {
485 return s.replace(/([.*+?^${}()|[\]\/\\])/g, "\\$1");
489 callback : function(cb, scope, args, delay){
490 if(typeof cb == "function"){
492 cb.defer(delay, scope, args || []);
494 cb.apply(scope, args || []);
500 * Return the dom node for the passed string (id), dom node, or Roo.Element
501 * @param {String/HTMLElement/Roo.Element} el
502 * @return HTMLElement
504 getDom : function(el){
508 return el.dom ? el.dom : (typeof el == 'string' ? document.getElementById(el) : el);
512 * Shorthand for {@link Roo.ComponentMgr#get}
514 * @return Roo.Component
516 getCmp : function(id){
517 return Roo.ComponentMgr.get(id);
520 num : function(v, defaultValue){
521 if(typeof v != 'number'){
527 destroy : function(){
528 for(var i = 0, a = arguments, len = a.length; i < len; i++) {
532 as.removeAllListeners();
536 if(typeof as.purgeListeners == 'function'){
539 if(typeof as.destroy == 'function'){
546 // inpired by a similar function in mootools library
548 * Returns the type of object that is passed in. If the object passed in is null or undefined it
549 * return false otherwise it returns one of the following values:<ul>
550 * <li><b>string</b>: If the object passed is a string</li>
551 * <li><b>number</b>: If the object passed is a number</li>
552 * <li><b>boolean</b>: If the object passed is a boolean value</li>
553 * <li><b>function</b>: If the object passed is a function reference</li>
554 * <li><b>object</b>: If the object passed is an object</li>
555 * <li><b>array</b>: If the object passed is an array</li>
556 * <li><b>regexp</b>: If the object passed is a regular expression</li>
557 * <li><b>element</b>: If the object passed is a DOM Element</li>
558 * <li><b>nodelist</b>: If the object passed is a DOM NodeList</li>
559 * <li><b>textnode</b>: If the object passed is a DOM text node and contains something other than whitespace</li>
560 * <li><b>whitespace</b>: If the object passed is a DOM text node and contains only whitespace</li>
561 * @param {Mixed} object
565 if(o === undefined || o === null){
572 if(t == 'object' && o.nodeName) {
574 case 1: return 'element';
575 case 3: return (/\S/).test(o.nodeValue) ? 'textnode' : 'whitespace';
578 if(t == 'object' || t == 'function') {
579 switch(o.constructor) {
580 case Array: return 'array';
581 case RegExp: return 'regexp';
583 if(typeof o.length == 'number' && typeof o.item == 'function') {
591 * Returns true if the passed value is null, undefined or an empty string (optional).
592 * @param {Mixed} value The value to test
593 * @param {Boolean} allowBlank (optional) Pass true if an empty string is not considered empty
596 isEmpty : function(v, allowBlank){
597 return v === null || v === undefined || (!allowBlank ? v === '' : false);
611 isBorderBox : isBorderBox,
613 isWindows : isWindows,
622 * By default, Ext intelligently decides whether floating elements should be shimmed. If you are using flash,
623 * you may want to set this to true.
626 useShims : ((isIE && !isIE7) || (isGecko && isMac)),
631 * Selects a single element as a Roo Element
632 * This is about as close as you can get to jQuery's $('do crazy stuff')
633 * @param {String} selector The selector/xpath query
634 * @param {Node} root (optional) The start of the query (defaults to document).
635 * @return {Roo.Element}
637 selectNode : function(selector, root)
639 var node = Roo.DomQuery.selectNode(selector,root);
640 return node ? Roo.get(node) : new Roo.Element(false);
648 Roo.namespace("Roo", "Roo.util", "Roo.grid", "Roo.dd", "Roo.tree", "Roo.data",
649 "Roo.form", "Roo.menu", "Roo.state", "Roo.lib", "Roo.layout",
652 "Roo.bootstrap.dash");
655 * Ext JS Library 1.1.1
656 * Copyright(c) 2006-2007, Ext JS, LLC.
658 * Originally Released Under LGPL - original licence link has changed is not relivant.
661 * <script type="text/javascript">
665 // wrappedn so fnCleanup is not in global scope...
667 function fnCleanUp() {
668 var p = Function.prototype;
669 delete p.createSequence;
671 delete p.createDelegate;
672 delete p.createCallback;
673 delete p.createInterceptor;
675 window.detachEvent("onunload", fnCleanUp);
677 window.attachEvent("onunload", fnCleanUp);
684 * These functions are available on every Function object (any JavaScript function).
686 Roo.apply(Function.prototype, {
688 * Creates a callback that passes arguments[0], arguments[1], arguments[2], ...
689 * Call directly on any function. Example: <code>myFunction.createCallback(myarg, myarg2)</code>
690 * Will create a function that is bound to those 2 args.
691 * @return {Function} The new function
693 createCallback : function(/*args...*/){
694 // make args available, in function below
695 var args = arguments;
698 return method.apply(window, args);
703 * Creates a delegate (callback) that sets the scope to obj.
704 * Call directly on any function. Example: <code>this.myFunction.createDelegate(this)</code>
705 * Will create a function that is automatically scoped to this.
706 * @param {Object} obj (optional) The object for which the scope is set
707 * @param {Array} args (optional) Overrides arguments for the call. (Defaults to the arguments passed by the caller)
708 * @param {Boolean/Number} appendArgs (optional) if True args are appended to call args instead of overriding,
709 * if a number the args are inserted at the specified position
710 * @return {Function} The new function
712 createDelegate : function(obj, args, appendArgs){
715 var callArgs = args || arguments;
716 if(appendArgs === true){
717 callArgs = Array.prototype.slice.call(arguments, 0);
718 callArgs = callArgs.concat(args);
719 }else if(typeof appendArgs == "number"){
720 callArgs = Array.prototype.slice.call(arguments, 0); // copy arguments first
721 var applyArgs = [appendArgs, 0].concat(args); // create method call params
722 Array.prototype.splice.apply(callArgs, applyArgs); // splice them in
724 return method.apply(obj || window, callArgs);
729 * Calls this function after the number of millseconds specified.
730 * @param {Number} millis The number of milliseconds for the setTimeout call (if 0 the function is executed immediately)
731 * @param {Object} obj (optional) The object for which the scope is set
732 * @param {Array} args (optional) Overrides arguments for the call. (Defaults to the arguments passed by the caller)
733 * @param {Boolean/Number} appendArgs (optional) if True args are appended to call args instead of overriding,
734 * if a number the args are inserted at the specified position
735 * @return {Number} The timeout id that can be used with clearTimeout
737 defer : function(millis, obj, args, appendArgs){
738 var fn = this.createDelegate(obj, args, appendArgs);
740 return setTimeout(fn, millis);
746 * Create a combined function call sequence of the original function + the passed function.
747 * The resulting function returns the results of the original function.
748 * The passed fcn is called with the parameters of the original function
749 * @param {Function} fcn The function to sequence
750 * @param {Object} scope (optional) The scope of the passed fcn (Defaults to scope of original function or window)
751 * @return {Function} The new function
753 createSequence : function(fcn, scope){
754 if(typeof fcn != "function"){
759 var retval = method.apply(this || window, arguments);
760 fcn.apply(scope || this || window, arguments);
766 * Creates an interceptor function. The passed fcn is called before the original one. If it returns false, the original one is not called.
767 * The resulting function returns the results of the original function.
768 * The passed fcn is called with the parameters of the original function.
770 * @param {Function} fcn The function to call before the original
771 * @param {Object} scope (optional) The scope of the passed fcn (Defaults to scope of original function or window)
772 * @return {Function} The new function
774 createInterceptor : function(fcn, scope){
775 if(typeof fcn != "function"){
782 if(fcn.apply(scope || this || window, arguments) === false){
785 return method.apply(this || window, arguments);
791 * Ext JS Library 1.1.1
792 * Copyright(c) 2006-2007, Ext JS, LLC.
794 * Originally Released Under LGPL - original licence link has changed is not relivant.
797 * <script type="text/javascript">
800 Roo.applyIf(String, {
805 * Escapes the passed string for ' and \
806 * @param {String} string The string to escape
807 * @return {String} The escaped string
810 escape : function(string) {
811 return string.replace(/('|\\)/g, "\\$1");
815 * Pads the left side of a string with a specified character. This is especially useful
816 * for normalizing number and date strings. Example usage:
818 var s = String.leftPad('123', 5, '0');
819 // s now contains the string: '00123'
821 * @param {String} string The original string
822 * @param {Number} size The total length of the output string
823 * @param {String} char (optional) The character with which to pad the original string (defaults to empty string " ")
824 * @return {String} The padded string
827 leftPad : function (val, size, ch) {
828 var result = new String(val);
829 if(ch === null || ch === undefined || ch === '') {
832 while (result.length < size) {
833 result = ch + result;
839 * Allows you to define a tokenized string and pass an arbitrary number of arguments to replace the tokens. Each
840 * token must be unique, and must increment in the format {0}, {1}, etc. Example usage:
842 var cls = 'my-class', text = 'Some text';
843 var s = String.format('<div class="{0}">{1}</div>', cls, text);
844 // s now contains the string: '<div class="my-class">Some text</div>'
846 * @param {String} string The tokenized string to be formatted
847 * @param {String} value1 The value to replace token {0}
848 * @param {String} value2 Etc...
849 * @return {String} The formatted string
852 format : function(format){
853 var args = Array.prototype.slice.call(arguments, 1);
854 return format.replace(/\{(\d+)\}/g, function(m, i){
855 return Roo.util.Format.htmlEncode(args[i]);
861 * Utility function that allows you to easily switch a string between two alternating values. The passed value
862 * is compared to the current string, and if they are equal, the other value that was passed in is returned. If
863 * they are already different, the first value passed in is returned. Note that this method returns the new value
864 * but does not change the current string.
866 // alternate sort directions
867 sort = sort.toggle('ASC', 'DESC');
869 // instead of conditional logic:
870 sort = (sort == 'ASC' ? 'DESC' : 'ASC');
872 * @param {String} value The value to compare to the current string
873 * @param {String} other The new value to use if the string already equals the first value passed in
874 * @return {String} The new value
877 String.prototype.toggle = function(value, other){
878 return this == value ? other : value;
881 * Ext JS Library 1.1.1
882 * Copyright(c) 2006-2007, Ext JS, LLC.
884 * Originally Released Under LGPL - original licence link has changed is not relivant.
887 * <script type="text/javascript">
893 Roo.applyIf(Number.prototype, {
895 * Checks whether or not the current number is within a desired range. If the number is already within the
896 * range it is returned, otherwise the min or max value is returned depending on which side of the range is
897 * exceeded. Note that this method returns the constrained value but does not change the current number.
898 * @param {Number} min The minimum number in the range
899 * @param {Number} max The maximum number in the range
900 * @return {Number} The constrained value if outside the range, otherwise the current value
902 constrain : function(min, max){
903 return Math.min(Math.max(this, min), max);
907 * Ext JS Library 1.1.1
908 * Copyright(c) 2006-2007, Ext JS, LLC.
910 * Originally Released Under LGPL - original licence link has changed is not relivant.
913 * <script type="text/javascript">
918 Roo.applyIf(Array.prototype, {
920 * Checks whether or not the specified object exists in the array.
921 * @param {Object} o The object to check for
922 * @return {Number} The index of o in the array (or -1 if it is not found)
924 indexOf : function(o){
925 for (var i = 0, len = this.length; i < len; i++){
926 if(this[i] == o) return i;
932 * Removes the specified object from the array. If the object is not found nothing happens.
933 * @param {Object} o The object to remove
935 remove : function(o){
936 var index = this.indexOf(o);
938 this.splice(index, 1);
942 * Map (JS 1.6 compatibility)
943 * @param {Function} function to call
947 var len = this.length >>> 0;
948 if (typeof fun != "function")
949 throw new TypeError();
951 var res = new Array(len);
952 var thisp = arguments[1];
953 for (var i = 0; i < len; i++)
956 res[i] = fun.call(thisp, this[i], i, this);
967 * Ext JS Library 1.1.1
968 * Copyright(c) 2006-2007, Ext JS, LLC.
970 * Originally Released Under LGPL - original licence link has changed is not relivant.
973 * <script type="text/javascript">
979 * The date parsing and format syntax is a subset of
980 * <a href="http://www.php.net/date">PHP's date() function</a>, and the formats that are
981 * supported will provide results equivalent to their PHP versions.
983 * Following is the list of all currently supported formats:
986 'Wed Jan 10 2007 15:05:01 GMT-0600 (Central Standard Time)'
988 Format Output Description
989 ------ ---------- --------------------------------------------------------------
990 d 10 Day of the month, 2 digits with leading zeros
991 D Wed A textual representation of a day, three letters
992 j 10 Day of the month without leading zeros
993 l Wednesday A full textual representation of the day of the week
994 S th English ordinal day of month suffix, 2 chars (use with j)
995 w 3 Numeric representation of the day of the week
996 z 9 The julian date, or day of the year (0-365)
997 W 01 ISO-8601 2-digit week number of year, weeks starting on Monday (00-52)
998 F January A full textual representation of the month
999 m 01 Numeric representation of a month, with leading zeros
1000 M Jan Month name abbreviation, three letters
1001 n 1 Numeric representation of a month, without leading zeros
1002 t 31 Number of days in the given month
1003 L 0 Whether it's a leap year (1 if it is a leap year, else 0)
1004 Y 2007 A full numeric representation of a year, 4 digits
1005 y 07 A two digit representation of a year
1006 a pm Lowercase Ante meridiem and Post meridiem
1007 A PM Uppercase Ante meridiem and Post meridiem
1008 g 3 12-hour format of an hour without leading zeros
1009 G 15 24-hour format of an hour without leading zeros
1010 h 03 12-hour format of an hour with leading zeros
1011 H 15 24-hour format of an hour with leading zeros
1012 i 05 Minutes with leading zeros
1013 s 01 Seconds, with leading zeros
1014 O -0600 Difference to Greenwich time (GMT) in hours (Allows +08, without minutes)
1015 P -06:00 Difference to Greenwich time (GMT) with colon between hours and minutes
1016 T CST Timezone setting of the machine running the code
1017 Z -21600 Timezone offset in seconds (negative if west of UTC, positive if east)
1020 * Example usage (note that you must escape format specifiers with '\\' to render them as character literals):
1022 var dt = new Date('1/10/2007 03:05:01 PM GMT-0600');
1023 document.write(dt.format('Y-m-d')); //2007-01-10
1024 document.write(dt.format('F j, Y, g:i a')); //January 10, 2007, 3:05 pm
1025 document.write(dt.format('l, \\t\\he dS of F Y h:i:s A')); //Wednesday, the 10th of January 2007 03:05:01 PM
1028 * Here are some standard date/time patterns that you might find helpful. They
1029 * are not part of the source of Date.js, but to use them you can simply copy this
1030 * block of code into any script that is included after Date.js and they will also become
1031 * globally available on the Date object. Feel free to add or remove patterns as needed in your code.
1034 ISO8601Long:"Y-m-d H:i:s",
1035 ISO8601Short:"Y-m-d",
1037 LongDate: "l, F d, Y",
1038 FullDateTime: "l, F d, Y g:i:s A",
1041 LongTime: "g:i:s A",
1042 SortableDateTime: "Y-m-d\\TH:i:s",
1043 UniversalSortableDateTime: "Y-m-d H:i:sO",
1050 var dt = new Date();
1051 document.write(dt.format(Date.patterns.ShortDate));
1056 * Most of the date-formatting functions below are the excellent work of Baron Schwartz.
1057 * They generate precompiled functions from date formats instead of parsing and
1058 * processing the pattern every time you format a date. These functions are available
1059 * on every Date object (any javascript function).
1061 * The original article and download are here:
1062 * http://www.xaprb.com/blog/2005/12/12/javascript-closures-for-runtime-efficiency/
1069 Returns the number of milliseconds between this date and date
1070 @param {Date} date (optional) Defaults to now
1071 @return {Number} The diff in milliseconds
1072 @member Date getElapsed
1074 Date.prototype.getElapsed = function(date) {
1075 return Math.abs((date || new Date()).getTime()-this.getTime());
1077 // was in date file..
1081 Date.parseFunctions = {count:0};
1083 Date.parseRegexes = [];
1085 Date.formatFunctions = {count:0};
1088 Date.prototype.dateFormat = function(format) {
1089 if (Date.formatFunctions[format] == null) {
1090 Date.createNewFormat(format);
1092 var func = Date.formatFunctions[format];
1093 return this[func]();
1098 * Formats a date given the supplied format string
1099 * @param {String} format The format string
1100 * @return {String} The formatted date
1103 Date.prototype.format = Date.prototype.dateFormat;
1106 Date.createNewFormat = function(format) {
1107 var funcName = "format" + Date.formatFunctions.count++;
1108 Date.formatFunctions[format] = funcName;
1109 var code = "Date.prototype." + funcName + " = function(){return ";
1110 var special = false;
1112 for (var i = 0; i < format.length; ++i) {
1113 ch = format.charAt(i);
1114 if (!special && ch == "\\") {
1119 code += "'" + String.escape(ch) + "' + ";
1122 code += Date.getFormatCode(ch);
1125 /** eval:var:zzzzzzzzzzzzz */
1126 eval(code.substring(0, code.length - 3) + ";}");
1130 Date.getFormatCode = function(character) {
1131 switch (character) {
1133 return "String.leftPad(this.getDate(), 2, '0') + ";
1135 return "Date.dayNames[this.getDay()].substring(0, 3) + ";
1137 return "this.getDate() + ";
1139 return "Date.dayNames[this.getDay()] + ";
1141 return "this.getSuffix() + ";
1143 return "this.getDay() + ";
1145 return "this.getDayOfYear() + ";
1147 return "this.getWeekOfYear() + ";
1149 return "Date.monthNames[this.getMonth()] + ";
1151 return "String.leftPad(this.getMonth() + 1, 2, '0') + ";
1153 return "Date.monthNames[this.getMonth()].substring(0, 3) + ";
1155 return "(this.getMonth() + 1) + ";
1157 return "this.getDaysInMonth() + ";
1159 return "(this.isLeapYear() ? 1 : 0) + ";
1161 return "this.getFullYear() + ";
1163 return "('' + this.getFullYear()).substring(2, 4) + ";
1165 return "(this.getHours() < 12 ? 'am' : 'pm') + ";
1167 return "(this.getHours() < 12 ? 'AM' : 'PM') + ";
1169 return "((this.getHours() % 12) ? this.getHours() % 12 : 12) + ";
1171 return "this.getHours() + ";
1173 return "String.leftPad((this.getHours() % 12) ? this.getHours() % 12 : 12, 2, '0') + ";
1175 return "String.leftPad(this.getHours(), 2, '0') + ";
1177 return "String.leftPad(this.getMinutes(), 2, '0') + ";
1179 return "String.leftPad(this.getSeconds(), 2, '0') + ";
1181 return "this.getGMTOffset() + ";
1183 return "this.getGMTColonOffset() + ";
1185 return "this.getTimezone() + ";
1187 return "(this.getTimezoneOffset() * -60) + ";
1189 return "'" + String.escape(character) + "' + ";
1194 * Parses the passed string using the specified format. Note that this function expects dates in normal calendar
1195 * format, meaning that months are 1-based (1 = January) and not zero-based like in JavaScript dates. Any part of
1196 * the date format that is not specified will default to the current date value for that part. Time parts can also
1197 * be specified, but default to 0. Keep in mind that the input date string must precisely match the specified format
1198 * string or the parse operation will fail.
1201 //dt = Fri May 25 2007 (current date)
1202 var dt = new Date();
1204 //dt = Thu May 25 2006 (today's month/day in 2006)
1205 dt = Date.parseDate("2006", "Y");
1207 //dt = Sun Jan 15 2006 (all date parts specified)
1208 dt = Date.parseDate("2006-1-15", "Y-m-d");
1210 //dt = Sun Jan 15 2006 15:20:01 GMT-0600 (CST)
1211 dt = Date.parseDate("2006-1-15 3:20:01 PM", "Y-m-d h:i:s A" );
1213 * @param {String} input The unparsed date as a string
1214 * @param {String} format The format the date is in
1215 * @return {Date} The parsed date
1218 Date.parseDate = function(input, format) {
1219 if (Date.parseFunctions[format] == null) {
1220 Date.createParser(format);
1222 var func = Date.parseFunctions[format];
1223 return Date[func](input);
1228 Date.createParser = function(format) {
1229 var funcName = "parse" + Date.parseFunctions.count++;
1230 var regexNum = Date.parseRegexes.length;
1231 var currentGroup = 1;
1232 Date.parseFunctions[format] = funcName;
1234 var code = "Date." + funcName + " = function(input){\n"
1235 + "var y = -1, m = -1, d = -1, h = -1, i = -1, s = -1, o, z, v;\n"
1236 + "var d = new Date();\n"
1237 + "y = d.getFullYear();\n"
1238 + "m = d.getMonth();\n"
1239 + "d = d.getDate();\n"
1240 + "var results = input.match(Date.parseRegexes[" + regexNum + "]);\n"
1241 + "if (results && results.length > 0) {";
1244 var special = false;
1246 for (var i = 0; i < format.length; ++i) {
1247 ch = format.charAt(i);
1248 if (!special && ch == "\\") {
1253 regex += String.escape(ch);
1256 var obj = Date.formatCodeToRegex(ch, currentGroup);
1257 currentGroup += obj.g;
1259 if (obj.g && obj.c) {
1265 code += "if (y >= 0 && m >= 0 && d > 0 && h >= 0 && i >= 0 && s >= 0)\n"
1266 + "{v = new Date(y, m, d, h, i, s);}\n"
1267 + "else if (y >= 0 && m >= 0 && d > 0 && h >= 0 && i >= 0)\n"
1268 + "{v = new Date(y, m, d, h, i);}\n"
1269 + "else if (y >= 0 && m >= 0 && d > 0 && h >= 0)\n"
1270 + "{v = new Date(y, m, d, h);}\n"
1271 + "else if (y >= 0 && m >= 0 && d > 0)\n"
1272 + "{v = new Date(y, m, d);}\n"
1273 + "else if (y >= 0 && m >= 0)\n"
1274 + "{v = new Date(y, m);}\n"
1275 + "else if (y >= 0)\n"
1276 + "{v = new Date(y);}\n"
1277 + "}return (v && (z || o))?\n" // favour UTC offset over GMT offset
1278 + " ((z)? v.add(Date.SECOND, (v.getTimezoneOffset() * 60) + (z*1)) :\n" // reset to UTC, then add offset
1279 + " v.add(Date.HOUR, (v.getGMTOffset() / 100) + (o / -100))) : v\n" // reset to GMT, then add offset
1282 Date.parseRegexes[regexNum] = new RegExp("^" + regex + "$");
1283 /** eval:var:zzzzzzzzzzzzz */
1288 Date.formatCodeToRegex = function(character, currentGroup) {
1289 switch (character) {
1293 s:"(?:Sun|Mon|Tue|Wed|Thu|Fri|Sat)"};
1296 c:"d = parseInt(results[" + currentGroup + "], 10);\n",
1297 s:"(\\d{1,2})"}; // day of month without leading zeroes
1300 c:"d = parseInt(results[" + currentGroup + "], 10);\n",
1301 s:"(\\d{2})"}; // day of month with leading zeroes
1305 s:"(?:" + Date.dayNames.join("|") + ")"};
1309 s:"(?:st|nd|rd|th)"};
1324 c:"m = parseInt(Date.monthNumbers[results[" + currentGroup + "].substring(0, 3)], 10);\n",
1325 s:"(" + Date.monthNames.join("|") + ")"};
1328 c:"m = parseInt(Date.monthNumbers[results[" + currentGroup + "]], 10);\n",
1329 s:"(Jan|Feb|Mar|Apr|May|Jun|Jul|Aug|Sep|Oct|Nov|Dec)"};
1332 c:"m = parseInt(results[" + currentGroup + "], 10) - 1;\n",
1333 s:"(\\d{1,2})"}; // Numeric representation of a month, without leading zeros
1336 c:"m = parseInt(results[" + currentGroup + "], 10) - 1;\n",
1337 s:"(\\d{2})"}; // Numeric representation of a month, with leading zeros
1348 c:"y = parseInt(results[" + currentGroup + "], 10);\n",
1352 c:"var ty = parseInt(results[" + currentGroup + "], 10);\n"
1353 + "y = ty > Date.y2kYear ? 1900 + ty : 2000 + ty;\n",
1357 c:"if (results[" + currentGroup + "] == 'am') {\n"
1358 + "if (h == 12) { h = 0; }\n"
1359 + "} else { if (h < 12) { h += 12; }}",
1363 c:"if (results[" + currentGroup + "] == 'AM') {\n"
1364 + "if (h == 12) { h = 0; }\n"
1365 + "} else { if (h < 12) { h += 12; }}",
1370 c:"h = parseInt(results[" + currentGroup + "], 10);\n",
1371 s:"(\\d{1,2})"}; // 12/24-hr format format of an hour without leading zeroes
1375 c:"h = parseInt(results[" + currentGroup + "], 10);\n",
1376 s:"(\\d{2})"}; // 12/24-hr format format of an hour with leading zeroes
1379 c:"i = parseInt(results[" + currentGroup + "], 10);\n",
1383 c:"s = parseInt(results[" + currentGroup + "], 10);\n",
1388 "o = results[", currentGroup, "];\n",
1389 "var sn = o.substring(0,1);\n", // get + / - sign
1390 "var hr = o.substring(1,3)*1 + Math.floor(o.substring(3,5) / 60);\n", // get hours (performs minutes-to-hour conversion also)
1391 "var mn = o.substring(3,5) % 60;\n", // get minutes
1392 "o = ((-12 <= (hr*60 + mn)/60) && ((hr*60 + mn)/60 <= 14))?\n", // -12hrs <= GMT offset <= 14hrs
1393 " (sn + String.leftPad(hr, 2, 0) + String.leftPad(mn, 2, 0)) : null;\n"
1395 s:"([+\-]\\d{2,4})"};
1401 "o = results[", currentGroup, "];\n",
1402 "var sn = o.substring(0,1);\n",
1403 "var hr = o.substring(1,3)*1 + Math.floor(o.substring(4,6) / 60);\n",
1404 "var mn = o.substring(4,6) % 60;\n",
1405 "o = ((-12 <= (hr*60 + mn)/60) && ((hr*60 + mn)/60 <= 14))?\n",
1406 " (sn + String.leftPad(hr, 2, 0) + String.leftPad(mn, 2, 0)) : null;\n"
1412 s:"[A-Z]{1,4}"}; // timezone abbrev. may be between 1 - 4 chars
1415 c:"z = results[" + currentGroup + "];\n" // -43200 <= UTC offset <= 50400
1416 + "z = (-43200 <= z*1 && z*1 <= 50400)? z : null;\n",
1417 s:"([+\-]?\\d{1,5})"}; // leading '+' sign is optional for UTC offset
1421 s:String.escape(character)};
1426 * Get the timezone abbreviation of the current date (equivalent to the format specifier 'T').
1427 * @return {String} The abbreviated timezone name (e.g. 'CST')
1429 Date.prototype.getTimezone = function() {
1430 return this.toString().replace(/^.*? ([A-Z]{1,4})[\-+][0-9]{4} .*$/, "$1");
1434 * Get the offset from GMT of the current date (equivalent to the format specifier 'O').
1435 * @return {String} The 4-character offset string prefixed with + or - (e.g. '-0600')
1437 Date.prototype.getGMTOffset = function() {
1438 return (this.getTimezoneOffset() > 0 ? "-" : "+")
1439 + String.leftPad(Math.abs(Math.floor(this.getTimezoneOffset() / 60)), 2, "0")
1440 + String.leftPad(this.getTimezoneOffset() % 60, 2, "0");
1444 * Get the offset from GMT of the current date (equivalent to the format specifier 'P').
1445 * @return {String} 2-characters representing hours and 2-characters representing minutes
1446 * seperated by a colon and prefixed with + or - (e.g. '-06:00')
1448 Date.prototype.getGMTColonOffset = function() {
1449 return (this.getTimezoneOffset() > 0 ? "-" : "+")
1450 + String.leftPad(Math.abs(Math.floor(this.getTimezoneOffset() / 60)), 2, "0")
1452 + String.leftPad(this.getTimezoneOffset() %60, 2, "0");
1456 * Get the numeric day number of the year, adjusted for leap year.
1457 * @return {Number} 0 through 364 (365 in leap years)
1459 Date.prototype.getDayOfYear = function() {
1461 Date.daysInMonth[1] = this.isLeapYear() ? 29 : 28;
1462 for (var i = 0; i < this.getMonth(); ++i) {
1463 num += Date.daysInMonth[i];
1465 return num + this.getDate() - 1;
1469 * Get the string representation of the numeric week number of the year
1470 * (equivalent to the format specifier 'W').
1471 * @return {String} '00' through '52'
1473 Date.prototype.getWeekOfYear = function() {
1474 // Skip to Thursday of this week
1475 var now = this.getDayOfYear() + (4 - this.getDay());
1476 // Find the first Thursday of the year
1477 var jan1 = new Date(this.getFullYear(), 0, 1);
1478 var then = (7 - jan1.getDay() + 4);
1479 return String.leftPad(((now - then) / 7) + 1, 2, "0");
1483 * Whether or not the current date is in a leap year.
1484 * @return {Boolean} True if the current date is in a leap year, else false
1486 Date.prototype.isLeapYear = function() {
1487 var year = this.getFullYear();
1488 return ((year & 3) == 0 && (year % 100 || (year % 400 == 0 && year)));
1492 * Get the first day of the current month, adjusted for leap year. The returned value
1493 * is the numeric day index within the week (0-6) which can be used in conjunction with
1494 * the {@link #monthNames} array to retrieve the textual day name.
1497 var dt = new Date('1/10/2007');
1498 document.write(Date.dayNames[dt.getFirstDayOfMonth()]); //output: 'Monday'
1500 * @return {Number} The day number (0-6)
1502 Date.prototype.getFirstDayOfMonth = function() {
1503 var day = (this.getDay() - (this.getDate() - 1)) % 7;
1504 return (day < 0) ? (day + 7) : day;
1508 * Get the last day of the current month, adjusted for leap year. The returned value
1509 * is the numeric day index within the week (0-6) which can be used in conjunction with
1510 * the {@link #monthNames} array to retrieve the textual day name.
1513 var dt = new Date('1/10/2007');
1514 document.write(Date.dayNames[dt.getLastDayOfMonth()]); //output: 'Wednesday'
1516 * @return {Number} The day number (0-6)
1518 Date.prototype.getLastDayOfMonth = function() {
1519 var day = (this.getDay() + (Date.daysInMonth[this.getMonth()] - this.getDate())) % 7;
1520 return (day < 0) ? (day + 7) : day;
1525 * Get the first date of this date's month
1528 Date.prototype.getFirstDateOfMonth = function() {
1529 return new Date(this.getFullYear(), this.getMonth(), 1);
1533 * Get the last date of this date's month
1536 Date.prototype.getLastDateOfMonth = function() {
1537 return new Date(this.getFullYear(), this.getMonth(), this.getDaysInMonth());
1540 * Get the number of days in the current month, adjusted for leap year.
1541 * @return {Number} The number of days in the month
1543 Date.prototype.getDaysInMonth = function() {
1544 Date.daysInMonth[1] = this.isLeapYear() ? 29 : 28;
1545 return Date.daysInMonth[this.getMonth()];
1549 * Get the English ordinal suffix of the current day (equivalent to the format specifier 'S').
1550 * @return {String} 'st, 'nd', 'rd' or 'th'
1552 Date.prototype.getSuffix = function() {
1553 switch (this.getDate()) {
1570 Date.daysInMonth = [31,28,31,30,31,30,31,31,30,31,30,31];
1573 * An array of textual month names.
1574 * Override these values for international dates, for example...
1575 * Date.monthNames = ['JanInYourLang', 'FebInYourLang', ...];
1594 * An array of textual day names.
1595 * Override these values for international dates, for example...
1596 * Date.dayNames = ['SundayInYourLang', 'MondayInYourLang', ...];
1612 Date.monthNumbers = {
1627 * Creates and returns a new Date instance with the exact same date value as the called instance.
1628 * Dates are copied and passed by reference, so if a copied date variable is modified later, the original
1629 * variable will also be changed. When the intention is to create a new variable that will not
1630 * modify the original instance, you should create a clone.
1632 * Example of correctly cloning a date:
1635 var orig = new Date('10/1/2006');
1638 document.write(orig); //returns 'Thu Oct 05 2006'!
1641 var orig = new Date('10/1/2006');
1642 var copy = orig.clone();
1644 document.write(orig); //returns 'Thu Oct 01 2006'
1646 * @return {Date} The new Date instance
1648 Date.prototype.clone = function() {
1649 return new Date(this.getTime());
1653 * Clears any time information from this date
1654 @param {Boolean} clone true to create a clone of this date, clear the time and return it
1655 @return {Date} this or the clone
1657 Date.prototype.clearTime = function(clone){
1659 return this.clone().clearTime();
1664 this.setMilliseconds(0);
1669 // safari setMonth is broken
1671 Date.brokenSetMonth = Date.prototype.setMonth;
1672 Date.prototype.setMonth = function(num){
1674 var n = Math.ceil(-num);
1675 var back_year = Math.ceil(n/12);
1676 var month = (n % 12) ? 12 - n % 12 : 0 ;
1677 this.setFullYear(this.getFullYear() - back_year);
1678 return Date.brokenSetMonth.call(this, month);
1680 return Date.brokenSetMonth.apply(this, arguments);
1685 /** Date interval constant
1689 /** Date interval constant
1693 /** Date interval constant
1697 /** Date interval constant
1701 /** Date interval constant
1705 /** Date interval constant
1709 /** Date interval constant
1715 * Provides a convenient method of performing basic date arithmetic. This method
1716 * does not modify the Date instance being called - it creates and returns
1717 * a new Date instance containing the resulting date value.
1722 var dt = new Date('10/29/2006').add(Date.DAY, 5);
1723 document.write(dt); //returns 'Fri Oct 06 2006 00:00:00'
1725 //Negative values will subtract correctly:
1726 var dt2 = new Date('10/1/2006').add(Date.DAY, -5);
1727 document.write(dt2); //returns 'Tue Sep 26 2006 00:00:00'
1729 //You can even chain several calls together in one line!
1730 var dt3 = new Date('10/1/2006').add(Date.DAY, 5).add(Date.HOUR, 8).add(Date.MINUTE, -30);
1731 document.write(dt3); //returns 'Fri Oct 06 2006 07:30:00'
1734 * @param {String} interval A valid date interval enum value
1735 * @param {Number} value The amount to add to the current date
1736 * @return {Date} The new Date instance
1738 Date.prototype.add = function(interval, value){
1739 var d = this.clone();
1740 if (!interval || value === 0) return d;
1741 switch(interval.toLowerCase()){
1743 d.setMilliseconds(this.getMilliseconds() + value);
1746 d.setSeconds(this.getSeconds() + value);
1749 d.setMinutes(this.getMinutes() + value);
1752 d.setHours(this.getHours() + value);
1755 d.setDate(this.getDate() + value);
1758 var day = this.getDate();
1760 day = Math.min(day, this.getFirstDateOfMonth().add('mo', value).getLastDateOfMonth().getDate());
1763 d.setMonth(this.getMonth() + value);
1766 d.setFullYear(this.getFullYear() + value);
1773 * Ext JS Library 1.1.1
1774 * Copyright(c) 2006-2007, Ext JS, LLC.
1776 * Originally Released Under LGPL - original licence link has changed is not relivant.
1779 * <script type="text/javascript">
1783 * @class Roo.lib.Dom
1786 * Dom utils (from YIU afaik)
1791 * Get the view width
1792 * @param {Boolean} full True will get the full document, otherwise it's the view width
1793 * @return {Number} The width
1796 getViewWidth : function(full) {
1797 return full ? this.getDocumentWidth() : this.getViewportWidth();
1800 * Get the view height
1801 * @param {Boolean} full True will get the full document, otherwise it's the view height
1802 * @return {Number} The height
1804 getViewHeight : function(full) {
1805 return full ? this.getDocumentHeight() : this.getViewportHeight();
1808 getDocumentHeight: function() {
1809 var scrollHeight = (document.compatMode != "CSS1Compat") ? document.body.scrollHeight : document.documentElement.scrollHeight;
1810 return Math.max(scrollHeight, this.getViewportHeight());
1813 getDocumentWidth: function() {
1814 var scrollWidth = (document.compatMode != "CSS1Compat") ? document.body.scrollWidth : document.documentElement.scrollWidth;
1815 return Math.max(scrollWidth, this.getViewportWidth());
1818 getViewportHeight: function() {
1819 var height = self.innerHeight;
1820 var mode = document.compatMode;
1822 if ((mode || Roo.isIE) && !Roo.isOpera) {
1823 height = (mode == "CSS1Compat") ?
1824 document.documentElement.clientHeight :
1825 document.body.clientHeight;
1831 getViewportWidth: function() {
1832 var width = self.innerWidth;
1833 var mode = document.compatMode;
1835 if (mode || Roo.isIE) {
1836 width = (mode == "CSS1Compat") ?
1837 document.documentElement.clientWidth :
1838 document.body.clientWidth;
1843 isAncestor : function(p, c) {
1850 if (p.contains && !Roo.isSafari) {
1851 return p.contains(c);
1852 } else if (p.compareDocumentPosition) {
1853 return !!(p.compareDocumentPosition(c) & 16);
1855 var parent = c.parentNode;
1860 else if (!parent.tagName || parent.tagName.toUpperCase() == "HTML") {
1863 parent = parent.parentNode;
1869 getRegion : function(el) {
1870 return Roo.lib.Region.getRegion(el);
1873 getY : function(el) {
1874 return this.getXY(el)[1];
1877 getX : function(el) {
1878 return this.getXY(el)[0];
1881 getXY : function(el) {
1882 var p, pe, b, scroll, bd = document.body;
1883 el = Roo.getDom(el);
1884 var fly = Roo.lib.AnimBase.fly;
1885 if (el.getBoundingClientRect) {
1886 b = el.getBoundingClientRect();
1887 scroll = fly(document).getScroll();
1888 return [b.left + scroll.left, b.top + scroll.top];
1894 var hasAbsolute = fly(el).getStyle("position") == "absolute";
1901 if (!hasAbsolute && fly(p).getStyle("position") == "absolute") {
1908 var bt = parseInt(pe.getStyle("borderTopWidth"), 10) || 0;
1909 var bl = parseInt(pe.getStyle("borderLeftWidth"), 10) || 0;
1916 if (p != el && pe.getStyle('overflow') != 'visible') {
1924 if (Roo.isSafari && hasAbsolute) {
1929 if (Roo.isGecko && !hasAbsolute) {
1931 x += parseInt(dbd.getStyle("borderLeftWidth"), 10) || 0;
1932 y += parseInt(dbd.getStyle("borderTopWidth"), 10) || 0;
1936 while (p && p != bd) {
1937 if (!Roo.isOpera || (p.tagName != 'TR' && fly(p).getStyle("display") != "inline")) {
1949 setXY : function(el, xy) {
1950 el = Roo.fly(el, '_setXY');
1952 var pts = el.translatePoints(xy);
1953 if (xy[0] !== false) {
1954 el.dom.style.left = pts.left + "px";
1956 if (xy[1] !== false) {
1957 el.dom.style.top = pts.top + "px";
1961 setX : function(el, x) {
1962 this.setXY(el, [x, false]);
1965 setY : function(el, y) {
1966 this.setXY(el, [false, y]);
1970 * Portions of this file are based on pieces of Yahoo User Interface Library
1971 * Copyright (c) 2007, Yahoo! Inc. All rights reserved.
1972 * YUI licensed under the BSD License:
1973 * http://developer.yahoo.net/yui/license.txt
1974 * <script type="text/javascript">
1978 Roo.lib.Event = function() {
1979 var loadComplete = false;
1981 var unloadListeners = [];
1983 var onAvailStack = [];
1985 var lastError = null;
1998 startInterval: function() {
1999 if (!this._interval) {
2001 var callback = function() {
2002 self._tryPreloadAttach();
2004 this._interval = setInterval(callback, this.POLL_INTERVAL);
2009 onAvailable: function(p_id, p_fn, p_obj, p_override) {
2010 onAvailStack.push({ id: p_id,
2013 override: p_override,
2014 checkReady: false });
2016 retryCount = this.POLL_RETRYS;
2017 this.startInterval();
2021 addListener: function(el, eventName, fn) {
2022 el = Roo.getDom(el);
2027 if ("unload" == eventName) {
2028 unloadListeners[unloadListeners.length] =
2029 [el, eventName, fn];
2033 var wrappedFn = function(e) {
2034 return fn(Roo.lib.Event.getEvent(e));
2037 var li = [el, eventName, fn, wrappedFn];
2039 var index = listeners.length;
2040 listeners[index] = li;
2042 this.doAdd(el, eventName, wrappedFn, false);
2048 removeListener: function(el, eventName, fn) {
2051 el = Roo.getDom(el);
2054 return this.purgeElement(el, false, eventName);
2058 if ("unload" == eventName) {
2060 for (i = 0,len = unloadListeners.length; i < len; i++) {
2061 var li = unloadListeners[i];
2064 li[1] == eventName &&
2066 unloadListeners.splice(i, 1);
2074 var cacheItem = null;
2077 var index = arguments[3];
2079 if ("undefined" == typeof index) {
2080 index = this._getCacheIndex(el, eventName, fn);
2084 cacheItem = listeners[index];
2087 if (!el || !cacheItem) {
2091 this.doRemove(el, eventName, cacheItem[this.WFN], false);
2093 delete listeners[index][this.WFN];
2094 delete listeners[index][this.FN];
2095 listeners.splice(index, 1);
2102 getTarget: function(ev, resolveTextNode) {
2103 ev = ev.browserEvent || ev;
2104 ev = ev.touches ? (ev.touches[0] || ev.changedTouches[0] || ev ) : ev;
2105 var t = ev.target || ev.srcElement;
2106 return this.resolveTextNode(t);
2110 resolveTextNode: function(node) {
2111 if (Roo.isSafari && node && 3 == node.nodeType) {
2112 return node.parentNode;
2119 getPageX: function(ev) {
2120 ev = ev.browserEvent || ev;
2121 ev = ev.touches ? (ev.touches[0] || ev.changedTouches[0] || ev ) : ev;
2123 if (!x && 0 !== x) {
2124 x = ev.clientX || 0;
2127 x += this.getScroll()[1];
2135 getPageY: function(ev) {
2136 ev = ev.browserEvent || ev;
2137 ev = ev.touches ? (ev.touches[0] || ev.changedTouches[0] || ev ) : ev;
2139 if (!y && 0 !== y) {
2140 y = ev.clientY || 0;
2143 y += this.getScroll()[0];
2152 getXY: function(ev) {
2153 ev = ev.browserEvent || ev;
2154 ev = ev.touches ? (ev.touches[0] || ev.changedTouches[0] || ev ) : ev;
2155 return [this.getPageX(ev), this.getPageY(ev)];
2159 getRelatedTarget: function(ev) {
2160 ev = ev.browserEvent || ev;
2161 ev = ev.touches ? (ev.touches[0] || ev.changedTouches[0] || ev ) : ev;
2162 var t = ev.relatedTarget;
2164 if (ev.type == "mouseout") {
2166 } else if (ev.type == "mouseover") {
2171 return this.resolveTextNode(t);
2175 getTime: function(ev) {
2176 ev = ev.browserEvent || ev;
2177 ev = ev.touches ? (ev.touches[0] || ev.changedTouches[0] || ev ) : ev;
2179 var t = new Date().getTime();
2183 this.lastError = ex;
2192 stopEvent: function(ev) {
2193 this.stopPropagation(ev);
2194 this.preventDefault(ev);
2198 stopPropagation: function(ev) {
2199 ev = ev.browserEvent || ev;
2200 if (ev.stopPropagation) {
2201 ev.stopPropagation();
2203 ev.cancelBubble = true;
2208 preventDefault: function(ev) {
2209 ev = ev.browserEvent || ev;
2210 if(ev.preventDefault) {
2211 ev.preventDefault();
2213 ev.returnValue = false;
2218 getEvent: function(e) {
2219 var ev = e || window.event;
2221 var c = this.getEvent.caller;
2223 ev = c.arguments[0];
2224 if (ev && Event == ev.constructor) {
2234 getCharCode: function(ev) {
2235 ev = ev.browserEvent || ev;
2236 return ev.charCode || ev.keyCode || 0;
2240 _getCacheIndex: function(el, eventName, fn) {
2241 for (var i = 0,len = listeners.length; i < len; ++i) {
2242 var li = listeners[i];
2244 li[this.FN] == fn &&
2245 li[this.EL] == el &&
2246 li[this.TYPE] == eventName) {
2258 getEl: function(id) {
2259 return document.getElementById(id);
2263 clearCache: function() {
2267 _load: function(e) {
2268 loadComplete = true;
2269 var EU = Roo.lib.Event;
2273 EU.doRemove(window, "load", EU._load);
2278 _tryPreloadAttach: function() {
2287 var tryAgain = !loadComplete;
2289 tryAgain = (retryCount > 0);
2294 for (var i = 0,len = onAvailStack.length; i < len; ++i) {
2295 var item = onAvailStack[i];
2297 var el = this.getEl(item.id);
2300 if (!item.checkReady ||
2303 (document && document.body)) {
2306 if (item.override) {
2307 if (item.override === true) {
2310 scope = item.override;
2313 item.fn.call(scope, item.obj);
2314 onAvailStack[i] = null;
2317 notAvail.push(item);
2322 retryCount = (notAvail.length === 0) ? 0 : retryCount - 1;
2326 this.startInterval();
2328 clearInterval(this._interval);
2329 this._interval = null;
2332 this.locked = false;
2339 purgeElement: function(el, recurse, eventName) {
2340 var elListeners = this.getListeners(el, eventName);
2342 for (var i = 0,len = elListeners.length; i < len; ++i) {
2343 var l = elListeners[i];
2344 this.removeListener(el, l.type, l.fn);
2348 if (recurse && el && el.childNodes) {
2349 for (i = 0,len = el.childNodes.length; i < len; ++i) {
2350 this.purgeElement(el.childNodes[i], recurse, eventName);
2356 getListeners: function(el, eventName) {
2357 var results = [], searchLists;
2359 searchLists = [listeners, unloadListeners];
2360 } else if (eventName == "unload") {
2361 searchLists = [unloadListeners];
2363 searchLists = [listeners];
2366 for (var j = 0; j < searchLists.length; ++j) {
2367 var searchList = searchLists[j];
2368 if (searchList && searchList.length > 0) {
2369 for (var i = 0,len = searchList.length; i < len; ++i) {
2370 var l = searchList[i];
2371 if (l && l[this.EL] === el &&
2372 (!eventName || eventName === l[this.TYPE])) {
2377 adjust: l[this.ADJ_SCOPE],
2385 return (results.length) ? results : null;
2389 _unload: function(e) {
2391 var EU = Roo.lib.Event, i, j, l, len, index;
2393 for (i = 0,len = unloadListeners.length; i < len; ++i) {
2394 l = unloadListeners[i];
2397 if (l[EU.ADJ_SCOPE]) {
2398 if (l[EU.ADJ_SCOPE] === true) {
2401 scope = l[EU.ADJ_SCOPE];
2404 l[EU.FN].call(scope, EU.getEvent(e), l[EU.OBJ]);
2405 unloadListeners[i] = null;
2411 unloadListeners = null;
2413 if (listeners && listeners.length > 0) {
2414 j = listeners.length;
2417 l = listeners[index];
2419 EU.removeListener(l[EU.EL], l[EU.TYPE],
2429 EU.doRemove(window, "unload", EU._unload);
2434 getScroll: function() {
2435 var dd = document.documentElement, db = document.body;
2436 if (dd && (dd.scrollTop || dd.scrollLeft)) {
2437 return [dd.scrollTop, dd.scrollLeft];
2439 return [db.scrollTop, db.scrollLeft];
2446 doAdd: function () {
2447 if (window.addEventListener) {
2448 return function(el, eventName, fn, capture) {
2449 el.addEventListener(eventName, fn, (capture));
2451 } else if (window.attachEvent) {
2452 return function(el, eventName, fn, capture) {
2453 el.attachEvent("on" + eventName, fn);
2462 doRemove: function() {
2463 if (window.removeEventListener) {
2464 return function (el, eventName, fn, capture) {
2465 el.removeEventListener(eventName, fn, (capture));
2467 } else if (window.detachEvent) {
2468 return function (el, eventName, fn) {
2469 el.detachEvent("on" + eventName, fn);
2481 var E = Roo.lib.Event;
2482 E.on = E.addListener;
2483 E.un = E.removeListener;
2485 if (document && document.body) {
2488 E.doAdd(window, "load", E._load);
2490 E.doAdd(window, "unload", E._unload);
2491 E._tryPreloadAttach();
2495 * Portions of this file are based on pieces of Yahoo User Interface Library
2496 * Copyright (c) 2007, Yahoo! Inc. All rights reserved.
2497 * YUI licensed under the BSD License:
2498 * http://developer.yahoo.net/yui/license.txt
2499 * <script type="text/javascript">
2505 * @class Roo.lib.Ajax
2512 request : function(method, uri, cb, data, options) {
2514 var hs = options.headers;
2517 if(hs.hasOwnProperty(h)){
2518 this.initHeader(h, hs[h], false);
2522 if(options.xmlData){
2523 this.initHeader('Content-Type', 'text/xml', false);
2525 data = options.xmlData;
2529 return this.asyncRequest(method, uri, cb, data);
2532 serializeForm : function(form) {
2533 if(typeof form == 'string') {
2534 form = (document.getElementById(form) || document.forms[form]);
2537 var el, name, val, disabled, data = '', hasSubmit = false;
2538 for (var i = 0; i < form.elements.length; i++) {
2539 el = form.elements[i];
2540 disabled = form.elements[i].disabled;
2541 name = form.elements[i].name;
2542 val = form.elements[i].value;
2544 if (!disabled && name){
2548 case 'select-multiple':
2549 for (var j = 0; j < el.options.length; j++) {
2550 if (el.options[j].selected) {
2552 data += Roo.encodeURIComponent(name) + '=' + Roo.encodeURIComponent(el.options[j].attributes['value'].specified ? el.options[j].value : el.options[j].text) + '&';
2555 data += Roo.encodeURIComponent(name) + '=' + Roo.encodeURIComponent(el.options[j].hasAttribute('value') ? el.options[j].value : el.options[j].text) + '&';
2563 data += Roo.encodeURIComponent(name) + '=' + Roo.encodeURIComponent(val) + '&';
2576 if(hasSubmit == false) {
2577 data += Roo.encodeURIComponent(name) + '=' + Roo.encodeURIComponent(val) + '&';
2582 data += Roo.encodeURIComponent(name) + '=' + Roo.encodeURIComponent(val) + '&';
2587 data = data.substr(0, data.length - 1);
2595 useDefaultHeader:true,
2597 defaultPostHeader:'application/x-www-form-urlencoded',
2599 useDefaultXhrHeader:true,
2601 defaultXhrHeader:'XMLHttpRequest',
2603 hasDefaultHeaders:true,
2615 setProgId:function(id)
2617 this.activeX.unshift(id);
2620 setDefaultPostHeader:function(b)
2622 this.useDefaultHeader = b;
2625 setDefaultXhrHeader:function(b)
2627 this.useDefaultXhrHeader = b;
2630 setPollingInterval:function(i)
2632 if (typeof i == 'number' && isFinite(i)) {
2633 this.pollInterval = i;
2637 createXhrObject:function(transactionId)
2643 http = new XMLHttpRequest();
2645 obj = { conn:http, tId:transactionId };
2649 for (var i = 0; i < this.activeX.length; ++i) {
2653 http = new ActiveXObject(this.activeX[i]);
2655 obj = { conn:http, tId:transactionId };
2668 getConnectionObject:function()
2671 var tId = this.transactionId;
2675 o = this.createXhrObject(tId);
2677 this.transactionId++;
2688 asyncRequest:function(method, uri, callback, postData)
2690 var o = this.getConnectionObject();
2696 o.conn.open(method, uri, true);
2698 if (this.useDefaultXhrHeader) {
2699 if (!this.defaultHeaders['X-Requested-With']) {
2700 this.initHeader('X-Requested-With', this.defaultXhrHeader, true);
2704 if(postData && this.useDefaultHeader){
2705 this.initHeader('Content-Type', this.defaultPostHeader);
2708 if (this.hasDefaultHeaders || this.hasHeaders) {
2712 this.handleReadyState(o, callback);
2713 o.conn.send(postData || null);
2719 handleReadyState:function(o, callback)
2723 if (callback && callback.timeout) {
2725 this.timeout[o.tId] = window.setTimeout(function() {
2726 oConn.abort(o, callback, true);
2727 }, callback.timeout);
2730 this.poll[o.tId] = window.setInterval(
2732 if (o.conn && o.conn.readyState == 4) {
2733 window.clearInterval(oConn.poll[o.tId]);
2734 delete oConn.poll[o.tId];
2736 if(callback && callback.timeout) {
2737 window.clearTimeout(oConn.timeout[o.tId]);
2738 delete oConn.timeout[o.tId];
2741 oConn.handleTransactionResponse(o, callback);
2744 , this.pollInterval);
2747 handleTransactionResponse:function(o, callback, isAbort)
2751 this.releaseObject(o);
2755 var httpStatus, responseObject;
2759 if (o.conn.status !== undefined && o.conn.status != 0) {
2760 httpStatus = o.conn.status;
2772 if (httpStatus >= 200 && httpStatus < 300) {
2773 responseObject = this.createResponseObject(o, callback.argument);
2774 if (callback.success) {
2775 if (!callback.scope) {
2776 callback.success(responseObject);
2781 callback.success.apply(callback.scope, [responseObject]);
2786 switch (httpStatus) {
2794 responseObject = this.createExceptionObject(o.tId, callback.argument, (isAbort ? isAbort : false));
2795 if (callback.failure) {
2796 if (!callback.scope) {
2797 callback.failure(responseObject);
2800 callback.failure.apply(callback.scope, [responseObject]);
2805 responseObject = this.createResponseObject(o, callback.argument);
2806 if (callback.failure) {
2807 if (!callback.scope) {
2808 callback.failure(responseObject);
2811 callback.failure.apply(callback.scope, [responseObject]);
2817 this.releaseObject(o);
2818 responseObject = null;
2821 createResponseObject:function(o, callbackArg)
2828 var headerStr = o.conn.getAllResponseHeaders();
2829 var header = headerStr.split('\n');
2830 for (var i = 0; i < header.length; i++) {
2831 var delimitPos = header[i].indexOf(':');
2832 if (delimitPos != -1) {
2833 headerObj[header[i].substring(0, delimitPos)] = header[i].substring(delimitPos + 2);
2841 obj.status = o.conn.status;
2842 obj.statusText = o.conn.statusText;
2843 obj.getResponseHeader = headerObj;
2844 obj.getAllResponseHeaders = headerStr;
2845 obj.responseText = o.conn.responseText;
2846 obj.responseXML = o.conn.responseXML;
2848 if (typeof callbackArg !== undefined) {
2849 obj.argument = callbackArg;
2855 createExceptionObject:function(tId, callbackArg, isAbort)
2858 var COMM_ERROR = 'communication failure';
2859 var ABORT_CODE = -1;
2860 var ABORT_ERROR = 'transaction aborted';
2866 obj.status = ABORT_CODE;
2867 obj.statusText = ABORT_ERROR;
2870 obj.status = COMM_CODE;
2871 obj.statusText = COMM_ERROR;
2875 obj.argument = callbackArg;
2881 initHeader:function(label, value, isDefault)
2883 var headerObj = (isDefault) ? this.defaultHeaders : this.headers;
2885 if (headerObj[label] === undefined) {
2886 headerObj[label] = value;
2891 headerObj[label] = value + "," + headerObj[label];
2895 this.hasDefaultHeaders = true;
2898 this.hasHeaders = true;
2903 setHeader:function(o)
2905 if (this.hasDefaultHeaders) {
2906 for (var prop in this.defaultHeaders) {
2907 if (this.defaultHeaders.hasOwnProperty(prop)) {
2908 o.conn.setRequestHeader(prop, this.defaultHeaders[prop]);
2913 if (this.hasHeaders) {
2914 for (var prop in this.headers) {
2915 if (this.headers.hasOwnProperty(prop)) {
2916 o.conn.setRequestHeader(prop, this.headers[prop]);
2920 this.hasHeaders = false;
2924 resetDefaultHeaders:function() {
2925 delete this.defaultHeaders;
2926 this.defaultHeaders = {};
2927 this.hasDefaultHeaders = false;
2930 abort:function(o, callback, isTimeout)
2932 if(this.isCallInProgress(o)) {
2934 window.clearInterval(this.poll[o.tId]);
2935 delete this.poll[o.tId];
2937 delete this.timeout[o.tId];
2940 this.handleTransactionResponse(o, callback, true);
2950 isCallInProgress:function(o)
2953 return o.conn.readyState != 4 && o.conn.readyState != 0;
2962 releaseObject:function(o)
2971 'MSXML2.XMLHTTP.3.0',
2979 * Portions of this file are based on pieces of Yahoo User Interface Library
2980 * Copyright (c) 2007, Yahoo! Inc. All rights reserved.
2981 * YUI licensed under the BSD License:
2982 * http://developer.yahoo.net/yui/license.txt
2983 * <script type="text/javascript">
2987 Roo.lib.Region = function(t, r, b, l) {
2997 Roo.lib.Region.prototype = {
2998 contains : function(region) {
2999 return ( region.left >= this.left &&
3000 region.right <= this.right &&
3001 region.top >= this.top &&
3002 region.bottom <= this.bottom );
3006 getArea : function() {
3007 return ( (this.bottom - this.top) * (this.right - this.left) );
3010 intersect : function(region) {
3011 var t = Math.max(this.top, region.top);
3012 var r = Math.min(this.right, region.right);
3013 var b = Math.min(this.bottom, region.bottom);
3014 var l = Math.max(this.left, region.left);
3016 if (b >= t && r >= l) {
3017 return new Roo.lib.Region(t, r, b, l);
3022 union : function(region) {
3023 var t = Math.min(this.top, region.top);
3024 var r = Math.max(this.right, region.right);
3025 var b = Math.max(this.bottom, region.bottom);
3026 var l = Math.min(this.left, region.left);
3028 return new Roo.lib.Region(t, r, b, l);
3031 adjust : function(t, l, b, r) {
3040 Roo.lib.Region.getRegion = function(el) {
3041 var p = Roo.lib.Dom.getXY(el);
3044 var r = p[0] + el.offsetWidth;
3045 var b = p[1] + el.offsetHeight;
3048 return new Roo.lib.Region(t, r, b, l);
3051 * Portions of this file are based on pieces of Yahoo User Interface Library
3052 * Copyright (c) 2007, Yahoo! Inc. All rights reserved.
3053 * YUI licensed under the BSD License:
3054 * http://developer.yahoo.net/yui/license.txt
3055 * <script type="text/javascript">
3058 //@@dep Roo.lib.Region
3061 Roo.lib.Point = function(x, y) {
3062 if (x instanceof Array) {
3066 this.x = this.right = this.left = this[0] = x;
3067 this.y = this.top = this.bottom = this[1] = y;
3070 Roo.lib.Point.prototype = new Roo.lib.Region();
3072 * Portions of this file are based on pieces of Yahoo User Interface Library
3073 * Copyright (c) 2007, Yahoo! Inc. All rights reserved.
3074 * YUI licensed under the BSD License:
3075 * http://developer.yahoo.net/yui/license.txt
3076 * <script type="text/javascript">
3083 scroll : function(el, args, duration, easing, cb, scope) {
3084 this.run(el, args, duration, easing, cb, scope, Roo.lib.Scroll);
3087 motion : function(el, args, duration, easing, cb, scope) {
3088 this.run(el, args, duration, easing, cb, scope, Roo.lib.Motion);
3091 color : function(el, args, duration, easing, cb, scope) {
3092 this.run(el, args, duration, easing, cb, scope, Roo.lib.ColorAnim);
3095 run : function(el, args, duration, easing, cb, scope, type) {
3096 type = type || Roo.lib.AnimBase;
3097 if (typeof easing == "string") {
3098 easing = Roo.lib.Easing[easing];
3100 var anim = new type(el, args, duration, easing);
3101 anim.animateX(function() {
3102 Roo.callback(cb, scope);
3108 * Portions of this file are based on pieces of Yahoo User Interface Library
3109 * Copyright (c) 2007, Yahoo! Inc. All rights reserved.
3110 * YUI licensed under the BSD License:
3111 * http://developer.yahoo.net/yui/license.txt
3112 * <script type="text/javascript">
3120 if (!libFlyweight) {
3121 libFlyweight = new Roo.Element.Flyweight();
3123 libFlyweight.dom = el;
3124 return libFlyweight;
3127 // since this uses fly! - it cant be in DOM (which does not have fly yet..)
3131 Roo.lib.AnimBase = function(el, attributes, duration, method) {
3133 this.init(el, attributes, duration, method);
3137 Roo.lib.AnimBase.fly = fly;
3141 Roo.lib.AnimBase.prototype = {
3143 toString: function() {
3144 var el = this.getEl();
3145 var id = el.id || el.tagName;
3146 return ("Anim " + id);
3150 noNegatives: /width|height|opacity|padding/i,
3151 offsetAttribute: /^((width|height)|(top|left))$/,
3152 defaultUnit: /width|height|top$|bottom$|left$|right$/i,
3153 offsetUnit: /\d+(em|%|en|ex|pt|in|cm|mm|pc)$/i
3157 doMethod: function(attr, start, end) {
3158 return this.method(this.currentFrame, start, end - start, this.totalFrames);
3162 setAttribute: function(attr, val, unit) {
3163 if (this.patterns.noNegatives.test(attr)) {
3164 val = (val > 0) ? val : 0;
3167 Roo.fly(this.getEl(), '_anim').setStyle(attr, val + unit);
3171 getAttribute: function(attr) {
3172 var el = this.getEl();
3173 var val = fly(el).getStyle(attr);
3175 if (val !== 'auto' && !this.patterns.offsetUnit.test(val)) {
3176 return parseFloat(val);
3179 var a = this.patterns.offsetAttribute.exec(attr) || [];
3180 var pos = !!( a[3] );
3181 var box = !!( a[2] );
3184 if (box || (fly(el).getStyle('position') == 'absolute' && pos)) {
3185 val = el['offset' + a[0].charAt(0).toUpperCase() + a[0].substr(1)];
3194 getDefaultUnit: function(attr) {
3195 if (this.patterns.defaultUnit.test(attr)) {
3202 animateX : function(callback, scope) {
3203 var f = function() {
3204 this.onComplete.removeListener(f);
3205 if (typeof callback == "function") {
3206 callback.call(scope || this, this);
3209 this.onComplete.addListener(f, this);
3214 setRuntimeAttribute: function(attr) {
3217 var attributes = this.attributes;
3219 this.runtimeAttributes[attr] = {};
3221 var isset = function(prop) {
3222 return (typeof prop !== 'undefined');
3225 if (!isset(attributes[attr]['to']) && !isset(attributes[attr]['by'])) {
3229 start = ( isset(attributes[attr]['from']) ) ? attributes[attr]['from'] : this.getAttribute(attr);
3232 if (isset(attributes[attr]['to'])) {
3233 end = attributes[attr]['to'];
3234 } else if (isset(attributes[attr]['by'])) {
3235 if (start.constructor == Array) {
3237 for (var i = 0, len = start.length; i < len; ++i) {
3238 end[i] = start[i] + attributes[attr]['by'][i];
3241 end = start + attributes[attr]['by'];
3245 this.runtimeAttributes[attr].start = start;
3246 this.runtimeAttributes[attr].end = end;
3249 this.runtimeAttributes[attr].unit = ( isset(attributes[attr].unit) ) ? attributes[attr]['unit'] : this.getDefaultUnit(attr);
3253 init: function(el, attributes, duration, method) {
3255 var isAnimated = false;
3258 var startTime = null;
3261 var actualFrames = 0;
3264 el = Roo.getDom(el);
3267 this.attributes = attributes || {};
3270 this.duration = duration || 1;
3273 this.method = method || Roo.lib.Easing.easeNone;
3276 this.useSeconds = true;
3279 this.currentFrame = 0;
3282 this.totalFrames = Roo.lib.AnimMgr.fps;
3285 this.getEl = function() {
3290 this.isAnimated = function() {
3295 this.getStartTime = function() {
3299 this.runtimeAttributes = {};
3302 this.animate = function() {
3303 if (this.isAnimated()) {
3307 this.currentFrame = 0;
3309 this.totalFrames = ( this.useSeconds ) ? Math.ceil(Roo.lib.AnimMgr.fps * this.duration) : this.duration;
3311 Roo.lib.AnimMgr.registerElement(this);
3315 this.stop = function(finish) {
3317 this.currentFrame = this.totalFrames;
3318 this._onTween.fire();
3320 Roo.lib.AnimMgr.stop(this);
3323 var onStart = function() {
3324 this.onStart.fire();
3326 this.runtimeAttributes = {};
3327 for (var attr in this.attributes) {
3328 this.setRuntimeAttribute(attr);
3333 startTime = new Date();
3337 var onTween = function() {
3339 duration: new Date() - this.getStartTime(),
3340 currentFrame: this.currentFrame
3343 data.toString = function() {
3345 'duration: ' + data.duration +
3346 ', currentFrame: ' + data.currentFrame
3350 this.onTween.fire(data);
3352 var runtimeAttributes = this.runtimeAttributes;
3354 for (var attr in runtimeAttributes) {
3355 this.setAttribute(attr, this.doMethod(attr, runtimeAttributes[attr].start, runtimeAttributes[attr].end), runtimeAttributes[attr].unit);
3361 var onComplete = function() {
3362 var actual_duration = (new Date() - startTime) / 1000 ;
3365 duration: actual_duration,
3366 frames: actualFrames,
3367 fps: actualFrames / actual_duration
3370 data.toString = function() {
3372 'duration: ' + data.duration +
3373 ', frames: ' + data.frames +
3374 ', fps: ' + data.fps
3380 this.onComplete.fire(data);
3384 this._onStart = new Roo.util.Event(this);
3385 this.onStart = new Roo.util.Event(this);
3386 this.onTween = new Roo.util.Event(this);
3387 this._onTween = new Roo.util.Event(this);
3388 this.onComplete = new Roo.util.Event(this);
3389 this._onComplete = new Roo.util.Event(this);
3390 this._onStart.addListener(onStart);
3391 this._onTween.addListener(onTween);
3392 this._onComplete.addListener(onComplete);
3397 * Portions of this file are based on pieces of Yahoo User Interface Library
3398 * Copyright (c) 2007, Yahoo! Inc. All rights reserved.
3399 * YUI licensed under the BSD License:
3400 * http://developer.yahoo.net/yui/license.txt
3401 * <script type="text/javascript">
3405 Roo.lib.AnimMgr = new function() {
3422 this.registerElement = function(tween) {
3423 queue[queue.length] = tween;
3425 tween._onStart.fire();
3430 this.unRegister = function(tween, index) {
3431 tween._onComplete.fire();
3432 index = index || getIndex(tween);
3434 queue.splice(index, 1);
3438 if (tweenCount <= 0) {
3444 this.start = function() {
3445 if (thread === null) {
3446 thread = setInterval(this.run, this.delay);
3451 this.stop = function(tween) {
3453 clearInterval(thread);
3455 for (var i = 0, len = queue.length; i < len; ++i) {
3456 if (queue[0].isAnimated()) {
3457 this.unRegister(queue[0], 0);
3466 this.unRegister(tween);
3471 this.run = function() {
3472 for (var i = 0, len = queue.length; i < len; ++i) {
3473 var tween = queue[i];
3474 if (!tween || !tween.isAnimated()) {
3478 if (tween.currentFrame < tween.totalFrames || tween.totalFrames === null)
3480 tween.currentFrame += 1;
3482 if (tween.useSeconds) {
3483 correctFrame(tween);
3485 tween._onTween.fire();
3488 Roo.lib.AnimMgr.stop(tween, i);
3493 var getIndex = function(anim) {
3494 for (var i = 0, len = queue.length; i < len; ++i) {
3495 if (queue[i] == anim) {
3503 var correctFrame = function(tween) {
3504 var frames = tween.totalFrames;
3505 var frame = tween.currentFrame;
3506 var expected = (tween.currentFrame * tween.duration * 1000 / tween.totalFrames);
3507 var elapsed = (new Date() - tween.getStartTime());
3510 if (elapsed < tween.duration * 1000) {
3511 tweak = Math.round((elapsed / expected - 1) * tween.currentFrame);
3513 tweak = frames - (frame + 1);
3515 if (tweak > 0 && isFinite(tweak)) {
3516 if (tween.currentFrame + tweak >= frames) {
3517 tweak = frames - (frame + 1);
3520 tween.currentFrame += tweak;
3526 * Portions of this file are based on pieces of Yahoo User Interface Library
3527 * Copyright (c) 2007, Yahoo! Inc. All rights reserved.
3528 * YUI licensed under the BSD License:
3529 * http://developer.yahoo.net/yui/license.txt
3530 * <script type="text/javascript">
3533 Roo.lib.Bezier = new function() {
3535 this.getPosition = function(points, t) {
3536 var n = points.length;
3539 for (var i = 0; i < n; ++i) {
3540 tmp[i] = [points[i][0], points[i][1]];
3543 for (var j = 1; j < n; ++j) {
3544 for (i = 0; i < n - j; ++i) {
3545 tmp[i][0] = (1 - t) * tmp[i][0] + t * tmp[parseInt(i + 1, 10)][0];
3546 tmp[i][1] = (1 - t) * tmp[i][1] + t * tmp[parseInt(i + 1, 10)][1];
3550 return [ tmp[0][0], tmp[0][1] ];
3554 * Portions of this file are based on pieces of Yahoo User Interface Library
3555 * Copyright (c) 2007, Yahoo! Inc. All rights reserved.
3556 * YUI licensed under the BSD License:
3557 * http://developer.yahoo.net/yui/license.txt
3558 * <script type="text/javascript">
3563 Roo.lib.ColorAnim = function(el, attributes, duration, method) {
3564 Roo.lib.ColorAnim.superclass.constructor.call(this, el, attributes, duration, method);
3567 Roo.extend(Roo.lib.ColorAnim, Roo.lib.AnimBase);
3569 var fly = Roo.lib.AnimBase.fly;
3571 var superclass = Y.ColorAnim.superclass;
3572 var proto = Y.ColorAnim.prototype;
3574 proto.toString = function() {
3575 var el = this.getEl();
3576 var id = el.id || el.tagName;
3577 return ("ColorAnim " + id);
3580 proto.patterns.color = /color$/i;
3581 proto.patterns.rgb = /^rgb\(([0-9]+)\s*,\s*([0-9]+)\s*,\s*([0-9]+)\)$/i;
3582 proto.patterns.hex = /^#?([0-9A-F]{2})([0-9A-F]{2})([0-9A-F]{2})$/i;
3583 proto.patterns.hex3 = /^#?([0-9A-F]{1})([0-9A-F]{1})([0-9A-F]{1})$/i;
3584 proto.patterns.transparent = /^transparent|rgba\(0, 0, 0, 0\)$/;
3587 proto.parseColor = function(s) {
3588 if (s.length == 3) {
3592 var c = this.patterns.hex.exec(s);
3593 if (c && c.length == 4) {
3594 return [ parseInt(c[1], 16), parseInt(c[2], 16), parseInt(c[3], 16) ];
3597 c = this.patterns.rgb.exec(s);
3598 if (c && c.length == 4) {
3599 return [ parseInt(c[1], 10), parseInt(c[2], 10), parseInt(c[3], 10) ];
3602 c = this.patterns.hex3.exec(s);
3603 if (c && c.length == 4) {
3604 return [ parseInt(c[1] + c[1], 16), parseInt(c[2] + c[2], 16), parseInt(c[3] + c[3], 16) ];
3609 // since this uses fly! - it cant be in ColorAnim (which does not have fly yet..)
3610 proto.getAttribute = function(attr) {
3611 var el = this.getEl();
3612 if (this.patterns.color.test(attr)) {
3613 var val = fly(el).getStyle(attr);
3615 if (this.patterns.transparent.test(val)) {
3616 var parent = el.parentNode;
3617 val = fly(parent).getStyle(attr);
3619 while (parent && this.patterns.transparent.test(val)) {
3620 parent = parent.parentNode;
3621 val = fly(parent).getStyle(attr);
3622 if (parent.tagName.toUpperCase() == 'HTML') {
3628 val = superclass.getAttribute.call(this, attr);
3633 proto.getAttribute = function(attr) {
3634 var el = this.getEl();
3635 if (this.patterns.color.test(attr)) {
3636 var val = fly(el).getStyle(attr);
3638 if (this.patterns.transparent.test(val)) {
3639 var parent = el.parentNode;
3640 val = fly(parent).getStyle(attr);
3642 while (parent && this.patterns.transparent.test(val)) {
3643 parent = parent.parentNode;
3644 val = fly(parent).getStyle(attr);
3645 if (parent.tagName.toUpperCase() == 'HTML') {
3651 val = superclass.getAttribute.call(this, attr);
3657 proto.doMethod = function(attr, start, end) {
3660 if (this.patterns.color.test(attr)) {
3662 for (var i = 0, len = start.length; i < len; ++i) {
3663 val[i] = superclass.doMethod.call(this, attr, start[i], end[i]);
3666 val = 'rgb(' + Math.floor(val[0]) + ',' + Math.floor(val[1]) + ',' + Math.floor(val[2]) + ')';
3669 val = superclass.doMethod.call(this, attr, start, end);
3675 proto.setRuntimeAttribute = function(attr) {
3676 superclass.setRuntimeAttribute.call(this, attr);
3678 if (this.patterns.color.test(attr)) {
3679 var attributes = this.attributes;
3680 var start = this.parseColor(this.runtimeAttributes[attr].start);
3681 var end = this.parseColor(this.runtimeAttributes[attr].end);
3683 if (typeof attributes[attr]['to'] === 'undefined' && typeof attributes[attr]['by'] !== 'undefined') {
3684 end = this.parseColor(attributes[attr].by);
3686 for (var i = 0, len = start.length; i < len; ++i) {
3687 end[i] = start[i] + end[i];
3691 this.runtimeAttributes[attr].start = start;
3692 this.runtimeAttributes[attr].end = end;
3698 * Portions of this file are based on pieces of Yahoo User Interface Library
3699 * Copyright (c) 2007, Yahoo! Inc. All rights reserved.
3700 * YUI licensed under the BSD License:
3701 * http://developer.yahoo.net/yui/license.txt
3702 * <script type="text/javascript">
3708 easeNone: function (t, b, c, d) {
3709 return c * t / d + b;
3713 easeIn: function (t, b, c, d) {
3714 return c * (t /= d) * t + b;
3718 easeOut: function (t, b, c, d) {
3719 return -c * (t /= d) * (t - 2) + b;
3723 easeBoth: function (t, b, c, d) {
3724 if ((t /= d / 2) < 1) {
3725 return c / 2 * t * t + b;
3728 return -c / 2 * ((--t) * (t - 2) - 1) + b;
3732 easeInStrong: function (t, b, c, d) {
3733 return c * (t /= d) * t * t * t + b;
3737 easeOutStrong: function (t, b, c, d) {
3738 return -c * ((t = t / d - 1) * t * t * t - 1) + b;
3742 easeBothStrong: function (t, b, c, d) {
3743 if ((t /= d / 2) < 1) {
3744 return c / 2 * t * t * t * t + b;
3747 return -c / 2 * ((t -= 2) * t * t * t - 2) + b;
3752 elasticIn: function (t, b, c, d, a, p) {
3756 if ((t /= d) == 1) {
3763 if (!a || a < Math.abs(c)) {
3768 var s = p / (2 * Math.PI) * Math.asin(c / a);
3771 return -(a * Math.pow(2, 10 * (t -= 1)) * Math.sin((t * d - s) * (2 * Math.PI) / p)) + b;
3775 elasticOut: function (t, b, c, d, a, p) {
3779 if ((t /= d) == 1) {
3786 if (!a || a < Math.abs(c)) {
3791 var s = p / (2 * Math.PI) * Math.asin(c / a);
3794 return a * Math.pow(2, -10 * t) * Math.sin((t * d - s) * (2 * Math.PI) / p) + c + b;
3798 elasticBoth: function (t, b, c, d, a, p) {
3803 if ((t /= d / 2) == 2) {
3811 if (!a || a < Math.abs(c)) {
3816 var s = p / (2 * Math.PI) * Math.asin(c / a);
3820 return -.5 * (a * Math.pow(2, 10 * (t -= 1)) *
3821 Math.sin((t * d - s) * (2 * Math.PI) / p)) + b;
3823 return a * Math.pow(2, -10 * (t -= 1)) *
3824 Math.sin((t * d - s) * (2 * Math.PI) / p) * .5 + c + b;
3829 backIn: function (t, b, c, d, s) {
3830 if (typeof s == 'undefined') {
3833 return c * (t /= d) * t * ((s + 1) * t - s) + b;
3837 backOut: function (t, b, c, d, s) {
3838 if (typeof s == 'undefined') {
3841 return c * ((t = t / d - 1) * t * ((s + 1) * t + s) + 1) + b;
3845 backBoth: function (t, b, c, d, s) {
3846 if (typeof s == 'undefined') {
3850 if ((t /= d / 2 ) < 1) {
3851 return c / 2 * (t * t * (((s *= (1.525)) + 1) * t - s)) + b;
3853 return c / 2 * ((t -= 2) * t * (((s *= (1.525)) + 1) * t + s) + 2) + b;
3857 bounceIn: function (t, b, c, d) {
3858 return c - Roo.lib.Easing.bounceOut(d - t, 0, c, d) + b;
3862 bounceOut: function (t, b, c, d) {
3863 if ((t /= d) < (1 / 2.75)) {
3864 return c * (7.5625 * t * t) + b;
3865 } else if (t < (2 / 2.75)) {
3866 return c * (7.5625 * (t -= (1.5 / 2.75)) * t + .75) + b;
3867 } else if (t < (2.5 / 2.75)) {
3868 return c * (7.5625 * (t -= (2.25 / 2.75)) * t + .9375) + b;
3870 return c * (7.5625 * (t -= (2.625 / 2.75)) * t + .984375) + b;
3874 bounceBoth: function (t, b, c, d) {
3876 return Roo.lib.Easing.bounceIn(t * 2, 0, c, d) * .5 + b;
3878 return Roo.lib.Easing.bounceOut(t * 2 - d, 0, c, d) * .5 + c * .5 + b;
3881 * Portions of this file are based on pieces of Yahoo User Interface Library
3882 * Copyright (c) 2007, Yahoo! Inc. All rights reserved.
3883 * YUI licensed under the BSD License:
3884 * http://developer.yahoo.net/yui/license.txt
3885 * <script type="text/javascript">
3889 Roo.lib.Motion = function(el, attributes, duration, method) {
3891 Roo.lib.Motion.superclass.constructor.call(this, el, attributes, duration, method);
3895 Roo.extend(Roo.lib.Motion, Roo.lib.ColorAnim);
3899 var superclass = Y.Motion.superclass;
3900 var proto = Y.Motion.prototype;
3902 proto.toString = function() {
3903 var el = this.getEl();
3904 var id = el.id || el.tagName;
3905 return ("Motion " + id);
3908 proto.patterns.points = /^points$/i;
3910 proto.setAttribute = function(attr, val, unit) {
3911 if (this.patterns.points.test(attr)) {
3912 unit = unit || 'px';
3913 superclass.setAttribute.call(this, 'left', val[0], unit);
3914 superclass.setAttribute.call(this, 'top', val[1], unit);
3916 superclass.setAttribute.call(this, attr, val, unit);
3920 proto.getAttribute = function(attr) {
3921 if (this.patterns.points.test(attr)) {
3923 superclass.getAttribute.call(this, 'left'),
3924 superclass.getAttribute.call(this, 'top')
3927 val = superclass.getAttribute.call(this, attr);
3933 proto.doMethod = function(attr, start, end) {
3936 if (this.patterns.points.test(attr)) {
3937 var t = this.method(this.currentFrame, 0, 100, this.totalFrames) / 100;
3938 val = Y.Bezier.getPosition(this.runtimeAttributes[attr], t);
3940 val = superclass.doMethod.call(this, attr, start, end);
3945 proto.setRuntimeAttribute = function(attr) {
3946 if (this.patterns.points.test(attr)) {
3947 var el = this.getEl();
3948 var attributes = this.attributes;
3950 var control = attributes['points']['control'] || [];
3954 if (control.length > 0 && !(control[0] instanceof Array)) {
3955 control = [control];
3958 for (i = 0,len = control.length; i < len; ++i) {
3959 tmp[i] = control[i];
3964 Roo.fly(el).position();
3966 if (isset(attributes['points']['from'])) {
3967 Roo.lib.Dom.setXY(el, attributes['points']['from']);
3970 Roo.lib.Dom.setXY(el, Roo.lib.Dom.getXY(el));
3973 start = this.getAttribute('points');
3976 if (isset(attributes['points']['to'])) {
3977 end = translateValues.call(this, attributes['points']['to'], start);
3979 var pageXY = Roo.lib.Dom.getXY(this.getEl());
3980 for (i = 0,len = control.length; i < len; ++i) {
3981 control[i] = translateValues.call(this, control[i], start);
3985 } else if (isset(attributes['points']['by'])) {
3986 end = [ start[0] + attributes['points']['by'][0], start[1] + attributes['points']['by'][1] ];
3988 for (i = 0,len = control.length; i < len; ++i) {
3989 control[i] = [ start[0] + control[i][0], start[1] + control[i][1] ];
3993 this.runtimeAttributes[attr] = [start];
3995 if (control.length > 0) {
3996 this.runtimeAttributes[attr] = this.runtimeAttributes[attr].concat(control);
3999 this.runtimeAttributes[attr][this.runtimeAttributes[attr].length] = end;
4002 superclass.setRuntimeAttribute.call(this, attr);
4006 var translateValues = function(val, start) {
4007 var pageXY = Roo.lib.Dom.getXY(this.getEl());
4008 val = [ val[0] - pageXY[0] + start[0], val[1] - pageXY[1] + start[1] ];
4013 var isset = function(prop) {
4014 return (typeof prop !== 'undefined');
4018 * Portions of this file are based on pieces of Yahoo User Interface Library
4019 * Copyright (c) 2007, Yahoo! Inc. All rights reserved.
4020 * YUI licensed under the BSD License:
4021 * http://developer.yahoo.net/yui/license.txt
4022 * <script type="text/javascript">
4026 Roo.lib.Scroll = function(el, attributes, duration, method) {
4028 Roo.lib.Scroll.superclass.constructor.call(this, el, attributes, duration, method);
4032 Roo.extend(Roo.lib.Scroll, Roo.lib.ColorAnim);
4036 var superclass = Y.Scroll.superclass;
4037 var proto = Y.Scroll.prototype;
4039 proto.toString = function() {
4040 var el = this.getEl();
4041 var id = el.id || el.tagName;
4042 return ("Scroll " + id);
4045 proto.doMethod = function(attr, start, end) {
4048 if (attr == 'scroll') {
4050 this.method(this.currentFrame, start[0], end[0] - start[0], this.totalFrames),
4051 this.method(this.currentFrame, start[1], end[1] - start[1], this.totalFrames)
4055 val = superclass.doMethod.call(this, attr, start, end);
4060 proto.getAttribute = function(attr) {
4062 var el = this.getEl();
4064 if (attr == 'scroll') {
4065 val = [ el.scrollLeft, el.scrollTop ];
4067 val = superclass.getAttribute.call(this, attr);
4073 proto.setAttribute = function(attr, val, unit) {
4074 var el = this.getEl();
4076 if (attr == 'scroll') {
4077 el.scrollLeft = val[0];
4078 el.scrollTop = val[1];
4080 superclass.setAttribute.call(this, attr, val, unit);
4086 * Ext JS Library 1.1.1
4087 * Copyright(c) 2006-2007, Ext JS, LLC.
4089 * Originally Released Under LGPL - original licence link has changed is not relivant.
4092 * <script type="text/javascript">
4096 // nasty IE9 hack - what a pile of crap that is..
4098 if (typeof Range != "undefined" && typeof Range.prototype.createContextualFragment == "undefined") {
4099 Range.prototype.createContextualFragment = function (html) {
4100 var doc = window.document;
4101 var container = doc.createElement("div");
4102 container.innerHTML = html;
4103 var frag = doc.createDocumentFragment(), n;
4104 while ((n = container.firstChild)) {
4105 frag.appendChild(n);
4112 * @class Roo.DomHelper
4113 * Utility class for working with DOM and/or Templates. It transparently supports using HTML fragments or DOM.
4114 * For more information see <a href="http://web.archive.org/web/20071221063734/http://www.jackslocum.com/blog/2006/10/06/domhelper-create-elements-using-dom-html-fragments-or-templates/">this blog post with examples</a>.
4117 Roo.DomHelper = function(){
4118 var tempTableEl = null;
4119 var emptyTags = /^(?:br|frame|hr|img|input|link|meta|range|spacer|wbr|area|param|col)$/i;
4120 var tableRe = /^table|tbody|tr|td$/i;
4122 // build as innerHTML where available
4124 var createHtml = function(o){
4125 if(typeof o == 'string'){
4134 if(attr == "tag" || attr == "children" || attr == "cn" || attr == "html" || typeof o[attr] == "function") continue;
4135 if(attr == "style"){
4137 if(typeof s == "function"){
4140 if(typeof s == "string"){
4141 b += ' style="' + s + '"';
4142 }else if(typeof s == "object"){
4145 if(typeof s[key] != "function"){
4146 b += key + ":" + s[key] + ";";
4153 b += ' class="' + o["cls"] + '"';
4154 }else if(attr == "htmlFor"){
4155 b += ' for="' + o["htmlFor"] + '"';
4157 b += " " + attr + '="' + o[attr] + '"';
4161 if(emptyTags.test(o.tag)){
4165 var cn = o.children || o.cn;
4167 //http://bugs.kde.org/show_bug.cgi?id=71506
4168 if((cn instanceof Array) || (Roo.isSafari && typeof(cn.join) == "function")){
4169 for(var i = 0, len = cn.length; i < len; i++) {
4170 b += createHtml(cn[i], b);
4173 b += createHtml(cn, b);
4179 b += "</" + o.tag + ">";
4186 var createDom = function(o, parentNode){
4188 // defininition craeted..
4190 if (o.ns && o.ns != 'html') {
4192 if (o.xmlns && typeof(xmlns[o.ns]) == 'undefined') {
4193 xmlns[o.ns] = o.xmlns;
4196 if (typeof(xmlns[o.ns]) == 'undefined') {
4197 console.log("Trying to create namespace element " + o.ns + ", however no xmlns was sent to builder previously");
4203 if (typeof(o) == 'string') {
4204 return parentNode.appendChild(document.createTextNode(o));
4206 o.tag = o.tag || div;
4207 if (o.ns && Roo.isIE) {
4209 o.tag = o.ns + ':' + o.tag;
4212 var el = ns ? document.createElementNS( ns, o.tag||'div') : document.createElement(o.tag||'div');
4213 var useSet = el.setAttribute ? true : false; // In IE some elements don't have setAttribute
4216 if(attr == "tag" || attr == "ns" ||attr == "xmlns" ||attr == "children" || attr == "cn" || attr == "html" ||
4217 attr == "style" || typeof o[attr] == "function") continue;
4219 if(attr=="cls" && Roo.isIE){
4220 el.className = o["cls"];
4222 if(useSet) el.setAttribute(attr=="cls" ? 'class' : attr, o[attr]);
4223 else el[attr] = o[attr];
4226 Roo.DomHelper.applyStyles(el, o.style);
4227 var cn = o.children || o.cn;
4229 //http://bugs.kde.org/show_bug.cgi?id=71506
4230 if((cn instanceof Array) || (Roo.isSafari && typeof(cn.join) == "function")){
4231 for(var i = 0, len = cn.length; i < len; i++) {
4232 createDom(cn[i], el);
4239 el.innerHTML = o.html;
4242 parentNode.appendChild(el);
4247 var ieTable = function(depth, s, h, e){
4248 tempTableEl.innerHTML = [s, h, e].join('');
4249 var i = -1, el = tempTableEl;
4256 // kill repeat to save bytes
4260 tbe = '</tbody>'+te,
4266 * Nasty code for IE's broken table implementation
4268 var insertIntoTable = function(tag, where, el, html){
4270 tempTableEl = document.createElement('div');
4275 if(where == 'afterbegin' || where == 'beforeend'){ // INTO a TD
4278 if(where == 'beforebegin'){
4282 before = el.nextSibling;
4285 node = ieTable(4, trs, html, tre);
4287 else if(tag == 'tr'){
4288 if(where == 'beforebegin'){
4291 node = ieTable(3, tbs, html, tbe);
4292 } else if(where == 'afterend'){
4293 before = el.nextSibling;
4295 node = ieTable(3, tbs, html, tbe);
4296 } else{ // INTO a TR
4297 if(where == 'afterbegin'){
4298 before = el.firstChild;
4300 node = ieTable(4, trs, html, tre);
4302 } else if(tag == 'tbody'){
4303 if(where == 'beforebegin'){
4306 node = ieTable(2, ts, html, te);
4307 } else if(where == 'afterend'){
4308 before = el.nextSibling;
4310 node = ieTable(2, ts, html, te);
4312 if(where == 'afterbegin'){
4313 before = el.firstChild;
4315 node = ieTable(3, tbs, html, tbe);
4318 if(where == 'beforebegin' || where == 'afterend'){ // OUTSIDE the table
4321 if(where == 'afterbegin'){
4322 before = el.firstChild;
4324 node = ieTable(2, ts, html, te);
4326 el.insertBefore(node, before);
4331 /** True to force the use of DOM instead of html fragments @type Boolean */
4335 * Returns the markup for the passed Element(s) config
4336 * @param {Object} o The Dom object spec (and children)
4339 markup : function(o){
4340 return createHtml(o);
4344 * Applies a style specification to an element
4345 * @param {String/HTMLElement} el The element to apply styles to
4346 * @param {String/Object/Function} styles A style specification string eg "width:100px", or object in the form {width:"100px"}, or
4347 * a function which returns such a specification.
4349 applyStyles : function(el, styles){
4352 if(typeof styles == "string"){
4353 var re = /\s?([a-z\-]*)\:\s?([^;]*);?/gi;
4355 while ((matches = re.exec(styles)) != null){
4356 el.setStyle(matches[1], matches[2]);
4358 }else if (typeof styles == "object"){
4359 for (var style in styles){
4360 el.setStyle(style, styles[style]);
4362 }else if (typeof styles == "function"){
4363 Roo.DomHelper.applyStyles(el, styles.call());
4369 * Inserts an HTML fragment into the Dom
4370 * @param {String} where Where to insert the html in relation to el - beforeBegin, afterBegin, beforeEnd, afterEnd.
4371 * @param {HTMLElement} el The context element
4372 * @param {String} html The HTML fragmenet
4373 * @return {HTMLElement} The new node
4375 insertHtml : function(where, el, html){
4376 where = where.toLowerCase();
4377 if(el.insertAdjacentHTML){
4378 if(tableRe.test(el.tagName)){
4380 if(rs = insertIntoTable(el.tagName.toLowerCase(), where, el, html)){
4386 el.insertAdjacentHTML('BeforeBegin', html);
4387 return el.previousSibling;
4389 el.insertAdjacentHTML('AfterBegin', html);
4390 return el.firstChild;
4392 el.insertAdjacentHTML('BeforeEnd', html);
4393 return el.lastChild;
4395 el.insertAdjacentHTML('AfterEnd', html);
4396 return el.nextSibling;
4398 throw 'Illegal insertion point -> "' + where + '"';
4400 var range = el.ownerDocument.createRange();
4404 range.setStartBefore(el);
4405 frag = range.createContextualFragment(html);
4406 el.parentNode.insertBefore(frag, el);
4407 return el.previousSibling;
4410 range.setStartBefore(el.firstChild);
4411 frag = range.createContextualFragment(html);
4412 el.insertBefore(frag, el.firstChild);
4413 return el.firstChild;
4415 el.innerHTML = html;
4416 return el.firstChild;
4420 range.setStartAfter(el.lastChild);
4421 frag = range.createContextualFragment(html);
4422 el.appendChild(frag);
4423 return el.lastChild;
4425 el.innerHTML = html;
4426 return el.lastChild;
4429 range.setStartAfter(el);
4430 frag = range.createContextualFragment(html);
4431 el.parentNode.insertBefore(frag, el.nextSibling);
4432 return el.nextSibling;
4434 throw 'Illegal insertion point -> "' + where + '"';
4438 * Creates new Dom element(s) and inserts them before el
4439 * @param {String/HTMLElement/Element} el The context element
4440 * @param {Object/String} o The Dom object spec (and children) or raw HTML blob
4441 * @param {Boolean} returnElement (optional) true to return a Roo.Element
4442 * @return {HTMLElement/Roo.Element} The new node
4444 insertBefore : function(el, o, returnElement){
4445 return this.doInsert(el, o, returnElement, "beforeBegin");
4449 * Creates new Dom element(s) and inserts them after el
4450 * @param {String/HTMLElement/Element} el The context element
4451 * @param {Object} o The Dom object spec (and children)
4452 * @param {Boolean} returnElement (optional) true to return a Roo.Element
4453 * @return {HTMLElement/Roo.Element} The new node
4455 insertAfter : function(el, o, returnElement){
4456 return this.doInsert(el, o, returnElement, "afterEnd", "nextSibling");
4460 * Creates new Dom element(s) and inserts them as the first child of el
4461 * @param {String/HTMLElement/Element} el The context element
4462 * @param {Object/String} o The Dom object spec (and children) or raw HTML blob
4463 * @param {Boolean} returnElement (optional) true to return a Roo.Element
4464 * @return {HTMLElement/Roo.Element} The new node
4466 insertFirst : function(el, o, returnElement){
4467 return this.doInsert(el, o, returnElement, "afterBegin");
4471 doInsert : function(el, o, returnElement, pos, sibling){
4472 el = Roo.getDom(el);
4474 if(this.useDom || o.ns){
4475 newNode = createDom(o, null);
4476 el.parentNode.insertBefore(newNode, sibling ? el[sibling] : el);
4478 var html = createHtml(o);
4479 newNode = this.insertHtml(pos, el, html);
4481 return returnElement ? Roo.get(newNode, true) : newNode;
4485 * Creates new Dom element(s) and appends them to el
4486 * @param {String/HTMLElement/Element} el The context element
4487 * @param {Object/String} o The Dom object spec (and children) or raw HTML blob
4488 * @param {Boolean} returnElement (optional) true to return a Roo.Element
4489 * @return {HTMLElement/Roo.Element} The new node
4491 append : function(el, o, returnElement){
4492 el = Roo.getDom(el);
4494 if(this.useDom || o.ns){
4495 newNode = createDom(o, null);
4496 el.appendChild(newNode);
4498 var html = createHtml(o);
4499 newNode = this.insertHtml("beforeEnd", el, html);
4501 return returnElement ? Roo.get(newNode, true) : newNode;
4505 * Creates new Dom element(s) and overwrites the contents of el with them
4506 * @param {String/HTMLElement/Element} el The context element
4507 * @param {Object/String} o The Dom object spec (and children) or raw HTML blob
4508 * @param {Boolean} returnElement (optional) true to return a Roo.Element
4509 * @return {HTMLElement/Roo.Element} The new node
4511 overwrite : function(el, o, returnElement){
4512 el = Roo.getDom(el);
4515 while (el.childNodes.length) {
4516 el.removeChild(el.firstChild);
4520 el.innerHTML = createHtml(o);
4523 return returnElement ? Roo.get(el.firstChild, true) : el.firstChild;
4527 * Creates a new Roo.DomHelper.Template from the Dom object spec
4528 * @param {Object} o The Dom object spec (and children)
4529 * @return {Roo.DomHelper.Template} The new template
4531 createTemplate : function(o){
4532 var html = createHtml(o);
4533 return new Roo.Template(html);
4539 * Ext JS Library 1.1.1
4540 * Copyright(c) 2006-2007, Ext JS, LLC.
4542 * Originally Released Under LGPL - original licence link has changed is not relivant.
4545 * <script type="text/javascript">
4549 * @class Roo.Template
4550 * Represents an HTML fragment template. Templates can be precompiled for greater performance.
4551 * For a list of available format functions, see {@link Roo.util.Format}.<br />
4554 var t = new Roo.Template({
4555 html : '<div name="{id}">' +
4556 '<span class="{cls}">{name:trim} {someval:this.myformat}{value:ellipsis(10)}</span>' +
4558 myformat: function (value, allValues) {
4559 return 'XX' + value;
4562 t.append('some-element', {id: 'myid', cls: 'myclass', name: 'foo', value: 'bar'});
4564 * For more information see this blog post with examples:
4565 * <a href="http://www.cnitblog.com/seeyeah/archive/2011/12/30/38728.html/">DomHelper
4566 - Create Elements using DOM, HTML fragments and Templates</a>.
4568 * @param {Object} cfg - Configuration object.
4570 Roo.Template = function(cfg){
4572 if(cfg instanceof Array){
4574 }else if(arguments.length > 1){
4575 cfg = Array.prototype.join.call(arguments, "");
4579 if (typeof(cfg) == 'object') {
4590 Roo.Template.prototype = {
4593 * @cfg {String} url The Url to load the template from. beware if you are loading from a url, the data may not be ready if you use it instantly..
4594 * it should be fixed so that template is observable...
4598 * @cfg {String} html The HTML fragment or an array of fragments to join("") or multiple arguments to join("")
4602 * Returns an HTML fragment of this template with the specified values applied.
4603 * @param {Object} values The template values. Can be an array if your params are numeric (i.e. {0}) or an object (i.e. {foo: 'bar'})
4604 * @return {String} The HTML fragment
4606 applyTemplate : function(values){
4610 return this.compiled(values);
4612 var useF = this.disableFormats !== true;
4613 var fm = Roo.util.Format, tpl = this;
4614 var fn = function(m, name, format, args){
4616 if(format.substr(0, 5) == "this."){
4617 return tpl.call(format.substr(5), values[name], values);
4620 // quoted values are required for strings in compiled templates,
4621 // but for non compiled we need to strip them
4622 // quoted reversed for jsmin
4623 var re = /^\s*['"](.*)["']\s*$/;
4624 args = args.split(',');
4625 for(var i = 0, len = args.length; i < len; i++){
4626 args[i] = args[i].replace(re, "$1");
4628 args = [values[name]].concat(args);
4630 args = [values[name]];
4632 return fm[format].apply(fm, args);
4635 return values[name] !== undefined ? values[name] : "";
4638 return this.html.replace(this.re, fn);
4656 this.loading = true;
4657 this.compiled = false;
4659 var cx = new Roo.data.Connection();
4663 success : function (response) {
4665 _t.html = response.responseText;
4669 failure : function(response) {
4670 Roo.log("Template failed to load from " + _t.url);
4677 * Sets the HTML used as the template and optionally compiles it.
4678 * @param {String} html
4679 * @param {Boolean} compile (optional) True to compile the template (defaults to undefined)
4680 * @return {Roo.Template} this
4682 set : function(html, compile){
4684 this.compiled = null;
4692 * True to disable format functions (defaults to false)
4695 disableFormats : false,
4698 * The regular expression used to match template variables
4702 re : /\{([\w-]+)(?:\:([\w\.]*)(?:\((.*?)?\))?)?\}/g,
4705 * Compiles the template into an internal function, eliminating the RegEx overhead.
4706 * @return {Roo.Template} this
4708 compile : function(){
4709 var fm = Roo.util.Format;
4710 var useF = this.disableFormats !== true;
4711 var sep = Roo.isGecko ? "+" : ",";
4712 var fn = function(m, name, format, args){
4714 args = args ? ',' + args : "";
4715 if(format.substr(0, 5) != "this."){
4716 format = "fm." + format + '(';
4718 format = 'this.call("'+ format.substr(5) + '", ';
4722 args= ''; format = "(values['" + name + "'] == undefined ? '' : ";
4724 return "'"+ sep + format + "values['" + name + "']" + args + ")"+sep+"'";
4727 // branched to use + in gecko and [].join() in others
4729 body = "this.compiled = function(values){ return '" +
4730 this.html.replace(/\\/g, '\\\\').replace(/(\r\n|\n)/g, '\\n').replace(/'/g, "\\'").replace(this.re, fn) +
4733 body = ["this.compiled = function(values){ return ['"];
4734 body.push(this.html.replace(/\\/g, '\\\\').replace(/(\r\n|\n)/g, '\\n').replace(/'/g, "\\'").replace(this.re, fn));
4735 body.push("'].join('');};");
4736 body = body.join('');
4746 // private function used to call members
4747 call : function(fnName, value, allValues){
4748 return this[fnName](value, allValues);
4752 * Applies the supplied values to the template and inserts the new node(s) as the first child of el.
4753 * @param {String/HTMLElement/Roo.Element} el The context element
4754 * @param {Object} values The template values. Can be an array if your params are numeric (i.e. {0}) or an object (i.e. {foo: 'bar'})
4755 * @param {Boolean} returnElement (optional) true to return a Roo.Element (defaults to undefined)
4756 * @return {HTMLElement/Roo.Element} The new node or Element
4758 insertFirst: function(el, values, returnElement){
4759 return this.doInsert('afterBegin', el, values, returnElement);
4763 * Applies the supplied values to the template and inserts the new node(s) before el.
4764 * @param {String/HTMLElement/Roo.Element} el The context element
4765 * @param {Object} values The template values. Can be an array if your params are numeric (i.e. {0}) or an object (i.e. {foo: 'bar'})
4766 * @param {Boolean} returnElement (optional) true to return a Roo.Element (defaults to undefined)
4767 * @return {HTMLElement/Roo.Element} The new node or Element
4769 insertBefore: function(el, values, returnElement){
4770 return this.doInsert('beforeBegin', el, values, returnElement);
4774 * Applies the supplied values to the template and inserts the new node(s) after el.
4775 * @param {String/HTMLElement/Roo.Element} el The context element
4776 * @param {Object} values The template values. Can be an array if your params are numeric (i.e. {0}) or an object (i.e. {foo: 'bar'})
4777 * @param {Boolean} returnElement (optional) true to return a Roo.Element (defaults to undefined)
4778 * @return {HTMLElement/Roo.Element} The new node or Element
4780 insertAfter : function(el, values, returnElement){
4781 return this.doInsert('afterEnd', el, values, returnElement);
4785 * Applies the supplied values to the template and appends the new node(s) to el.
4786 * @param {String/HTMLElement/Roo.Element} el The context element
4787 * @param {Object} values The template values. Can be an array if your params are numeric (i.e. {0}) or an object (i.e. {foo: 'bar'})
4788 * @param {Boolean} returnElement (optional) true to return a Roo.Element (defaults to undefined)
4789 * @return {HTMLElement/Roo.Element} The new node or Element
4791 append : function(el, values, returnElement){
4792 return this.doInsert('beforeEnd', el, values, returnElement);
4795 doInsert : function(where, el, values, returnEl){
4796 el = Roo.getDom(el);
4797 var newNode = Roo.DomHelper.insertHtml(where, el, this.applyTemplate(values));
4798 return returnEl ? Roo.get(newNode, true) : newNode;
4802 * Applies the supplied values to the template and overwrites the content of el with the new node(s).
4803 * @param {String/HTMLElement/Roo.Element} el The context element
4804 * @param {Object} values The template values. Can be an array if your params are numeric (i.e. {0}) or an object (i.e. {foo: 'bar'})
4805 * @param {Boolean} returnElement (optional) true to return a Roo.Element (defaults to undefined)
4806 * @return {HTMLElement/Roo.Element} The new node or Element
4808 overwrite : function(el, values, returnElement){
4809 el = Roo.getDom(el);
4810 el.innerHTML = this.applyTemplate(values);
4811 return returnElement ? Roo.get(el.firstChild, true) : el.firstChild;
4815 * Alias for {@link #applyTemplate}
4818 Roo.Template.prototype.apply = Roo.Template.prototype.applyTemplate;
4821 Roo.DomHelper.Template = Roo.Template;
4824 * Creates a template from the passed element's value (<i>display:none</i> textarea, preferred) or innerHTML.
4825 * @param {String/HTMLElement} el A DOM element or its id
4826 * @returns {Roo.Template} The created template
4829 Roo.Template.from = function(el){
4830 el = Roo.getDom(el);
4831 return new Roo.Template(el.value || el.innerHTML);
4834 * Ext JS Library 1.1.1
4835 * Copyright(c) 2006-2007, Ext JS, LLC.
4837 * Originally Released Under LGPL - original licence link has changed is not relivant.
4840 * <script type="text/javascript">
4845 * This is code is also distributed under MIT license for use
4846 * with jQuery and prototype JavaScript libraries.
4849 * @class Roo.DomQuery
4850 Provides high performance selector/xpath processing by compiling queries into reusable functions. New pseudo classes and matchers can be plugged. It works on HTML and XML documents (if a content node is passed in).
4852 DomQuery supports most of the <a href="http://www.w3.org/TR/2005/WD-css3-selectors-20051215/">CSS3 selectors spec</a>, along with some custom selectors and basic XPath.</p>
4855 All selectors, attribute filters and pseudos below can be combined infinitely in any order. For example "div.foo:nth-child(odd)[@foo=bar].bar:first" would be a perfectly valid selector. Node filters are processed in the order in which they appear, which allows you to optimize your queries for your document structure.
4857 <h4>Element Selectors:</h4>
4859 <li> <b>*</b> any element</li>
4860 <li> <b>E</b> an element with the tag E</li>
4861 <li> <b>E F</b> All descendent elements of E that have the tag F</li>
4862 <li> <b>E > F</b> or <b>E/F</b> all direct children elements of E that have the tag F</li>
4863 <li> <b>E + F</b> all elements with the tag F that are immediately preceded by an element with the tag E</li>
4864 <li> <b>E ~ F</b> all elements with the tag F that are preceded by a sibling element with the tag E</li>
4866 <h4>Attribute Selectors:</h4>
4867 <p>The use of @ and quotes are optional. For example, div[@foo='bar'] is also a valid attribute selector.</p>
4869 <li> <b>E[foo]</b> has an attribute "foo"</li>
4870 <li> <b>E[foo=bar]</b> has an attribute "foo" that equals "bar"</li>
4871 <li> <b>E[foo^=bar]</b> has an attribute "foo" that starts with "bar"</li>
4872 <li> <b>E[foo$=bar]</b> has an attribute "foo" that ends with "bar"</li>
4873 <li> <b>E[foo*=bar]</b> has an attribute "foo" that contains the substring "bar"</li>
4874 <li> <b>E[foo%=2]</b> has an attribute "foo" that is evenly divisible by 2</li>
4875 <li> <b>E[foo!=bar]</b> has an attribute "foo" that does not equal "bar"</li>
4877 <h4>Pseudo Classes:</h4>
4879 <li> <b>E:first-child</b> E is the first child of its parent</li>
4880 <li> <b>E:last-child</b> E is the last child of its parent</li>
4881 <li> <b>E:nth-child(<i>n</i>)</b> E is the <i>n</i>th child of its parent (1 based as per the spec)</li>
4882 <li> <b>E:nth-child(odd)</b> E is an odd child of its parent</li>
4883 <li> <b>E:nth-child(even)</b> E is an even child of its parent</li>
4884 <li> <b>E:only-child</b> E is the only child of its parent</li>
4885 <li> <b>E:checked</b> E is an element that is has a checked attribute that is true (e.g. a radio or checkbox) </li>
4886 <li> <b>E:first</b> the first E in the resultset</li>
4887 <li> <b>E:last</b> the last E in the resultset</li>
4888 <li> <b>E:nth(<i>n</i>)</b> the <i>n</i>th E in the resultset (1 based)</li>
4889 <li> <b>E:odd</b> shortcut for :nth-child(odd)</li>
4890 <li> <b>E:even</b> shortcut for :nth-child(even)</li>
4891 <li> <b>E:contains(foo)</b> E's innerHTML contains the substring "foo"</li>
4892 <li> <b>E:nodeValue(foo)</b> E contains a textNode with a nodeValue that equals "foo"</li>
4893 <li> <b>E:not(S)</b> an E element that does not match simple selector S</li>
4894 <li> <b>E:has(S)</b> an E element that has a descendent that matches simple selector S</li>
4895 <li> <b>E:next(S)</b> an E element whose next sibling matches simple selector S</li>
4896 <li> <b>E:prev(S)</b> an E element whose previous sibling matches simple selector S</li>
4898 <h4>CSS Value Selectors:</h4>
4900 <li> <b>E{display=none}</b> css value "display" that equals "none"</li>
4901 <li> <b>E{display^=none}</b> css value "display" that starts with "none"</li>
4902 <li> <b>E{display$=none}</b> css value "display" that ends with "none"</li>
4903 <li> <b>E{display*=none}</b> css value "display" that contains the substring "none"</li>
4904 <li> <b>E{display%=2}</b> css value "display" that is evenly divisible by 2</li>
4905 <li> <b>E{display!=none}</b> css value "display" that does not equal "none"</li>
4909 Roo.DomQuery = function(){
4910 var cache = {}, simpleCache = {}, valueCache = {};
4911 var nonSpace = /\S/;
4912 var trimRe = /^\s+|\s+$/g;
4913 var tplRe = /\{(\d+)\}/g;
4914 var modeRe = /^(\s?[\/>+~]\s?|\s|$)/;
4915 var tagTokenRe = /^(#)?([\w-\*]+)/;
4916 var nthRe = /(\d*)n\+?(\d*)/, nthRe2 = /\D/;
4918 function child(p, index){
4920 var n = p.firstChild;
4922 if(n.nodeType == 1){
4933 while((n = n.nextSibling) && n.nodeType != 1);
4938 while((n = n.previousSibling) && n.nodeType != 1);
4942 function children(d){
4943 var n = d.firstChild, ni = -1;
4945 var nx = n.nextSibling;
4946 if(n.nodeType == 3 && !nonSpace.test(n.nodeValue)){
4956 function byClassName(c, a, v){
4960 var r = [], ri = -1, cn;
4961 for(var i = 0, ci; ci = c[i]; i++){
4962 if((' '+ci.className+' ').indexOf(v) != -1){
4969 function attrValue(n, attr){
4970 if(!n.tagName && typeof n.length != "undefined"){
4979 if(attr == "class" || attr == "className"){
4982 return n.getAttribute(attr) || n[attr];
4986 function getNodes(ns, mode, tagName){
4987 var result = [], ri = -1, cs;
4991 tagName = tagName || "*";
4992 if(typeof ns.getElementsByTagName != "undefined"){
4996 for(var i = 0, ni; ni = ns[i]; i++){
4997 cs = ni.getElementsByTagName(tagName);
4998 for(var j = 0, ci; ci = cs[j]; j++){
5002 }else if(mode == "/" || mode == ">"){
5003 var utag = tagName.toUpperCase();
5004 for(var i = 0, ni, cn; ni = ns[i]; i++){
5005 cn = ni.children || ni.childNodes;
5006 for(var j = 0, cj; cj = cn[j]; j++){
5007 if(cj.nodeName == utag || cj.nodeName == tagName || tagName == '*'){
5012 }else if(mode == "+"){
5013 var utag = tagName.toUpperCase();
5014 for(var i = 0, n; n = ns[i]; i++){
5015 while((n = n.nextSibling) && n.nodeType != 1);
5016 if(n && (n.nodeName == utag || n.nodeName == tagName || tagName == '*')){
5020 }else if(mode == "~"){
5021 for(var i = 0, n; n = ns[i]; i++){
5022 while((n = n.nextSibling) && (n.nodeType != 1 || (tagName == '*' || n.tagName.toLowerCase()!=tagName)));
5031 function concat(a, b){
5035 for(var i = 0, l = b.length; i < l; i++){
5041 function byTag(cs, tagName){
5042 if(cs.tagName || cs == document){
5048 var r = [], ri = -1;
5049 tagName = tagName.toLowerCase();
5050 for(var i = 0, ci; ci = cs[i]; i++){
5051 if(ci.nodeType == 1 && ci.tagName.toLowerCase()==tagName){
5058 function byId(cs, attr, id){
5059 if(cs.tagName || cs == document){
5065 var r = [], ri = -1;
5066 for(var i = 0,ci; ci = cs[i]; i++){
5067 if(ci && ci.id == id){
5075 function byAttribute(cs, attr, value, op, custom){
5076 var r = [], ri = -1, st = custom=="{";
5077 var f = Roo.DomQuery.operators[op];
5078 for(var i = 0, ci; ci = cs[i]; i++){
5081 a = Roo.DomQuery.getStyle(ci, attr);
5083 else if(attr == "class" || attr == "className"){
5085 }else if(attr == "for"){
5087 }else if(attr == "href"){
5088 a = ci.getAttribute("href", 2);
5090 a = ci.getAttribute(attr);
5092 if((f && f(a, value)) || (!f && a)){
5099 function byPseudo(cs, name, value){
5100 return Roo.DomQuery.pseudos[name](cs, value);
5103 // This is for IE MSXML which does not support expandos.
5104 // IE runs the same speed using setAttribute, however FF slows way down
5105 // and Safari completely fails so they need to continue to use expandos.
5106 var isIE = window.ActiveXObject ? true : false;
5108 // this eval is stop the compressor from
5109 // renaming the variable to something shorter
5111 /** eval:var:batch */
5116 function nodupIEXml(cs){
5118 cs[0].setAttribute("_nodup", d);
5120 for(var i = 1, len = cs.length; i < len; i++){
5122 if(!c.getAttribute("_nodup") != d){
5123 c.setAttribute("_nodup", d);
5127 for(var i = 0, len = cs.length; i < len; i++){
5128 cs[i].removeAttribute("_nodup");
5137 var len = cs.length, c, i, r = cs, cj, ri = -1;
5138 if(!len || typeof cs.nodeType != "undefined" || len == 1){
5141 if(isIE && typeof cs[0].selectSingleNode != "undefined"){
5142 return nodupIEXml(cs);
5146 for(i = 1; c = cs[i]; i++){
5151 for(var j = 0; j < i; j++){
5154 for(j = i+1; cj = cs[j]; j++){
5166 function quickDiffIEXml(c1, c2){
5168 for(var i = 0, len = c1.length; i < len; i++){
5169 c1[i].setAttribute("_qdiff", d);
5172 for(var i = 0, len = c2.length; i < len; i++){
5173 if(c2[i].getAttribute("_qdiff") != d){
5174 r[r.length] = c2[i];
5177 for(var i = 0, len = c1.length; i < len; i++){
5178 c1[i].removeAttribute("_qdiff");
5183 function quickDiff(c1, c2){
5184 var len1 = c1.length;
5188 if(isIE && c1[0].selectSingleNode){
5189 return quickDiffIEXml(c1, c2);
5192 for(var i = 0; i < len1; i++){
5196 for(var i = 0, len = c2.length; i < len; i++){
5197 if(c2[i]._qdiff != d){
5198 r[r.length] = c2[i];
5204 function quickId(ns, mode, root, id){
5206 var d = root.ownerDocument || root;
5207 return d.getElementById(id);
5209 ns = getNodes(ns, mode, "*");
5210 return byId(ns, null, id);
5214 getStyle : function(el, name){
5215 return Roo.fly(el).getStyle(name);
5218 * Compiles a selector/xpath query into a reusable function. The returned function
5219 * takes one parameter "root" (optional), which is the context node from where the query should start.
5220 * @param {String} selector The selector/xpath query
5221 * @param {String} type (optional) Either "select" (the default) or "simple" for a simple selector match
5222 * @return {Function}
5224 compile : function(path, type){
5225 type = type || "select";
5227 var fn = ["var f = function(root){\n var mode; ++batch; var n = root || document;\n"];
5228 var q = path, mode, lq;
5229 var tk = Roo.DomQuery.matchers;
5230 var tklen = tk.length;
5233 // accept leading mode switch
5234 var lmode = q.match(modeRe);
5235 if(lmode && lmode[1]){
5236 fn[fn.length] = 'mode="'+lmode[1].replace(trimRe, "")+'";';
5237 q = q.replace(lmode[1], "");
5239 // strip leading slashes
5240 while(path.substr(0, 1)=="/"){
5241 path = path.substr(1);
5244 while(q && lq != q){
5246 var tm = q.match(tagTokenRe);
5247 if(type == "select"){
5250 fn[fn.length] = 'n = quickId(n, mode, root, "'+tm[2]+'");';
5252 fn[fn.length] = 'n = getNodes(n, mode, "'+tm[2]+'");';
5254 q = q.replace(tm[0], "");
5255 }else if(q.substr(0, 1) != '@'){
5256 fn[fn.length] = 'n = getNodes(n, mode, "*");';
5261 fn[fn.length] = 'n = byId(n, null, "'+tm[2]+'");';
5263 fn[fn.length] = 'n = byTag(n, "'+tm[2]+'");';
5265 q = q.replace(tm[0], "");
5268 while(!(mm = q.match(modeRe))){
5269 var matched = false;
5270 for(var j = 0; j < tklen; j++){
5272 var m = q.match(t.re);
5274 fn[fn.length] = t.select.replace(tplRe, function(x, i){
5277 q = q.replace(m[0], "");
5282 // prevent infinite loop on bad selector
5284 throw 'Error parsing selector, parsing failed at "' + q + '"';
5288 fn[fn.length] = 'mode="'+mm[1].replace(trimRe, "")+'";';
5289 q = q.replace(mm[1], "");
5292 fn[fn.length] = "return nodup(n);\n}";
5295 * list of variables that need from compression as they are used by eval.
5305 * eval:var:byClassName
5307 * eval:var:byAttribute
5308 * eval:var:attrValue
5316 * Selects a group of elements.
5317 * @param {String} selector The selector/xpath query (can be a comma separated list of selectors)
5318 * @param {Node} root (optional) The start of the query (defaults to document).
5321 select : function(path, root, type){
5322 if(!root || root == document){
5325 if(typeof root == "string"){
5326 root = document.getElementById(root);
5328 var paths = path.split(",");
5330 for(var i = 0, len = paths.length; i < len; i++){
5331 var p = paths[i].replace(trimRe, "");
5333 cache[p] = Roo.DomQuery.compile(p);
5335 throw p + " is not a valid selector";
5338 var result = cache[p](root);
5339 if(result && result != document){
5340 results = results.concat(result);
5343 if(paths.length > 1){
5344 return nodup(results);
5350 * Selects a single element.
5351 * @param {String} selector The selector/xpath query
5352 * @param {Node} root (optional) The start of the query (defaults to document).
5355 selectNode : function(path, root){
5356 return Roo.DomQuery.select(path, root)[0];
5360 * Selects the value of a node, optionally replacing null with the defaultValue.
5361 * @param {String} selector The selector/xpath query
5362 * @param {Node} root (optional) The start of the query (defaults to document).
5363 * @param {String} defaultValue
5365 selectValue : function(path, root, defaultValue){
5366 path = path.replace(trimRe, "");
5367 if(!valueCache[path]){
5368 valueCache[path] = Roo.DomQuery.compile(path, "select");
5370 var n = valueCache[path](root);
5371 n = n[0] ? n[0] : n;
5372 var v = (n && n.firstChild ? n.firstChild.nodeValue : null);
5373 return ((v === null||v === undefined||v==='') ? defaultValue : v);
5377 * Selects the value of a node, parsing integers and floats.
5378 * @param {String} selector The selector/xpath query
5379 * @param {Node} root (optional) The start of the query (defaults to document).
5380 * @param {Number} defaultValue
5383 selectNumber : function(path, root, defaultValue){
5384 var v = Roo.DomQuery.selectValue(path, root, defaultValue || 0);
5385 return parseFloat(v);
5389 * Returns true if the passed element(s) match the passed simple selector (e.g. div.some-class or span:first-child)
5390 * @param {String/HTMLElement/Array} el An element id, element or array of elements
5391 * @param {String} selector The simple selector to test
5394 is : function(el, ss){
5395 if(typeof el == "string"){
5396 el = document.getElementById(el);
5398 var isArray = (el instanceof Array);
5399 var result = Roo.DomQuery.filter(isArray ? el : [el], ss);
5400 return isArray ? (result.length == el.length) : (result.length > 0);
5404 * Filters an array of elements to only include matches of a simple selector (e.g. div.some-class or span:first-child)
5405 * @param {Array} el An array of elements to filter
5406 * @param {String} selector The simple selector to test
5407 * @param {Boolean} nonMatches If true, it returns the elements that DON'T match
5408 * the selector instead of the ones that match
5411 filter : function(els, ss, nonMatches){
5412 ss = ss.replace(trimRe, "");
5413 if(!simpleCache[ss]){
5414 simpleCache[ss] = Roo.DomQuery.compile(ss, "simple");
5416 var result = simpleCache[ss](els);
5417 return nonMatches ? quickDiff(result, els) : result;
5421 * Collection of matching regular expressions and code snippets.
5425 select: 'n = byClassName(n, null, " {1} ");'
5427 re: /^\:([\w-]+)(?:\(((?:[^\s>\/]*|.*?))\))?/,
5428 select: 'n = byPseudo(n, "{1}", "{2}");'
5430 re: /^(?:([\[\{])(?:@)?([\w-]+)\s?(?:(=|.=)\s?['"]?(.*?)["']?)?[\]\}])/,
5431 select: 'n = byAttribute(n, "{2}", "{4}", "{3}", "{1}");'
5434 select: 'n = byId(n, null, "{1}");'
5437 select: 'return {firstChild:{nodeValue:attrValue(n, "{1}")}};'
5442 * Collection of operator comparison functions. The default operators are =, !=, ^=, $=, *=, %=, |= and ~=.
5443 * New operators can be added as long as the match the format <i>c</i>= where <i>c</i> is any character other than space, > <.
5446 "=" : function(a, v){
5449 "!=" : function(a, v){
5452 "^=" : function(a, v){
5453 return a && a.substr(0, v.length) == v;
5455 "$=" : function(a, v){
5456 return a && a.substr(a.length-v.length) == v;
5458 "*=" : function(a, v){
5459 return a && a.indexOf(v) !== -1;
5461 "%=" : function(a, v){
5462 return (a % v) == 0;
5464 "|=" : function(a, v){
5465 return a && (a == v || a.substr(0, v.length+1) == v+'-');
5467 "~=" : function(a, v){
5468 return a && (' '+a+' ').indexOf(' '+v+' ') != -1;
5473 * Collection of "pseudo class" processors. Each processor is passed the current nodeset (array)
5474 * and the argument (if any) supplied in the selector.
5477 "first-child" : function(c){
5478 var r = [], ri = -1, n;
5479 for(var i = 0, ci; ci = n = c[i]; i++){
5480 while((n = n.previousSibling) && n.nodeType != 1);
5488 "last-child" : function(c){
5489 var r = [], ri = -1, n;
5490 for(var i = 0, ci; ci = n = c[i]; i++){
5491 while((n = n.nextSibling) && n.nodeType != 1);
5499 "nth-child" : function(c, a) {
5500 var r = [], ri = -1;
5501 var m = nthRe.exec(a == "even" && "2n" || a == "odd" && "2n+1" || !nthRe2.test(a) && "n+" + a || a);
5502 var f = (m[1] || 1) - 0, l = m[2] - 0;
5503 for(var i = 0, n; n = c[i]; i++){
5504 var pn = n.parentNode;
5505 if (batch != pn._batch) {
5507 for(var cn = pn.firstChild; cn; cn = cn.nextSibling){
5508 if(cn.nodeType == 1){
5515 if (l == 0 || n.nodeIndex == l){
5518 } else if ((n.nodeIndex + l) % f == 0){
5526 "only-child" : function(c){
5527 var r = [], ri = -1;;
5528 for(var i = 0, ci; ci = c[i]; i++){
5529 if(!prev(ci) && !next(ci)){
5536 "empty" : function(c){
5537 var r = [], ri = -1;
5538 for(var i = 0, ci; ci = c[i]; i++){
5539 var cns = ci.childNodes, j = 0, cn, empty = true;
5542 if(cn.nodeType == 1 || cn.nodeType == 3){
5554 "contains" : function(c, v){
5555 var r = [], ri = -1;
5556 for(var i = 0, ci; ci = c[i]; i++){
5557 if((ci.textContent||ci.innerText||'').indexOf(v) != -1){
5564 "nodeValue" : function(c, v){
5565 var r = [], ri = -1;
5566 for(var i = 0, ci; ci = c[i]; i++){
5567 if(ci.firstChild && ci.firstChild.nodeValue == v){
5574 "checked" : function(c){
5575 var r = [], ri = -1;
5576 for(var i = 0, ci; ci = c[i]; i++){
5577 if(ci.checked == true){
5584 "not" : function(c, ss){
5585 return Roo.DomQuery.filter(c, ss, true);
5588 "odd" : function(c){
5589 return this["nth-child"](c, "odd");
5592 "even" : function(c){
5593 return this["nth-child"](c, "even");
5596 "nth" : function(c, a){
5597 return c[a-1] || [];
5600 "first" : function(c){
5604 "last" : function(c){
5605 return c[c.length-1] || [];
5608 "has" : function(c, ss){
5609 var s = Roo.DomQuery.select;
5610 var r = [], ri = -1;
5611 for(var i = 0, ci; ci = c[i]; i++){
5612 if(s(ss, ci).length > 0){
5619 "next" : function(c, ss){
5620 var is = Roo.DomQuery.is;
5621 var r = [], ri = -1;
5622 for(var i = 0, ci; ci = c[i]; i++){
5631 "prev" : function(c, ss){
5632 var is = Roo.DomQuery.is;
5633 var r = [], ri = -1;
5634 for(var i = 0, ci; ci = c[i]; i++){
5647 * Selects an array of DOM nodes by CSS/XPath selector. Shorthand of {@link Roo.DomQuery#select}
5648 * @param {String} path The selector/xpath query
5649 * @param {Node} root (optional) The start of the query (defaults to document).
5654 Roo.query = Roo.DomQuery.select;
5657 * Ext JS Library 1.1.1
5658 * Copyright(c) 2006-2007, Ext JS, LLC.
5660 * Originally Released Under LGPL - original licence link has changed is not relivant.
5663 * <script type="text/javascript">
5667 * @class Roo.util.Observable
5668 * Base class that provides a common interface for publishing events. Subclasses are expected to
5669 * to have a property "events" with all the events defined.<br>
5672 Employee = function(name){
5679 Roo.extend(Employee, Roo.util.Observable);
5681 * @param {Object} config properties to use (incuding events / listeners)
5684 Roo.util.Observable = function(cfg){
5687 this.addEvents(cfg.events || {});
5689 delete cfg.events; // make sure
5692 Roo.apply(this, cfg);
5695 this.on(this.listeners);
5696 delete this.listeners;
5699 Roo.util.Observable.prototype = {
5701 * @cfg {Object} listeners list of events and functions to call for this object,
5705 'click' : function(e) {
5715 * Fires the specified event with the passed parameters (minus the event name).
5716 * @param {String} eventName
5717 * @param {Object...} args Variable number of parameters are passed to handlers
5718 * @return {Boolean} returns false if any of the handlers return false otherwise it returns true
5720 fireEvent : function(){
5721 var ce = this.events[arguments[0].toLowerCase()];
5722 if(typeof ce == "object"){
5723 return ce.fire.apply(ce, Array.prototype.slice.call(arguments, 1));
5730 filterOptRe : /^(?:scope|delay|buffer|single)$/,
5733 * Appends an event handler to this component
5734 * @param {String} eventName The type of event to listen for
5735 * @param {Function} handler The method the event invokes
5736 * @param {Object} scope (optional) The scope in which to execute the handler
5737 * function. The handler function's "this" context.
5738 * @param {Object} options (optional) An object containing handler configuration
5739 * properties. This may contain any of the following properties:<ul>
5740 * <li>scope {Object} The scope in which to execute the handler function. The handler function's "this" context.</li>
5741 * <li>delay {Number} The number of milliseconds to delay the invocation of the handler after te event fires.</li>
5742 * <li>single {Boolean} True to add a handler to handle just the next firing of the event, and then remove itself.</li>
5743 * <li>buffer {Number} Causes the handler to be scheduled to run in an {@link Roo.util.DelayedTask} delayed
5744 * by the specified number of milliseconds. If the event fires again within that time, the original
5745 * handler is <em>not</em> invoked, but the new handler is scheduled in its place.</li>
5748 * <b>Combining Options</b><br>
5749 * Using the options argument, it is possible to combine different types of listeners:<br>
5751 * A normalized, delayed, one-time listener that auto stops the event and passes a custom argument (forumId)
5753 el.on('click', this.onClick, this, {
5760 * <b>Attaching multiple handlers in 1 call</b><br>
5761 * The method also allows for a single argument to be passed which is a config object containing properties
5762 * which specify multiple handlers.
5771 fn: this.onMouseOver,
5775 fn: this.onMouseOut,
5781 * Or a shorthand syntax which passes the same scope object to all handlers:
5784 'click': this.onClick,
5785 'mouseover': this.onMouseOver,
5786 'mouseout': this.onMouseOut,
5791 addListener : function(eventName, fn, scope, o){
5792 if(typeof eventName == "object"){
5795 if(this.filterOptRe.test(e)){
5798 if(typeof o[e] == "function"){
5800 this.addListener(e, o[e], o.scope, o);
5802 // individual options
5803 this.addListener(e, o[e].fn, o[e].scope, o[e]);
5808 o = (!o || typeof o == "boolean") ? {} : o;
5809 eventName = eventName.toLowerCase();
5810 var ce = this.events[eventName] || true;
5811 if(typeof ce == "boolean"){
5812 ce = new Roo.util.Event(this, eventName);
5813 this.events[eventName] = ce;
5815 ce.addListener(fn, scope, o);
5819 * Removes a listener
5820 * @param {String} eventName The type of event to listen for
5821 * @param {Function} handler The handler to remove
5822 * @param {Object} scope (optional) The scope (this object) for the handler
5824 removeListener : function(eventName, fn, scope){
5825 var ce = this.events[eventName.toLowerCase()];
5826 if(typeof ce == "object"){
5827 ce.removeListener(fn, scope);
5832 * Removes all listeners for this object
5834 purgeListeners : function(){
5835 for(var evt in this.events){
5836 if(typeof this.events[evt] == "object"){
5837 this.events[evt].clearListeners();
5842 relayEvents : function(o, events){
5843 var createHandler = function(ename){
5845 return this.fireEvent.apply(this, Roo.combine(ename, Array.prototype.slice.call(arguments, 0)));
5848 for(var i = 0, len = events.length; i < len; i++){
5849 var ename = events[i];
5850 if(!this.events[ename]){ this.events[ename] = true; };
5851 o.on(ename, createHandler(ename), this);
5856 * Used to define events on this Observable
5857 * @param {Object} object The object with the events defined
5859 addEvents : function(o){
5863 Roo.applyIf(this.events, o);
5867 * Checks to see if this object has any listeners for a specified event
5868 * @param {String} eventName The name of the event to check for
5869 * @return {Boolean} True if the event is being listened for, else false
5871 hasListener : function(eventName){
5872 var e = this.events[eventName];
5873 return typeof e == "object" && e.listeners.length > 0;
5877 * Appends an event handler to this element (shorthand for addListener)
5878 * @param {String} eventName The type of event to listen for
5879 * @param {Function} handler The method the event invokes
5880 * @param {Object} scope (optional) The scope in which to execute the handler
5881 * function. The handler function's "this" context.
5882 * @param {Object} options (optional)
5885 Roo.util.Observable.prototype.on = Roo.util.Observable.prototype.addListener;
5887 * Removes a listener (shorthand for removeListener)
5888 * @param {String} eventName The type of event to listen for
5889 * @param {Function} handler The handler to remove
5890 * @param {Object} scope (optional) The scope (this object) for the handler
5893 Roo.util.Observable.prototype.un = Roo.util.Observable.prototype.removeListener;
5896 * Starts capture on the specified Observable. All events will be passed
5897 * to the supplied function with the event name + standard signature of the event
5898 * <b>before</b> the event is fired. If the supplied function returns false,
5899 * the event will not fire.
5900 * @param {Observable} o The Observable to capture
5901 * @param {Function} fn The function to call
5902 * @param {Object} scope (optional) The scope (this object) for the fn
5905 Roo.util.Observable.capture = function(o, fn, scope){
5906 o.fireEvent = o.fireEvent.createInterceptor(fn, scope);
5910 * Removes <b>all</b> added captures from the Observable.
5911 * @param {Observable} o The Observable to release
5914 Roo.util.Observable.releaseCapture = function(o){
5915 o.fireEvent = Roo.util.Observable.prototype.fireEvent;
5920 var createBuffered = function(h, o, scope){
5921 var task = new Roo.util.DelayedTask();
5923 task.delay(o.buffer, h, scope, Array.prototype.slice.call(arguments, 0));
5927 var createSingle = function(h, e, fn, scope){
5929 e.removeListener(fn, scope);
5930 return h.apply(scope, arguments);
5934 var createDelayed = function(h, o, scope){
5936 var args = Array.prototype.slice.call(arguments, 0);
5937 setTimeout(function(){
5938 h.apply(scope, args);
5943 Roo.util.Event = function(obj, name){
5946 this.listeners = [];
5949 Roo.util.Event.prototype = {
5950 addListener : function(fn, scope, options){
5951 var o = options || {};
5952 scope = scope || this.obj;
5953 if(!this.isListening(fn, scope)){
5954 var l = {fn: fn, scope: scope, options: o};
5957 h = createDelayed(h, o, scope);
5960 h = createSingle(h, this, fn, scope);
5963 h = createBuffered(h, o, scope);
5966 if(!this.firing){ // if we are currently firing this event, don't disturb the listener loop
5967 this.listeners.push(l);
5969 this.listeners = this.listeners.slice(0);
5970 this.listeners.push(l);
5975 findListener : function(fn, scope){
5976 scope = scope || this.obj;
5977 var ls = this.listeners;
5978 for(var i = 0, len = ls.length; i < len; i++){
5980 if(l.fn == fn && l.scope == scope){
5987 isListening : function(fn, scope){
5988 return this.findListener(fn, scope) != -1;
5991 removeListener : function(fn, scope){
5993 if((index = this.findListener(fn, scope)) != -1){
5995 this.listeners.splice(index, 1);
5997 this.listeners = this.listeners.slice(0);
5998 this.listeners.splice(index, 1);
6005 clearListeners : function(){
6006 this.listeners = [];
6010 var ls = this.listeners, scope, len = ls.length;
6013 var args = Array.prototype.slice.call(arguments, 0);
6014 for(var i = 0; i < len; i++){
6016 if(l.fireFn.apply(l.scope||this.obj||window, arguments) === false){
6017 this.firing = false;
6021 this.firing = false;
6028 * Ext JS Library 1.1.1
6029 * Copyright(c) 2006-2007, Ext JS, LLC.
6031 * Originally Released Under LGPL - original licence link has changed is not relivant.
6034 * <script type="text/javascript">
6038 * @class Roo.EventManager
6039 * Registers event handlers that want to receive a normalized EventObject instead of the standard browser event and provides
6040 * several useful events directly.
6041 * See {@link Roo.EventObject} for more details on normalized event objects.
6044 Roo.EventManager = function(){
6045 var docReadyEvent, docReadyProcId, docReadyState = false;
6046 var resizeEvent, resizeTask, textEvent, textSize;
6047 var E = Roo.lib.Event;
6048 var D = Roo.lib.Dom;
6053 var fireDocReady = function(){
6055 docReadyState = true;
6058 clearInterval(docReadyProcId);
6060 if(Roo.isGecko || Roo.isOpera) {
6061 document.removeEventListener("DOMContentLoaded", fireDocReady, false);
6064 var defer = document.getElementById("ie-deferred-loader");
6066 defer.onreadystatechange = null;
6067 defer.parentNode.removeChild(defer);
6071 docReadyEvent.fire();
6072 docReadyEvent.clearListeners();
6077 var initDocReady = function(){
6078 docReadyEvent = new Roo.util.Event();
6079 if(Roo.isGecko || Roo.isOpera) {
6080 document.addEventListener("DOMContentLoaded", fireDocReady, false);
6082 document.write("<s"+'cript id="ie-deferred-loader" defer="defer" src="/'+'/:"></s'+"cript>");
6083 var defer = document.getElementById("ie-deferred-loader");
6084 defer.onreadystatechange = function(){
6085 if(this.readyState == "complete"){
6089 }else if(Roo.isSafari){
6090 docReadyProcId = setInterval(function(){
6091 var rs = document.readyState;
6092 if(rs == "complete") {
6097 // no matter what, make sure it fires on load
6098 E.on(window, "load", fireDocReady);
6101 var createBuffered = function(h, o){
6102 var task = new Roo.util.DelayedTask(h);
6104 // create new event object impl so new events don't wipe out properties
6105 e = new Roo.EventObjectImpl(e);
6106 task.delay(o.buffer, h, null, [e]);
6110 var createSingle = function(h, el, ename, fn){
6112 Roo.EventManager.removeListener(el, ename, fn);
6117 var createDelayed = function(h, o){
6119 // create new event object impl so new events don't wipe out properties
6120 e = new Roo.EventObjectImpl(e);
6121 setTimeout(function(){
6126 var transitionEndVal = false;
6128 var transitionEnd = function()
6130 if (transitionEndVal) {
6131 return transitionEndVal;
6133 var el = document.createElement('div');
6135 var transEndEventNames = {
6136 WebkitTransition : 'webkitTransitionEnd',
6137 MozTransition : 'transitionend',
6138 OTransition : 'oTransitionEnd otransitionend',
6139 transition : 'transitionend'
6142 for (var name in transEndEventNames) {
6143 if (el.style[name] !== undefined) {
6144 transitionEndVal = transEndEventNames[name];
6145 return transitionEndVal ;
6151 var listen = function(element, ename, opt, fn, scope){
6152 var o = (!opt || typeof opt == "boolean") ? {} : opt;
6153 fn = fn || o.fn; scope = scope || o.scope;
6154 var el = Roo.getDom(element);
6158 throw "Error listening for \"" + ename + '\". Element "' + element + '" doesn\'t exist.';
6161 if (ename == 'transitionend') {
6162 ename = transitionEnd();
6164 var h = function(e){
6165 e = Roo.EventObject.setEvent(e);
6168 t = e.getTarget(o.delegate, el);
6175 if(o.stopEvent === true){
6178 if(o.preventDefault === true){
6181 if(o.stopPropagation === true){
6182 e.stopPropagation();
6185 if(o.normalized === false){
6189 fn.call(scope || el, e, t, o);
6192 h = createDelayed(h, o);
6195 h = createSingle(h, el, ename, fn);
6198 h = createBuffered(h, o);
6200 fn._handlers = fn._handlers || [];
6203 fn._handlers.push([Roo.id(el), ename, h]);
6208 if(ename == "mousewheel" && el.addEventListener){ // workaround for jQuery
6209 el.addEventListener("DOMMouseScroll", h, false);
6210 E.on(window, 'unload', function(){
6211 el.removeEventListener("DOMMouseScroll", h, false);
6214 if(ename == "mousedown" && el == document){ // fix stopped mousedowns on the document
6215 Roo.EventManager.stoppedMouseDownEvent.addListener(h);
6220 var stopListening = function(el, ename, fn){
6221 var id = Roo.id(el), hds = fn._handlers, hd = fn;
6223 for(var i = 0, len = hds.length; i < len; i++){
6225 if(h[0] == id && h[1] == ename){
6232 E.un(el, ename, hd);
6233 el = Roo.getDom(el);
6234 if(ename == "mousewheel" && el.addEventListener){
6235 el.removeEventListener("DOMMouseScroll", hd, false);
6237 if(ename == "mousedown" && el == document){ // fix stopped mousedowns on the document
6238 Roo.EventManager.stoppedMouseDownEvent.removeListener(hd);
6242 var propRe = /^(?:scope|delay|buffer|single|stopEvent|preventDefault|stopPropagation|normalized|args|delegate)$/;
6249 * @scope Roo.EventManager
6254 * This is no longer needed and is deprecated. Places a simple wrapper around an event handler to override the browser event
6255 * object with a Roo.EventObject
6256 * @param {Function} fn The method the event invokes
6257 * @param {Object} scope An object that becomes the scope of the handler
6258 * @param {boolean} override If true, the obj passed in becomes
6259 * the execution scope of the listener
6260 * @return {Function} The wrapped function
6263 wrap : function(fn, scope, override){
6265 Roo.EventObject.setEvent(e);
6266 fn.call(override ? scope || window : window, Roo.EventObject, scope);
6271 * Appends an event handler to an element (shorthand for addListener)
6272 * @param {String/HTMLElement} element The html element or id to assign the
6273 * @param {String} eventName The type of event to listen for
6274 * @param {Function} handler The method the event invokes
6275 * @param {Object} scope (optional) The scope in which to execute the handler
6276 * function. The handler function's "this" context.
6277 * @param {Object} options (optional) An object containing handler configuration
6278 * properties. This may contain any of the following properties:<ul>
6279 * <li>scope {Object} The scope in which to execute the handler function. The handler function's "this" context.</li>
6280 * <li>delegate {String} A simple selector to filter the target or look for a descendant of the target</li>
6281 * <li>stopEvent {Boolean} True to stop the event. That is stop propagation, and prevent the default action.</li>
6282 * <li>preventDefault {Boolean} True to prevent the default action</li>
6283 * <li>stopPropagation {Boolean} True to prevent event propagation</li>
6284 * <li>normalized {Boolean} False to pass a browser event to the handler function instead of an Roo.EventObject</li>
6285 * <li>delay {Number} The number of milliseconds to delay the invocation of the handler after te event fires.</li>
6286 * <li>single {Boolean} True to add a handler to handle just the next firing of the event, and then remove itself.</li>
6287 * <li>buffer {Number} Causes the handler to be scheduled to run in an {@link Roo.util.DelayedTask} delayed
6288 * by the specified number of milliseconds. If the event fires again within that time, the original
6289 * handler is <em>not</em> invoked, but the new handler is scheduled in its place.</li>
6292 * <b>Combining Options</b><br>
6293 * Using the options argument, it is possible to combine different types of listeners:<br>
6295 * A normalized, delayed, one-time listener that auto stops the event and passes a custom argument (forumId)<div style="margin: 5px 20px 20px;">
6297 el.on('click', this.onClick, this, {
6304 * <b>Attaching multiple handlers in 1 call</b><br>
6305 * The method also allows for a single argument to be passed which is a config object containing properties
6306 * which specify multiple handlers.
6316 fn: this.onMouseOver
6325 * Or a shorthand syntax:<br>
6328 'click' : this.onClick,
6329 'mouseover' : this.onMouseOver,
6330 'mouseout' : this.onMouseOut
6334 addListener : function(element, eventName, fn, scope, options){
6335 if(typeof eventName == "object"){
6341 if(typeof o[e] == "function"){
6343 listen(element, e, o, o[e], o.scope);
6345 // individual options
6346 listen(element, e, o[e]);
6351 return listen(element, eventName, options, fn, scope);
6355 * Removes an event handler
6357 * @param {String/HTMLElement} element The id or html element to remove the
6359 * @param {String} eventName The type of event
6360 * @param {Function} fn
6361 * @return {Boolean} True if a listener was actually removed
6363 removeListener : function(element, eventName, fn){
6364 return stopListening(element, eventName, fn);
6368 * Fires when the document is ready (before onload and before images are loaded). Can be
6369 * accessed shorthanded Roo.onReady().
6370 * @param {Function} fn The method the event invokes
6371 * @param {Object} scope An object that becomes the scope of the handler
6372 * @param {boolean} options
6374 onDocumentReady : function(fn, scope, options){
6375 if(docReadyState){ // if it already fired
6376 docReadyEvent.addListener(fn, scope, options);
6377 docReadyEvent.fire();
6378 docReadyEvent.clearListeners();
6384 docReadyEvent.addListener(fn, scope, options);
6388 * Fires when the window is resized and provides resize event buffering (50 milliseconds), passes new viewport width and height to handlers.
6389 * @param {Function} fn The method the event invokes
6390 * @param {Object} scope An object that becomes the scope of the handler
6391 * @param {boolean} options
6393 onWindowResize : function(fn, scope, options){
6395 resizeEvent = new Roo.util.Event();
6396 resizeTask = new Roo.util.DelayedTask(function(){
6397 resizeEvent.fire(D.getViewWidth(), D.getViewHeight());
6399 E.on(window, "resize", function(){
6401 resizeTask.delay(50);
6403 resizeEvent.fire(D.getViewWidth(), D.getViewHeight());
6407 resizeEvent.addListener(fn, scope, options);
6411 * Fires when the user changes the active text size. Handler gets called with 2 params, the old size and the new size.
6412 * @param {Function} fn The method the event invokes
6413 * @param {Object} scope An object that becomes the scope of the handler
6414 * @param {boolean} options
6416 onTextResize : function(fn, scope, options){
6418 textEvent = new Roo.util.Event();
6419 var textEl = new Roo.Element(document.createElement('div'));
6420 textEl.dom.className = 'x-text-resize';
6421 textEl.dom.innerHTML = 'X';
6422 textEl.appendTo(document.body);
6423 textSize = textEl.dom.offsetHeight;
6424 setInterval(function(){
6425 if(textEl.dom.offsetHeight != textSize){
6426 textEvent.fire(textSize, textSize = textEl.dom.offsetHeight);
6428 }, this.textResizeInterval);
6430 textEvent.addListener(fn, scope, options);
6434 * Removes the passed window resize listener.
6435 * @param {Function} fn The method the event invokes
6436 * @param {Object} scope The scope of handler
6438 removeResizeListener : function(fn, scope){
6440 resizeEvent.removeListener(fn, scope);
6445 fireResize : function(){
6447 resizeEvent.fire(D.getViewWidth(), D.getViewHeight());
6451 * Url used for onDocumentReady with using SSL (defaults to Roo.SSL_SECURE_URL)
6455 * The frequency, in milliseconds, to check for text resize events (defaults to 50)
6457 textResizeInterval : 50
6462 * @scopeAlias pub=Roo.EventManager
6466 * Appends an event handler to an element (shorthand for addListener)
6467 * @param {String/HTMLElement} element The html element or id to assign the
6468 * @param {String} eventName The type of event to listen for
6469 * @param {Function} handler The method the event invokes
6470 * @param {Object} scope (optional) The scope in which to execute the handler
6471 * function. The handler function's "this" context.
6472 * @param {Object} options (optional) An object containing handler configuration
6473 * properties. This may contain any of the following properties:<ul>
6474 * <li>scope {Object} The scope in which to execute the handler function. The handler function's "this" context.</li>
6475 * <li>delegate {String} A simple selector to filter the target or look for a descendant of the target</li>
6476 * <li>stopEvent {Boolean} True to stop the event. That is stop propagation, and prevent the default action.</li>
6477 * <li>preventDefault {Boolean} True to prevent the default action</li>
6478 * <li>stopPropagation {Boolean} True to prevent event propagation</li>
6479 * <li>normalized {Boolean} False to pass a browser event to the handler function instead of an Roo.EventObject</li>
6480 * <li>delay {Number} The number of milliseconds to delay the invocation of the handler after te event fires.</li>
6481 * <li>single {Boolean} True to add a handler to handle just the next firing of the event, and then remove itself.</li>
6482 * <li>buffer {Number} Causes the handler to be scheduled to run in an {@link Roo.util.DelayedTask} delayed
6483 * by the specified number of milliseconds. If the event fires again within that time, the original
6484 * handler is <em>not</em> invoked, but the new handler is scheduled in its place.</li>
6487 * <b>Combining Options</b><br>
6488 * Using the options argument, it is possible to combine different types of listeners:<br>
6490 * A normalized, delayed, one-time listener that auto stops the event and passes a custom argument (forumId)<div style="margin: 5px 20px 20px;">
6492 el.on('click', this.onClick, this, {
6499 * <b>Attaching multiple handlers in 1 call</b><br>
6500 * The method also allows for a single argument to be passed which is a config object containing properties
6501 * which specify multiple handlers.
6511 fn: this.onMouseOver
6520 * Or a shorthand syntax:<br>
6523 'click' : this.onClick,
6524 'mouseover' : this.onMouseOver,
6525 'mouseout' : this.onMouseOut
6529 pub.on = pub.addListener;
6530 pub.un = pub.removeListener;
6532 pub.stoppedMouseDownEvent = new Roo.util.Event();
6536 * Fires when the document is ready (before onload and before images are loaded). Shorthand of {@link Roo.EventManager#onDocumentReady}.
6537 * @param {Function} fn The method the event invokes
6538 * @param {Object} scope An object that becomes the scope of the handler
6539 * @param {boolean} override If true, the obj passed in becomes
6540 * the execution scope of the listener
6544 Roo.onReady = Roo.EventManager.onDocumentReady;
6546 Roo.onReady(function(){
6547 var bd = Roo.get(document.body);
6552 : Roo.isGecko ? "roo-gecko"
6553 : Roo.isOpera ? "roo-opera"
6554 : Roo.isSafari ? "roo-safari" : ""];
6557 cls.push("roo-mac");
6560 cls.push("roo-linux");
6562 if(Roo.isBorderBox){
6563 cls.push('roo-border-box');
6565 if(Roo.isStrict){ // add to the parent to allow for selectors like ".ext-strict .ext-ie"
6566 var p = bd.dom.parentNode;
6568 p.className += ' roo-strict';
6571 bd.addClass(cls.join(' '));
6575 * @class Roo.EventObject
6576 * EventObject exposes the Yahoo! UI Event functionality directly on the object
6577 * passed to your event handler. It exists mostly for convenience. It also fixes the annoying null checks automatically to cleanup your code
6580 function handleClick(e){ // e is not a standard event object, it is a Roo.EventObject
6582 var target = e.getTarget();
6585 var myDiv = Roo.get("myDiv");
6586 myDiv.on("click", handleClick);
6588 Roo.EventManager.on("myDiv", 'click', handleClick);
6589 Roo.EventManager.addListener("myDiv", 'click', handleClick);
6593 Roo.EventObject = function(){
6595 var E = Roo.lib.Event;
6597 // safari keypress events for special keys return bad keycodes
6600 63235 : 39, // right
6603 63276 : 33, // page up
6604 63277 : 34, // page down
6605 63272 : 46, // delete
6610 // normalize button clicks
6611 var btnMap = Roo.isIE ? {1:0,4:1,2:2} :
6612 (Roo.isSafari ? {1:0,2:1,3:2} : {0:0,1:1,2:2});
6614 Roo.EventObjectImpl = function(e){
6616 this.setEvent(e.browserEvent || e);
6619 Roo.EventObjectImpl.prototype = {
6621 * Used to fix doc tools.
6622 * @scope Roo.EventObject.prototype
6628 /** The normal browser event */
6629 browserEvent : null,
6630 /** The button pressed in a mouse event */
6632 /** True if the shift key was down during the event */
6634 /** True if the control key was down during the event */
6636 /** True if the alt key was down during the event */
6695 setEvent : function(e){
6696 if(e == this || (e && e.browserEvent)){ // already wrapped
6699 this.browserEvent = e;
6701 // normalize buttons
6702 this.button = e.button ? btnMap[e.button] : (e.which ? e.which-1 : -1);
6703 if(e.type == 'click' && this.button == -1){
6707 this.shiftKey = e.shiftKey;
6708 // mac metaKey behaves like ctrlKey
6709 this.ctrlKey = e.ctrlKey || e.metaKey;
6710 this.altKey = e.altKey;
6711 // in getKey these will be normalized for the mac
6712 this.keyCode = e.keyCode;
6713 // keyup warnings on firefox.
6714 this.charCode = (e.type == 'keyup' || e.type == 'keydown') ? 0 : e.charCode;
6715 // cache the target for the delayed and or buffered events
6716 this.target = E.getTarget(e);
6718 this.xy = E.getXY(e);
6721 this.shiftKey = false;
6722 this.ctrlKey = false;
6723 this.altKey = false;
6733 * Stop the event (preventDefault and stopPropagation)
6735 stopEvent : function(){
6736 if(this.browserEvent){
6737 if(this.browserEvent.type == 'mousedown'){
6738 Roo.EventManager.stoppedMouseDownEvent.fire(this);
6740 E.stopEvent(this.browserEvent);
6745 * Prevents the browsers default handling of the event.
6747 preventDefault : function(){
6748 if(this.browserEvent){
6749 E.preventDefault(this.browserEvent);
6754 isNavKeyPress : function(){
6755 var k = this.keyCode;
6756 k = Roo.isSafari ? (safariKeys[k] || k) : k;
6757 return (k >= 33 && k <= 40) || k == this.RETURN || k == this.TAB || k == this.ESC;
6760 isSpecialKey : function(){
6761 var k = this.keyCode;
6762 return (this.type == 'keypress' && this.ctrlKey) || k == 9 || k == 13 || k == 40 || k == 27 ||
6763 (k == 16) || (k == 17) ||
6764 (k >= 18 && k <= 20) ||
6765 (k >= 33 && k <= 35) ||
6766 (k >= 36 && k <= 39) ||
6767 (k >= 44 && k <= 45);
6770 * Cancels bubbling of the event.
6772 stopPropagation : function(){
6773 if(this.browserEvent){
6774 if(this.type == 'mousedown'){
6775 Roo.EventManager.stoppedMouseDownEvent.fire(this);
6777 E.stopPropagation(this.browserEvent);
6782 * Gets the key code for the event.
6785 getCharCode : function(){
6786 return this.charCode || this.keyCode;
6790 * Returns a normalized keyCode for the event.
6791 * @return {Number} The key code
6793 getKey : function(){
6794 var k = this.keyCode || this.charCode;
6795 return Roo.isSafari ? (safariKeys[k] || k) : k;
6799 * Gets the x coordinate of the event.
6802 getPageX : function(){
6807 * Gets the y coordinate of the event.
6810 getPageY : function(){
6815 * Gets the time of the event.
6818 getTime : function(){
6819 if(this.browserEvent){
6820 return E.getTime(this.browserEvent);
6826 * Gets the page coordinates of the event.
6827 * @return {Array} The xy values like [x, y]
6834 * Gets the target for the event.
6835 * @param {String} selector (optional) A simple selector to filter the target or look for an ancestor of the target
6836 * @param {Number/String/HTMLElement/Element} maxDepth (optional) The max depth to
6837 search as a number or element (defaults to 10 || document.body)
6838 * @param {Boolean} returnEl (optional) True to return a Roo.Element object instead of DOM node
6839 * @return {HTMLelement}
6841 getTarget : function(selector, maxDepth, returnEl){
6842 return selector ? Roo.fly(this.target).findParent(selector, maxDepth, returnEl) : this.target;
6845 * Gets the related target.
6846 * @return {HTMLElement}
6848 getRelatedTarget : function(){
6849 if(this.browserEvent){
6850 return E.getRelatedTarget(this.browserEvent);
6856 * Normalizes mouse wheel delta across browsers
6857 * @return {Number} The delta
6859 getWheelDelta : function(){
6860 var e = this.browserEvent;
6862 if(e.wheelDelta){ /* IE/Opera. */
6863 delta = e.wheelDelta/120;
6864 }else if(e.detail){ /* Mozilla case. */
6865 delta = -e.detail/3;
6871 * Returns true if the control, meta, shift or alt key was pressed during this event.
6874 hasModifier : function(){
6875 return !!((this.ctrlKey || this.altKey) || this.shiftKey);
6879 * Returns true if the target of this event equals el or is a child of el
6880 * @param {String/HTMLElement/Element} el
6881 * @param {Boolean} related (optional) true to test if the related target is within el instead of the target
6884 within : function(el, related){
6885 var t = this[related ? "getRelatedTarget" : "getTarget"]();
6886 return t && Roo.fly(el).contains(t);
6889 getPoint : function(){
6890 return new Roo.lib.Point(this.xy[0], this.xy[1]);
6894 return new Roo.EventObjectImpl();
6899 * Ext JS Library 1.1.1
6900 * Copyright(c) 2006-2007, Ext JS, LLC.
6902 * Originally Released Under LGPL - original licence link has changed is not relivant.
6905 * <script type="text/javascript">
6909 // was in Composite Element!??!?!
6912 var D = Roo.lib.Dom;
6913 var E = Roo.lib.Event;
6914 var A = Roo.lib.Anim;
6916 // local style camelizing for speed
6918 var camelRe = /(-[a-z])/gi;
6919 var camelFn = function(m, a){ return a.charAt(1).toUpperCase(); };
6920 var view = document.defaultView;
6923 * @class Roo.Element
6924 * Represents an Element in the DOM.<br><br>
6927 var el = Roo.get("my-div");
6930 var el = getEl("my-div");
6932 // or with a DOM element
6933 var el = Roo.get(myDivElement);
6935 * Using Roo.get() or getEl() instead of calling the constructor directly ensures you get the same object
6936 * each call instead of constructing a new one.<br><br>
6937 * <b>Animations</b><br />
6938 * Many of the functions for manipulating an element have an optional "animate" parameter. The animate parameter
6939 * should either be a boolean (true) or an object literal with animation options. The animation options are:
6941 Option Default Description
6942 --------- -------- ---------------------------------------------
6943 duration .35 The duration of the animation in seconds
6944 easing easeOut The YUI easing method
6945 callback none A function to execute when the anim completes
6946 scope this The scope (this) of the callback function
6948 * Also, the Anim object being used for the animation will be set on your options object as "anim", which allows you to stop or
6949 * manipulate the animation. Here's an example:
6951 var el = Roo.get("my-div");
6956 // default animation
6957 el.setWidth(100, true);
6959 // animation with some options set
6966 // using the "anim" property to get the Anim object
6972 el.setWidth(100, opt);
6974 if(opt.anim.isAnimated()){
6978 * <b> Composite (Collections of) Elements</b><br />
6979 * For working with collections of Elements, see <a href="Roo.CompositeElement.html">Roo.CompositeElement</a>
6980 * @constructor Create a new Element directly.
6981 * @param {String/HTMLElement} element
6982 * @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).
6984 Roo.Element = function(element, forceNew){
6985 var dom = typeof element == "string" ?
6986 document.getElementById(element) : element;
6987 if(!dom){ // invalid id/element
6991 if(forceNew !== true && id && Roo.Element.cache[id]){ // element object already exists
6992 return Roo.Element.cache[id];
7002 * The DOM element ID
7005 this.id = id || Roo.id(dom);
7008 var El = Roo.Element;
7012 * The element's default display mode (defaults to "")
7015 originalDisplay : "",
7019 * The default unit to append to CSS values where a unit isn't provided (defaults to px).
7024 * Sets the element's visibility mode. When setVisible() is called it
7025 * will use this to determine whether to set the visibility or the display property.
7026 * @param visMode Element.VISIBILITY or Element.DISPLAY
7027 * @return {Roo.Element} this
7029 setVisibilityMode : function(visMode){
7030 this.visibilityMode = visMode;
7034 * Convenience method for setVisibilityMode(Element.DISPLAY)
7035 * @param {String} display (optional) What to set display to when visible
7036 * @return {Roo.Element} this
7038 enableDisplayMode : function(display){
7039 this.setVisibilityMode(El.DISPLAY);
7040 if(typeof display != "undefined") this.originalDisplay = display;
7045 * 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)
7046 * @param {String} selector The simple selector to test
7047 * @param {Number/String/HTMLElement/Element} maxDepth (optional) The max depth to
7048 search as a number or element (defaults to 10 || document.body)
7049 * @param {Boolean} returnEl (optional) True to return a Roo.Element object instead of DOM node
7050 * @return {HTMLElement} The matching DOM node (or null if no match was found)
7052 findParent : function(simpleSelector, maxDepth, returnEl){
7053 var p = this.dom, b = document.body, depth = 0, dq = Roo.DomQuery, stopEl;
7054 maxDepth = maxDepth || 50;
7055 if(typeof maxDepth != "number"){
7056 stopEl = Roo.getDom(maxDepth);
7059 while(p && p.nodeType == 1 && depth < maxDepth && p != b && p != stopEl){
7060 if(dq.is(p, simpleSelector)){
7061 return returnEl ? Roo.get(p) : p;
7071 * Looks at parent nodes for a match of the passed simple selector (e.g. div.some-class or span:first-child)
7072 * @param {String} selector The simple selector to test
7073 * @param {Number/String/HTMLElement/Element} maxDepth (optional) The max depth to
7074 search as a number or element (defaults to 10 || document.body)
7075 * @param {Boolean} returnEl (optional) True to return a Roo.Element object instead of DOM node
7076 * @return {HTMLElement} The matching DOM node (or null if no match was found)
7078 findParentNode : function(simpleSelector, maxDepth, returnEl){
7079 var p = Roo.fly(this.dom.parentNode, '_internal');
7080 return p ? p.findParent(simpleSelector, maxDepth, returnEl) : null;
7084 * Walks up the dom looking for a parent node that matches the passed simple selector (e.g. div.some-class or span:first-child).
7085 * This is a shortcut for findParentNode() that always returns an Roo.Element.
7086 * @param {String} selector The simple selector to test
7087 * @param {Number/String/HTMLElement/Element} maxDepth (optional) The max depth to
7088 search as a number or element (defaults to 10 || document.body)
7089 * @return {Roo.Element} The matching DOM node (or null if no match was found)
7091 up : function(simpleSelector, maxDepth){
7092 return this.findParentNode(simpleSelector, maxDepth, true);
7098 * Returns true if this element matches the passed simple selector (e.g. div.some-class or span:first-child)
7099 * @param {String} selector The simple selector to test
7100 * @return {Boolean} True if this element matches the selector, else false
7102 is : function(simpleSelector){
7103 return Roo.DomQuery.is(this.dom, simpleSelector);
7107 * Perform animation on this element.
7108 * @param {Object} args The YUI animation control args
7109 * @param {Float} duration (optional) How long the animation lasts in seconds (defaults to .35)
7110 * @param {Function} onComplete (optional) Function to call when animation completes
7111 * @param {String} easing (optional) Easing method to use (defaults to 'easeOut')
7112 * @param {String} animType (optional) 'run' is the default. Can also be 'color', 'motion', or 'scroll'
7113 * @return {Roo.Element} this
7115 animate : function(args, duration, onComplete, easing, animType){
7116 this.anim(args, {duration: duration, callback: onComplete, easing: easing}, animType);
7121 * @private Internal animation call
7123 anim : function(args, opt, animType, defaultDur, defaultEase, cb){
7124 animType = animType || 'run';
7126 var anim = Roo.lib.Anim[animType](
7128 (opt.duration || defaultDur) || .35,
7129 (opt.easing || defaultEase) || 'easeOut',
7131 Roo.callback(cb, this);
7132 Roo.callback(opt.callback, opt.scope || this, [this, opt]);
7140 // private legacy anim prep
7141 preanim : function(a, i){
7142 return !a[i] ? false : (typeof a[i] == "object" ? a[i]: {duration: a[i+1], callback: a[i+2], easing: a[i+3]});
7146 * Removes worthless text nodes
7147 * @param {Boolean} forceReclean (optional) By default the element
7148 * keeps track if it has been cleaned already so
7149 * you can call this over and over. However, if you update the element and
7150 * need to force a reclean, you can pass true.
7152 clean : function(forceReclean){
7153 if(this.isCleaned && forceReclean !== true){
7157 var d = this.dom, n = d.firstChild, ni = -1;
7159 var nx = n.nextSibling;
7160 if(n.nodeType == 3 && !ns.test(n.nodeValue)){
7167 this.isCleaned = true;
7172 calcOffsetsTo : function(el){
7175 var restorePos = false;
7176 if(el.getStyle('position') == 'static'){
7177 el.position('relative');
7182 while(op && op != d && op.tagName != 'HTML'){
7185 op = op.offsetParent;
7188 el.position('static');
7194 * Scrolls this element into view within the passed container.
7195 * @param {String/HTMLElement/Element} container (optional) The container element to scroll (defaults to document.body)
7196 * @param {Boolean} hscroll (optional) False to disable horizontal scroll (defaults to true)
7197 * @return {Roo.Element} this
7199 scrollIntoView : function(container, hscroll){
7200 var c = Roo.getDom(container) || document.body;
7203 var o = this.calcOffsetsTo(c),
7206 b = t+el.offsetHeight,
7207 r = l+el.offsetWidth;
7209 var ch = c.clientHeight;
7210 var ct = parseInt(c.scrollTop, 10);
7211 var cl = parseInt(c.scrollLeft, 10);
7213 var cr = cl + c.clientWidth;
7221 if(hscroll !== false){
7225 c.scrollLeft = r-c.clientWidth;
7232 scrollChildIntoView : function(child, hscroll){
7233 Roo.fly(child, '_scrollChildIntoView').scrollIntoView(this, hscroll);
7237 * Measures the element's content height and updates height to match. Note: this function uses setTimeout so
7238 * the new height may not be available immediately.
7239 * @param {Boolean} animate (optional) Animate the transition (defaults to false)
7240 * @param {Float} duration (optional) Length of the animation in seconds (defaults to .35)
7241 * @param {Function} onComplete (optional) Function to call when animation completes
7242 * @param {String} easing (optional) Easing method to use (defaults to easeOut)
7243 * @return {Roo.Element} this
7245 autoHeight : function(animate, duration, onComplete, easing){
7246 var oldHeight = this.getHeight();
7248 this.setHeight(1); // force clipping
7249 setTimeout(function(){
7250 var height = parseInt(this.dom.scrollHeight, 10); // parseInt for Safari
7252 this.setHeight(height);
7254 if(typeof onComplete == "function"){
7258 this.setHeight(oldHeight); // restore original height
7259 this.setHeight(height, animate, duration, function(){
7261 if(typeof onComplete == "function") onComplete();
7262 }.createDelegate(this), easing);
7264 }.createDelegate(this), 0);
7269 * Returns true if this element is an ancestor of the passed element
7270 * @param {HTMLElement/String} el The element to check
7271 * @return {Boolean} True if this element is an ancestor of el, else false
7273 contains : function(el){
7274 if(!el){return false;}
7275 return D.isAncestor(this.dom, el.dom ? el.dom : el);
7279 * Checks whether the element is currently visible using both visibility and display properties.
7280 * @param {Boolean} deep (optional) True to walk the dom and see if parent elements are hidden (defaults to false)
7281 * @return {Boolean} True if the element is currently visible, else false
7283 isVisible : function(deep) {
7284 var vis = !(this.getStyle("visibility") == "hidden" || this.getStyle("display") == "none");
7285 if(deep !== true || !vis){
7288 var p = this.dom.parentNode;
7289 while(p && p.tagName.toLowerCase() != "body"){
7290 if(!Roo.fly(p, '_isVisible').isVisible()){
7299 * Creates a {@link Roo.CompositeElement} for child nodes based on the passed CSS selector (the selector should not contain an id).
7300 * @param {String} selector The CSS selector
7301 * @param {Boolean} unique (optional) True to create a unique Roo.Element for each child (defaults to false, which creates a single shared flyweight object)
7302 * @return {CompositeElement/CompositeElementLite} The composite element
7304 select : function(selector, unique){
7305 return El.select(selector, unique, this.dom);
7309 * Selects child nodes based on the passed CSS selector (the selector should not contain an id).
7310 * @param {String} selector The CSS selector
7311 * @return {Array} An array of the matched nodes
7313 query : function(selector, unique){
7314 return Roo.DomQuery.select(selector, this.dom);
7318 * Selects a single child at any depth below this element based on the passed CSS selector (the selector should not contain an id).
7319 * @param {String} selector The CSS selector
7320 * @param {Boolean} returnDom (optional) True to return the DOM node instead of Roo.Element (defaults to false)
7321 * @return {HTMLElement/Roo.Element} The child Roo.Element (or DOM node if returnDom = true)
7323 child : function(selector, returnDom){
7324 var n = Roo.DomQuery.selectNode(selector, this.dom);
7325 return returnDom ? n : Roo.get(n);
7329 * Selects a single *direct* child based on the passed CSS selector (the selector should not contain an id).
7330 * @param {String} selector The CSS selector
7331 * @param {Boolean} returnDom (optional) True to return the DOM node instead of Roo.Element (defaults to false)
7332 * @return {HTMLElement/Roo.Element} The child Roo.Element (or DOM node if returnDom = true)
7334 down : function(selector, returnDom){
7335 var n = Roo.DomQuery.selectNode(" > " + selector, this.dom);
7336 return returnDom ? n : Roo.get(n);
7340 * Initializes a {@link Roo.dd.DD} drag drop object for this element.
7341 * @param {String} group The group the DD object is member of
7342 * @param {Object} config The DD config object
7343 * @param {Object} overrides An object containing methods to override/implement on the DD object
7344 * @return {Roo.dd.DD} The DD object
7346 initDD : function(group, config, overrides){
7347 var dd = new Roo.dd.DD(Roo.id(this.dom), group, config);
7348 return Roo.apply(dd, overrides);
7352 * Initializes a {@link Roo.dd.DDProxy} object for this element.
7353 * @param {String} group The group the DDProxy object is member of
7354 * @param {Object} config The DDProxy config object
7355 * @param {Object} overrides An object containing methods to override/implement on the DDProxy object
7356 * @return {Roo.dd.DDProxy} The DDProxy object
7358 initDDProxy : function(group, config, overrides){
7359 var dd = new Roo.dd.DDProxy(Roo.id(this.dom), group, config);
7360 return Roo.apply(dd, overrides);
7364 * Initializes a {@link Roo.dd.DDTarget} object for this element.
7365 * @param {String} group The group the DDTarget object is member of
7366 * @param {Object} config The DDTarget config object
7367 * @param {Object} overrides An object containing methods to override/implement on the DDTarget object
7368 * @return {Roo.dd.DDTarget} The DDTarget object
7370 initDDTarget : function(group, config, overrides){
7371 var dd = new Roo.dd.DDTarget(Roo.id(this.dom), group, config);
7372 return Roo.apply(dd, overrides);
7376 * Sets the visibility of the element (see details). If the visibilityMode is set to Element.DISPLAY, it will use
7377 * the display property to hide the element, otherwise it uses visibility. The default is to hide and show using the visibility property.
7378 * @param {Boolean} visible Whether the element is visible
7379 * @param {Boolean/Object} animate (optional) True for the default animation, or a standard Element animation config object
7380 * @return {Roo.Element} this
7382 setVisible : function(visible, animate){
7384 if(this.visibilityMode == El.DISPLAY){
7385 this.setDisplayed(visible);
7388 this.dom.style.visibility = visible ? "visible" : "hidden";
7391 // closure for composites
7393 var visMode = this.visibilityMode;
7395 this.setOpacity(.01);
7396 this.setVisible(true);
7398 this.anim({opacity: { to: (visible?1:0) }},
7399 this.preanim(arguments, 1),
7400 null, .35, 'easeIn', function(){
7402 if(visMode == El.DISPLAY){
7403 dom.style.display = "none";
7405 dom.style.visibility = "hidden";
7407 Roo.get(dom).setOpacity(1);
7415 * Returns true if display is not "none"
7418 isDisplayed : function() {
7419 return this.getStyle("display") != "none";
7423 * Toggles the element's visibility or display, depending on visibility mode.
7424 * @param {Boolean/Object} animate (optional) True for the default animation, or a standard Element animation config object
7425 * @return {Roo.Element} this
7427 toggle : function(animate){
7428 this.setVisible(!this.isVisible(), this.preanim(arguments, 0));
7433 * Sets the CSS display property. Uses originalDisplay if the specified value is a boolean true.
7434 * @param {Boolean} value Boolean value to display the element using its default display, or a string to set the display directly
7435 * @return {Roo.Element} this
7437 setDisplayed : function(value) {
7438 if(typeof value == "boolean"){
7439 value = value ? this.originalDisplay : "none";
7441 this.setStyle("display", value);
7446 * Tries to focus the element. Any exceptions are caught and ignored.
7447 * @return {Roo.Element} this
7449 focus : function() {
7457 * Tries to blur the element. Any exceptions are caught and ignored.
7458 * @return {Roo.Element} this
7468 * Adds one or more CSS classes to the element. Duplicate classes are automatically filtered out.
7469 * @param {String/Array} className The CSS class to add, or an array of classes
7470 * @return {Roo.Element} this
7472 addClass : function(className){
7473 if(className instanceof Array){
7474 for(var i = 0, len = className.length; i < len; i++) {
7475 this.addClass(className[i]);
7478 if(className && !this.hasClass(className)){
7479 this.dom.className = this.dom.className + " " + className;
7486 * Adds one or more CSS classes to this element and removes the same class(es) from all siblings.
7487 * @param {String/Array} className The CSS class to add, or an array of classes
7488 * @return {Roo.Element} this
7490 radioClass : function(className){
7491 var siblings = this.dom.parentNode.childNodes;
7492 for(var i = 0; i < siblings.length; i++) {
7493 var s = siblings[i];
7494 if(s.nodeType == 1){
7495 Roo.get(s).removeClass(className);
7498 this.addClass(className);
7503 * Removes one or more CSS classes from the element.
7504 * @param {String/Array} className The CSS class to remove, or an array of classes
7505 * @return {Roo.Element} this
7507 removeClass : function(className){
7508 if(!className || !this.dom.className){
7511 if(className instanceof Array){
7512 for(var i = 0, len = className.length; i < len; i++) {
7513 this.removeClass(className[i]);
7516 if(this.hasClass(className)){
7517 var re = this.classReCache[className];
7519 re = new RegExp('(?:^|\\s+)' + className + '(?:\\s+|$)', "g");
7520 this.classReCache[className] = re;
7522 this.dom.className =
7523 this.dom.className.replace(re, " ");
7533 * Toggles the specified CSS class on this element (removes it if it already exists, otherwise adds it).
7534 * @param {String} className The CSS class to toggle
7535 * @return {Roo.Element} this
7537 toggleClass : function(className){
7538 if(this.hasClass(className)){
7539 this.removeClass(className);
7541 this.addClass(className);
7547 * Checks if the specified CSS class exists on this element's DOM node.
7548 * @param {String} className The CSS class to check for
7549 * @return {Boolean} True if the class exists, else false
7551 hasClass : function(className){
7552 return className && (' '+this.dom.className+' ').indexOf(' '+className+' ') != -1;
7556 * Replaces a CSS class on the element with another. If the old name does not exist, the new name will simply be added.
7557 * @param {String} oldClassName The CSS class to replace
7558 * @param {String} newClassName The replacement CSS class
7559 * @return {Roo.Element} this
7561 replaceClass : function(oldClassName, newClassName){
7562 this.removeClass(oldClassName);
7563 this.addClass(newClassName);
7568 * Returns an object with properties matching the styles requested.
7569 * For example, el.getStyles('color', 'font-size', 'width') might return
7570 * {'color': '#FFFFFF', 'font-size': '13px', 'width': '100px'}.
7571 * @param {String} style1 A style name
7572 * @param {String} style2 A style name
7573 * @param {String} etc.
7574 * @return {Object} The style object
7576 getStyles : function(){
7577 var a = arguments, len = a.length, r = {};
7578 for(var i = 0; i < len; i++){
7579 r[a[i]] = this.getStyle(a[i]);
7585 * Normalizes currentStyle and computedStyle. This is not YUI getStyle, it is an optimised version.
7586 * @param {String} property The style property whose value is returned.
7587 * @return {String} The current value of the style property for this element.
7589 getStyle : function(){
7590 return view && view.getComputedStyle ?
7592 var el = this.dom, v, cs, camel;
7593 if(prop == 'float'){
7596 if(el.style && (v = el.style[prop])){
7599 if(cs = view.getComputedStyle(el, "")){
7600 if(!(camel = propCache[prop])){
7601 camel = propCache[prop] = prop.replace(camelRe, camelFn);
7608 var el = this.dom, v, cs, camel;
7609 if(prop == 'opacity'){
7610 if(typeof el.style.filter == 'string'){
7611 var m = el.style.filter.match(/alpha\(opacity=(.*)\)/i);
7613 var fv = parseFloat(m[1]);
7615 return fv ? fv / 100 : 0;
7620 }else if(prop == 'float'){
7621 prop = "styleFloat";
7623 if(!(camel = propCache[prop])){
7624 camel = propCache[prop] = prop.replace(camelRe, camelFn);
7626 if(v = el.style[camel]){
7629 if(cs = el.currentStyle){
7637 * Wrapper for setting style properties, also takes single object parameter of multiple styles.
7638 * @param {String/Object} property The style property to be set, or an object of multiple styles.
7639 * @param {String} value (optional) The value to apply to the given property, or null if an object was passed.
7640 * @return {Roo.Element} this
7642 setStyle : function(prop, value){
7643 if(typeof prop == "string"){
7645 if (prop == 'float') {
7646 this.setStyle(Roo.isIE ? 'styleFloat' : 'cssFloat', value);
7651 if(!(camel = propCache[prop])){
7652 camel = propCache[prop] = prop.replace(camelRe, camelFn);
7655 if(camel == 'opacity') {
7656 this.setOpacity(value);
7658 this.dom.style[camel] = value;
7661 for(var style in prop){
7662 if(typeof prop[style] != "function"){
7663 this.setStyle(style, prop[style]);
7671 * More flexible version of {@link #setStyle} for setting style properties.
7672 * @param {String/Object/Function} styles A style specification string, e.g. "width:100px", or object in the form {width:"100px"}, or
7673 * a function which returns such a specification.
7674 * @return {Roo.Element} this
7676 applyStyles : function(style){
7677 Roo.DomHelper.applyStyles(this.dom, style);
7682 * 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).
7683 * @return {Number} The X position of the element
7686 return D.getX(this.dom);
7690 * 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).
7691 * @return {Number} The Y position of the element
7694 return D.getY(this.dom);
7698 * 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).
7699 * @return {Array} The XY position of the element
7702 return D.getXY(this.dom);
7706 * 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).
7707 * @param {Number} The X position of the element
7708 * @param {Boolean/Object} animate (optional) True for the default animation, or a standard Element animation config object
7709 * @return {Roo.Element} this
7711 setX : function(x, animate){
7713 D.setX(this.dom, x);
7715 this.setXY([x, this.getY()], this.preanim(arguments, 1));
7721 * 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).
7722 * @param {Number} The Y position of the element
7723 * @param {Boolean/Object} animate (optional) True for the default animation, or a standard Element animation config object
7724 * @return {Roo.Element} this
7726 setY : function(y, animate){
7728 D.setY(this.dom, y);
7730 this.setXY([this.getX(), y], this.preanim(arguments, 1));
7736 * Sets the element's left position directly using CSS style (instead of {@link #setX}).
7737 * @param {String} left The left CSS property value
7738 * @return {Roo.Element} this
7740 setLeft : function(left){
7741 this.setStyle("left", this.addUnits(left));
7746 * Sets the element's top position directly using CSS style (instead of {@link #setY}).
7747 * @param {String} top The top CSS property value
7748 * @return {Roo.Element} this
7750 setTop : function(top){
7751 this.setStyle("top", this.addUnits(top));
7756 * Sets the element's CSS right style.
7757 * @param {String} right The right CSS property value
7758 * @return {Roo.Element} this
7760 setRight : function(right){
7761 this.setStyle("right", this.addUnits(right));
7766 * Sets the element's CSS bottom style.
7767 * @param {String} bottom The bottom CSS property value
7768 * @return {Roo.Element} this
7770 setBottom : function(bottom){
7771 this.setStyle("bottom", this.addUnits(bottom));
7776 * Sets the position of the element in page coordinates, regardless of how the element is positioned.
7777 * The element must be part of the DOM tree to have page coordinates (display:none or elements not appended return false).
7778 * @param {Array} pos Contains X & Y [x, y] values for new position (coordinates are page-based)
7779 * @param {Boolean/Object} animate (optional) True for the default animation, or a standard Element animation config object
7780 * @return {Roo.Element} this
7782 setXY : function(pos, animate){
7784 D.setXY(this.dom, pos);
7786 this.anim({points: {to: pos}}, this.preanim(arguments, 1), 'motion');
7792 * Sets the position of the element in page coordinates, regardless of how the element is positioned.
7793 * The element must be part of the DOM tree to have page coordinates (display:none or elements not appended return false).
7794 * @param {Number} x X value for new position (coordinates are page-based)
7795 * @param {Number} y Y value for new position (coordinates are page-based)
7796 * @param {Boolean/Object} animate (optional) True for the default animation, or a standard Element animation config object
7797 * @return {Roo.Element} this
7799 setLocation : function(x, y, animate){
7800 this.setXY([x, y], this.preanim(arguments, 2));
7805 * Sets the position of the element in page coordinates, regardless of how the element is positioned.
7806 * The element must be part of the DOM tree to have page coordinates (display:none or elements not appended return false).
7807 * @param {Number} x X value for new position (coordinates are page-based)
7808 * @param {Number} y Y value for new position (coordinates are page-based)
7809 * @param {Boolean/Object} animate (optional) True for the default animation, or a standard Element animation config object
7810 * @return {Roo.Element} this
7812 moveTo : function(x, y, animate){
7813 this.setXY([x, y], this.preanim(arguments, 2));
7818 * Returns the region of the given element.
7819 * The element must be part of the DOM tree to have a region (display:none or elements not appended return false).
7820 * @return {Region} A Roo.lib.Region containing "top, left, bottom, right" member data.
7822 getRegion : function(){
7823 return D.getRegion(this.dom);
7827 * Returns the offset height of the element
7828 * @param {Boolean} contentHeight (optional) true to get the height minus borders and padding
7829 * @return {Number} The element's height
7831 getHeight : function(contentHeight){
7832 var h = this.dom.offsetHeight || 0;
7833 return contentHeight !== true ? h : h-this.getBorderWidth("tb")-this.getPadding("tb");
7837 * Returns the offset width of the element
7838 * @param {Boolean} contentWidth (optional) true to get the width minus borders and padding
7839 * @return {Number} The element's width
7841 getWidth : function(contentWidth){
7842 var w = this.dom.offsetWidth || 0;
7843 return contentWidth !== true ? w : w-this.getBorderWidth("lr")-this.getPadding("lr");
7847 * Returns either the offsetHeight or the height of this element based on CSS height adjusted by padding or borders
7848 * when needed to simulate offsetHeight when offsets aren't available. This may not work on display:none elements
7849 * if a height has not been set using CSS.
7852 getComputedHeight : function(){
7853 var h = Math.max(this.dom.offsetHeight, this.dom.clientHeight);
7855 h = parseInt(this.getStyle('height'), 10) || 0;
7856 if(!this.isBorderBox()){
7857 h += this.getFrameWidth('tb');
7864 * Returns either the offsetWidth or the width of this element based on CSS width adjusted by padding or borders
7865 * when needed to simulate offsetWidth when offsets aren't available. This may not work on display:none elements
7866 * if a width has not been set using CSS.
7869 getComputedWidth : function(){
7870 var w = Math.max(this.dom.offsetWidth, this.dom.clientWidth);
7872 w = parseInt(this.getStyle('width'), 10) || 0;
7873 if(!this.isBorderBox()){
7874 w += this.getFrameWidth('lr');
7881 * Returns the size of the element.
7882 * @param {Boolean} contentSize (optional) true to get the width/size minus borders and padding
7883 * @return {Object} An object containing the element's size {width: (element width), height: (element height)}
7885 getSize : function(contentSize){
7886 return {width: this.getWidth(contentSize), height: this.getHeight(contentSize)};
7890 * Returns the width and height of the viewport.
7891 * @return {Object} An object containing the viewport's size {width: (viewport width), height: (viewport height)}
7893 getViewSize : function(){
7894 var d = this.dom, doc = document, aw = 0, ah = 0;
7895 if(d == doc || d == doc.body){
7896 return {width : D.getViewWidth(), height: D.getViewHeight()};
7899 width : d.clientWidth,
7900 height: d.clientHeight
7906 * Returns the value of the "value" attribute
7907 * @param {Boolean} asNumber true to parse the value as a number
7908 * @return {String/Number}
7910 getValue : function(asNumber){
7911 return asNumber ? parseInt(this.dom.value, 10) : this.dom.value;
7915 adjustWidth : function(width){
7916 if(typeof width == "number"){
7917 if(this.autoBoxAdjust && !this.isBorderBox()){
7918 width -= (this.getBorderWidth("lr") + this.getPadding("lr"));
7928 adjustHeight : function(height){
7929 if(typeof height == "number"){
7930 if(this.autoBoxAdjust && !this.isBorderBox()){
7931 height -= (this.getBorderWidth("tb") + this.getPadding("tb"));
7941 * Set the width of the element
7942 * @param {Number} width The new width
7943 * @param {Boolean/Object} animate (optional) true for the default animation or a standard Element animation config object
7944 * @return {Roo.Element} this
7946 setWidth : function(width, animate){
7947 width = this.adjustWidth(width);
7949 this.dom.style.width = this.addUnits(width);
7951 this.anim({width: {to: width}}, this.preanim(arguments, 1));
7957 * Set the height of the element
7958 * @param {Number} height The new height
7959 * @param {Boolean/Object} animate (optional) true for the default animation or a standard Element animation config object
7960 * @return {Roo.Element} this
7962 setHeight : function(height, animate){
7963 height = this.adjustHeight(height);
7965 this.dom.style.height = this.addUnits(height);
7967 this.anim({height: {to: height}}, this.preanim(arguments, 1));
7973 * Set the size of the element. If animation is true, both width an height will be animated concurrently.
7974 * @param {Number} width The new width
7975 * @param {Number} height The new height
7976 * @param {Boolean/Object} animate (optional) true for the default animation or a standard Element animation config object
7977 * @return {Roo.Element} this
7979 setSize : function(width, height, animate){
7980 if(typeof width == "object"){ // in case of object from getSize()
7981 height = width.height; width = width.width;
7983 width = this.adjustWidth(width); height = this.adjustHeight(height);
7985 this.dom.style.width = this.addUnits(width);
7986 this.dom.style.height = this.addUnits(height);
7988 this.anim({width: {to: width}, height: {to: height}}, this.preanim(arguments, 2));
7994 * Sets the element's position and size in one shot. If animation is true then width, height, x and y will be animated concurrently.
7995 * @param {Number} x X value for new position (coordinates are page-based)
7996 * @param {Number} y Y value for new position (coordinates are page-based)
7997 * @param {Number} width The new width
7998 * @param {Number} height The new height
7999 * @param {Boolean/Object} animate (optional) true for the default animation or a standard Element animation config object
8000 * @return {Roo.Element} this
8002 setBounds : function(x, y, width, height, animate){
8004 this.setSize(width, height);
8005 this.setLocation(x, y);
8007 width = this.adjustWidth(width); height = this.adjustHeight(height);
8008 this.anim({points: {to: [x, y]}, width: {to: width}, height: {to: height}},
8009 this.preanim(arguments, 4), 'motion');
8015 * 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.
8016 * @param {Roo.lib.Region} region The region to fill
8017 * @param {Boolean/Object} animate (optional) true for the default animation or a standard Element animation config object
8018 * @return {Roo.Element} this
8020 setRegion : function(region, animate){
8021 this.setBounds(region.left, region.top, region.right-region.left, region.bottom-region.top, this.preanim(arguments, 1));
8026 * Appends an event handler
8028 * @param {String} eventName The type of event to append
8029 * @param {Function} fn The method the event invokes
8030 * @param {Object} scope (optional) The scope (this object) of the fn
8031 * @param {Object} options (optional)An object with standard {@link Roo.EventManager#addListener} options
8033 addListener : function(eventName, fn, scope, options){
8035 Roo.EventManager.on(this.dom, eventName, fn, scope || this, options);
8040 * Removes an event handler from this element
8041 * @param {String} eventName the type of event to remove
8042 * @param {Function} fn the method the event invokes
8043 * @return {Roo.Element} this
8045 removeListener : function(eventName, fn){
8046 Roo.EventManager.removeListener(this.dom, eventName, fn);
8051 * Removes all previous added listeners from this element
8052 * @return {Roo.Element} this
8054 removeAllListeners : function(){
8055 E.purgeElement(this.dom);
8059 relayEvent : function(eventName, observable){
8060 this.on(eventName, function(e){
8061 observable.fireEvent(eventName, e);
8066 * Set the opacity of the element
8067 * @param {Float} opacity The new opacity. 0 = transparent, .5 = 50% visibile, 1 = fully visible, etc
8068 * @param {Boolean/Object} animate (optional) true for the default animation or a standard Element animation config object
8069 * @return {Roo.Element} this
8071 setOpacity : function(opacity, animate){
8073 var s = this.dom.style;
8076 s.filter = (s.filter || '').replace(/alpha\([^\)]*\)/gi,"") +
8077 (opacity == 1 ? "" : "alpha(opacity=" + opacity * 100 + ")");
8079 s.opacity = opacity;
8082 this.anim({opacity: {to: opacity}}, this.preanim(arguments, 1), null, .35, 'easeIn');
8088 * Gets the left X coordinate
8089 * @param {Boolean} local True to get the local css position instead of page coordinate
8092 getLeft : function(local){
8096 return parseInt(this.getStyle("left"), 10) || 0;
8101 * Gets the right X coordinate of the element (element X position + element width)
8102 * @param {Boolean} local True to get the local css position instead of page coordinate
8105 getRight : function(local){
8107 return this.getX() + this.getWidth();
8109 return (this.getLeft(true) + this.getWidth()) || 0;
8114 * Gets the top Y coordinate
8115 * @param {Boolean} local True to get the local css position instead of page coordinate
8118 getTop : function(local) {
8122 return parseInt(this.getStyle("top"), 10) || 0;
8127 * Gets the bottom Y coordinate of the element (element Y position + element height)
8128 * @param {Boolean} local True to get the local css position instead of page coordinate
8131 getBottom : function(local){
8133 return this.getY() + this.getHeight();
8135 return (this.getTop(true) + this.getHeight()) || 0;
8140 * Initializes positioning on this element. If a desired position is not passed, it will make the
8141 * the element positioned relative IF it is not already positioned.
8142 * @param {String} pos (optional) Positioning to use "relative", "absolute" or "fixed"
8143 * @param {Number} zIndex (optional) The zIndex to apply
8144 * @param {Number} x (optional) Set the page X position
8145 * @param {Number} y (optional) Set the page Y position
8147 position : function(pos, zIndex, x, y){
8149 if(this.getStyle('position') == 'static'){
8150 this.setStyle('position', 'relative');
8153 this.setStyle("position", pos);
8156 this.setStyle("z-index", zIndex);
8158 if(x !== undefined && y !== undefined){
8160 }else if(x !== undefined){
8162 }else if(y !== undefined){
8168 * Clear positioning back to the default when the document was loaded
8169 * @param {String} value (optional) The value to use for the left,right,top,bottom, defaults to '' (empty string). You could use 'auto'.
8170 * @return {Roo.Element} this
8172 clearPositioning : function(value){
8180 "position" : "static"
8186 * Gets an object with all CSS positioning properties. Useful along with setPostioning to get
8187 * snapshot before performing an update and then restoring the element.
8190 getPositioning : function(){
8191 var l = this.getStyle("left");
8192 var t = this.getStyle("top");
8194 "position" : this.getStyle("position"),
8196 "right" : l ? "" : this.getStyle("right"),
8198 "bottom" : t ? "" : this.getStyle("bottom"),
8199 "z-index" : this.getStyle("z-index")
8204 * Gets the width of the border(s) for the specified side(s)
8205 * @param {String} side Can be t, l, r, b or any combination of those to add multiple values. For example,
8206 * passing lr would get the border (l)eft width + the border (r)ight width.
8207 * @return {Number} The width of the sides passed added together
8209 getBorderWidth : function(side){
8210 return this.addStyles(side, El.borders);
8214 * Gets the width of the padding(s) for the specified side(s)
8215 * @param {String} side Can be t, l, r, b or any combination of those to add multiple values. For example,
8216 * passing lr would get the padding (l)eft + the padding (r)ight.
8217 * @return {Number} The padding of the sides passed added together
8219 getPadding : function(side){
8220 return this.addStyles(side, El.paddings);
8224 * Set positioning with an object returned by getPositioning().
8225 * @param {Object} posCfg
8226 * @return {Roo.Element} this
8228 setPositioning : function(pc){
8229 this.applyStyles(pc);
8230 if(pc.right == "auto"){
8231 this.dom.style.right = "";
8233 if(pc.bottom == "auto"){
8234 this.dom.style.bottom = "";
8240 fixDisplay : function(){
8241 if(this.getStyle("display") == "none"){
8242 this.setStyle("visibility", "hidden");
8243 this.setStyle("display", this.originalDisplay); // first try reverting to default
8244 if(this.getStyle("display") == "none"){ // if that fails, default to block
8245 this.setStyle("display", "block");
8251 * Quick set left and top adding default units
8252 * @param {String} left The left CSS property value
8253 * @param {String} top The top CSS property value
8254 * @return {Roo.Element} this
8256 setLeftTop : function(left, top){
8257 this.dom.style.left = this.addUnits(left);
8258 this.dom.style.top = this.addUnits(top);
8263 * Move this element relative to its current position.
8264 * @param {String} direction Possible values are: "l","left" - "r","right" - "t","top","up" - "b","bottom","down".
8265 * @param {Number} distance How far to move the element in pixels
8266 * @param {Boolean/Object} animate (optional) true for the default animation or a standard Element animation config object
8267 * @return {Roo.Element} this
8269 move : function(direction, distance, animate){
8270 var xy = this.getXY();
8271 direction = direction.toLowerCase();
8275 this.moveTo(xy[0]-distance, xy[1], this.preanim(arguments, 2));
8279 this.moveTo(xy[0]+distance, xy[1], this.preanim(arguments, 2));
8284 this.moveTo(xy[0], xy[1]-distance, this.preanim(arguments, 2));
8289 this.moveTo(xy[0], xy[1]+distance, this.preanim(arguments, 2));
8296 * Store the current overflow setting and clip overflow on the element - use {@link #unclip} to remove
8297 * @return {Roo.Element} this
8300 if(!this.isClipped){
8301 this.isClipped = true;
8302 this.originalClip = {
8303 "o": this.getStyle("overflow"),
8304 "x": this.getStyle("overflow-x"),
8305 "y": this.getStyle("overflow-y")
8307 this.setStyle("overflow", "hidden");
8308 this.setStyle("overflow-x", "hidden");
8309 this.setStyle("overflow-y", "hidden");
8315 * Return clipping (overflow) to original clipping before clip() was called
8316 * @return {Roo.Element} this
8318 unclip : function(){
8320 this.isClipped = false;
8321 var o = this.originalClip;
8322 if(o.o){this.setStyle("overflow", o.o);}
8323 if(o.x){this.setStyle("overflow-x", o.x);}
8324 if(o.y){this.setStyle("overflow-y", o.y);}
8331 * Gets the x,y coordinates specified by the anchor position on the element.
8332 * @param {String} anchor (optional) The specified anchor position (defaults to "c"). See {@link #alignTo} for details on supported anchor positions.
8333 * @param {Object} size (optional) An object containing the size to use for calculating anchor position
8334 * {width: (target width), height: (target height)} (defaults to the element's current size)
8335 * @param {Boolean} local (optional) True to get the local (element top/left-relative) anchor position instead of page coordinates
8336 * @return {Array} [x, y] An array containing the element's x and y coordinates
8338 getAnchorXY : function(anchor, local, s){
8339 //Passing a different size is useful for pre-calculating anchors,
8340 //especially for anchored animations that change the el size.
8342 var w, h, vp = false;
8345 if(d == document.body || d == document){
8347 w = D.getViewWidth(); h = D.getViewHeight();
8349 w = this.getWidth(); h = this.getHeight();
8352 w = s.width; h = s.height;
8354 var x = 0, y = 0, r = Math.round;
8355 switch((anchor || "tl").toLowerCase()){
8397 var sc = this.getScroll();
8398 return [x + sc.left, y + sc.top];
8400 //Add the element's offset xy
8401 var o = this.getXY();
8402 return [x+o[0], y+o[1]];
8406 * Gets the x,y coordinates to align this element with another element. See {@link #alignTo} for more info on the
8407 * supported position values.
8408 * @param {String/HTMLElement/Roo.Element} element The element to align to.
8409 * @param {String} position The position to align to.
8410 * @param {Array} offsets (optional) Offset the positioning by [x, y]
8411 * @return {Array} [x, y]
8413 getAlignToXY : function(el, p, o){
8417 throw "Element.alignTo with an element that doesn't exist";
8419 var c = false; //constrain to viewport
8420 var p1 = "", p2 = "";
8427 }else if(p.indexOf("-") == -1){
8430 p = p.toLowerCase();
8431 var m = p.match(/^([a-z]+)-([a-z]+)(\?)?$/);
8433 throw "Element.alignTo with an invalid alignment " + p;
8435 p1 = m[1]; p2 = m[2]; c = !!m[3];
8437 //Subtract the aligned el's internal xy from the target's offset xy
8438 //plus custom offset to get the aligned el's new offset xy
8439 var a1 = this.getAnchorXY(p1, true);
8440 var a2 = el.getAnchorXY(p2, false);
8441 var x = a2[0] - a1[0] + o[0];
8442 var y = a2[1] - a1[1] + o[1];
8444 //constrain the aligned el to viewport if necessary
8445 var w = this.getWidth(), h = this.getHeight(), r = el.getRegion();
8446 // 5px of margin for ie
8447 var dw = D.getViewWidth()-5, dh = D.getViewHeight()-5;
8449 //If we are at a viewport boundary and the aligned el is anchored on a target border that is
8450 //perpendicular to the vp border, allow the aligned el to slide on that border,
8451 //otherwise swap the aligned el to the opposite border of the target.
8452 var p1y = p1.charAt(0), p1x = p1.charAt(p1.length-1);
8453 var p2y = p2.charAt(0), p2x = p2.charAt(p2.length-1);
8454 var swapY = ((p1y=="t" && p2y=="b") || (p1y=="b" && p2y=="t"));
8455 var swapX = ((p1x=="r" && p2x=="l") || (p1x=="l" && p2x=="r"));
8458 var scrollX = (doc.documentElement.scrollLeft || doc.body.scrollLeft || 0)+5;
8459 var scrollY = (doc.documentElement.scrollTop || doc.body.scrollTop || 0)+5;
8461 if((x+w) > dw + scrollX){
8462 x = swapX ? r.left-w : dw+scrollX-w;
8465 x = swapX ? r.right : scrollX;
8467 if((y+h) > dh + scrollY){
8468 y = swapY ? r.top-h : dh+scrollY-h;
8471 y = swapY ? r.bottom : scrollY;
8478 getConstrainToXY : function(){
8479 var os = {top:0, left:0, bottom:0, right: 0};
8481 return function(el, local, offsets, proposedXY){
8483 offsets = offsets ? Roo.applyIf(offsets, os) : os;
8485 var vw, vh, vx = 0, vy = 0;
8486 if(el.dom == document.body || el.dom == document){
8487 vw = Roo.lib.Dom.getViewWidth();
8488 vh = Roo.lib.Dom.getViewHeight();
8490 vw = el.dom.clientWidth;
8491 vh = el.dom.clientHeight;
8493 var vxy = el.getXY();
8499 var s = el.getScroll();
8501 vx += offsets.left + s.left;
8502 vy += offsets.top + s.top;
8504 vw -= offsets.right;
8505 vh -= offsets.bottom;
8510 var xy = proposedXY || (!local ? this.getXY() : [this.getLeft(true), this.getTop(true)]);
8511 var x = xy[0], y = xy[1];
8512 var w = this.dom.offsetWidth, h = this.dom.offsetHeight;
8514 // only move it if it needs it
8517 // first validate right/bottom
8526 // then make sure top/left isn't negative
8535 return moved ? [x, y] : false;
8540 adjustForConstraints : function(xy, parent, offsets){
8541 return this.getConstrainToXY(parent || document, false, offsets, xy) || xy;
8545 * Aligns this element with another element relative to the specified anchor points. If the other element is the
8546 * document it aligns it to the viewport.
8547 * The position parameter is optional, and can be specified in any one of the following formats:
8549 * <li><b>Blank</b>: Defaults to aligning the element's top-left corner to the target's bottom-left corner ("tl-bl").</li>
8550 * <li><b>One anchor (deprecated)</b>: The passed anchor position is used as the target element's anchor point.
8551 * The element being aligned will position its top-left corner (tl) to that point. <i>This method has been
8552 * deprecated in favor of the newer two anchor syntax below</i>.</li>
8553 * <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
8554 * element's anchor point, and the second value is used as the target's anchor point.</li>
8556 * In addition to the anchor points, the position parameter also supports the "?" character. If "?" is passed at the end of
8557 * the position string, the element will attempt to align as specified, but the position will be adjusted to constrain to
8558 * the viewport if necessary. Note that the element being aligned might be swapped to align to a different position than
8559 * that specified in order to enforce the viewport constraints.
8560 * Following are all of the supported anchor positions:
8563 ----- -----------------------------
8564 tl The top left corner (default)
8565 t The center of the top edge
8566 tr The top right corner
8567 l The center of the left edge
8568 c In the center of the element
8569 r The center of the right edge
8570 bl The bottom left corner
8571 b The center of the bottom edge
8572 br The bottom right corner
8576 // align el to other-el using the default positioning ("tl-bl", non-constrained)
8577 el.alignTo("other-el");
8579 // align the top left corner of el with the top right corner of other-el (constrained to viewport)
8580 el.alignTo("other-el", "tr?");
8582 // align the bottom right corner of el with the center left edge of other-el
8583 el.alignTo("other-el", "br-l?");
8585 // align the center of el with the bottom left corner of other-el and
8586 // adjust the x position by -6 pixels (and the y position by 0)
8587 el.alignTo("other-el", "c-bl", [-6, 0]);
8589 * @param {String/HTMLElement/Roo.Element} element The element to align to.
8590 * @param {String} position The position to align to.
8591 * @param {Array} offsets (optional) Offset the positioning by [x, y]
8592 * @param {Boolean/Object} animate (optional) true for the default animation or a standard Element animation config object
8593 * @return {Roo.Element} this
8595 alignTo : function(element, position, offsets, animate){
8596 var xy = this.getAlignToXY(element, position, offsets);
8597 this.setXY(xy, this.preanim(arguments, 3));
8602 * Anchors an element to another element and realigns it when the window is resized.
8603 * @param {String/HTMLElement/Roo.Element} element The element to align to.
8604 * @param {String} position The position to align to.
8605 * @param {Array} offsets (optional) Offset the positioning by [x, y]
8606 * @param {Boolean/Object} animate (optional) True for the default animation or a standard Element animation config object
8607 * @param {Boolean/Number} monitorScroll (optional) True to monitor body scroll and reposition. If this parameter
8608 * is a number, it is used as the buffer delay (defaults to 50ms).
8609 * @param {Function} callback The function to call after the animation finishes
8610 * @return {Roo.Element} this
8612 anchorTo : function(el, alignment, offsets, animate, monitorScroll, callback){
8613 var action = function(){
8614 this.alignTo(el, alignment, offsets, animate);
8615 Roo.callback(callback, this);
8617 Roo.EventManager.onWindowResize(action, this);
8618 var tm = typeof monitorScroll;
8619 if(tm != 'undefined'){
8620 Roo.EventManager.on(window, 'scroll', action, this,
8621 {buffer: tm == 'number' ? monitorScroll : 50});
8623 action.call(this); // align immediately
8627 * Clears any opacity settings from this element. Required in some cases for IE.
8628 * @return {Roo.Element} this
8630 clearOpacity : function(){
8631 if (window.ActiveXObject) {
8632 if(typeof this.dom.style.filter == 'string' && (/alpha/i).test(this.dom.style.filter)){
8633 this.dom.style.filter = "";
8636 this.dom.style.opacity = "";
8637 this.dom.style["-moz-opacity"] = "";
8638 this.dom.style["-khtml-opacity"] = "";
8644 * Hide this element - Uses display mode to determine whether to use "display" or "visibility". See {@link #setVisible}.
8645 * @param {Boolean/Object} animate (optional) true for the default animation or a standard Element animation config object
8646 * @return {Roo.Element} this
8648 hide : function(animate){
8649 this.setVisible(false, this.preanim(arguments, 0));
8654 * Show this element - Uses display mode to determine whether to use "display" or "visibility". See {@link #setVisible}.
8655 * @param {Boolean/Object} animate (optional) true for the default animation or a standard Element animation config object
8656 * @return {Roo.Element} this
8658 show : function(animate){
8659 this.setVisible(true, this.preanim(arguments, 0));
8664 * @private Test if size has a unit, otherwise appends the default
8666 addUnits : function(size){
8667 return Roo.Element.addUnits(size, this.defaultUnit);
8671 * Temporarily enables offsets (width,height,x,y) for an element with display:none, use endMeasure() when done.
8672 * @return {Roo.Element} this
8674 beginMeasure : function(){
8676 if(el.offsetWidth || el.offsetHeight){
8677 return this; // offsets work already
8680 var p = this.dom, b = document.body; // start with this element
8681 while((!el.offsetWidth && !el.offsetHeight) && p && p.tagName && p != b){
8682 var pe = Roo.get(p);
8683 if(pe.getStyle('display') == 'none'){
8684 changed.push({el: p, visibility: pe.getStyle("visibility")});
8685 p.style.visibility = "hidden";
8686 p.style.display = "block";
8690 this._measureChanged = changed;
8696 * Restores displays to before beginMeasure was called
8697 * @return {Roo.Element} this
8699 endMeasure : function(){
8700 var changed = this._measureChanged;
8702 for(var i = 0, len = changed.length; i < len; i++) {
8704 r.el.style.visibility = r.visibility;
8705 r.el.style.display = "none";
8707 this._measureChanged = null;
8713 * Update the innerHTML of this element, optionally searching for and processing scripts
8714 * @param {String} html The new HTML
8715 * @param {Boolean} loadScripts (optional) true to look for and process scripts
8716 * @param {Function} callback For async script loading you can be noticed when the update completes
8717 * @return {Roo.Element} this
8719 update : function(html, loadScripts, callback){
8720 if(typeof html == "undefined"){
8723 if(loadScripts !== true){
8724 this.dom.innerHTML = html;
8725 if(typeof callback == "function"){
8733 html += '<span id="' + id + '"></span>';
8735 E.onAvailable(id, function(){
8736 var hd = document.getElementsByTagName("head")[0];
8737 var re = /(?:<script([^>]*)?>)((\n|\r|.)*?)(?:<\/script>)/ig;
8738 var srcRe = /\ssrc=([\'\"])(.*?)\1/i;
8739 var typeRe = /\stype=([\'\"])(.*?)\1/i;
8742 while(match = re.exec(html)){
8743 var attrs = match[1];
8744 var srcMatch = attrs ? attrs.match(srcRe) : false;
8745 if(srcMatch && srcMatch[2]){
8746 var s = document.createElement("script");
8747 s.src = srcMatch[2];
8748 var typeMatch = attrs.match(typeRe);
8749 if(typeMatch && typeMatch[2]){
8750 s.type = typeMatch[2];
8753 }else if(match[2] && match[2].length > 0){
8754 if(window.execScript) {
8755 window.execScript(match[2]);
8763 window.eval(match[2]);
8767 var el = document.getElementById(id);
8768 if(el){el.parentNode.removeChild(el);}
8769 if(typeof callback == "function"){
8773 dom.innerHTML = html.replace(/(?:<script.*?>)((\n|\r|.)*?)(?:<\/script>)/ig, "");
8778 * Direct access to the UpdateManager update() method (takes the same parameters).
8779 * @param {String/Function} url The url for this request or a function to call to get the url
8780 * @param {String/Object} params (optional) The parameters to pass as either a url encoded string "param1=1&param2=2" or an object {param1: 1, param2: 2}
8781 * @param {Function} callback (optional) Callback when transaction is complete - called with signature (oElement, bSuccess)
8782 * @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.
8783 * @return {Roo.Element} this
8786 var um = this.getUpdateManager();
8787 um.update.apply(um, arguments);
8792 * Gets this element's UpdateManager
8793 * @return {Roo.UpdateManager} The UpdateManager
8795 getUpdateManager : function(){
8796 if(!this.updateManager){
8797 this.updateManager = new Roo.UpdateManager(this);
8799 return this.updateManager;
8803 * Disables text selection for this element (normalized across browsers)
8804 * @return {Roo.Element} this
8806 unselectable : function(){
8807 this.dom.unselectable = "on";
8808 this.swallowEvent("selectstart", true);
8809 this.applyStyles("-moz-user-select:none;-khtml-user-select:none;");
8810 this.addClass("x-unselectable");
8815 * Calculates the x, y to center this element on the screen
8816 * @return {Array} The x, y values [x, y]
8818 getCenterXY : function(){
8819 return this.getAlignToXY(document, 'c-c');
8823 * Centers the Element in either the viewport, or another Element.
8824 * @param {String/HTMLElement/Roo.Element} centerIn (optional) The element in which to center the element.
8826 center : function(centerIn){
8827 this.alignTo(centerIn || document, 'c-c');
8832 * Tests various css rules/browsers to determine if this element uses a border box
8835 isBorderBox : function(){
8836 return noBoxAdjust[this.dom.tagName.toLowerCase()] || Roo.isBorderBox;
8840 * Return a box {x, y, width, height} that can be used to set another elements
8841 * size/location to match this element.
8842 * @param {Boolean} contentBox (optional) If true a box for the content of the element is returned.
8843 * @param {Boolean} local (optional) If true the element's left and top are returned instead of page x/y.
8844 * @return {Object} box An object in the format {x, y, width, height}
8846 getBox : function(contentBox, local){
8851 var left = parseInt(this.getStyle("left"), 10) || 0;
8852 var top = parseInt(this.getStyle("top"), 10) || 0;
8855 var el = this.dom, w = el.offsetWidth, h = el.offsetHeight, bx;
8857 bx = {x: xy[0], y: xy[1], 0: xy[0], 1: xy[1], width: w, height: h};
8859 var l = this.getBorderWidth("l")+this.getPadding("l");
8860 var r = this.getBorderWidth("r")+this.getPadding("r");
8861 var t = this.getBorderWidth("t")+this.getPadding("t");
8862 var b = this.getBorderWidth("b")+this.getPadding("b");
8863 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)};
8865 bx.right = bx.x + bx.width;
8866 bx.bottom = bx.y + bx.height;
8871 * Returns the sum width of the padding and borders for the passed "sides". See getBorderWidth()
8872 for more information about the sides.
8873 * @param {String} sides
8876 getFrameWidth : function(sides, onlyContentBox){
8877 return onlyContentBox && Roo.isBorderBox ? 0 : (this.getPadding(sides) + this.getBorderWidth(sides));
8881 * 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.
8882 * @param {Object} box The box to fill {x, y, width, height}
8883 * @param {Boolean} adjust (optional) Whether to adjust for box-model issues automatically
8884 * @param {Boolean/Object} animate (optional) true for the default animation or a standard Element animation config object
8885 * @return {Roo.Element} this
8887 setBox : function(box, adjust, animate){
8888 var w = box.width, h = box.height;
8889 if((adjust && !this.autoBoxAdjust) && !this.isBorderBox()){
8890 w -= (this.getBorderWidth("lr") + this.getPadding("lr"));
8891 h -= (this.getBorderWidth("tb") + this.getPadding("tb"));
8893 this.setBounds(box.x, box.y, w, h, this.preanim(arguments, 2));
8898 * Forces the browser to repaint this element
8899 * @return {Roo.Element} this
8901 repaint : function(){
8903 this.addClass("x-repaint");
8904 setTimeout(function(){
8905 Roo.get(dom).removeClass("x-repaint");
8911 * Returns an object with properties top, left, right and bottom representing the margins of this element unless sides is passed,
8912 * then it returns the calculated width of the sides (see getPadding)
8913 * @param {String} sides (optional) Any combination of l, r, t, b to get the sum of those sides
8914 * @return {Object/Number}
8916 getMargins : function(side){
8919 top: parseInt(this.getStyle("margin-top"), 10) || 0,
8920 left: parseInt(this.getStyle("margin-left"), 10) || 0,
8921 bottom: parseInt(this.getStyle("margin-bottom"), 10) || 0,
8922 right: parseInt(this.getStyle("margin-right"), 10) || 0
8925 return this.addStyles(side, El.margins);
8930 addStyles : function(sides, styles){
8932 for(var i = 0, len = sides.length; i < len; i++){
8933 v = this.getStyle(styles[sides.charAt(i)]);
8935 w = parseInt(v, 10);
8943 * Creates a proxy element of this element
8944 * @param {String/Object} config The class name of the proxy element or a DomHelper config object
8945 * @param {String/HTMLElement} renderTo (optional) The element or element id to render the proxy to (defaults to document.body)
8946 * @param {Boolean} matchBox (optional) True to align and size the proxy to this element now (defaults to false)
8947 * @return {Roo.Element} The new proxy element
8949 createProxy : function(config, renderTo, matchBox){
8951 renderTo = Roo.getDom(renderTo);
8953 renderTo = document.body;
8955 config = typeof config == "object" ?
8956 config : {tag : "div", cls: config};
8957 var proxy = Roo.DomHelper.append(renderTo, config, true);
8959 proxy.setBox(this.getBox());
8965 * Puts a mask over this element to disable user interaction. Requires core.css.
8966 * This method can only be applied to elements which accept child nodes.
8967 * @param {String} msg (optional) A message to display in the mask
8968 * @param {String} msgCls (optional) A css class to apply to the msg element
8969 * @return {Element} The mask element
8971 mask : function(msg, msgCls)
8973 if(this.getStyle("position") == "static" && this.dom.tagName !== 'BODY'){
8974 this.setStyle("position", "relative");
8977 this._mask = Roo.DomHelper.append(this.dom, {cls:"roo-el-mask"}, true);
8979 this.addClass("x-masked");
8980 this._mask.setDisplayed(true);
8985 while (dom && dom.style) {
8986 if (!isNaN(parseInt(dom.style.zIndex))) {
8987 z = Math.max(z, parseInt(dom.style.zIndex));
8989 dom = dom.parentNode;
8991 // if we are masking the body - then it hides everything..
8992 if (this.dom == document.body) {
8994 this._mask.setWidth(Roo.lib.Dom.getDocumentWidth());
8995 this._mask.setHeight(Roo.lib.Dom.getDocumentHeight());
8998 if(typeof msg == 'string'){
9000 this._maskMsg = Roo.DomHelper.append(this.dom, {cls:"roo-el-mask-msg", cn:{tag:'div'}}, true);
9002 var mm = this._maskMsg;
9003 mm.dom.className = msgCls ? "roo-el-mask-msg " + msgCls : "roo-el-mask-msg";
9004 mm.dom.firstChild.innerHTML = msg;
9005 mm.setDisplayed(true);
9007 mm.setStyle('z-index', z + 102);
9009 if(Roo.isIE && !(Roo.isIE7 && Roo.isStrict) && this.getStyle('height') == 'auto'){ // ie will not expand full height automatically
9010 this._mask.setHeight(this.getHeight());
9012 this._mask.setStyle('z-index', z + 100);
9018 * Removes a previously applied mask. If removeEl is true the mask overlay is destroyed, otherwise
9019 * it is cached for reuse.
9021 unmask : function(removeEl){
9023 if(removeEl === true){
9024 this._mask.remove();
9027 this._maskMsg.remove();
9028 delete this._maskMsg;
9031 this._mask.setDisplayed(false);
9033 this._maskMsg.setDisplayed(false);
9037 this.removeClass("x-masked");
9041 * Returns true if this element is masked
9044 isMasked : function(){
9045 return this._mask && this._mask.isVisible();
9049 * Creates an iframe shim for this element to keep selects and other windowed objects from
9051 * @return {Roo.Element} The new shim element
9053 createShim : function(){
9054 var el = document.createElement('iframe');
9055 el.frameBorder = 'no';
9056 el.className = 'roo-shim';
9057 if(Roo.isIE && Roo.isSecure){
9058 el.src = Roo.SSL_SECURE_URL;
9060 var shim = Roo.get(this.dom.parentNode.insertBefore(el, this.dom));
9061 shim.autoBoxAdjust = false;
9066 * Removes this element from the DOM and deletes it from the cache
9068 remove : function(){
9069 if(this.dom.parentNode){
9070 this.dom.parentNode.removeChild(this.dom);
9072 delete El.cache[this.dom.id];
9076 * Sets up event handlers to add and remove a css class when the mouse is over this element
9077 * @param {String} className
9078 * @param {Boolean} preventFlicker (optional) If set to true, it prevents flickering by filtering
9079 * mouseout events for children elements
9080 * @return {Roo.Element} this
9082 addClassOnOver : function(className, preventFlicker){
9083 this.on("mouseover", function(){
9084 Roo.fly(this, '_internal').addClass(className);
9086 var removeFn = function(e){
9087 if(preventFlicker !== true || !e.within(this, true)){
9088 Roo.fly(this, '_internal').removeClass(className);
9091 this.on("mouseout", removeFn, this.dom);
9096 * Sets up event handlers to add and remove a css class when this element has the focus
9097 * @param {String} className
9098 * @return {Roo.Element} this
9100 addClassOnFocus : function(className){
9101 this.on("focus", function(){
9102 Roo.fly(this, '_internal').addClass(className);
9104 this.on("blur", function(){
9105 Roo.fly(this, '_internal').removeClass(className);
9110 * 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)
9111 * @param {String} className
9112 * @return {Roo.Element} this
9114 addClassOnClick : function(className){
9116 this.on("mousedown", function(){
9117 Roo.fly(dom, '_internal').addClass(className);
9118 var d = Roo.get(document);
9119 var fn = function(){
9120 Roo.fly(dom, '_internal').removeClass(className);
9121 d.removeListener("mouseup", fn);
9123 d.on("mouseup", fn);
9129 * Stops the specified event from bubbling and optionally prevents the default action
9130 * @param {String} eventName
9131 * @param {Boolean} preventDefault (optional) true to prevent the default action too
9132 * @return {Roo.Element} this
9134 swallowEvent : function(eventName, preventDefault){
9135 var fn = function(e){
9136 e.stopPropagation();
9141 if(eventName instanceof Array){
9142 for(var i = 0, len = eventName.length; i < len; i++){
9143 this.on(eventName[i], fn);
9147 this.on(eventName, fn);
9154 fitToParentDelegate : Roo.emptyFn, // keep a reference to the fitToParent delegate
9157 * Sizes this element to its parent element's dimensions performing
9158 * neccessary box adjustments.
9159 * @param {Boolean} monitorResize (optional) If true maintains the fit when the browser window is resized.
9160 * @param {String/HTMLElment/Element} targetParent (optional) The target parent, default to the parentNode.
9161 * @return {Roo.Element} this
9163 fitToParent : function(monitorResize, targetParent) {
9164 Roo.EventManager.removeResizeListener(this.fitToParentDelegate); // always remove previous fitToParent delegate from onWindowResize
9165 this.fitToParentDelegate = Roo.emptyFn; // remove reference to previous delegate
9166 if (monitorResize === true && !this.dom.parentNode) { // check if this Element still exists
9169 var p = Roo.get(targetParent || this.dom.parentNode);
9170 this.setSize(p.getComputedWidth() - p.getFrameWidth('lr'), p.getComputedHeight() - p.getFrameWidth('tb'));
9171 if (monitorResize === true) {
9172 this.fitToParentDelegate = this.fitToParent.createDelegate(this, [true, targetParent]);
9173 Roo.EventManager.onWindowResize(this.fitToParentDelegate);
9179 * Gets the next sibling, skipping text nodes
9180 * @return {HTMLElement} The next sibling or null
9182 getNextSibling : function(){
9183 var n = this.dom.nextSibling;
9184 while(n && n.nodeType != 1){
9191 * Gets the previous sibling, skipping text nodes
9192 * @return {HTMLElement} The previous sibling or null
9194 getPrevSibling : function(){
9195 var n = this.dom.previousSibling;
9196 while(n && n.nodeType != 1){
9197 n = n.previousSibling;
9204 * Appends the passed element(s) to this element
9205 * @param {String/HTMLElement/Array/Element/CompositeElement} el
9206 * @return {Roo.Element} this
9208 appendChild: function(el){
9215 * Creates the passed DomHelper config and appends it to this element or optionally inserts it before the passed child element.
9216 * @param {Object} config DomHelper element config object. If no tag is specified (e.g., {tag:'input'}) then a div will be
9217 * automatically generated with the specified attributes.
9218 * @param {HTMLElement} insertBefore (optional) a child element of this element
9219 * @param {Boolean} returnDom (optional) true to return the dom node instead of creating an Element
9220 * @return {Roo.Element} The new child element
9222 createChild: function(config, insertBefore, returnDom){
9223 config = config || {tag:'div'};
9225 return Roo.DomHelper.insertBefore(insertBefore, config, returnDom !== true);
9227 return Roo.DomHelper[!this.dom.firstChild ? 'overwrite' : 'append'](this.dom, config, returnDom !== true);
9231 * Appends this element to the passed element
9232 * @param {String/HTMLElement/Element} el The new parent element
9233 * @return {Roo.Element} this
9235 appendTo: function(el){
9236 el = Roo.getDom(el);
9237 el.appendChild(this.dom);
9242 * Inserts this element before the passed element in the DOM
9243 * @param {String/HTMLElement/Element} el The element to insert before
9244 * @return {Roo.Element} this
9246 insertBefore: function(el){
9247 el = Roo.getDom(el);
9248 el.parentNode.insertBefore(this.dom, el);
9253 * Inserts this element after the passed element in the DOM
9254 * @param {String/HTMLElement/Element} el The element to insert after
9255 * @return {Roo.Element} this
9257 insertAfter: function(el){
9258 el = Roo.getDom(el);
9259 el.parentNode.insertBefore(this.dom, el.nextSibling);
9264 * Inserts (or creates) an element (or DomHelper config) as the first child of the this element
9265 * @param {String/HTMLElement/Element/Object} el The id or element to insert or a DomHelper config to create and insert
9266 * @return {Roo.Element} The new child
9268 insertFirst: function(el, returnDom){
9270 if(typeof el == 'object' && !el.nodeType){ // dh config
9271 return this.createChild(el, this.dom.firstChild, returnDom);
9273 el = Roo.getDom(el);
9274 this.dom.insertBefore(el, this.dom.firstChild);
9275 return !returnDom ? Roo.get(el) : el;
9280 * Inserts (or creates) the passed element (or DomHelper config) as a sibling of this element
9281 * @param {String/HTMLElement/Element/Object} el The id or element to insert or a DomHelper config to create and insert
9282 * @param {String} where (optional) 'before' or 'after' defaults to before
9283 * @param {Boolean} returnDom (optional) True to return the raw DOM element instead of Roo.Element
9284 * @return {Roo.Element} the inserted Element
9286 insertSibling: function(el, where, returnDom){
9287 where = where ? where.toLowerCase() : 'before';
9289 var rt, refNode = where == 'before' ? this.dom : this.dom.nextSibling;
9291 if(typeof el == 'object' && !el.nodeType){ // dh config
9292 if(where == 'after' && !this.dom.nextSibling){
9293 rt = Roo.DomHelper.append(this.dom.parentNode, el, !returnDom);
9295 rt = Roo.DomHelper[where == 'after' ? 'insertAfter' : 'insertBefore'](this.dom, el, !returnDom);
9299 rt = this.dom.parentNode.insertBefore(Roo.getDom(el),
9300 where == 'before' ? this.dom : this.dom.nextSibling);
9309 * Creates and wraps this element with another element
9310 * @param {Object} config (optional) DomHelper element config object for the wrapper element or null for an empty div
9311 * @param {Boolean} returnDom (optional) True to return the raw DOM element instead of Roo.Element
9312 * @return {HTMLElement/Element} The newly created wrapper element
9314 wrap: function(config, returnDom){
9316 config = {tag: "div"};
9318 var newEl = Roo.DomHelper.insertBefore(this.dom, config, !returnDom);
9319 newEl.dom ? newEl.dom.appendChild(this.dom) : newEl.appendChild(this.dom);
9324 * Replaces the passed element with this element
9325 * @param {String/HTMLElement/Element} el The element to replace
9326 * @return {Roo.Element} this
9328 replace: function(el){
9330 this.insertBefore(el);
9336 * Inserts an html fragment into this element
9337 * @param {String} where Where to insert the html in relation to the this element - beforeBegin, afterBegin, beforeEnd, afterEnd.
9338 * @param {String} html The HTML fragment
9339 * @param {Boolean} returnEl True to return an Roo.Element
9340 * @return {HTMLElement/Roo.Element} The inserted node (or nearest related if more than 1 inserted)
9342 insertHtml : function(where, html, returnEl){
9343 var el = Roo.DomHelper.insertHtml(where, this.dom, html);
9344 return returnEl ? Roo.get(el) : el;
9348 * Sets the passed attributes as attributes of this element (a style attribute can be a string, object or function)
9349 * @param {Object} o The object with the attributes
9350 * @param {Boolean} useSet (optional) false to override the default setAttribute to use expandos.
9351 * @return {Roo.Element} this
9353 set : function(o, useSet){
9355 useSet = typeof useSet == 'undefined' ? (el.setAttribute ? true : false) : useSet;
9357 if(attr == "style" || typeof o[attr] == "function") continue;
9359 el.className = o["cls"];
9361 if(useSet) el.setAttribute(attr, o[attr]);
9362 else el[attr] = o[attr];
9366 Roo.DomHelper.applyStyles(el, o.style);
9372 * Convenience method for constructing a KeyMap
9373 * @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:
9374 * {key: (number or array), shift: (true/false), ctrl: (true/false), alt: (true/false)}
9375 * @param {Function} fn The function to call
9376 * @param {Object} scope (optional) The scope of the function
9377 * @return {Roo.KeyMap} The KeyMap created
9379 addKeyListener : function(key, fn, scope){
9381 if(typeof key != "object" || key instanceof Array){
9397 return new Roo.KeyMap(this, config);
9401 * Creates a KeyMap for this element
9402 * @param {Object} config The KeyMap config. See {@link Roo.KeyMap} for more details
9403 * @return {Roo.KeyMap} The KeyMap created
9405 addKeyMap : function(config){
9406 return new Roo.KeyMap(this, config);
9410 * Returns true if this element is scrollable.
9413 isScrollable : function(){
9415 return dom.scrollHeight > dom.clientHeight || dom.scrollWidth > dom.clientWidth;
9419 * 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().
9420 * @param {String} side Either "left" for scrollLeft values or "top" for scrollTop values.
9421 * @param {Number} value The new scroll value
9422 * @param {Boolean/Object} animate (optional) true for the default animation or a standard Element animation config object
9423 * @return {Element} this
9426 scrollTo : function(side, value, animate){
9427 var prop = side.toLowerCase() == "left" ? "scrollLeft" : "scrollTop";
9429 this.dom[prop] = value;
9431 var to = prop == "scrollLeft" ? [value, this.dom.scrollTop] : [this.dom.scrollLeft, value];
9432 this.anim({scroll: {"to": to}}, this.preanim(arguments, 2), 'scroll');
9438 * Scrolls this element the specified direction. Does bounds checking to make sure the scroll is
9439 * within this element's scrollable range.
9440 * @param {String} direction Possible values are: "l","left" - "r","right" - "t","top","up" - "b","bottom","down".
9441 * @param {Number} distance How far to scroll the element in pixels
9442 * @param {Boolean/Object} animate (optional) true for the default animation or a standard Element animation config object
9443 * @return {Boolean} Returns true if a scroll was triggered or false if the element
9444 * was scrolled as far as it could go.
9446 scroll : function(direction, distance, animate){
9447 if(!this.isScrollable()){
9451 var l = el.scrollLeft, t = el.scrollTop;
9452 var w = el.scrollWidth, h = el.scrollHeight;
9453 var cw = el.clientWidth, ch = el.clientHeight;
9454 direction = direction.toLowerCase();
9455 var scrolled = false;
9456 var a = this.preanim(arguments, 2);
9461 var v = Math.min(l + distance, w-cw);
9462 this.scrollTo("left", v, a);
9469 var v = Math.max(l - distance, 0);
9470 this.scrollTo("left", v, a);
9478 var v = Math.max(t - distance, 0);
9479 this.scrollTo("top", v, a);
9487 var v = Math.min(t + distance, h-ch);
9488 this.scrollTo("top", v, a);
9497 * Translates the passed page coordinates into left/top css values for this element
9498 * @param {Number/Array} x The page x or an array containing [x, y]
9499 * @param {Number} y The page y
9500 * @return {Object} An object with left and top properties. e.g. {left: (value), top: (value)}
9502 translatePoints : function(x, y){
9503 if(typeof x == 'object' || x instanceof Array){
9506 var p = this.getStyle('position');
9507 var o = this.getXY();
9509 var l = parseInt(this.getStyle('left'), 10);
9510 var t = parseInt(this.getStyle('top'), 10);
9513 l = (p == "relative") ? 0 : this.dom.offsetLeft;
9516 t = (p == "relative") ? 0 : this.dom.offsetTop;
9519 return {left: (x - o[0] + l), top: (y - o[1] + t)};
9523 * Returns the current scroll position of the element.
9524 * @return {Object} An object containing the scroll position in the format {left: (scrollLeft), top: (scrollTop)}
9526 getScroll : function(){
9527 var d = this.dom, doc = document;
9528 if(d == doc || d == doc.body){
9529 var l = window.pageXOffset || doc.documentElement.scrollLeft || doc.body.scrollLeft || 0;
9530 var t = window.pageYOffset || doc.documentElement.scrollTop || doc.body.scrollTop || 0;
9531 return {left: l, top: t};
9533 return {left: d.scrollLeft, top: d.scrollTop};
9538 * Return the CSS color for the specified CSS attribute. rgb, 3 digit (like #fff) and valid values
9539 * are convert to standard 6 digit hex color.
9540 * @param {String} attr The css attribute
9541 * @param {String} defaultValue The default value to use when a valid color isn't found
9542 * @param {String} prefix (optional) defaults to #. Use an empty string when working with
9545 getColor : function(attr, defaultValue, prefix){
9546 var v = this.getStyle(attr);
9547 if(!v || v == "transparent" || v == "inherit") {
9548 return defaultValue;
9550 var color = typeof prefix == "undefined" ? "#" : prefix;
9551 if(v.substr(0, 4) == "rgb("){
9552 var rvs = v.slice(4, v.length -1).split(",");
9553 for(var i = 0; i < 3; i++){
9554 var h = parseInt(rvs[i]).toString(16);
9561 if(v.substr(0, 1) == "#"){
9563 for(var i = 1; i < 4; i++){
9564 var c = v.charAt(i);
9567 }else if(v.length == 7){
9568 color += v.substr(1);
9572 return(color.length > 5 ? color.toLowerCase() : defaultValue);
9576 * Wraps the specified element with a special markup/CSS block that renders by default as a gray container with a
9577 * gradient background, rounded corners and a 4-way shadow.
9578 * @param {String} class (optional) A base CSS class to apply to the containing wrapper element (defaults to 'x-box').
9579 * Note that there are a number of CSS rules that are dependent on this name to make the overall effect work,
9580 * so if you supply an alternate base class, make sure you also supply all of the necessary rules.
9581 * @return {Roo.Element} this
9583 boxWrap : function(cls){
9584 cls = cls || 'x-box';
9585 var el = Roo.get(this.insertHtml('beforeBegin', String.format('<div class="{0}">'+El.boxMarkup+'</div>', cls)));
9586 el.child('.'+cls+'-mc').dom.appendChild(this.dom);
9591 * Returns the value of a namespaced attribute from the element's underlying DOM node.
9592 * @param {String} namespace The namespace in which to look for the attribute
9593 * @param {String} name The attribute name
9594 * @return {String} The attribute value
9596 getAttributeNS : Roo.isIE ? function(ns, name){
9598 var type = typeof d[ns+":"+name];
9599 if(type != 'undefined' && type != 'unknown'){
9600 return d[ns+":"+name];
9603 } : function(ns, name){
9605 return d.getAttributeNS(ns, name) || d.getAttribute(ns+":"+name) || d.getAttribute(name) || d[name];
9610 * Sets or Returns the value the dom attribute value
9611 * @param {String|Object} name The attribute name (or object to set multiple attributes)
9612 * @param {String} value (optional) The value to set the attribute to
9613 * @return {String} The attribute value
9615 attr : function(name){
9616 if (arguments.length > 1) {
9617 this.dom.setAttribute(name, arguments[1]);
9618 return arguments[1];
9620 if (typeof(name) == 'object') {
9621 for(var i in name) {
9622 this.attr(i, name[i]);
9628 if (!this.dom.hasAttribute(name)) {
9631 return this.dom.getAttribute(name);
9638 var ep = El.prototype;
9641 * Appends an event handler (Shorthand for addListener)
9642 * @param {String} eventName The type of event to append
9643 * @param {Function} fn The method the event invokes
9644 * @param {Object} scope (optional) The scope (this object) of the fn
9645 * @param {Object} options (optional)An object with standard {@link Roo.EventManager#addListener} options
9648 ep.on = ep.addListener;
9650 ep.mon = ep.addListener;
9653 * Removes an event handler from this element (shorthand for removeListener)
9654 * @param {String} eventName the type of event to remove
9655 * @param {Function} fn the method the event invokes
9656 * @return {Roo.Element} this
9659 ep.un = ep.removeListener;
9662 * true to automatically adjust width and height settings for box-model issues (default to true)
9664 ep.autoBoxAdjust = true;
9667 El.unitPattern = /\d+(px|em|%|en|ex|pt|in|cm|mm|pc)$/i;
9670 El.addUnits = function(v, defaultUnit){
9671 if(v === "" || v == "auto"){
9674 if(v === undefined){
9677 if(typeof v == "number" || !El.unitPattern.test(v)){
9678 return v + (defaultUnit || 'px');
9683 // special markup used throughout Roo when box wrapping elements
9684 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>';
9686 * Visibility mode constant - Use visibility to hide element
9692 * Visibility mode constant - Use display to hide element
9698 El.borders = {l: "border-left-width", r: "border-right-width", t: "border-top-width", b: "border-bottom-width"};
9699 El.paddings = {l: "padding-left", r: "padding-right", t: "padding-top", b: "padding-bottom"};
9700 El.margins = {l: "margin-left", r: "margin-right", t: "margin-top", b: "margin-bottom"};
9712 * Static method to retrieve Element objects. Uses simple caching to consistently return the same object.
9713 * Automatically fixes if an object was recreated with the same id via AJAX or DOM.
9714 * @param {String/HTMLElement/Element} el The id of the node, a DOM Node or an existing Element.
9715 * @return {Element} The Element object
9718 El.get = function(el){
9720 if(!el){ return null; }
9721 if(typeof el == "string"){ // element id
9722 if(!(elm = document.getElementById(el))){
9725 if(ex = El.cache[el]){
9728 ex = El.cache[el] = new El(elm);
9731 }else if(el.tagName){ // dom element
9735 if(ex = El.cache[id]){
9738 ex = El.cache[id] = new El(el);
9741 }else if(el instanceof El){
9743 el.dom = document.getElementById(el.id) || el.dom; // refresh dom element in case no longer valid,
9744 // catch case where it hasn't been appended
9745 El.cache[el.id] = el; // in case it was created directly with Element(), let's cache it
9748 }else if(el.isComposite){
9750 }else if(el instanceof Array){
9751 return El.select(el);
9752 }else if(el == document){
9753 // create a bogus element object representing the document object
9755 var f = function(){};
9756 f.prototype = El.prototype;
9758 docEl.dom = document;
9766 El.uncache = function(el){
9767 for(var i = 0, a = arguments, len = a.length; i < len; i++) {
9769 delete El.cache[a[i].id || a[i]];
9775 // Garbage collection - uncache elements/purge listeners on orphaned elements
9776 // so we don't hold a reference and cause the browser to retain them
9777 El.garbageCollect = function(){
9778 if(!Roo.enableGarbageCollector){
9779 clearInterval(El.collectorThread);
9782 for(var eid in El.cache){
9783 var el = El.cache[eid], d = el.dom;
9784 // -------------------------------------------------------
9785 // Determining what is garbage:
9786 // -------------------------------------------------------
9788 // dom node is null, definitely garbage
9789 // -------------------------------------------------------
9791 // no parentNode == direct orphan, definitely garbage
9792 // -------------------------------------------------------
9793 // !d.offsetParent && !document.getElementById(eid)
9794 // display none elements have no offsetParent so we will
9795 // also try to look it up by it's id. However, check
9796 // offsetParent first so we don't do unneeded lookups.
9797 // This enables collection of elements that are not orphans
9798 // directly, but somewhere up the line they have an orphan
9800 // -------------------------------------------------------
9801 if(!d || !d.parentNode || (!d.offsetParent && !document.getElementById(eid))){
9802 delete El.cache[eid];
9803 if(d && Roo.enableListenerCollection){
9809 El.collectorThreadId = setInterval(El.garbageCollect, 30000);
9813 El.Flyweight = function(dom){
9816 El.Flyweight.prototype = El.prototype;
9818 El._flyweights = {};
9820 * Gets the globally shared flyweight Element, with the passed node as the active element. Do not store a reference to this element -
9821 * the dom node can be overwritten by other code.
9822 * @param {String/HTMLElement} el The dom node or id
9823 * @param {String} named (optional) Allows for creation of named reusable flyweights to
9824 * prevent conflicts (e.g. internally Roo uses "_internal")
9826 * @return {Element} The shared Element object
9828 El.fly = function(el, named){
9829 named = named || '_global';
9830 el = Roo.getDom(el);
9834 if(!El._flyweights[named]){
9835 El._flyweights[named] = new El.Flyweight();
9837 El._flyweights[named].dom = el;
9838 return El._flyweights[named];
9842 * Static method to retrieve Element objects. Uses simple caching to consistently return the same object.
9843 * Automatically fixes if an object was recreated with the same id via AJAX or DOM.
9844 * Shorthand of {@link Roo.Element#get}
9845 * @param {String/HTMLElement/Element} el The id of the node, a DOM Node or an existing Element.
9846 * @return {Element} The Element object
9852 * Gets the globally shared flyweight Element, with the passed node as the active element. Do not store a reference to this element -
9853 * the dom node can be overwritten by other code.
9854 * Shorthand of {@link Roo.Element#fly}
9855 * @param {String/HTMLElement} el The dom node or id
9856 * @param {String} named (optional) Allows for creation of named reusable flyweights to
9857 * prevent conflicts (e.g. internally Roo uses "_internal")
9859 * @return {Element} The shared Element object
9865 // speedy lookup for elements never to box adjust
9866 var noBoxAdjust = Roo.isStrict ? {
9869 input:1, select:1, textarea:1
9871 if(Roo.isIE || Roo.isGecko){
9872 noBoxAdjust['button'] = 1;
9876 Roo.EventManager.on(window, 'unload', function(){
9878 delete El._flyweights;
9886 Roo.Element.selectorFunction = Roo.DomQuery.select;
9889 Roo.Element.select = function(selector, unique, root){
9891 if(typeof selector == "string"){
9892 els = Roo.Element.selectorFunction(selector, root);
9893 }else if(selector.length !== undefined){
9896 throw "Invalid selector";
9898 if(unique === true){
9899 return new Roo.CompositeElement(els);
9901 return new Roo.CompositeElementLite(els);
9905 * Selects elements based on the passed CSS selector to enable working on them as 1.
9906 * @param {String/Array} selector The CSS selector or an array of elements
9907 * @param {Boolean} unique (optional) true to create a unique Roo.Element for each element (defaults to a shared flyweight object)
9908 * @param {HTMLElement/String} root (optional) The root element of the query or id of the root
9909 * @return {CompositeElementLite/CompositeElement}
9913 Roo.select = Roo.Element.select;
9930 * Ext JS Library 1.1.1
9931 * Copyright(c) 2006-2007, Ext JS, LLC.
9933 * Originally Released Under LGPL - original licence link has changed is not relivant.
9936 * <script type="text/javascript">
9941 //Notifies Element that fx methods are available
9942 Roo.enableFx = true;
9946 * <p>A class to provide basic animation and visual effects support. <b>Note:</b> This class is automatically applied
9947 * to the {@link Roo.Element} interface when included, so all effects calls should be performed via Element.
9948 * Conversely, since the effects are not actually defined in Element, Roo.Fx <b>must</b> be included in order for the
9949 * Element effects to work.</p><br/>
9951 * <p>It is important to note that although the Fx methods and many non-Fx Element methods support "method chaining" in that
9952 * they return the Element object itself as the method return value, it is not always possible to mix the two in a single
9953 * method chain. The Fx methods use an internal effects queue so that each effect can be properly timed and sequenced.
9954 * Non-Fx methods, on the other hand, have no such internal queueing and will always execute immediately. For this reason,
9955 * while it may be possible to mix certain Fx and non-Fx method calls in a single chain, it may not always provide the
9956 * expected results and should be done with care.</p><br/>
9958 * <p>Motion effects support 8-way anchoring, meaning that you can choose one of 8 different anchor points on the Element
9959 * that will serve as either the start or end point of the animation. Following are all of the supported anchor positions:</p>
9962 ----- -----------------------------
9963 tl The top left corner
9964 t The center of the top edge
9965 tr The top right corner
9966 l The center of the left edge
9967 r The center of the right edge
9968 bl The bottom left corner
9969 b The center of the bottom edge
9970 br The bottom right corner
9972 * <b>Although some Fx methods accept specific custom config parameters, the ones shown in the Config Options section
9973 * below are common options that can be passed to any Fx method.</b>
9974 * @cfg {Function} callback A function called when the effect is finished
9975 * @cfg {Object} scope The scope of the effect function
9976 * @cfg {String} easing A valid Easing value for the effect
9977 * @cfg {String} afterCls A css class to apply after the effect
9978 * @cfg {Number} duration The length of time (in seconds) that the effect should last
9979 * @cfg {Boolean} remove Whether the Element should be removed from the DOM and destroyed after the effect finishes
9980 * @cfg {Boolean} useDisplay Whether to use the <i>display</i> CSS property instead of <i>visibility</i> when hiding Elements (only applies to
9981 * effects that end with the element being visually hidden, ignored otherwise)
9982 * @cfg {String/Object/Function} afterStyle A style specification string, e.g. "width:100px", or an object in the form {width:"100px"}, or
9983 * a function which returns such a specification that will be applied to the Element after the effect finishes
9984 * @cfg {Boolean} block Whether the effect should block other effects from queueing while it runs
9985 * @cfg {Boolean} concurrent Whether to allow subsequently-queued effects to run at the same time as the current effect, or to ensure that they run in sequence
9986 * @cfg {Boolean} stopFx Whether subsequent effects should be stopped and removed after the current effect finishes
9990 * Slides the element into view. An anchor point can be optionally passed to set the point of
9991 * origin for the slide effect. This function automatically handles wrapping the element with
9992 * a fixed-size container if needed. See the Fx class overview for valid anchor point options.
9995 // default: slide the element in from the top
9998 // custom: slide the element in from the right with a 2-second duration
9999 el.slideIn('r', { duration: 2 });
10001 // common config options shown with default values
10007 * @param {String} anchor (optional) One of the valid Fx anchor positions (defaults to top: 't')
10008 * @param {Object} options (optional) Object literal with any of the Fx config options
10009 * @return {Roo.Element} The Element
10011 slideIn : function(anchor, o){
10012 var el = this.getFxEl();
10015 el.queueFx(o, function(){
10017 anchor = anchor || "t";
10019 // fix display to visibility
10022 // restore values after effect
10023 var r = this.getFxRestore();
10024 var b = this.getBox();
10025 // fixed size for slide
10029 var wrap = this.fxWrap(r.pos, o, "hidden");
10031 var st = this.dom.style;
10032 st.visibility = "visible";
10033 st.position = "absolute";
10035 // clear out temp styles after slide and unwrap
10036 var after = function(){
10037 el.fxUnwrap(wrap, r.pos, o);
10038 st.width = r.width;
10039 st.height = r.height;
10042 // time to calc the positions
10043 var a, pt = {to: [b.x, b.y]}, bw = {to: b.width}, bh = {to: b.height};
10045 switch(anchor.toLowerCase()){
10047 wrap.setSize(b.width, 0);
10048 st.left = st.bottom = "0";
10052 wrap.setSize(0, b.height);
10053 st.right = st.top = "0";
10057 wrap.setSize(0, b.height);
10058 wrap.setX(b.right);
10059 st.left = st.top = "0";
10060 a = {width: bw, points: pt};
10063 wrap.setSize(b.width, 0);
10064 wrap.setY(b.bottom);
10065 st.left = st.top = "0";
10066 a = {height: bh, points: pt};
10069 wrap.setSize(0, 0);
10070 st.right = st.bottom = "0";
10071 a = {width: bw, height: bh};
10074 wrap.setSize(0, 0);
10075 wrap.setY(b.y+b.height);
10076 st.right = st.top = "0";
10077 a = {width: bw, height: bh, points: pt};
10080 wrap.setSize(0, 0);
10081 wrap.setXY([b.right, b.bottom]);
10082 st.left = st.top = "0";
10083 a = {width: bw, height: bh, points: pt};
10086 wrap.setSize(0, 0);
10087 wrap.setX(b.x+b.width);
10088 st.left = st.bottom = "0";
10089 a = {width: bw, height: bh, points: pt};
10092 this.dom.style.visibility = "visible";
10095 arguments.callee.anim = wrap.fxanim(a,
10105 * Slides the element out of view. An anchor point can be optionally passed to set the end point
10106 * for the slide effect. When the effect is completed, the element will be hidden (visibility =
10107 * 'hidden') but block elements will still take up space in the document. The element must be removed
10108 * from the DOM using the 'remove' config option if desired. This function automatically handles
10109 * wrapping the element with a fixed-size container if needed. See the Fx class overview for valid anchor point options.
10112 // default: slide the element out to the top
10115 // custom: slide the element out to the right with a 2-second duration
10116 el.slideOut('r', { duration: 2 });
10118 // common config options shown with default values
10126 * @param {String} anchor (optional) One of the valid Fx anchor positions (defaults to top: 't')
10127 * @param {Object} options (optional) Object literal with any of the Fx config options
10128 * @return {Roo.Element} The Element
10130 slideOut : function(anchor, o){
10131 var el = this.getFxEl();
10134 el.queueFx(o, function(){
10136 anchor = anchor || "t";
10138 // restore values after effect
10139 var r = this.getFxRestore();
10141 var b = this.getBox();
10142 // fixed size for slide
10146 var wrap = this.fxWrap(r.pos, o, "visible");
10148 var st = this.dom.style;
10149 st.visibility = "visible";
10150 st.position = "absolute";
10154 var after = function(){
10156 el.setDisplayed(false);
10161 el.fxUnwrap(wrap, r.pos, o);
10163 st.width = r.width;
10164 st.height = r.height;
10169 var a, zero = {to: 0};
10170 switch(anchor.toLowerCase()){
10172 st.left = st.bottom = "0";
10173 a = {height: zero};
10176 st.right = st.top = "0";
10180 st.left = st.top = "0";
10181 a = {width: zero, points: {to:[b.right, b.y]}};
10184 st.left = st.top = "0";
10185 a = {height: zero, points: {to:[b.x, b.bottom]}};
10188 st.right = st.bottom = "0";
10189 a = {width: zero, height: zero};
10192 st.right = st.top = "0";
10193 a = {width: zero, height: zero, points: {to:[b.x, b.bottom]}};
10196 st.left = st.top = "0";
10197 a = {width: zero, height: zero, points: {to:[b.x+b.width, b.bottom]}};
10200 st.left = st.bottom = "0";
10201 a = {width: zero, height: zero, points: {to:[b.right, b.y]}};
10205 arguments.callee.anim = wrap.fxanim(a,
10215 * Fades the element out while slowly expanding it in all directions. When the effect is completed, the
10216 * element will be hidden (visibility = 'hidden') but block elements will still take up space in the document.
10217 * The element must be removed from the DOM using the 'remove' config option if desired.
10223 // common config options shown with default values
10231 * @param {Object} options (optional) Object literal with any of the Fx config options
10232 * @return {Roo.Element} The Element
10234 puff : function(o){
10235 var el = this.getFxEl();
10238 el.queueFx(o, function(){
10239 this.clearOpacity();
10242 // restore values after effect
10243 var r = this.getFxRestore();
10244 var st = this.dom.style;
10246 var after = function(){
10248 el.setDisplayed(false);
10255 el.setPositioning(r.pos);
10256 st.width = r.width;
10257 st.height = r.height;
10262 var width = this.getWidth();
10263 var height = this.getHeight();
10265 arguments.callee.anim = this.fxanim({
10266 width : {to: this.adjustWidth(width * 2)},
10267 height : {to: this.adjustHeight(height * 2)},
10268 points : {by: [-(width * .5), -(height * .5)]},
10270 fontSize: {to:200, unit: "%"}
10281 * Blinks the element as if it was clicked and then collapses on its center (similar to switching off a television).
10282 * When the effect is completed, the element will be hidden (visibility = 'hidden') but block elements will still
10283 * take up space in the document. The element must be removed from the DOM using the 'remove' config option if desired.
10289 // all config options shown with default values
10297 * @param {Object} options (optional) Object literal with any of the Fx config options
10298 * @return {Roo.Element} The Element
10300 switchOff : function(o){
10301 var el = this.getFxEl();
10304 el.queueFx(o, function(){
10305 this.clearOpacity();
10308 // restore values after effect
10309 var r = this.getFxRestore();
10310 var st = this.dom.style;
10312 var after = function(){
10314 el.setDisplayed(false);
10320 el.setPositioning(r.pos);
10321 st.width = r.width;
10322 st.height = r.height;
10327 this.fxanim({opacity:{to:0.3}}, null, null, .1, null, function(){
10328 this.clearOpacity();
10332 points:{by:[0, this.getHeight() * .5]}
10333 }, o, 'motion', 0.3, 'easeIn', after);
10334 }).defer(100, this);
10341 * Highlights the Element by setting a color (applies to the background-color by default, but can be
10342 * changed using the "attr" config option) and then fading back to the original color. If no original
10343 * color is available, you should provide the "endColor" config option which will be cleared after the animation.
10346 // default: highlight background to yellow
10349 // custom: highlight foreground text to blue for 2 seconds
10350 el.highlight("0000ff", { attr: 'color', duration: 2 });
10352 // common config options shown with default values
10353 el.highlight("ffff9c", {
10354 attr: "background-color", //can be any valid CSS property (attribute) that supports a color value
10355 endColor: (current color) or "ffffff",
10360 * @param {String} color (optional) The highlight color. Should be a 6 char hex color without the leading # (defaults to yellow: 'ffff9c')
10361 * @param {Object} options (optional) Object literal with any of the Fx config options
10362 * @return {Roo.Element} The Element
10364 highlight : function(color, o){
10365 var el = this.getFxEl();
10368 el.queueFx(o, function(){
10369 color = color || "ffff9c";
10370 attr = o.attr || "backgroundColor";
10372 this.clearOpacity();
10375 var origColor = this.getColor(attr);
10376 var restoreColor = this.dom.style[attr];
10377 endColor = (o.endColor || origColor) || "ffffff";
10379 var after = function(){
10380 el.dom.style[attr] = restoreColor;
10385 a[attr] = {from: color, to: endColor};
10386 arguments.callee.anim = this.fxanim(a,
10396 * Shows a ripple of exploding, attenuating borders to draw attention to an Element.
10399 // default: a single light blue ripple
10402 // custom: 3 red ripples lasting 3 seconds total
10403 el.frame("ff0000", 3, { duration: 3 });
10405 // common config options shown with default values
10406 el.frame("C3DAF9", 1, {
10407 duration: 1 //duration of entire animation (not each individual ripple)
10408 // Note: Easing is not configurable and will be ignored if included
10411 * @param {String} color (optional) The color of the border. Should be a 6 char hex color without the leading # (defaults to light blue: 'C3DAF9').
10412 * @param {Number} count (optional) The number of ripples to display (defaults to 1)
10413 * @param {Object} options (optional) Object literal with any of the Fx config options
10414 * @return {Roo.Element} The Element
10416 frame : function(color, count, o){
10417 var el = this.getFxEl();
10420 el.queueFx(o, function(){
10421 color = color || "#C3DAF9";
10422 if(color.length == 6){
10423 color = "#" + color;
10425 count = count || 1;
10426 duration = o.duration || 1;
10429 var b = this.getBox();
10430 var animFn = function(){
10431 var proxy = this.createProxy({
10434 visbility:"hidden",
10435 position:"absolute",
10436 "z-index":"35000", // yee haw
10437 border:"0px solid " + color
10440 var scale = Roo.isBorderBox ? 2 : 1;
10442 top:{from:b.y, to:b.y - 20},
10443 left:{from:b.x, to:b.x - 20},
10444 borderWidth:{from:0, to:10},
10445 opacity:{from:1, to:0},
10446 height:{from:b.height, to:(b.height + (20*scale))},
10447 width:{from:b.width, to:(b.width + (20*scale))}
10448 }, duration, function(){
10452 animFn.defer((duration/2)*1000, this);
10463 * Creates a pause before any subsequent queued effects begin. If there are
10464 * no effects queued after the pause it will have no effect.
10469 * @param {Number} seconds The length of time to pause (in seconds)
10470 * @return {Roo.Element} The Element
10472 pause : function(seconds){
10473 var el = this.getFxEl();
10476 el.queueFx(o, function(){
10477 setTimeout(function(){
10479 }, seconds * 1000);
10485 * Fade an element in (from transparent to opaque). The ending opacity can be specified
10486 * using the "endOpacity" config option.
10489 // default: fade in from opacity 0 to 100%
10492 // custom: fade in from opacity 0 to 75% over 2 seconds
10493 el.fadeIn({ endOpacity: .75, duration: 2});
10495 // common config options shown with default values
10497 endOpacity: 1, //can be any value between 0 and 1 (e.g. .5)
10502 * @param {Object} options (optional) Object literal with any of the Fx config options
10503 * @return {Roo.Element} The Element
10505 fadeIn : function(o){
10506 var el = this.getFxEl();
10508 el.queueFx(o, function(){
10509 this.setOpacity(0);
10511 this.dom.style.visibility = 'visible';
10512 var to = o.endOpacity || 1;
10513 arguments.callee.anim = this.fxanim({opacity:{to:to}},
10514 o, null, .5, "easeOut", function(){
10516 this.clearOpacity();
10525 * Fade an element out (from opaque to transparent). The ending opacity can be specified
10526 * using the "endOpacity" config option.
10529 // default: fade out from the element's current opacity to 0
10532 // custom: fade out from the element's current opacity to 25% over 2 seconds
10533 el.fadeOut({ endOpacity: .25, duration: 2});
10535 // common config options shown with default values
10537 endOpacity: 0, //can be any value between 0 and 1 (e.g. .5)
10544 * @param {Object} options (optional) Object literal with any of the Fx config options
10545 * @return {Roo.Element} The Element
10547 fadeOut : function(o){
10548 var el = this.getFxEl();
10550 el.queueFx(o, function(){
10551 arguments.callee.anim = this.fxanim({opacity:{to:o.endOpacity || 0}},
10552 o, null, .5, "easeOut", function(){
10553 if(this.visibilityMode == Roo.Element.DISPLAY || o.useDisplay){
10554 this.dom.style.display = "none";
10556 this.dom.style.visibility = "hidden";
10558 this.clearOpacity();
10566 * Animates the transition of an element's dimensions from a starting height/width
10567 * to an ending height/width.
10570 // change height and width to 100x100 pixels
10571 el.scale(100, 100);
10573 // common config options shown with default values. The height and width will default to
10574 // the element's existing values if passed as null.
10577 [element's height], {
10582 * @param {Number} width The new width (pass undefined to keep the original width)
10583 * @param {Number} height The new height (pass undefined to keep the original height)
10584 * @param {Object} options (optional) Object literal with any of the Fx config options
10585 * @return {Roo.Element} The Element
10587 scale : function(w, h, o){
10588 this.shift(Roo.apply({}, o, {
10596 * Animates the transition of any combination of an element's dimensions, xy position and/or opacity.
10597 * Any of these properties not specified in the config object will not be changed. This effect
10598 * requires that at least one new dimension, position or opacity setting must be passed in on
10599 * the config object in order for the function to have any effect.
10602 // slide the element horizontally to x position 200 while changing the height and opacity
10603 el.shift({ x: 200, height: 50, opacity: .8 });
10605 // common config options shown with default values.
10607 width: [element's width],
10608 height: [element's height],
10609 x: [element's x position],
10610 y: [element's y position],
10611 opacity: [element's opacity],
10616 * @param {Object} options Object literal with any of the Fx config options
10617 * @return {Roo.Element} The Element
10619 shift : function(o){
10620 var el = this.getFxEl();
10622 el.queueFx(o, function(){
10623 var a = {}, w = o.width, h = o.height, x = o.x, y = o.y, op = o.opacity;
10624 if(w !== undefined){
10625 a.width = {to: this.adjustWidth(w)};
10627 if(h !== undefined){
10628 a.height = {to: this.adjustHeight(h)};
10630 if(x !== undefined || y !== undefined){
10632 x !== undefined ? x : this.getX(),
10633 y !== undefined ? y : this.getY()
10636 if(op !== undefined){
10637 a.opacity = {to: op};
10639 if(o.xy !== undefined){
10640 a.points = {to: o.xy};
10642 arguments.callee.anim = this.fxanim(a,
10643 o, 'motion', .35, "easeOut", function(){
10651 * Slides the element while fading it out of view. An anchor point can be optionally passed to set the
10652 * ending point of the effect.
10655 // default: slide the element downward while fading out
10658 // custom: slide the element out to the right with a 2-second duration
10659 el.ghost('r', { duration: 2 });
10661 // common config options shown with default values
10669 * @param {String} anchor (optional) One of the valid Fx anchor positions (defaults to bottom: 'b')
10670 * @param {Object} options (optional) Object literal with any of the Fx config options
10671 * @return {Roo.Element} The Element
10673 ghost : function(anchor, o){
10674 var el = this.getFxEl();
10677 el.queueFx(o, function(){
10678 anchor = anchor || "b";
10680 // restore values after effect
10681 var r = this.getFxRestore();
10682 var w = this.getWidth(),
10683 h = this.getHeight();
10685 var st = this.dom.style;
10687 var after = function(){
10689 el.setDisplayed(false);
10695 el.setPositioning(r.pos);
10696 st.width = r.width;
10697 st.height = r.height;
10702 var a = {opacity: {to: 0}, points: {}}, pt = a.points;
10703 switch(anchor.toLowerCase()){
10730 arguments.callee.anim = this.fxanim(a,
10740 * Ensures that all effects queued after syncFx is called on the element are
10741 * run concurrently. This is the opposite of {@link #sequenceFx}.
10742 * @return {Roo.Element} The Element
10744 syncFx : function(){
10745 this.fxDefaults = Roo.apply(this.fxDefaults || {}, {
10754 * Ensures that all effects queued after sequenceFx is called on the element are
10755 * run in sequence. This is the opposite of {@link #syncFx}.
10756 * @return {Roo.Element} The Element
10758 sequenceFx : function(){
10759 this.fxDefaults = Roo.apply(this.fxDefaults || {}, {
10761 concurrent : false,
10768 nextFx : function(){
10769 var ef = this.fxQueue[0];
10776 * Returns true if the element has any effects actively running or queued, else returns false.
10777 * @return {Boolean} True if element has active effects, else false
10779 hasActiveFx : function(){
10780 return this.fxQueue && this.fxQueue[0];
10784 * Stops any running effects and clears the element's internal effects queue if it contains
10785 * any additional effects that haven't started yet.
10786 * @return {Roo.Element} The Element
10788 stopFx : function(){
10789 if(this.hasActiveFx()){
10790 var cur = this.fxQueue[0];
10791 if(cur && cur.anim && cur.anim.isAnimated()){
10792 this.fxQueue = [cur]; // clear out others
10793 cur.anim.stop(true);
10800 beforeFx : function(o){
10801 if(this.hasActiveFx() && !o.concurrent){
10812 * Returns true if the element is currently blocking so that no other effect can be queued
10813 * until this effect is finished, else returns false if blocking is not set. This is commonly
10814 * used to ensure that an effect initiated by a user action runs to completion prior to the
10815 * same effect being restarted (e.g., firing only one effect even if the user clicks several times).
10816 * @return {Boolean} True if blocking, else false
10818 hasFxBlock : function(){
10819 var q = this.fxQueue;
10820 return q && q[0] && q[0].block;
10824 queueFx : function(o, fn){
10828 if(!this.hasFxBlock()){
10829 Roo.applyIf(o, this.fxDefaults);
10831 var run = this.beforeFx(o);
10832 fn.block = o.block;
10833 this.fxQueue.push(fn);
10845 fxWrap : function(pos, o, vis){
10847 if(!o.wrap || !(wrap = Roo.get(o.wrap))){
10850 wrapXY = this.getXY();
10852 var div = document.createElement("div");
10853 div.style.visibility = vis;
10854 wrap = Roo.get(this.dom.parentNode.insertBefore(div, this.dom));
10855 wrap.setPositioning(pos);
10856 if(wrap.getStyle("position") == "static"){
10857 wrap.position("relative");
10859 this.clearPositioning('auto');
10861 wrap.dom.appendChild(this.dom);
10863 wrap.setXY(wrapXY);
10870 fxUnwrap : function(wrap, pos, o){
10871 this.clearPositioning();
10872 this.setPositioning(pos);
10874 wrap.dom.parentNode.insertBefore(this.dom, wrap.dom);
10880 getFxRestore : function(){
10881 var st = this.dom.style;
10882 return {pos: this.getPositioning(), width: st.width, height : st.height};
10886 afterFx : function(o){
10888 this.applyStyles(o.afterStyle);
10891 this.addClass(o.afterCls);
10893 if(o.remove === true){
10896 Roo.callback(o.callback, o.scope, [this]);
10898 this.fxQueue.shift();
10904 getFxEl : function(){ // support for composite element fx
10905 return Roo.get(this.dom);
10909 fxanim : function(args, opt, animType, defaultDur, defaultEase, cb){
10910 animType = animType || 'run';
10912 var anim = Roo.lib.Anim[animType](
10914 (opt.duration || defaultDur) || .35,
10915 (opt.easing || defaultEase) || 'easeOut',
10917 Roo.callback(cb, this);
10926 // backwords compat
10927 Roo.Fx.resize = Roo.Fx.scale;
10929 //When included, Roo.Fx is automatically applied to Element so that all basic
10930 //effects are available directly via the Element API
10931 Roo.apply(Roo.Element.prototype, Roo.Fx);/*
10933 * Ext JS Library 1.1.1
10934 * Copyright(c) 2006-2007, Ext JS, LLC.
10936 * Originally Released Under LGPL - original licence link has changed is not relivant.
10939 * <script type="text/javascript">
10944 * @class Roo.CompositeElement
10945 * Standard composite class. Creates a Roo.Element for every element in the collection.
10947 * <b>NOTE: Although they are not listed, this class supports all of the set/update methods of Roo.Element. All Roo.Element
10948 * actions will be performed on all the elements in this collection.</b>
10950 * All methods return <i>this</i> and can be chained.
10952 var els = Roo.select("#some-el div.some-class", true);
10953 // or select directly from an existing element
10954 var el = Roo.get('some-el');
10955 el.select('div.some-class', true);
10957 els.setWidth(100); // all elements become 100 width
10958 els.hide(true); // all elements fade out and hide
10960 els.setWidth(100).hide(true);
10963 Roo.CompositeElement = function(els){
10964 this.elements = [];
10965 this.addElements(els);
10967 Roo.CompositeElement.prototype = {
10969 addElements : function(els){
10970 if(!els) return this;
10971 if(typeof els == "string"){
10972 els = Roo.Element.selectorFunction(els);
10974 var yels = this.elements;
10975 var index = yels.length-1;
10976 for(var i = 0, len = els.length; i < len; i++) {
10977 yels[++index] = Roo.get(els[i]);
10983 * Clears this composite and adds the elements returned by the passed selector.
10984 * @param {String/Array} els A string CSS selector, an array of elements or an element
10985 * @return {CompositeElement} this
10987 fill : function(els){
10988 this.elements = [];
10994 * Filters this composite to only elements that match the passed selector.
10995 * @param {String} selector A string CSS selector
10996 * @param {Boolean} inverse return inverse filter (not matches)
10997 * @return {CompositeElement} this
10999 filter : function(selector, inverse){
11001 inverse = inverse || false;
11002 this.each(function(el){
11003 var match = inverse ? !el.is(selector) : el.is(selector);
11005 els[els.length] = el.dom;
11012 invoke : function(fn, args){
11013 var els = this.elements;
11014 for(var i = 0, len = els.length; i < len; i++) {
11015 Roo.Element.prototype[fn].apply(els[i], args);
11020 * Adds elements to this composite.
11021 * @param {String/Array} els A string CSS selector, an array of elements or an element
11022 * @return {CompositeElement} this
11024 add : function(els){
11025 if(typeof els == "string"){
11026 this.addElements(Roo.Element.selectorFunction(els));
11027 }else if(els.length !== undefined){
11028 this.addElements(els);
11030 this.addElements([els]);
11035 * Calls the passed function passing (el, this, index) for each element in this composite.
11036 * @param {Function} fn The function to call
11037 * @param {Object} scope (optional) The <i>this</i> object (defaults to the element)
11038 * @return {CompositeElement} this
11040 each : function(fn, scope){
11041 var els = this.elements;
11042 for(var i = 0, len = els.length; i < len; i++){
11043 if(fn.call(scope || els[i], els[i], this, i) === false) {
11051 * Returns the Element object at the specified index
11052 * @param {Number} index
11053 * @return {Roo.Element}
11055 item : function(index){
11056 return this.elements[index] || null;
11060 * Returns the first Element
11061 * @return {Roo.Element}
11063 first : function(){
11064 return this.item(0);
11068 * Returns the last Element
11069 * @return {Roo.Element}
11072 return this.item(this.elements.length-1);
11076 * Returns the number of elements in this composite
11079 getCount : function(){
11080 return this.elements.length;
11084 * Returns true if this composite contains the passed element
11087 contains : function(el){
11088 return this.indexOf(el) !== -1;
11092 * Returns true if this composite contains the passed element
11095 indexOf : function(el){
11096 return this.elements.indexOf(Roo.get(el));
11101 * Removes the specified element(s).
11102 * @param {Mixed} el The id of an element, the Element itself, the index of the element in this composite
11103 * or an array of any of those.
11104 * @param {Boolean} removeDom (optional) True to also remove the element from the document
11105 * @return {CompositeElement} this
11107 removeElement : function(el, removeDom){
11108 if(el instanceof Array){
11109 for(var i = 0, len = el.length; i < len; i++){
11110 this.removeElement(el[i]);
11114 var index = typeof el == 'number' ? el : this.indexOf(el);
11117 var d = this.elements[index];
11121 d.parentNode.removeChild(d);
11124 this.elements.splice(index, 1);
11130 * Replaces the specified element with the passed element.
11131 * @param {String/HTMLElement/Element/Number} el The id of an element, the Element itself, the index of the element in this composite
11133 * @param {String/HTMLElement/Element} replacement The id of an element or the Element itself.
11134 * @param {Boolean} domReplace (Optional) True to remove and replace the element in the document too.
11135 * @return {CompositeElement} this
11137 replaceElement : function(el, replacement, domReplace){
11138 var index = typeof el == 'number' ? el : this.indexOf(el);
11141 this.elements[index].replaceWith(replacement);
11143 this.elements.splice(index, 1, Roo.get(replacement))
11150 * Removes all elements.
11152 clear : function(){
11153 this.elements = [];
11157 Roo.CompositeElement.createCall = function(proto, fnName){
11158 if(!proto[fnName]){
11159 proto[fnName] = function(){
11160 return this.invoke(fnName, arguments);
11164 for(var fnName in Roo.Element.prototype){
11165 if(typeof Roo.Element.prototype[fnName] == "function"){
11166 Roo.CompositeElement.createCall(Roo.CompositeElement.prototype, fnName);
11172 * Ext JS Library 1.1.1
11173 * Copyright(c) 2006-2007, Ext JS, LLC.
11175 * Originally Released Under LGPL - original licence link has changed is not relivant.
11178 * <script type="text/javascript">
11182 * @class Roo.CompositeElementLite
11183 * @extends Roo.CompositeElement
11184 * Flyweight composite class. Reuses the same Roo.Element for element operations.
11186 var els = Roo.select("#some-el div.some-class");
11187 // or select directly from an existing element
11188 var el = Roo.get('some-el');
11189 el.select('div.some-class');
11191 els.setWidth(100); // all elements become 100 width
11192 els.hide(true); // all elements fade out and hide
11194 els.setWidth(100).hide(true);
11195 </code></pre><br><br>
11196 * <b>NOTE: Although they are not listed, this class supports all of the set/update methods of Roo.Element. All Roo.Element
11197 * actions will be performed on all the elements in this collection.</b>
11199 Roo.CompositeElementLite = function(els){
11200 Roo.CompositeElementLite.superclass.constructor.call(this, els);
11201 this.el = new Roo.Element.Flyweight();
11203 Roo.extend(Roo.CompositeElementLite, Roo.CompositeElement, {
11204 addElements : function(els){
11206 if(els instanceof Array){
11207 this.elements = this.elements.concat(els);
11209 var yels = this.elements;
11210 var index = yels.length-1;
11211 for(var i = 0, len = els.length; i < len; i++) {
11212 yels[++index] = els[i];
11218 invoke : function(fn, args){
11219 var els = this.elements;
11221 for(var i = 0, len = els.length; i < len; i++) {
11223 Roo.Element.prototype[fn].apply(el, args);
11228 * Returns a flyweight Element of the dom element object at the specified index
11229 * @param {Number} index
11230 * @return {Roo.Element}
11232 item : function(index){
11233 if(!this.elements[index]){
11236 this.el.dom = this.elements[index];
11240 // fixes scope with flyweight
11241 addListener : function(eventName, handler, scope, opt){
11242 var els = this.elements;
11243 for(var i = 0, len = els.length; i < len; i++) {
11244 Roo.EventManager.on(els[i], eventName, handler, scope || els[i], opt);
11250 * Calls the passed function passing (el, this, index) for each element in this composite. <b>The element
11251 * passed is the flyweight (shared) Roo.Element instance, so if you require a
11252 * a reference to the dom node, use el.dom.</b>
11253 * @param {Function} fn The function to call
11254 * @param {Object} scope (optional) The <i>this</i> object (defaults to the element)
11255 * @return {CompositeElement} this
11257 each : function(fn, scope){
11258 var els = this.elements;
11260 for(var i = 0, len = els.length; i < len; i++){
11262 if(fn.call(scope || el, el, this, i) === false){
11269 indexOf : function(el){
11270 return this.elements.indexOf(Roo.getDom(el));
11273 replaceElement : function(el, replacement, domReplace){
11274 var index = typeof el == 'number' ? el : this.indexOf(el);
11276 replacement = Roo.getDom(replacement);
11278 var d = this.elements[index];
11279 d.parentNode.insertBefore(replacement, d);
11280 d.parentNode.removeChild(d);
11282 this.elements.splice(index, 1, replacement);
11287 Roo.CompositeElementLite.prototype.on = Roo.CompositeElementLite.prototype.addListener;
11291 * Ext JS Library 1.1.1
11292 * Copyright(c) 2006-2007, Ext JS, LLC.
11294 * Originally Released Under LGPL - original licence link has changed is not relivant.
11297 * <script type="text/javascript">
11303 * @class Roo.data.Connection
11304 * @extends Roo.util.Observable
11305 * The class encapsulates a connection to the page's originating domain, allowing requests to be made
11306 * either to a configured URL, or to a URL specified at request time.<br><br>
11308 * Requests made by this class are asynchronous, and will return immediately. No data from
11309 * the server will be available to the statement immediately following the {@link #request} call.
11310 * To process returned data, use a callback in the request options object, or an event listener.</p><br>
11312 * Note: If you are doing a file upload, you will not get a normal response object sent back to
11313 * your callback or event handler. Since the upload is handled via in IFRAME, there is no XMLHttpRequest.
11314 * The response object is created using the innerHTML of the IFRAME's document as the responseText
11315 * property and, if present, the IFRAME's XML document as the responseXML property.</p><br>
11316 * This means that a valid XML or HTML document must be returned. If JSON data is required, it is suggested
11317 * that it be placed either inside a <textarea> in an HTML document and retrieved from the responseText
11318 * using a regex, or inside a CDATA section in an XML document and retrieved from the responseXML using
11319 * standard DOM methods.
11321 * @param {Object} config a configuration object.
11323 Roo.data.Connection = function(config){
11324 Roo.apply(this, config);
11327 * @event beforerequest
11328 * Fires before a network request is made to retrieve a data object.
11329 * @param {Connection} conn This Connection object.
11330 * @param {Object} options The options config object passed to the {@link #request} method.
11332 "beforerequest" : true,
11334 * @event requestcomplete
11335 * Fires if the request was successfully completed.
11336 * @param {Connection} conn This Connection object.
11337 * @param {Object} response The XHR object containing the response data.
11338 * See {@link http://www.w3.org/TR/XMLHttpRequest/} for details.
11339 * @param {Object} options The options config object passed to the {@link #request} method.
11341 "requestcomplete" : true,
11343 * @event requestexception
11344 * Fires if an error HTTP status was returned from the server.
11345 * See {@link http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html} for details of HTTP status codes.
11346 * @param {Connection} conn This Connection object.
11347 * @param {Object} response The XHR object containing the response data.
11348 * See {@link http://www.w3.org/TR/XMLHttpRequest/} for details.
11349 * @param {Object} options The options config object passed to the {@link #request} method.
11351 "requestexception" : true
11353 Roo.data.Connection.superclass.constructor.call(this);
11356 Roo.extend(Roo.data.Connection, Roo.util.Observable, {
11358 * @cfg {String} url (Optional) The default URL to be used for requests to the server. (defaults to undefined)
11361 * @cfg {Object} extraParams (Optional) An object containing properties which are used as
11362 * extra parameters to each request made by this object. (defaults to undefined)
11365 * @cfg {Object} defaultHeaders (Optional) An object containing request headers which are added
11366 * to each request made by this object. (defaults to undefined)
11369 * @cfg {String} method (Optional) The default HTTP method to be used for requests. (defaults to undefined; if not set but parms are present will use POST, otherwise GET)
11372 * @cfg {Number} timeout (Optional) The timeout in milliseconds to be used for requests. (defaults to 30000)
11376 * @cfg {Boolean} autoAbort (Optional) Whether this request should abort any pending requests. (defaults to false)
11382 * @cfg {Boolean} disableCaching (Optional) True to add a unique cache-buster param to GET requests. (defaults to true)
11385 disableCaching: true,
11388 * Sends an HTTP request to a remote server.
11389 * @param {Object} options An object which may contain the following properties:<ul>
11390 * <li><b>url</b> {String} (Optional) The URL to which to send the request. Defaults to configured URL</li>
11391 * <li><b>params</b> {Object/String/Function} (Optional) An object containing properties which are used as parameters to the
11392 * request, a url encoded string or a function to call to get either.</li>
11393 * <li><b>method</b> {String} (Optional) The HTTP method to use for the request. Defaults to the configured method, or
11394 * if no method was configured, "GET" if no parameters are being sent, and "POST" if parameters are being sent.</li>
11395 * <li><b>callback</b> {Function} (Optional) The function to be called upon receipt of the HTTP response.
11396 * The callback is called regardless of success or failure and is passed the following parameters:<ul>
11397 * <li>options {Object} The parameter to the request call.</li>
11398 * <li>success {Boolean} True if the request succeeded.</li>
11399 * <li>response {Object} The XMLHttpRequest object containing the response data.</li>
11401 * <li><b>success</b> {Function} (Optional) The function to be called upon success of the request.
11402 * The callback is passed the following parameters:<ul>
11403 * <li>response {Object} The XMLHttpRequest object containing the response data.</li>
11404 * <li>options {Object} The parameter to the request call.</li>
11406 * <li><b>failure</b> {Function} (Optional) The function to be called upon failure of the request.
11407 * The callback is passed the following parameters:<ul>
11408 * <li>response {Object} The XMLHttpRequest object containing the response data.</li>
11409 * <li>options {Object} The parameter to the request call.</li>
11411 * <li><b>scope</b> {Object} (Optional) The scope in which to execute the callbacks: The "this" object
11412 * for the callback function. Defaults to the browser window.</li>
11413 * <li><b>form</b> {Object/String} (Optional) A form object or id to pull parameters from.</li>
11414 * <li><b>isUpload</b> {Boolean} (Optional) True if the form object is a file upload (will usually be automatically detected).</li>
11415 * <li><b>headers</b> {Object} (Optional) Request headers to set for the request.</li>
11416 * <li><b>xmlData</b> {Object} (Optional) XML document to use for the post. Note: This will be used instead of
11417 * params for the post data. Any params will be appended to the URL.</li>
11418 * <li><b>disableCaching</b> {Boolean} (Optional) True to add a unique cache-buster param to GET requests.</li>
11420 * @return {Number} transactionId
11422 request : function(o){
11423 if(this.fireEvent("beforerequest", this, o) !== false){
11426 if(typeof p == "function"){
11427 p = p.call(o.scope||window, o);
11429 if(typeof p == "object"){
11430 p = Roo.urlEncode(o.params);
11432 if(this.extraParams){
11433 var extras = Roo.urlEncode(this.extraParams);
11434 p = p ? (p + '&' + extras) : extras;
11437 var url = o.url || this.url;
11438 if(typeof url == 'function'){
11439 url = url.call(o.scope||window, o);
11443 var form = Roo.getDom(o.form);
11444 url = url || form.action;
11446 var enctype = form.getAttribute("enctype");
11447 if(o.isUpload || (enctype && enctype.toLowerCase() == 'multipart/form-data')){
11448 return this.doFormUpload(o, p, url);
11450 var f = Roo.lib.Ajax.serializeForm(form);
11451 p = p ? (p + '&' + f) : f;
11454 var hs = o.headers;
11455 if(this.defaultHeaders){
11456 hs = Roo.apply(hs || {}, this.defaultHeaders);
11463 success: this.handleResponse,
11464 failure: this.handleFailure,
11466 argument: {options: o},
11467 timeout : o.timeout || this.timeout
11470 var method = o.method||this.method||(p ? "POST" : "GET");
11472 if(method == 'GET' && (this.disableCaching && o.disableCaching !== false) || o.disableCaching === true){
11473 url += (url.indexOf('?') != -1 ? '&' : '?') + '_dc=' + (new Date().getTime());
11476 if(typeof o.autoAbort == 'boolean'){ // options gets top priority
11480 }else if(this.autoAbort !== false){
11484 if((method == 'GET' && p) || o.xmlData){
11485 url += (url.indexOf('?') != -1 ? '&' : '?') + p;
11488 this.transId = Roo.lib.Ajax.request(method, url, cb, p, o);
11489 return this.transId;
11491 Roo.callback(o.callback, o.scope, [o, null, null]);
11497 * Determine whether this object has a request outstanding.
11498 * @param {Number} transactionId (Optional) defaults to the last transaction
11499 * @return {Boolean} True if there is an outstanding request.
11501 isLoading : function(transId){
11503 return Roo.lib.Ajax.isCallInProgress(transId);
11505 return this.transId ? true : false;
11510 * Aborts any outstanding request.
11511 * @param {Number} transactionId (Optional) defaults to the last transaction
11513 abort : function(transId){
11514 if(transId || this.isLoading()){
11515 Roo.lib.Ajax.abort(transId || this.transId);
11520 handleResponse : function(response){
11521 this.transId = false;
11522 var options = response.argument.options;
11523 response.argument = options ? options.argument : null;
11524 this.fireEvent("requestcomplete", this, response, options);
11525 Roo.callback(options.success, options.scope, [response, options]);
11526 Roo.callback(options.callback, options.scope, [options, true, response]);
11530 handleFailure : function(response, e){
11531 this.transId = false;
11532 var options = response.argument.options;
11533 response.argument = options ? options.argument : null;
11534 this.fireEvent("requestexception", this, response, options, e);
11535 Roo.callback(options.failure, options.scope, [response, options]);
11536 Roo.callback(options.callback, options.scope, [options, false, response]);
11540 doFormUpload : function(o, ps, url){
11542 var frame = document.createElement('iframe');
11545 frame.className = 'x-hidden';
11547 frame.src = Roo.SSL_SECURE_URL;
11549 document.body.appendChild(frame);
11552 document.frames[id].name = id;
11555 var form = Roo.getDom(o.form);
11557 form.method = 'POST';
11558 form.enctype = form.encoding = 'multipart/form-data';
11564 if(ps){ // add dynamic params
11566 ps = Roo.urlDecode(ps, false);
11568 if(ps.hasOwnProperty(k)){
11569 hd = document.createElement('input');
11570 hd.type = 'hidden';
11573 form.appendChild(hd);
11580 var r = { // bogus response object
11585 r.argument = o ? o.argument : null;
11590 doc = frame.contentWindow.document;
11592 doc = (frame.contentDocument || window.frames[id].document);
11594 if(doc && doc.body){
11595 r.responseText = doc.body.innerHTML;
11597 if(doc && doc.XMLDocument){
11598 r.responseXML = doc.XMLDocument;
11600 r.responseXML = doc;
11607 Roo.EventManager.removeListener(frame, 'load', cb, this);
11609 this.fireEvent("requestcomplete", this, r, o);
11610 Roo.callback(o.success, o.scope, [r, o]);
11611 Roo.callback(o.callback, o.scope, [o, true, r]);
11613 setTimeout(function(){document.body.removeChild(frame);}, 100);
11616 Roo.EventManager.on(frame, 'load', cb, this);
11619 if(hiddens){ // remove dynamic params
11620 for(var i = 0, len = hiddens.length; i < len; i++){
11621 form.removeChild(hiddens[i]);
11628 * Ext JS Library 1.1.1
11629 * Copyright(c) 2006-2007, Ext JS, LLC.
11631 * Originally Released Under LGPL - original licence link has changed is not relivant.
11634 * <script type="text/javascript">
11638 * Global Ajax request class.
11641 * @extends Roo.data.Connection
11644 * @cfg {String} url The default URL to be used for requests to the server. (defaults to undefined)
11645 * @cfg {Object} extraParams An object containing properties which are used as extra parameters to each request made by this object. (defaults to undefined)
11646 * @cfg {Object} defaultHeaders An object containing request headers which are added to each request made by this object. (defaults to undefined)
11647 * @cfg {String} method (Optional) The default HTTP method to be used for requests. (defaults to undefined; if not set but parms are present will use POST, otherwise GET)
11648 * @cfg {Number} timeout (Optional) The timeout in milliseconds to be used for requests. (defaults to 30000)
11649 * @cfg {Boolean} autoAbort (Optional) Whether a new request should abort any pending requests. (defaults to false)
11650 * @cfg {Boolean} disableCaching (Optional) True to add a unique cache-buster param to GET requests. (defaults to true)
11652 Roo.Ajax = new Roo.data.Connection({
11661 * Serialize the passed form into a url encoded string
11663 * @param {String/HTMLElement} form
11666 serializeForm : function(form){
11667 return Roo.lib.Ajax.serializeForm(form);
11671 * Ext JS Library 1.1.1
11672 * Copyright(c) 2006-2007, Ext JS, LLC.
11674 * Originally Released Under LGPL - original licence link has changed is not relivant.
11677 * <script type="text/javascript">
11682 * @class Roo.UpdateManager
11683 * @extends Roo.util.Observable
11684 * Provides AJAX-style update for Element object.<br><br>
11687 * // Get it from a Roo.Element object
11688 * var el = Roo.get("foo");
11689 * var mgr = el.getUpdateManager();
11690 * mgr.update("http://myserver.com/index.php", "param1=1&param2=2");
11692 * mgr.formUpdate("myFormId", "http://myserver.com/index.php");
11694 * // or directly (returns the same UpdateManager instance)
11695 * var mgr = new Roo.UpdateManager("myElementId");
11696 * mgr.startAutoRefresh(60, "http://myserver.com/index.php");
11697 * mgr.on("update", myFcnNeedsToKnow);
11699 // short handed call directly from the element object
11700 Roo.get("foo").load({
11704 text: "Loading Foo..."
11708 * Create new UpdateManager directly.
11709 * @param {String/HTMLElement/Roo.Element} el The element to update
11710 * @param {Boolean} forceNew (optional) By default the constructor checks to see if the passed element already has an UpdateManager and if it does it returns the same instance. This will skip that check (useful for extending this class).
11712 Roo.UpdateManager = function(el, forceNew){
11714 if(!forceNew && el.updateManager){
11715 return el.updateManager;
11718 * The Element object
11719 * @type Roo.Element
11723 * Cached url to use for refreshes. Overwritten every time update() is called unless "discardUrl" param is set to true.
11726 this.defaultUrl = null;
11730 * @event beforeupdate
11731 * Fired before an update is made, return false from your handler and the update is cancelled.
11732 * @param {Roo.Element} el
11733 * @param {String/Object/Function} url
11734 * @param {String/Object} params
11736 "beforeupdate": true,
11739 * Fired after successful update is made.
11740 * @param {Roo.Element} el
11741 * @param {Object} oResponseObject The response Object
11746 * Fired on update failure.
11747 * @param {Roo.Element} el
11748 * @param {Object} oResponseObject The response Object
11752 var d = Roo.UpdateManager.defaults;
11754 * Blank page URL to use with SSL file uploads (Defaults to Roo.UpdateManager.defaults.sslBlankUrl or "about:blank").
11757 this.sslBlankUrl = d.sslBlankUrl;
11759 * Whether to append unique parameter on get request to disable caching (Defaults to Roo.UpdateManager.defaults.disableCaching or false).
11762 this.disableCaching = d.disableCaching;
11764 * Text for loading indicator (Defaults to Roo.UpdateManager.defaults.indicatorText or '<div class="loading-indicator">Loading...</div>').
11767 this.indicatorText = d.indicatorText;
11769 * Whether to show indicatorText when loading (Defaults to Roo.UpdateManager.defaults.showLoadIndicator or true).
11772 this.showLoadIndicator = d.showLoadIndicator;
11774 * Timeout for requests or form posts in seconds (Defaults to Roo.UpdateManager.defaults.timeout or 30 seconds).
11777 this.timeout = d.timeout;
11780 * True to process scripts in the output (Defaults to Roo.UpdateManager.defaults.loadScripts (false)).
11783 this.loadScripts = d.loadScripts;
11786 * Transaction object of current executing transaction
11788 this.transaction = null;
11793 this.autoRefreshProcId = null;
11795 * Delegate for refresh() prebound to "this", use myUpdater.refreshDelegate.createCallback(arg1, arg2) to bind arguments
11798 this.refreshDelegate = this.refresh.createDelegate(this);
11800 * Delegate for update() prebound to "this", use myUpdater.updateDelegate.createCallback(arg1, arg2) to bind arguments
11803 this.updateDelegate = this.update.createDelegate(this);
11805 * Delegate for formUpdate() prebound to "this", use myUpdater.formUpdateDelegate.createCallback(arg1, arg2) to bind arguments
11808 this.formUpdateDelegate = this.formUpdate.createDelegate(this);
11812 this.successDelegate = this.processSuccess.createDelegate(this);
11816 this.failureDelegate = this.processFailure.createDelegate(this);
11818 if(!this.renderer){
11820 * The renderer for this UpdateManager. Defaults to {@link Roo.UpdateManager.BasicRenderer}.
11822 this.renderer = new Roo.UpdateManager.BasicRenderer();
11825 Roo.UpdateManager.superclass.constructor.call(this);
11828 Roo.extend(Roo.UpdateManager, Roo.util.Observable, {
11830 * Get the Element this UpdateManager is bound to
11831 * @return {Roo.Element} The element
11833 getEl : function(){
11837 * Performs an async request, updating this element with the response. If params are specified it uses POST, otherwise it uses GET.
11838 * @param {Object/String/Function} url The url for this request or a function to call to get the url or a config object containing any of the following options:
11841 url: "your-url.php",<br/>
11842 params: {param1: "foo", param2: "bar"}, // or a URL encoded string<br/>
11843 callback: yourFunction,<br/>
11844 scope: yourObject, //(optional scope) <br/>
11845 discardUrl: false, <br/>
11846 nocache: false,<br/>
11847 text: "Loading...",<br/>
11849 scripts: false<br/>
11852 * The only required property is url. The optional properties nocache, text and scripts
11853 * are shorthand for disableCaching, indicatorText and loadScripts and are used to set their associated property on this UpdateManager instance.
11854 * @param {String/Object} params (optional) The parameters to pass as either a url encoded string "param1=1&param2=2" or an object {param1: 1, param2: 2}
11855 * @param {Function} callback (optional) Callback when transaction is complete - called with signature (oElement, bSuccess, oResponse)
11856 * @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.
11858 update : function(url, params, callback, discardUrl){
11859 if(this.fireEvent("beforeupdate", this.el, url, params) !== false){
11860 var method = this.method,
11862 if(typeof url == "object"){ // must be config object
11865 params = params || cfg.params;
11866 callback = callback || cfg.callback;
11867 discardUrl = discardUrl || cfg.discardUrl;
11868 if(callback && cfg.scope){
11869 callback = callback.createDelegate(cfg.scope);
11871 if(typeof cfg.method != "undefined"){method = cfg.method;};
11872 if(typeof cfg.nocache != "undefined"){this.disableCaching = cfg.nocache;};
11873 if(typeof cfg.text != "undefined"){this.indicatorText = '<div class="loading-indicator">'+cfg.text+"</div>";};
11874 if(typeof cfg.scripts != "undefined"){this.loadScripts = cfg.scripts;};
11875 if(typeof cfg.timeout != "undefined"){this.timeout = cfg.timeout;};
11877 this.showLoading();
11879 this.defaultUrl = url;
11881 if(typeof url == "function"){
11882 url = url.call(this);
11885 method = method || (params ? "POST" : "GET");
11886 if(method == "GET"){
11887 url = this.prepareUrl(url);
11890 var o = Roo.apply(cfg ||{}, {
11893 success: this.successDelegate,
11894 failure: this.failureDelegate,
11895 callback: undefined,
11896 timeout: (this.timeout*1000),
11897 argument: {"url": url, "form": null, "callback": callback, "params": params}
11899 Roo.log("updated manager called with timeout of " + o.timeout);
11900 this.transaction = Roo.Ajax.request(o);
11905 * Performs an async form post, updating this element with the response. If the form has the attribute enctype="multipart/form-data", it assumes it's a file upload.
11906 * Uses this.sslBlankUrl for SSL file uploads to prevent IE security warning.
11907 * @param {String/HTMLElement} form The form Id or form element
11908 * @param {String} url (optional) The url to pass the form to. If omitted the action attribute on the form will be used.
11909 * @param {Boolean} reset (optional) Whether to try to reset the form after the update
11910 * @param {Function} callback (optional) Callback when transaction is complete - called with signature (oElement, bSuccess, oResponse)
11912 formUpdate : function(form, url, reset, callback){
11913 if(this.fireEvent("beforeupdate", this.el, form, url) !== false){
11914 if(typeof url == "function"){
11915 url = url.call(this);
11917 form = Roo.getDom(form);
11918 this.transaction = Roo.Ajax.request({
11921 success: this.successDelegate,
11922 failure: this.failureDelegate,
11923 timeout: (this.timeout*1000),
11924 argument: {"url": url, "form": form, "callback": callback, "reset": reset}
11926 this.showLoading.defer(1, this);
11931 * Refresh the element with the last used url or defaultUrl. If there is no url, it returns immediately
11932 * @param {Function} callback (optional) Callback when transaction is complete - called with signature (oElement, bSuccess)
11934 refresh : function(callback){
11935 if(this.defaultUrl == null){
11938 this.update(this.defaultUrl, null, callback, true);
11942 * Set this element to auto refresh.
11943 * @param {Number} interval How often to update (in seconds).
11944 * @param {String/Function} url (optional) The url for this request or a function to call to get the url (Defaults to the last used url)
11945 * @param {String/Object} params (optional) The parameters to pass as either a url encoded string "¶m1=1¶m2=2" or as an object {param1: 1, param2: 2}
11946 * @param {Function} callback (optional) Callback when transaction is complete - called with signature (oElement, bSuccess)
11947 * @param {Boolean} refreshNow (optional) Whether to execute the refresh now, or wait the interval
11949 startAutoRefresh : function(interval, url, params, callback, refreshNow){
11951 this.update(url || this.defaultUrl, params, callback, true);
11953 if(this.autoRefreshProcId){
11954 clearInterval(this.autoRefreshProcId);
11956 this.autoRefreshProcId = setInterval(this.update.createDelegate(this, [url || this.defaultUrl, params, callback, true]), interval*1000);
11960 * Stop auto refresh on this element.
11962 stopAutoRefresh : function(){
11963 if(this.autoRefreshProcId){
11964 clearInterval(this.autoRefreshProcId);
11965 delete this.autoRefreshProcId;
11969 isAutoRefreshing : function(){
11970 return this.autoRefreshProcId ? true : false;
11973 * Called to update the element to "Loading" state. Override to perform custom action.
11975 showLoading : function(){
11976 if(this.showLoadIndicator){
11977 this.el.update(this.indicatorText);
11982 * Adds unique parameter to query string if disableCaching = true
11985 prepareUrl : function(url){
11986 if(this.disableCaching){
11987 var append = "_dc=" + (new Date().getTime());
11988 if(url.indexOf("?") !== -1){
11989 url += "&" + append;
11991 url += "?" + append;
12000 processSuccess : function(response){
12001 this.transaction = null;
12002 if(response.argument.form && response.argument.reset){
12003 try{ // put in try/catch since some older FF releases had problems with this
12004 response.argument.form.reset();
12007 if(this.loadScripts){
12008 this.renderer.render(this.el, response, this,
12009 this.updateComplete.createDelegate(this, [response]));
12011 this.renderer.render(this.el, response, this);
12012 this.updateComplete(response);
12016 updateComplete : function(response){
12017 this.fireEvent("update", this.el, response);
12018 if(typeof response.argument.callback == "function"){
12019 response.argument.callback(this.el, true, response);
12026 processFailure : function(response){
12027 this.transaction = null;
12028 this.fireEvent("failure", this.el, response);
12029 if(typeof response.argument.callback == "function"){
12030 response.argument.callback(this.el, false, response);
12035 * Set the content renderer for this UpdateManager. See {@link Roo.UpdateManager.BasicRenderer#render} for more details.
12036 * @param {Object} renderer The object implementing the render() method
12038 setRenderer : function(renderer){
12039 this.renderer = renderer;
12042 getRenderer : function(){
12043 return this.renderer;
12047 * Set the defaultUrl used for updates
12048 * @param {String/Function} defaultUrl The url or a function to call to get the url
12050 setDefaultUrl : function(defaultUrl){
12051 this.defaultUrl = defaultUrl;
12055 * Aborts the executing transaction
12057 abort : function(){
12058 if(this.transaction){
12059 Roo.Ajax.abort(this.transaction);
12064 * Returns true if an update is in progress
12065 * @return {Boolean}
12067 isUpdating : function(){
12068 if(this.transaction){
12069 return Roo.Ajax.isLoading(this.transaction);
12076 * @class Roo.UpdateManager.defaults
12077 * @static (not really - but it helps the doc tool)
12078 * The defaults collection enables customizing the default properties of UpdateManager
12080 Roo.UpdateManager.defaults = {
12082 * Timeout for requests or form posts in seconds (Defaults 30 seconds).
12088 * True to process scripts by default (Defaults to false).
12091 loadScripts : false,
12094 * Blank page URL to use with SSL file uploads (Defaults to "javascript:false").
12097 sslBlankUrl : (Roo.SSL_SECURE_URL || "javascript:false"),
12099 * Whether to append unique parameter on get request to disable caching (Defaults to false).
12102 disableCaching : false,
12104 * Whether to show indicatorText when loading (Defaults to true).
12107 showLoadIndicator : true,
12109 * Text for loading indicator (Defaults to '<div class="loading-indicator">Loading...</div>').
12112 indicatorText : '<div class="loading-indicator">Loading...</div>'
12116 * Static convenience method. This method is deprecated in favor of el.load({url:'foo.php', ...}).
12118 * <pre><code>Roo.UpdateManager.updateElement("my-div", "stuff.php");</code></pre>
12119 * @param {String/HTMLElement/Roo.Element} el The element to update
12120 * @param {String} url The url
12121 * @param {String/Object} params (optional) Url encoded param string or an object of name/value pairs
12122 * @param {Object} options (optional) A config object with any of the UpdateManager properties you want to set - for example: {disableCaching:true, indicatorText: "Loading data..."}
12125 * @member Roo.UpdateManager
12127 Roo.UpdateManager.updateElement = function(el, url, params, options){
12128 var um = Roo.get(el, true).getUpdateManager();
12129 Roo.apply(um, options);
12130 um.update(url, params, options ? options.callback : null);
12132 // alias for backwards compat
12133 Roo.UpdateManager.update = Roo.UpdateManager.updateElement;
12135 * @class Roo.UpdateManager.BasicRenderer
12136 * Default Content renderer. Updates the elements innerHTML with the responseText.
12138 Roo.UpdateManager.BasicRenderer = function(){};
12140 Roo.UpdateManager.BasicRenderer.prototype = {
12142 * This is called when the transaction is completed and it's time to update the element - The BasicRenderer
12143 * updates the elements innerHTML with the responseText - To perform a custom render (i.e. XML or JSON processing),
12144 * create an object with a "render(el, response)" method and pass it to setRenderer on the UpdateManager.
12145 * @param {Roo.Element} el The element being rendered
12146 * @param {Object} response The YUI Connect response object
12147 * @param {UpdateManager} updateManager The calling update manager
12148 * @param {Function} callback A callback that will need to be called if loadScripts is true on the UpdateManager
12150 render : function(el, response, updateManager, callback){
12151 el.update(response.responseText, updateManager.loadScripts, callback);
12157 * (c)) Alan Knowles
12163 * @class Roo.DomTemplate
12164 * @extends Roo.Template
12165 * An effort at a dom based template engine..
12167 * Similar to XTemplate, except it uses dom parsing to create the template..
12169 * Supported features:
12174 {a_variable} - output encoded.
12175 {a_variable.format:("Y-m-d")} - call a method on the variable
12176 {a_variable:raw} - unencoded output
12177 {a_variable:toFixed(1,2)} - Roo.util.Format."toFixed"
12178 {a_variable:this.method_on_template(...)} - call a method on the template object.
12183 <div roo-for="a_variable or condition.."></div>
12184 <div roo-if="a_variable or condition"></div>
12185 <div roo-exec="some javascript"></div>
12186 <div roo-name="named_template"></div>
12191 Roo.DomTemplate = function()
12193 Roo.DomTemplate.superclass.constructor.apply(this, arguments);
12200 Roo.extend(Roo.DomTemplate, Roo.Template, {
12202 * id counter for sub templates.
12206 * flag to indicate if dom parser is inside a pre,
12207 * it will strip whitespace if not.
12212 * The various sub templates
12220 * basic tag replacing syntax
12223 * // you can fake an object call by doing this
12227 re : /(\{|\%7B)([\w-\.]+)(?:\:([\w\.]*)(?:\(([^)]*?)?\))?)?(\}|\%7D)/g,
12228 //re : /\{([\w-\.]+)(?:\:([\w\.]*)(?:\((.*?)?\))?)?\}/g,
12230 iterChild : function (node, method) {
12232 var oldPre = this.inPre;
12233 if (node.tagName == 'PRE') {
12236 for( var i = 0; i < node.childNodes.length; i++) {
12237 method.call(this, node.childNodes[i]);
12239 this.inPre = oldPre;
12245 * compile the template
12247 * This is not recursive, so I'm not sure how nested templates are really going to be handled..
12250 compile: function()
12254 // covert the html into DOM...
12258 doc = document.implementation.createHTMLDocument("");
12259 doc.documentElement.innerHTML = this.html ;
12260 div = doc.documentElement;
12262 // old IE... - nasty -- it causes all sorts of issues.. with
12263 // images getting pulled from server..
12264 div = document.createElement('div');
12265 div.innerHTML = this.html;
12267 //doc.documentElement.innerHTML = htmlBody
12273 this.iterChild(div, function(n) {_t.compileNode(n, true); });
12275 var tpls = this.tpls;
12277 // create a top level template from the snippet..
12279 //Roo.log(div.innerHTML);
12286 body : div.innerHTML,
12299 Roo.each(tpls, function(tp){
12300 this.compileTpl(tp);
12301 this.tpls[tp.id] = tp;
12304 this.master = tpls[0];
12310 compileNode : function(node, istop) {
12315 // skip anything not a tag..
12316 if (node.nodeType != 1) {
12317 if (node.nodeType == 3 && !this.inPre) {
12318 // reduce white space..
12319 node.nodeValue = node.nodeValue.replace(/\s+/g, ' ');
12342 case (node.hasAttribute('roo-for')): tpl.attr = 'for'; break;
12343 case (node.hasAttribute('roo-if')): tpl.attr = 'if'; break;
12344 case (node.hasAttribute('roo-name')): tpl.attr = 'name'; break;
12345 case (node.hasAttribute('roo-exec')): tpl.attr = 'exec'; break;
12351 // just itterate children..
12352 this.iterChild(node,this.compileNode);
12355 tpl.uid = this.id++;
12356 tpl.value = node.getAttribute('roo-' + tpl.attr);
12357 node.removeAttribute('roo-'+ tpl.attr);
12358 if (tpl.attr != 'name') {
12359 var placeholder = document.createTextNode('{domtpl' + tpl.uid + '}');
12360 node.parentNode.replaceChild(placeholder, node);
12363 var placeholder = document.createElement('span');
12364 placeholder.className = 'roo-tpl-' + tpl.value;
12365 node.parentNode.replaceChild(placeholder, node);
12368 // parent now sees '{domtplXXXX}
12369 this.iterChild(node,this.compileNode);
12371 // we should now have node body...
12372 var div = document.createElement('div');
12373 div.appendChild(node);
12375 // this has the unfortunate side effect of converting tagged attributes
12376 // eg. href="{...}" into %7C...%7D
12377 // this has been fixed by searching for those combo's although it's a bit hacky..
12380 tpl.body = div.innerHTML;
12387 switch (tpl.value) {
12388 case '.': tpl.forCall = new Function('values', 'parent', 'with(values){ return values; }'); break;
12389 case '..': tpl.forCall= new Function('values', 'parent', 'with(values){ return parent; }'); break;
12390 default: tpl.forCall= new Function('values', 'parent', 'with(values){ return '+tpl.value+'; }');
12395 tpl.execCall = new Function('values', 'parent', 'with(values){ '+(Roo.util.Format.htmlDecode(tpl.value))+'; }');
12399 tpl.ifCall = new Function('values', 'parent', 'with(values){ return '+(Roo.util.Format.htmlDecode(tpl.value))+'; }');
12403 tpl.id = tpl.value; // replace non characters???
12409 this.tpls.push(tpl);
12419 * Compile a segment of the template into a 'sub-template'
12425 compileTpl : function(tpl)
12427 var fm = Roo.util.Format;
12428 var useF = this.disableFormats !== true;
12430 var sep = Roo.isGecko ? "+\n" : ",\n";
12432 var undef = function(str) {
12433 Roo.debug && Roo.log("Property not found :" + str);
12437 //Roo.log(tpl.body);
12441 var fn = function(m, lbrace, name, format, args)
12444 //Roo.log(arguments);
12445 args = args ? args.replace(/\\'/g,"'") : args;
12446 //["{TEST:(a,b,c)}", "TEST", "", "a,b,c", 0, "{TEST:(a,b,c)}"]
12447 if (typeof(format) == 'undefined') {
12448 format = 'htmlEncode';
12450 if (format == 'raw' ) {
12454 if(name.substr(0, 6) == 'domtpl'){
12455 return "'"+ sep +'this.applySubTemplate('+name.substr(6)+', values, parent)'+sep+"'";
12458 // build an array of options to determine if value is undefined..
12460 // basically get 'xxxx.yyyy' then do
12461 // (typeof(xxxx) == 'undefined' || typeof(xxx.yyyy) == 'undefined') ?
12462 // (function () { Roo.log("Property not found"); return ''; })() :
12467 Roo.each(name.split('.'), function(st) {
12468 lookfor += (lookfor.length ? '.': '') + st;
12469 udef_ar.push( "(typeof(" + lookfor + ") == 'undefined')" );
12472 var udef_st = '((' + udef_ar.join(" || ") +") ? undef('" + name + "') : "; // .. needs )
12475 if(format && useF){
12477 args = args ? ',' + args : "";
12479 if(format.substr(0, 5) != "this."){
12480 format = "fm." + format + '(';
12482 format = 'this.call("'+ format.substr(5) + '", ';
12486 return "'"+ sep + udef_st + format + name + args + "))"+sep+"'";
12489 if (args && args.length) {
12490 // called with xxyx.yuu:(test,test)
12492 return "'"+ sep + udef_st + name + '(' + args + "))"+sep+"'";
12494 // raw.. - :raw modifier..
12495 return "'"+ sep + udef_st + name + ")"+sep+"'";
12499 // branched to use + in gecko and [].join() in others
12501 body = "tpl.compiled = function(values, parent){ with(values) { return '" +
12502 tpl.body.replace(/(\r\n|\n)/g, '\\n').replace(/'/g, "\\'").replace(this.re, fn) +
12505 body = ["tpl.compiled = function(values, parent){ with (values) { return ['"];
12506 body.push(tpl.body.replace(/(\r\n|\n)/g,
12507 '\\n').replace(/'/g, "\\'").replace(this.re, fn));
12508 body.push("'].join('');};};");
12509 body = body.join('');
12512 Roo.debug && Roo.log(body.replace(/\\n/,'\n'));
12514 /** eval:var:tpl eval:var:fm eval:var:useF eval:var:undef */
12521 * same as applyTemplate, except it's done to one of the subTemplates
12522 * when using named templates, you can do:
12524 * var str = pl.applySubTemplate('your-name', values);
12527 * @param {Number} id of the template
12528 * @param {Object} values to apply to template
12529 * @param {Object} parent (normaly the instance of this object)
12531 applySubTemplate : function(id, values, parent)
12535 var t = this.tpls[id];
12539 if(t.ifCall && !t.ifCall.call(this, values, parent)){
12540 Roo.debug && Roo.log('if call on ' + t.value + ' return false');
12544 Roo.log('Xtemplate.applySubTemplate('+ id+ '): Exception thrown on roo-if="' + t.value + '" - ' + e.toString());
12551 if(t.execCall && t.execCall.call(this, values, parent)){
12555 Roo.log('Xtemplate.applySubTemplate('+ id+ '): Exception thrown on roo-for="' + t.value + '" - ' + e.toString());
12561 var vs = t.forCall ? t.forCall.call(this, values, parent) : values;
12562 parent = t.target ? values : parent;
12563 if(t.forCall && vs instanceof Array){
12565 for(var i = 0, len = vs.length; i < len; i++){
12567 buf[buf.length] = t.compiled.call(this, vs[i], parent);
12569 Roo.log('Xtemplate.applySubTemplate('+ id+ '): Exception thrown on body="' + t.value + '" - ' + e.toString());
12571 //Roo.log(t.compiled);
12575 return buf.join('');
12578 Roo.log('Xtemplate.applySubTemplate('+ id+ '): Exception thrown on roo-for="' + t.value + '" - ' + e.toString());
12583 return t.compiled.call(this, vs, parent);
12585 Roo.log('Xtemplate.applySubTemplate('+ id+ '): Exception thrown on body="' + t.value + '" - ' + e.toString());
12587 //Roo.log(t.compiled);
12595 applyTemplate : function(values){
12596 return this.master.compiled.call(this, values, {});
12597 //var s = this.subs;
12600 apply : function(){
12601 return this.applyTemplate.apply(this, arguments);
12606 Roo.DomTemplate.from = function(el){
12607 el = Roo.getDom(el);
12608 return new Roo.Domtemplate(el.value || el.innerHTML);
12611 * Ext JS Library 1.1.1
12612 * Copyright(c) 2006-2007, Ext JS, LLC.
12614 * Originally Released Under LGPL - original licence link has changed is not relivant.
12617 * <script type="text/javascript">
12621 * @class Roo.util.DelayedTask
12622 * Provides a convenient method of performing setTimeout where a new
12623 * timeout cancels the old timeout. An example would be performing validation on a keypress.
12624 * You can use this class to buffer
12625 * the keypress events for a certain number of milliseconds, and perform only if they stop
12626 * for that amount of time.
12627 * @constructor The parameters to this constructor serve as defaults and are not required.
12628 * @param {Function} fn (optional) The default function to timeout
12629 * @param {Object} scope (optional) The default scope of that timeout
12630 * @param {Array} args (optional) The default Array of arguments
12632 Roo.util.DelayedTask = function(fn, scope, args){
12633 var id = null, d, t;
12635 var call = function(){
12636 var now = new Date().getTime();
12640 fn.apply(scope, args || []);
12644 * Cancels any pending timeout and queues a new one
12645 * @param {Number} delay The milliseconds to delay
12646 * @param {Function} newFn (optional) Overrides function passed to constructor
12647 * @param {Object} newScope (optional) Overrides scope passed to constructor
12648 * @param {Array} newArgs (optional) Overrides args passed to constructor
12650 this.delay = function(delay, newFn, newScope, newArgs){
12651 if(id && delay != d){
12655 t = new Date().getTime();
12657 scope = newScope || scope;
12658 args = newArgs || args;
12660 id = setInterval(call, d);
12665 * Cancel the last queued timeout
12667 this.cancel = function(){
12675 * Ext JS Library 1.1.1
12676 * Copyright(c) 2006-2007, Ext JS, LLC.
12678 * Originally Released Under LGPL - original licence link has changed is not relivant.
12681 * <script type="text/javascript">
12685 Roo.util.TaskRunner = function(interval){
12686 interval = interval || 10;
12687 var tasks = [], removeQueue = [];
12689 var running = false;
12691 var stopThread = function(){
12697 var startThread = function(){
12700 id = setInterval(runTasks, interval);
12704 var removeTask = function(task){
12705 removeQueue.push(task);
12711 var runTasks = function(){
12712 if(removeQueue.length > 0){
12713 for(var i = 0, len = removeQueue.length; i < len; i++){
12714 tasks.remove(removeQueue[i]);
12717 if(tasks.length < 1){
12722 var now = new Date().getTime();
12723 for(var i = 0, len = tasks.length; i < len; ++i){
12725 var itime = now - t.taskRunTime;
12726 if(t.interval <= itime){
12727 var rt = t.run.apply(t.scope || t, t.args || [++t.taskRunCount]);
12728 t.taskRunTime = now;
12729 if(rt === false || t.taskRunCount === t.repeat){
12734 if(t.duration && t.duration <= (now - t.taskStartTime)){
12741 * Queues a new task.
12742 * @param {Object} task
12744 this.start = function(task){
12746 task.taskStartTime = new Date().getTime();
12747 task.taskRunTime = 0;
12748 task.taskRunCount = 0;
12753 this.stop = function(task){
12758 this.stopAll = function(){
12760 for(var i = 0, len = tasks.length; i < len; i++){
12761 if(tasks[i].onStop){
12770 Roo.TaskMgr = new Roo.util.TaskRunner();/*
12772 * Ext JS Library 1.1.1
12773 * Copyright(c) 2006-2007, Ext JS, LLC.
12775 * Originally Released Under LGPL - original licence link has changed is not relivant.
12778 * <script type="text/javascript">
12783 * @class Roo.util.MixedCollection
12784 * @extends Roo.util.Observable
12785 * A Collection class that maintains both numeric indexes and keys and exposes events.
12787 * @param {Boolean} allowFunctions True if the addAll function should add function references to the
12788 * collection (defaults to false)
12789 * @param {Function} keyFn A function that can accept an item of the type(s) stored in this MixedCollection
12790 * and return the key value for that item. This is used when available to look up the key on items that
12791 * were passed without an explicit key parameter to a MixedCollection method. Passing this parameter is
12792 * equivalent to providing an implementation for the {@link #getKey} method.
12794 Roo.util.MixedCollection = function(allowFunctions, keyFn){
12802 * Fires when the collection is cleared.
12807 * Fires when an item is added to the collection.
12808 * @param {Number} index The index at which the item was added.
12809 * @param {Object} o The item added.
12810 * @param {String} key The key associated with the added item.
12815 * Fires when an item is replaced in the collection.
12816 * @param {String} key he key associated with the new added.
12817 * @param {Object} old The item being replaced.
12818 * @param {Object} new The new item.
12823 * Fires when an item is removed from the collection.
12824 * @param {Object} o The item being removed.
12825 * @param {String} key (optional) The key associated with the removed item.
12830 this.allowFunctions = allowFunctions === true;
12832 this.getKey = keyFn;
12834 Roo.util.MixedCollection.superclass.constructor.call(this);
12837 Roo.extend(Roo.util.MixedCollection, Roo.util.Observable, {
12838 allowFunctions : false,
12841 * Adds an item to the collection.
12842 * @param {String} key The key to associate with the item
12843 * @param {Object} o The item to add.
12844 * @return {Object} The item added.
12846 add : function(key, o){
12847 if(arguments.length == 1){
12849 key = this.getKey(o);
12851 if(typeof key == "undefined" || key === null){
12853 this.items.push(o);
12854 this.keys.push(null);
12856 var old = this.map[key];
12858 return this.replace(key, o);
12861 this.items.push(o);
12863 this.keys.push(key);
12865 this.fireEvent("add", this.length-1, o, key);
12870 * MixedCollection has a generic way to fetch keys if you implement getKey.
12873 var mc = new Roo.util.MixedCollection();
12874 mc.add(someEl.dom.id, someEl);
12875 mc.add(otherEl.dom.id, otherEl);
12879 var mc = new Roo.util.MixedCollection();
12880 mc.getKey = function(el){
12886 // or via the constructor
12887 var mc = new Roo.util.MixedCollection(false, function(el){
12893 * @param o {Object} The item for which to find the key.
12894 * @return {Object} The key for the passed item.
12896 getKey : function(o){
12901 * Replaces an item in the collection.
12902 * @param {String} key The key associated with the item to replace, or the item to replace.
12903 * @param o {Object} o (optional) If the first parameter passed was a key, the item to associate with that key.
12904 * @return {Object} The new item.
12906 replace : function(key, o){
12907 if(arguments.length == 1){
12909 key = this.getKey(o);
12911 var old = this.item(key);
12912 if(typeof key == "undefined" || key === null || typeof old == "undefined"){
12913 return this.add(key, o);
12915 var index = this.indexOfKey(key);
12916 this.items[index] = o;
12918 this.fireEvent("replace", key, old, o);
12923 * Adds all elements of an Array or an Object to the collection.
12924 * @param {Object/Array} objs An Object containing properties which will be added to the collection, or
12925 * an Array of values, each of which are added to the collection.
12927 addAll : function(objs){
12928 if(arguments.length > 1 || objs instanceof Array){
12929 var args = arguments.length > 1 ? arguments : objs;
12930 for(var i = 0, len = args.length; i < len; i++){
12934 for(var key in objs){
12935 if(this.allowFunctions || typeof objs[key] != "function"){
12936 this.add(key, objs[key]);
12943 * Executes the specified function once for every item in the collection, passing each
12944 * item as the first and only parameter. returning false from the function will stop the iteration.
12945 * @param {Function} fn The function to execute for each item.
12946 * @param {Object} scope (optional) The scope in which to execute the function.
12948 each : function(fn, scope){
12949 var items = [].concat(this.items); // each safe for removal
12950 for(var i = 0, len = items.length; i < len; i++){
12951 if(fn.call(scope || items[i], items[i], i, len) === false){
12958 * Executes the specified function once for every key in the collection, passing each
12959 * key, and its associated item as the first two parameters.
12960 * @param {Function} fn The function to execute for each item.
12961 * @param {Object} scope (optional) The scope in which to execute the function.
12963 eachKey : function(fn, scope){
12964 for(var i = 0, len = this.keys.length; i < len; i++){
12965 fn.call(scope || window, this.keys[i], this.items[i], i, len);
12970 * Returns the first item in the collection which elicits a true return value from the
12971 * passed selection function.
12972 * @param {Function} fn The selection function to execute for each item.
12973 * @param {Object} scope (optional) The scope in which to execute the function.
12974 * @return {Object} The first item in the collection which returned true from the selection function.
12976 find : function(fn, scope){
12977 for(var i = 0, len = this.items.length; i < len; i++){
12978 if(fn.call(scope || window, this.items[i], this.keys[i])){
12979 return this.items[i];
12986 * Inserts an item at the specified index in the collection.
12987 * @param {Number} index The index to insert the item at.
12988 * @param {String} key The key to associate with the new item, or the item itself.
12989 * @param {Object} o (optional) If the second parameter was a key, the new item.
12990 * @return {Object} The item inserted.
12992 insert : function(index, key, o){
12993 if(arguments.length == 2){
12995 key = this.getKey(o);
12997 if(index >= this.length){
12998 return this.add(key, o);
13001 this.items.splice(index, 0, o);
13002 if(typeof key != "undefined" && key != null){
13005 this.keys.splice(index, 0, key);
13006 this.fireEvent("add", index, o, key);
13011 * Removed an item from the collection.
13012 * @param {Object} o The item to remove.
13013 * @return {Object} The item removed.
13015 remove : function(o){
13016 return this.removeAt(this.indexOf(o));
13020 * Remove an item from a specified index in the collection.
13021 * @param {Number} index The index within the collection of the item to remove.
13023 removeAt : function(index){
13024 if(index < this.length && index >= 0){
13026 var o = this.items[index];
13027 this.items.splice(index, 1);
13028 var key = this.keys[index];
13029 if(typeof key != "undefined"){
13030 delete this.map[key];
13032 this.keys.splice(index, 1);
13033 this.fireEvent("remove", o, key);
13038 * Removed an item associated with the passed key fom the collection.
13039 * @param {String} key The key of the item to remove.
13041 removeKey : function(key){
13042 return this.removeAt(this.indexOfKey(key));
13046 * Returns the number of items in the collection.
13047 * @return {Number} the number of items in the collection.
13049 getCount : function(){
13050 return this.length;
13054 * Returns index within the collection of the passed Object.
13055 * @param {Object} o The item to find the index of.
13056 * @return {Number} index of the item.
13058 indexOf : function(o){
13059 if(!this.items.indexOf){
13060 for(var i = 0, len = this.items.length; i < len; i++){
13061 if(this.items[i] == o) return i;
13065 return this.items.indexOf(o);
13070 * Returns index within the collection of the passed key.
13071 * @param {String} key The key to find the index of.
13072 * @return {Number} index of the key.
13074 indexOfKey : function(key){
13075 if(!this.keys.indexOf){
13076 for(var i = 0, len = this.keys.length; i < len; i++){
13077 if(this.keys[i] == key) return i;
13081 return this.keys.indexOf(key);
13086 * Returns the item associated with the passed key OR index. Key has priority over index.
13087 * @param {String/Number} key The key or index of the item.
13088 * @return {Object} The item associated with the passed key.
13090 item : function(key){
13091 var item = typeof this.map[key] != "undefined" ? this.map[key] : this.items[key];
13092 return typeof item != 'function' || this.allowFunctions ? item : null; // for prototype!
13096 * Returns the item at the specified index.
13097 * @param {Number} index The index of the item.
13100 itemAt : function(index){
13101 return this.items[index];
13105 * Returns the item associated with the passed key.
13106 * @param {String/Number} key The key of the item.
13107 * @return {Object} The item associated with the passed key.
13109 key : function(key){
13110 return this.map[key];
13114 * Returns true if the collection contains the passed Object as an item.
13115 * @param {Object} o The Object to look for in the collection.
13116 * @return {Boolean} True if the collection contains the Object as an item.
13118 contains : function(o){
13119 return this.indexOf(o) != -1;
13123 * Returns true if the collection contains the passed Object as a key.
13124 * @param {String} key The key to look for in the collection.
13125 * @return {Boolean} True if the collection contains the Object as a key.
13127 containsKey : function(key){
13128 return typeof this.map[key] != "undefined";
13132 * Removes all items from the collection.
13134 clear : function(){
13139 this.fireEvent("clear");
13143 * Returns the first item in the collection.
13144 * @return {Object} the first item in the collection..
13146 first : function(){
13147 return this.items[0];
13151 * Returns the last item in the collection.
13152 * @return {Object} the last item in the collection..
13155 return this.items[this.length-1];
13158 _sort : function(property, dir, fn){
13159 var dsc = String(dir).toUpperCase() == "DESC" ? -1 : 1;
13160 fn = fn || function(a, b){
13163 var c = [], k = this.keys, items = this.items;
13164 for(var i = 0, len = items.length; i < len; i++){
13165 c[c.length] = {key: k[i], value: items[i], index: i};
13167 c.sort(function(a, b){
13168 var v = fn(a[property], b[property]) * dsc;
13170 v = (a.index < b.index ? -1 : 1);
13174 for(var i = 0, len = c.length; i < len; i++){
13175 items[i] = c[i].value;
13178 this.fireEvent("sort", this);
13182 * Sorts this collection with the passed comparison function
13183 * @param {String} direction (optional) "ASC" or "DESC"
13184 * @param {Function} fn (optional) comparison function
13186 sort : function(dir, fn){
13187 this._sort("value", dir, fn);
13191 * Sorts this collection by keys
13192 * @param {String} direction (optional) "ASC" or "DESC"
13193 * @param {Function} fn (optional) a comparison function (defaults to case insensitive string)
13195 keySort : function(dir, fn){
13196 this._sort("key", dir, fn || function(a, b){
13197 return String(a).toUpperCase()-String(b).toUpperCase();
13202 * Returns a range of items in this collection
13203 * @param {Number} startIndex (optional) defaults to 0
13204 * @param {Number} endIndex (optional) default to the last item
13205 * @return {Array} An array of items
13207 getRange : function(start, end){
13208 var items = this.items;
13209 if(items.length < 1){
13212 start = start || 0;
13213 end = Math.min(typeof end == "undefined" ? this.length-1 : end, this.length-1);
13216 for(var i = start; i <= end; i++) {
13217 r[r.length] = items[i];
13220 for(var i = start; i >= end; i--) {
13221 r[r.length] = items[i];
13228 * Filter the <i>objects</i> in this collection by a specific property.
13229 * Returns a new collection that has been filtered.
13230 * @param {String} property A property on your objects
13231 * @param {String/RegExp} value Either string that the property values
13232 * should start with or a RegExp to test against the property
13233 * @return {MixedCollection} The new filtered collection
13235 filter : function(property, value){
13236 if(!value.exec){ // not a regex
13237 value = String(value);
13238 if(value.length == 0){
13239 return this.clone();
13241 value = new RegExp("^" + Roo.escapeRe(value), "i");
13243 return this.filterBy(function(o){
13244 return o && value.test(o[property]);
13249 * Filter by a function. * Returns a new collection that has been filtered.
13250 * The passed function will be called with each
13251 * object in the collection. If the function returns true, the value is included
13252 * otherwise it is filtered.
13253 * @param {Function} fn The function to be called, it will receive the args o (the object), k (the key)
13254 * @param {Object} scope (optional) The scope of the function (defaults to this)
13255 * @return {MixedCollection} The new filtered collection
13257 filterBy : function(fn, scope){
13258 var r = new Roo.util.MixedCollection();
13259 r.getKey = this.getKey;
13260 var k = this.keys, it = this.items;
13261 for(var i = 0, len = it.length; i < len; i++){
13262 if(fn.call(scope||this, it[i], k[i])){
13263 r.add(k[i], it[i]);
13270 * Creates a duplicate of this collection
13271 * @return {MixedCollection}
13273 clone : function(){
13274 var r = new Roo.util.MixedCollection();
13275 var k = this.keys, it = this.items;
13276 for(var i = 0, len = it.length; i < len; i++){
13277 r.add(k[i], it[i]);
13279 r.getKey = this.getKey;
13284 * Returns the item associated with the passed key or index.
13286 * @param {String/Number} key The key or index of the item.
13287 * @return {Object} The item associated with the passed key.
13289 Roo.util.MixedCollection.prototype.get = Roo.util.MixedCollection.prototype.item;/*
13291 * Ext JS Library 1.1.1
13292 * Copyright(c) 2006-2007, Ext JS, LLC.
13294 * Originally Released Under LGPL - original licence link has changed is not relivant.
13297 * <script type="text/javascript">
13300 * @class Roo.util.JSON
13301 * Modified version of Douglas Crockford"s json.js that doesn"t
13302 * mess with the Object prototype
13303 * http://www.json.org/js.html
13306 Roo.util.JSON = new (function(){
13307 var useHasOwn = {}.hasOwnProperty ? true : false;
13309 // crashes Safari in some instances
13310 //var validRE = /^("(\\.|[^"\\\n\r])*?"|[,:{}\[\]0-9.\-+Eaeflnr-u \n\r\t])+?$/;
13312 var pad = function(n) {
13313 return n < 10 ? "0" + n : n;
13326 var encodeString = function(s){
13327 if (/["\\\x00-\x1f]/.test(s)) {
13328 return '"' + s.replace(/([\x00-\x1f\\"])/g, function(a, b) {
13333 c = b.charCodeAt();
13335 Math.floor(c / 16).toString(16) +
13336 (c % 16).toString(16);
13339 return '"' + s + '"';
13342 var encodeArray = function(o){
13343 var a = ["["], b, i, l = o.length, v;
13344 for (i = 0; i < l; i += 1) {
13346 switch (typeof v) {
13355 a.push(v === null ? "null" : Roo.util.JSON.encode(v));
13363 var encodeDate = function(o){
13364 return '"' + o.getFullYear() + "-" +
13365 pad(o.getMonth() + 1) + "-" +
13366 pad(o.getDate()) + "T" +
13367 pad(o.getHours()) + ":" +
13368 pad(o.getMinutes()) + ":" +
13369 pad(o.getSeconds()) + '"';
13373 * Encodes an Object, Array or other value
13374 * @param {Mixed} o The variable to encode
13375 * @return {String} The JSON string
13377 this.encode = function(o)
13379 // should this be extended to fully wrap stringify..
13381 if(typeof o == "undefined" || o === null){
13383 }else if(o instanceof Array){
13384 return encodeArray(o);
13385 }else if(o instanceof Date){
13386 return encodeDate(o);
13387 }else if(typeof o == "string"){
13388 return encodeString(o);
13389 }else if(typeof o == "number"){
13390 return isFinite(o) ? String(o) : "null";
13391 }else if(typeof o == "boolean"){
13394 var a = ["{"], b, i, v;
13396 if(!useHasOwn || o.hasOwnProperty(i)) {
13398 switch (typeof v) {
13407 a.push(this.encode(i), ":",
13408 v === null ? "null" : this.encode(v));
13419 * Decodes (parses) a JSON string to an object. If the JSON is invalid, this function throws a SyntaxError.
13420 * @param {String} json The JSON string
13421 * @return {Object} The resulting object
13423 this.decode = function(json){
13425 return /** eval:var:json */ eval("(" + json + ')');
13429 * Shorthand for {@link Roo.util.JSON#encode}
13430 * @member Roo encode
13432 Roo.encode = typeof(JSON) != 'undefined' && JSON.stringify ? JSON.stringify : Roo.util.JSON.encode;
13434 * Shorthand for {@link Roo.util.JSON#decode}
13435 * @member Roo decode
13437 Roo.decode = typeof(JSON) != 'undefined' && JSON.parse ? JSON.parse : Roo.util.JSON.decode;
13440 * Ext JS Library 1.1.1
13441 * Copyright(c) 2006-2007, Ext JS, LLC.
13443 * Originally Released Under LGPL - original licence link has changed is not relivant.
13446 * <script type="text/javascript">
13450 * @class Roo.util.Format
13451 * Reusable data formatting functions
13454 Roo.util.Format = function(){
13455 var trimRe = /^\s+|\s+$/g;
13458 * Truncate a string and add an ellipsis ('...') to the end if it exceeds the specified length
13459 * @param {String} value The string to truncate
13460 * @param {Number} length The maximum length to allow before truncating
13461 * @return {String} The converted text
13463 ellipsis : function(value, len){
13464 if(value && value.length > len){
13465 return value.substr(0, len-3)+"...";
13471 * Checks a reference and converts it to empty string if it is undefined
13472 * @param {Mixed} value Reference to check
13473 * @return {Mixed} Empty string if converted, otherwise the original value
13475 undef : function(value){
13476 return typeof value != "undefined" ? value : "";
13480 * Convert certain characters (&, <, >, and ') to their HTML character equivalents for literal display in web pages.
13481 * @param {String} value The string to encode
13482 * @return {String} The encoded text
13484 htmlEncode : function(value){
13485 return !value ? value : String(value).replace(/&/g, "&").replace(/>/g, ">").replace(/</g, "<").replace(/"/g, """);
13489 * Convert certain characters (&, <, >, and ') from their HTML character equivalents.
13490 * @param {String} value The string to decode
13491 * @return {String} The decoded text
13493 htmlDecode : function(value){
13494 return !value ? value : String(value).replace(/&/g, "&").replace(/>/g, ">").replace(/</g, "<").replace(/"/g, '"');
13498 * Trims any whitespace from either side of a string
13499 * @param {String} value The text to trim
13500 * @return {String} The trimmed text
13502 trim : function(value){
13503 return String(value).replace(trimRe, "");
13507 * Returns a substring from within an original string
13508 * @param {String} value The original text
13509 * @param {Number} start The start index of the substring
13510 * @param {Number} length The length of the substring
13511 * @return {String} The substring
13513 substr : function(value, start, length){
13514 return String(value).substr(start, length);
13518 * Converts a string to all lower case letters
13519 * @param {String} value The text to convert
13520 * @return {String} The converted text
13522 lowercase : function(value){
13523 return String(value).toLowerCase();
13527 * Converts a string to all upper case letters
13528 * @param {String} value The text to convert
13529 * @return {String} The converted text
13531 uppercase : function(value){
13532 return String(value).toUpperCase();
13536 * Converts the first character only of a string to upper case
13537 * @param {String} value The text to convert
13538 * @return {String} The converted text
13540 capitalize : function(value){
13541 return !value ? value : value.charAt(0).toUpperCase() + value.substr(1).toLowerCase();
13545 call : function(value, fn){
13546 if(arguments.length > 2){
13547 var args = Array.prototype.slice.call(arguments, 2);
13548 args.unshift(value);
13550 return /** eval:var:value */ eval(fn).apply(window, args);
13552 /** eval:var:value */
13553 return /** eval:var:value */ eval(fn).call(window, value);
13559 * safer version of Math.toFixed..??/
13560 * @param {Number/String} value The numeric value to format
13561 * @param {Number/String} value Decimal places
13562 * @return {String} The formatted currency string
13564 toFixed : function(v, n)
13566 // why not use to fixed - precision is buggered???
13568 return Math.round(v-0);
13570 var fact = Math.pow(10,n+1);
13571 v = (Math.round((v-0)*fact))/fact;
13572 var z = (''+fact).substring(2);
13573 if (v == Math.floor(v)) {
13574 return Math.floor(v) + '.' + z;
13577 // now just padd decimals..
13578 var ps = String(v).split('.');
13579 var fd = (ps[1] + z);
13580 var r = fd.substring(0,n);
13581 var rm = fd.substring(n);
13583 return ps[0] + '.' + r;
13585 r*=1; // turn it into a number;
13587 if (String(r).length != n) {
13590 r = String(r).substring(1); // chop the end off.
13593 return ps[0] + '.' + r;
13598 * Format a number as US currency
13599 * @param {Number/String} value The numeric value to format
13600 * @return {String} The formatted currency string
13602 usMoney : function(v){
13603 return '$' + Roo.util.Format.number(v);
13608 * eventually this should probably emulate php's number_format
13609 * @param {Number/String} value The numeric value to format
13610 * @param {Number} decimals number of decimal places
13611 * @return {String} The formatted currency string
13613 number : function(v,decimals)
13615 // multiply and round.
13616 decimals = typeof(decimals) == 'undefined' ? 2 : decimals;
13617 var mul = Math.pow(10, decimals);
13618 var zero = String(mul).substring(1);
13619 v = (Math.round((v-0)*mul))/mul;
13621 // if it's '0' number.. then
13623 //v = (v == Math.floor(v)) ? v + "." + zero : ((v*10 == Math.floor(v*10)) ? v + "0" : v);
13625 var ps = v.split('.');
13629 var r = /(\d+)(\d{3})/;
13631 while (r.test(whole)) {
13632 whole = whole.replace(r, '$1' + ',' + '$2');
13638 (decimals ? ('.'+ ps[1] + zero.substring(ps[1].length)) : '') :
13639 // does not have decimals
13640 (decimals ? ('.' + zero) : '');
13643 return whole + sub ;
13647 * Parse a value into a formatted date using the specified format pattern.
13648 * @param {Mixed} value The value to format
13649 * @param {String} format (optional) Any valid date format string (defaults to 'm/d/Y')
13650 * @return {String} The formatted date string
13652 date : function(v, format){
13656 if(!(v instanceof Date)){
13657 v = new Date(Date.parse(v));
13659 return v.dateFormat(format || Roo.util.Format.defaults.date);
13663 * Returns a date rendering function that can be reused to apply a date format multiple times efficiently
13664 * @param {String} format Any valid date format string
13665 * @return {Function} The date formatting function
13667 dateRenderer : function(format){
13668 return function(v){
13669 return Roo.util.Format.date(v, format);
13674 stripTagsRE : /<\/?[^>]+>/gi,
13677 * Strips all HTML tags
13678 * @param {Mixed} value The text from which to strip tags
13679 * @return {String} The stripped text
13681 stripTags : function(v){
13682 return !v ? v : String(v).replace(this.stripTagsRE, "");
13686 Roo.util.Format.defaults = {
13690 * Ext JS Library 1.1.1
13691 * Copyright(c) 2006-2007, Ext JS, LLC.
13693 * Originally Released Under LGPL - original licence link has changed is not relivant.
13696 * <script type="text/javascript">
13703 * @class Roo.MasterTemplate
13704 * @extends Roo.Template
13705 * Provides a template that can have child templates. The syntax is:
13707 var t = new Roo.MasterTemplate(
13708 '<select name="{name}">',
13709 '<tpl name="options"><option value="{value:trim}">{text:ellipsis(10)}</option></tpl>',
13712 t.add('options', {value: 'foo', text: 'bar'});
13713 // or you can add multiple child elements in one shot
13714 t.addAll('options', [
13715 {value: 'foo', text: 'bar'},
13716 {value: 'foo2', text: 'bar2'},
13717 {value: 'foo3', text: 'bar3'}
13719 // then append, applying the master template values
13720 t.append('my-form', {name: 'my-select'});
13722 * A name attribute for the child template is not required if you have only one child
13723 * template or you want to refer to them by index.
13725 Roo.MasterTemplate = function(){
13726 Roo.MasterTemplate.superclass.constructor.apply(this, arguments);
13727 this.originalHtml = this.html;
13729 var m, re = this.subTemplateRe;
13732 while(m = re.exec(this.html)){
13733 var name = m[1], content = m[2];
13738 tpl : new Roo.Template(content)
13741 st[name] = st[subIndex];
13743 st[subIndex].tpl.compile();
13744 st[subIndex].tpl.call = this.call.createDelegate(this);
13747 this.subCount = subIndex;
13750 Roo.extend(Roo.MasterTemplate, Roo.Template, {
13752 * The regular expression used to match sub templates
13756 subTemplateRe : /<tpl(?:\sname="([\w-]+)")?>((?:.|\n)*?)<\/tpl>/gi,
13759 * Applies the passed values to a child template.
13760 * @param {String/Number} name (optional) The name or index of the child template
13761 * @param {Array/Object} values The values to be applied to the template
13762 * @return {MasterTemplate} this
13764 add : function(name, values){
13765 if(arguments.length == 1){
13766 values = arguments[0];
13769 var s = this.subs[name];
13770 s.buffer[s.buffer.length] = s.tpl.apply(values);
13775 * Applies all the passed values to a child template.
13776 * @param {String/Number} name (optional) The name or index of the child template
13777 * @param {Array} values The values to be applied to the template, this should be an array of objects.
13778 * @param {Boolean} reset (optional) True to reset the template first
13779 * @return {MasterTemplate} this
13781 fill : function(name, values, reset){
13783 if(a.length == 1 || (a.length == 2 && typeof a[1] == "boolean")){
13791 for(var i = 0, len = values.length; i < len; i++){
13792 this.add(name, values[i]);
13798 * Resets the template for reuse
13799 * @return {MasterTemplate} this
13801 reset : function(){
13803 for(var i = 0; i < this.subCount; i++){
13809 applyTemplate : function(values){
13811 var replaceIndex = -1;
13812 this.html = this.originalHtml.replace(this.subTemplateRe, function(m, name){
13813 return s[++replaceIndex].buffer.join("");
13815 return Roo.MasterTemplate.superclass.applyTemplate.call(this, values);
13818 apply : function(){
13819 return this.applyTemplate.apply(this, arguments);
13822 compile : function(){return this;}
13826 * Alias for fill().
13829 Roo.MasterTemplate.prototype.addAll = Roo.MasterTemplate.prototype.fill;
13831 * Creates a template from the passed element's value (display:none textarea, preferred) or innerHTML. e.g.
13832 * var tpl = Roo.MasterTemplate.from('element-id');
13833 * @param {String/HTMLElement} el
13834 * @param {Object} config
13837 Roo.MasterTemplate.from = function(el, config){
13838 el = Roo.getDom(el);
13839 return new Roo.MasterTemplate(el.value || el.innerHTML, config || '');
13842 * Ext JS Library 1.1.1
13843 * Copyright(c) 2006-2007, Ext JS, LLC.
13845 * Originally Released Under LGPL - original licence link has changed is not relivant.
13848 * <script type="text/javascript">
13853 * @class Roo.util.CSS
13854 * Utility class for manipulating CSS rules
13857 Roo.util.CSS = function(){
13859 var doc = document;
13861 var camelRe = /(-[a-z])/gi;
13862 var camelFn = function(m, a){ return a.charAt(1).toUpperCase(); };
13866 * Very simple dynamic creation of stylesheets from a text blob of rules. The text will wrapped in a style
13867 * tag and appended to the HEAD of the document.
13868 * @param {String|Object} cssText The text containing the css rules
13869 * @param {String} id An id to add to the stylesheet for later removal
13870 * @return {StyleSheet}
13872 createStyleSheet : function(cssText, id){
13874 var head = doc.getElementsByTagName("head")[0];
13875 var nrules = doc.createElement("style");
13876 nrules.setAttribute("type", "text/css");
13878 nrules.setAttribute("id", id);
13880 if (typeof(cssText) != 'string') {
13881 // support object maps..
13882 // not sure if this a good idea..
13883 // perhaps it should be merged with the general css handling
13884 // and handle js style props.
13885 var cssTextNew = [];
13886 for(var n in cssText) {
13888 for(var k in cssText[n]) {
13889 citems.push( k + ' : ' +cssText[n][k] + ';' );
13891 cssTextNew.push( n + ' { ' + citems.join(' ') + '} ');
13894 cssText = cssTextNew.join("\n");
13900 head.appendChild(nrules);
13901 ss = nrules.styleSheet;
13902 ss.cssText = cssText;
13905 nrules.appendChild(doc.createTextNode(cssText));
13907 nrules.cssText = cssText;
13909 head.appendChild(nrules);
13910 ss = nrules.styleSheet ? nrules.styleSheet : (nrules.sheet || doc.styleSheets[doc.styleSheets.length-1]);
13912 this.cacheStyleSheet(ss);
13917 * Removes a style or link tag by id
13918 * @param {String} id The id of the tag
13920 removeStyleSheet : function(id){
13921 var existing = doc.getElementById(id);
13923 existing.parentNode.removeChild(existing);
13928 * Dynamically swaps an existing stylesheet reference for a new one
13929 * @param {String} id The id of an existing link tag to remove
13930 * @param {String} url The href of the new stylesheet to include
13932 swapStyleSheet : function(id, url){
13933 this.removeStyleSheet(id);
13934 var ss = doc.createElement("link");
13935 ss.setAttribute("rel", "stylesheet");
13936 ss.setAttribute("type", "text/css");
13937 ss.setAttribute("id", id);
13938 ss.setAttribute("href", url);
13939 doc.getElementsByTagName("head")[0].appendChild(ss);
13943 * Refresh the rule cache if you have dynamically added stylesheets
13944 * @return {Object} An object (hash) of rules indexed by selector
13946 refreshCache : function(){
13947 return this.getRules(true);
13951 cacheStyleSheet : function(stylesheet){
13955 try{// try catch for cross domain access issue
13956 var ssRules = stylesheet.cssRules || stylesheet.rules;
13957 for(var j = ssRules.length-1; j >= 0; --j){
13958 rules[ssRules[j].selectorText] = ssRules[j];
13964 * Gets all css rules for the document
13965 * @param {Boolean} refreshCache true to refresh the internal cache
13966 * @return {Object} An object (hash) of rules indexed by selector
13968 getRules : function(refreshCache){
13969 if(rules == null || refreshCache){
13971 var ds = doc.styleSheets;
13972 for(var i =0, len = ds.length; i < len; i++){
13974 this.cacheStyleSheet(ds[i]);
13982 * Gets an an individual CSS rule by selector(s)
13983 * @param {String/Array} selector The CSS selector or an array of selectors to try. The first selector that is found is returned.
13984 * @param {Boolean} refreshCache true to refresh the internal cache if you have recently updated any rules or added styles dynamically
13985 * @return {CSSRule} The CSS rule or null if one is not found
13987 getRule : function(selector, refreshCache){
13988 var rs = this.getRules(refreshCache);
13989 if(!(selector instanceof Array)){
13990 return rs[selector];
13992 for(var i = 0; i < selector.length; i++){
13993 if(rs[selector[i]]){
13994 return rs[selector[i]];
14002 * Updates a rule property
14003 * @param {String/Array} selector If it's an array it tries each selector until it finds one. Stops immediately once one is found.
14004 * @param {String} property The css property
14005 * @param {String} value The new value for the property
14006 * @return {Boolean} true If a rule was found and updated
14008 updateRule : function(selector, property, value){
14009 if(!(selector instanceof Array)){
14010 var rule = this.getRule(selector);
14012 rule.style[property.replace(camelRe, camelFn)] = value;
14016 for(var i = 0; i < selector.length; i++){
14017 if(this.updateRule(selector[i], property, value)){
14027 * Ext JS Library 1.1.1
14028 * Copyright(c) 2006-2007, Ext JS, LLC.
14030 * Originally Released Under LGPL - original licence link has changed is not relivant.
14033 * <script type="text/javascript">
14039 * @class Roo.util.ClickRepeater
14040 * @extends Roo.util.Observable
14042 * A wrapper class which can be applied to any element. Fires a "click" event while the
14043 * mouse is pressed. The interval between firings may be specified in the config but
14044 * defaults to 10 milliseconds.
14046 * Optionally, a CSS class may be applied to the element during the time it is pressed.
14048 * @cfg {String/HTMLElement/Element} el The element to act as a button.
14049 * @cfg {Number} delay The initial delay before the repeating event begins firing.
14050 * Similar to an autorepeat key delay.
14051 * @cfg {Number} interval The interval between firings of the "click" event. Default 10 ms.
14052 * @cfg {String} pressClass A CSS class name to be applied to the element while pressed.
14053 * @cfg {Boolean} accelerate True if autorepeating should start slowly and accelerate.
14054 * "interval" and "delay" are ignored. "immediate" is honored.
14055 * @cfg {Boolean} preventDefault True to prevent the default click event
14056 * @cfg {Boolean} stopDefault True to stop the default click event
14059 * 2007-02-02 jvs Original code contributed by Nige "Animal" White
14060 * 2007-02-02 jvs Renamed to ClickRepeater
14061 * 2007-02-03 jvs Modifications for FF Mac and Safari
14064 * @param {String/HTMLElement/Element} el The element to listen on
14065 * @param {Object} config
14067 Roo.util.ClickRepeater = function(el, config)
14069 this.el = Roo.get(el);
14070 this.el.unselectable();
14072 Roo.apply(this, config);
14077 * Fires when the mouse button is depressed.
14078 * @param {Roo.util.ClickRepeater} this
14080 "mousedown" : true,
14083 * Fires on a specified interval during the time the element is pressed.
14084 * @param {Roo.util.ClickRepeater} this
14089 * Fires when the mouse key is released.
14090 * @param {Roo.util.ClickRepeater} this
14095 this.el.on("mousedown", this.handleMouseDown, this);
14096 if(this.preventDefault || this.stopDefault){
14097 this.el.on("click", function(e){
14098 if(this.preventDefault){
14099 e.preventDefault();
14101 if(this.stopDefault){
14107 // allow inline handler
14109 this.on("click", this.handler, this.scope || this);
14112 Roo.util.ClickRepeater.superclass.constructor.call(this);
14115 Roo.extend(Roo.util.ClickRepeater, Roo.util.Observable, {
14118 preventDefault : true,
14119 stopDefault : false,
14123 handleMouseDown : function(){
14124 clearTimeout(this.timer);
14126 if(this.pressClass){
14127 this.el.addClass(this.pressClass);
14129 this.mousedownTime = new Date();
14131 Roo.get(document).on("mouseup", this.handleMouseUp, this);
14132 this.el.on("mouseout", this.handleMouseOut, this);
14134 this.fireEvent("mousedown", this);
14135 this.fireEvent("click", this);
14137 this.timer = this.click.defer(this.delay || this.interval, this);
14141 click : function(){
14142 this.fireEvent("click", this);
14143 this.timer = this.click.defer(this.getInterval(), this);
14147 getInterval: function(){
14148 if(!this.accelerate){
14149 return this.interval;
14151 var pressTime = this.mousedownTime.getElapsed();
14152 if(pressTime < 500){
14154 }else if(pressTime < 1700){
14156 }else if(pressTime < 2600){
14158 }else if(pressTime < 3500){
14160 }else if(pressTime < 4400){
14162 }else if(pressTime < 5300){
14164 }else if(pressTime < 6200){
14172 handleMouseOut : function(){
14173 clearTimeout(this.timer);
14174 if(this.pressClass){
14175 this.el.removeClass(this.pressClass);
14177 this.el.on("mouseover", this.handleMouseReturn, this);
14181 handleMouseReturn : function(){
14182 this.el.un("mouseover", this.handleMouseReturn);
14183 if(this.pressClass){
14184 this.el.addClass(this.pressClass);
14190 handleMouseUp : function(){
14191 clearTimeout(this.timer);
14192 this.el.un("mouseover", this.handleMouseReturn);
14193 this.el.un("mouseout", this.handleMouseOut);
14194 Roo.get(document).un("mouseup", this.handleMouseUp);
14195 this.el.removeClass(this.pressClass);
14196 this.fireEvent("mouseup", this);
14200 * Ext JS Library 1.1.1
14201 * Copyright(c) 2006-2007, Ext JS, LLC.
14203 * Originally Released Under LGPL - original licence link has changed is not relivant.
14206 * <script type="text/javascript">
14211 * @class Roo.KeyNav
14212 * <p>Provides a convenient wrapper for normalized keyboard navigation. KeyNav allows you to bind
14213 * navigation keys to function calls that will get called when the keys are pressed, providing an easy
14214 * way to implement custom navigation schemes for any UI component.</p>
14215 * <p>The following are all of the possible keys that can be implemented: enter, left, right, up, down, tab, esc,
14216 * pageUp, pageDown, del, home, end. Usage:</p>
14218 var nav = new Roo.KeyNav("my-element", {
14219 "left" : function(e){
14220 this.moveLeft(e.ctrlKey);
14222 "right" : function(e){
14223 this.moveRight(e.ctrlKey);
14225 "enter" : function(e){
14232 * @param {String/HTMLElement/Roo.Element} el The element to bind to
14233 * @param {Object} config The config
14235 Roo.KeyNav = function(el, config){
14236 this.el = Roo.get(el);
14237 Roo.apply(this, config);
14238 if(!this.disabled){
14239 this.disabled = true;
14244 Roo.KeyNav.prototype = {
14246 * @cfg {Boolean} disabled
14247 * True to disable this KeyNav instance (defaults to false)
14251 * @cfg {String} defaultEventAction
14252 * The method to call on the {@link Roo.EventObject} after this KeyNav intercepts a key. Valid values are
14253 * {@link Roo.EventObject#stopEvent}, {@link Roo.EventObject#preventDefault} and
14254 * {@link Roo.EventObject#stopPropagation} (defaults to 'stopEvent')
14256 defaultEventAction: "stopEvent",
14258 * @cfg {Boolean} forceKeyDown
14259 * Handle the keydown event instead of keypress (defaults to false). KeyNav automatically does this for IE since
14260 * IE does not propagate special keys on keypress, but setting this to true will force other browsers to also
14261 * handle keydown instead of keypress.
14263 forceKeyDown : false,
14266 prepareEvent : function(e){
14267 var k = e.getKey();
14268 var h = this.keyToHandler[k];
14269 //if(h && this[h]){
14270 // e.stopPropagation();
14272 if(Roo.isSafari && h && k >= 37 && k <= 40){
14278 relay : function(e){
14279 var k = e.getKey();
14280 var h = this.keyToHandler[k];
14282 if(this.doRelay(e, this[h], h) !== true){
14283 e[this.defaultEventAction]();
14289 doRelay : function(e, h, hname){
14290 return h.call(this.scope || this, e);
14293 // possible handlers
14307 // quick lookup hash
14324 * Enable this KeyNav
14326 enable: function(){
14328 // ie won't do special keys on keypress, no one else will repeat keys with keydown
14329 // the EventObject will normalize Safari automatically
14330 if(this.forceKeyDown || Roo.isIE || Roo.isAir){
14331 this.el.on("keydown", this.relay, this);
14333 this.el.on("keydown", this.prepareEvent, this);
14334 this.el.on("keypress", this.relay, this);
14336 this.disabled = false;
14341 * Disable this KeyNav
14343 disable: function(){
14344 if(!this.disabled){
14345 if(this.forceKeyDown || Roo.isIE || Roo.isAir){
14346 this.el.un("keydown", this.relay);
14348 this.el.un("keydown", this.prepareEvent);
14349 this.el.un("keypress", this.relay);
14351 this.disabled = true;
14356 * Ext JS Library 1.1.1
14357 * Copyright(c) 2006-2007, Ext JS, LLC.
14359 * Originally Released Under LGPL - original licence link has changed is not relivant.
14362 * <script type="text/javascript">
14367 * @class Roo.KeyMap
14368 * Handles mapping keys to actions for an element. One key map can be used for multiple actions.
14369 * The constructor accepts the same config object as defined by {@link #addBinding}.
14370 * If you bind a callback function to a KeyMap, anytime the KeyMap handles an expected key
14371 * combination it will call the function with this signature (if the match is a multi-key
14372 * combination the callback will still be called only once): (String key, Roo.EventObject e)
14373 * A KeyMap can also handle a string representation of keys.<br />
14376 // map one key by key code
14377 var map = new Roo.KeyMap("my-element", {
14378 key: 13, // or Roo.EventObject.ENTER
14383 // map multiple keys to one action by string
14384 var map = new Roo.KeyMap("my-element", {
14390 // map multiple keys to multiple actions by strings and array of codes
14391 var map = new Roo.KeyMap("my-element", [
14394 fn: function(){ alert("Return was pressed"); }
14397 fn: function(){ alert('a, b or c was pressed'); }
14402 fn: function(){ alert('Control + shift + tab was pressed.'); }
14406 * <b>Note: A KeyMap starts enabled</b>
14408 * @param {String/HTMLElement/Roo.Element} el The element to bind to
14409 * @param {Object} config The config (see {@link #addBinding})
14410 * @param {String} eventName (optional) The event to bind to (defaults to "keydown")
14412 Roo.KeyMap = function(el, config, eventName){
14413 this.el = Roo.get(el);
14414 this.eventName = eventName || "keydown";
14415 this.bindings = [];
14417 this.addBinding(config);
14422 Roo.KeyMap.prototype = {
14424 * True to stop the event from bubbling and prevent the default browser action if the
14425 * key was handled by the KeyMap (defaults to false)
14431 * Add a new binding to this KeyMap. The following config object properties are supported:
14433 Property Type Description
14434 ---------- --------------- ----------------------------------------------------------------------
14435 key String/Array A single keycode or an array of keycodes to handle
14436 shift Boolean True to handle key only when shift is pressed (defaults to false)
14437 ctrl Boolean True to handle key only when ctrl is pressed (defaults to false)
14438 alt Boolean True to handle key only when alt is pressed (defaults to false)
14439 fn Function The function to call when KeyMap finds the expected key combination
14440 scope Object The scope of the callback function
14446 var map = new Roo.KeyMap(document, {
14447 key: Roo.EventObject.ENTER,
14452 //Add a new binding to the existing KeyMap later
14460 * @param {Object/Array} config A single KeyMap config or an array of configs
14462 addBinding : function(config){
14463 if(config instanceof Array){
14464 for(var i = 0, len = config.length; i < len; i++){
14465 this.addBinding(config[i]);
14469 var keyCode = config.key,
14470 shift = config.shift,
14471 ctrl = config.ctrl,
14474 scope = config.scope;
14475 if(typeof keyCode == "string"){
14477 var keyString = keyCode.toUpperCase();
14478 for(var j = 0, len = keyString.length; j < len; j++){
14479 ks.push(keyString.charCodeAt(j));
14483 var keyArray = keyCode instanceof Array;
14484 var handler = function(e){
14485 if((!shift || e.shiftKey) && (!ctrl || e.ctrlKey) && (!alt || e.altKey)){
14486 var k = e.getKey();
14488 for(var i = 0, len = keyCode.length; i < len; i++){
14489 if(keyCode[i] == k){
14490 if(this.stopEvent){
14493 fn.call(scope || window, k, e);
14499 if(this.stopEvent){
14502 fn.call(scope || window, k, e);
14507 this.bindings.push(handler);
14511 * Shorthand for adding a single key listener
14512 * @param {Number/Array/Object} key Either the numeric key code, array of key codes or an object with the
14513 * following options:
14514 * {key: (number or array), shift: (true/false), ctrl: (true/false), alt: (true/false)}
14515 * @param {Function} fn The function to call
14516 * @param {Object} scope (optional) The scope of the function
14518 on : function(key, fn, scope){
14519 var keyCode, shift, ctrl, alt;
14520 if(typeof key == "object" && !(key instanceof Array)){
14539 handleKeyDown : function(e){
14540 if(this.enabled){ //just in case
14541 var b = this.bindings;
14542 for(var i = 0, len = b.length; i < len; i++){
14543 b[i].call(this, e);
14549 * Returns true if this KeyMap is enabled
14550 * @return {Boolean}
14552 isEnabled : function(){
14553 return this.enabled;
14557 * Enables this KeyMap
14559 enable: function(){
14561 this.el.on(this.eventName, this.handleKeyDown, this);
14562 this.enabled = true;
14567 * Disable this KeyMap
14569 disable: function(){
14571 this.el.removeListener(this.eventName, this.handleKeyDown, this);
14572 this.enabled = false;
14577 * Ext JS Library 1.1.1
14578 * Copyright(c) 2006-2007, Ext JS, LLC.
14580 * Originally Released Under LGPL - original licence link has changed is not relivant.
14583 * <script type="text/javascript">
14588 * @class Roo.util.TextMetrics
14589 * Provides precise pixel measurements for blocks of text so that you can determine exactly how high and
14590 * wide, in pixels, a given block of text will be.
14593 Roo.util.TextMetrics = function(){
14597 * Measures the size of the specified text
14598 * @param {String/HTMLElement} el The element, dom node or id from which to copy existing CSS styles
14599 * that can affect the size of the rendered text
14600 * @param {String} text The text to measure
14601 * @param {Number} fixedWidth (optional) If the text will be multiline, you have to set a fixed width
14602 * in order to accurately measure the text height
14603 * @return {Object} An object containing the text's size {width: (width), height: (height)}
14605 measure : function(el, text, fixedWidth){
14607 shared = Roo.util.TextMetrics.Instance(el, fixedWidth);
14610 shared.setFixedWidth(fixedWidth || 'auto');
14611 return shared.getSize(text);
14615 * Return a unique TextMetrics instance that can be bound directly to an element and reused. This reduces
14616 * the overhead of multiple calls to initialize the style properties on each measurement.
14617 * @param {String/HTMLElement} el The element, dom node or id that the instance will be bound to
14618 * @param {Number} fixedWidth (optional) If the text will be multiline, you have to set a fixed width
14619 * in order to accurately measure the text height
14620 * @return {Roo.util.TextMetrics.Instance} instance The new instance
14622 createInstance : function(el, fixedWidth){
14623 return Roo.util.TextMetrics.Instance(el, fixedWidth);
14630 Roo.util.TextMetrics.Instance = function(bindTo, fixedWidth){
14631 var ml = new Roo.Element(document.createElement('div'));
14632 document.body.appendChild(ml.dom);
14633 ml.position('absolute');
14634 ml.setLeftTop(-1000, -1000);
14638 ml.setWidth(fixedWidth);
14643 * Returns the size of the specified text based on the internal element's style and width properties
14644 * @memberOf Roo.util.TextMetrics.Instance#
14645 * @param {String} text The text to measure
14646 * @return {Object} An object containing the text's size {width: (width), height: (height)}
14648 getSize : function(text){
14650 var s = ml.getSize();
14656 * Binds this TextMetrics instance to an element from which to copy existing CSS styles
14657 * that can affect the size of the rendered text
14658 * @memberOf Roo.util.TextMetrics.Instance#
14659 * @param {String/HTMLElement} el The element, dom node or id
14661 bind : function(el){
14663 Roo.fly(el).getStyles('font-size','font-style', 'font-weight', 'font-family','line-height')
14668 * Sets a fixed width on the internal measurement element. If the text will be multiline, you have
14669 * to set a fixed width in order to accurately measure the text height.
14670 * @memberOf Roo.util.TextMetrics.Instance#
14671 * @param {Number} width The width to set on the element
14673 setFixedWidth : function(width){
14674 ml.setWidth(width);
14678 * Returns the measured width of the specified text
14679 * @memberOf Roo.util.TextMetrics.Instance#
14680 * @param {String} text The text to measure
14681 * @return {Number} width The width in pixels
14683 getWidth : function(text){
14684 ml.dom.style.width = 'auto';
14685 return this.getSize(text).width;
14689 * Returns the measured height of the specified text. For multiline text, be sure to call
14690 * {@link #setFixedWidth} if necessary.
14691 * @memberOf Roo.util.TextMetrics.Instance#
14692 * @param {String} text The text to measure
14693 * @return {Number} height The height in pixels
14695 getHeight : function(text){
14696 return this.getSize(text).height;
14700 instance.bind(bindTo);
14705 // backwards compat
14706 Roo.Element.measureText = Roo.util.TextMetrics.measure;/*
14708 * Ext JS Library 1.1.1
14709 * Copyright(c) 2006-2007, Ext JS, LLC.
14711 * Originally Released Under LGPL - original licence link has changed is not relivant.
14714 * <script type="text/javascript">
14718 * @class Roo.state.Provider
14719 * Abstract base class for state provider implementations. This class provides methods
14720 * for encoding and decoding <b>typed</b> variables including dates and defines the
14721 * Provider interface.
14723 Roo.state.Provider = function(){
14725 * @event statechange
14726 * Fires when a state change occurs.
14727 * @param {Provider} this This state provider
14728 * @param {String} key The state key which was changed
14729 * @param {String} value The encoded value for the state
14732 "statechange": true
14735 Roo.state.Provider.superclass.constructor.call(this);
14737 Roo.extend(Roo.state.Provider, Roo.util.Observable, {
14739 * Returns the current value for a key
14740 * @param {String} name The key name
14741 * @param {Mixed} defaultValue A default value to return if the key's value is not found
14742 * @return {Mixed} The state data
14744 get : function(name, defaultValue){
14745 return typeof this.state[name] == "undefined" ?
14746 defaultValue : this.state[name];
14750 * Clears a value from the state
14751 * @param {String} name The key name
14753 clear : function(name){
14754 delete this.state[name];
14755 this.fireEvent("statechange", this, name, null);
14759 * Sets the value for a key
14760 * @param {String} name The key name
14761 * @param {Mixed} value The value to set
14763 set : function(name, value){
14764 this.state[name] = value;
14765 this.fireEvent("statechange", this, name, value);
14769 * Decodes a string previously encoded with {@link #encodeValue}.
14770 * @param {String} value The value to decode
14771 * @return {Mixed} The decoded value
14773 decodeValue : function(cookie){
14774 var re = /^(a|n|d|b|s|o)\:(.*)$/;
14775 var matches = re.exec(unescape(cookie));
14776 if(!matches || !matches[1]) return; // non state cookie
14777 var type = matches[1];
14778 var v = matches[2];
14781 return parseFloat(v);
14783 return new Date(Date.parse(v));
14788 var values = v.split("^");
14789 for(var i = 0, len = values.length; i < len; i++){
14790 all.push(this.decodeValue(values[i]));
14795 var values = v.split("^");
14796 for(var i = 0, len = values.length; i < len; i++){
14797 var kv = values[i].split("=");
14798 all[kv[0]] = this.decodeValue(kv[1]);
14807 * Encodes a value including type information. Decode with {@link #decodeValue}.
14808 * @param {Mixed} value The value to encode
14809 * @return {String} The encoded value
14811 encodeValue : function(v){
14813 if(typeof v == "number"){
14815 }else if(typeof v == "boolean"){
14816 enc = "b:" + (v ? "1" : "0");
14817 }else if(v instanceof Date){
14818 enc = "d:" + v.toGMTString();
14819 }else if(v instanceof Array){
14821 for(var i = 0, len = v.length; i < len; i++){
14822 flat += this.encodeValue(v[i]);
14823 if(i != len-1) flat += "^";
14826 }else if(typeof v == "object"){
14829 if(typeof v[key] != "function"){
14830 flat += key + "=" + this.encodeValue(v[key]) + "^";
14833 enc = "o:" + flat.substring(0, flat.length-1);
14837 return escape(enc);
14843 * Ext JS Library 1.1.1
14844 * Copyright(c) 2006-2007, Ext JS, LLC.
14846 * Originally Released Under LGPL - original licence link has changed is not relivant.
14849 * <script type="text/javascript">
14852 * @class Roo.state.Manager
14853 * This is the global state manager. By default all components that are "state aware" check this class
14854 * for state information if you don't pass them a custom state provider. In order for this class
14855 * to be useful, it must be initialized with a provider when your application initializes.
14857 // in your initialization function
14859 Roo.state.Manager.setProvider(new Roo.state.CookieProvider());
14861 // supposed you have a {@link Roo.BorderLayout}
14862 var layout = new Roo.BorderLayout(...);
14863 layout.restoreState();
14864 // or a {Roo.BasicDialog}
14865 var dialog = new Roo.BasicDialog(...);
14866 dialog.restoreState();
14870 Roo.state.Manager = function(){
14871 var provider = new Roo.state.Provider();
14875 * Configures the default state provider for your application
14876 * @param {Provider} stateProvider The state provider to set
14878 setProvider : function(stateProvider){
14879 provider = stateProvider;
14883 * Returns the current value for a key
14884 * @param {String} name The key name
14885 * @param {Mixed} defaultValue The default value to return if the key lookup does not match
14886 * @return {Mixed} The state data
14888 get : function(key, defaultValue){
14889 return provider.get(key, defaultValue);
14893 * Sets the value for a key
14894 * @param {String} name The key name
14895 * @param {Mixed} value The state data
14897 set : function(key, value){
14898 provider.set(key, value);
14902 * Clears a value from the state
14903 * @param {String} name The key name
14905 clear : function(key){
14906 provider.clear(key);
14910 * Gets the currently configured state provider
14911 * @return {Provider} The state provider
14913 getProvider : function(){
14920 * Ext JS Library 1.1.1
14921 * Copyright(c) 2006-2007, Ext JS, LLC.
14923 * Originally Released Under LGPL - original licence link has changed is not relivant.
14926 * <script type="text/javascript">
14929 * @class Roo.state.CookieProvider
14930 * @extends Roo.state.Provider
14931 * The default Provider implementation which saves state via cookies.
14934 var cp = new Roo.state.CookieProvider({
14936 expires: new Date(new Date().getTime()+(1000*60*60*24*30)); //30 days
14937 domain: "roojs.com"
14939 Roo.state.Manager.setProvider(cp);
14941 * @cfg {String} path The path for which the cookie is active (defaults to root '/' which makes it active for all pages in the site)
14942 * @cfg {Date} expires The cookie expiration date (defaults to 7 days from now)
14943 * @cfg {String} domain The domain to save the cookie for. Note that you cannot specify a different domain than
14944 * your page is on, but you can specify a sub-domain, or simply the domain itself like 'roojs.com' to include
14945 * all sub-domains if you need to access cookies across different sub-domains (defaults to null which uses the same
14946 * domain the page is running on including the 'www' like 'www.roojs.com')
14947 * @cfg {Boolean} secure True if the site is using SSL (defaults to false)
14949 * Create a new CookieProvider
14950 * @param {Object} config The configuration object
14952 Roo.state.CookieProvider = function(config){
14953 Roo.state.CookieProvider.superclass.constructor.call(this);
14955 this.expires = new Date(new Date().getTime()+(1000*60*60*24*7)); //7 days
14956 this.domain = null;
14957 this.secure = false;
14958 Roo.apply(this, config);
14959 this.state = this.readCookies();
14962 Roo.extend(Roo.state.CookieProvider, Roo.state.Provider, {
14964 set : function(name, value){
14965 if(typeof value == "undefined" || value === null){
14969 this.setCookie(name, value);
14970 Roo.state.CookieProvider.superclass.set.call(this, name, value);
14974 clear : function(name){
14975 this.clearCookie(name);
14976 Roo.state.CookieProvider.superclass.clear.call(this, name);
14980 readCookies : function(){
14982 var c = document.cookie + ";";
14983 var re = /\s?(.*?)=(.*?);/g;
14985 while((matches = re.exec(c)) != null){
14986 var name = matches[1];
14987 var value = matches[2];
14988 if(name && name.substring(0,3) == "ys-"){
14989 cookies[name.substr(3)] = this.decodeValue(value);
14996 setCookie : function(name, value){
14997 document.cookie = "ys-"+ name + "=" + this.encodeValue(value) +
14998 ((this.expires == null) ? "" : ("; expires=" + this.expires.toGMTString())) +
14999 ((this.path == null) ? "" : ("; path=" + this.path)) +
15000 ((this.domain == null) ? "" : ("; domain=" + this.domain)) +
15001 ((this.secure == true) ? "; secure" : "");
15005 clearCookie : function(name){
15006 document.cookie = "ys-" + name + "=null; expires=Thu, 01-Jan-70 00:00:01 GMT" +
15007 ((this.path == null) ? "" : ("; path=" + this.path)) +
15008 ((this.domain == null) ? "" : ("; domain=" + this.domain)) +
15009 ((this.secure == true) ? "; secure" : "");
15013 * Ext JS Library 1.1.1
15014 * Copyright(c) 2006-2007, Ext JS, LLC.
15016 * Originally Released Under LGPL - original licence link has changed is not relivant.
15019 * <script type="text/javascript">
15024 * @class Roo.ComponentMgr
15025 * Provides a common registry of all components on a page so that they can be easily accessed by component id (see {@link Roo.getCmp}).
15028 Roo.ComponentMgr = function(){
15029 var all = new Roo.util.MixedCollection();
15033 * Registers a component.
15034 * @param {Roo.Component} c The component
15036 register : function(c){
15041 * Unregisters a component.
15042 * @param {Roo.Component} c The component
15044 unregister : function(c){
15049 * Returns a component by id
15050 * @param {String} id The component id
15052 get : function(id){
15053 return all.get(id);
15057 * Registers a function that will be called when a specified component is added to ComponentMgr
15058 * @param {String} id The component id
15059 * @param {Funtction} fn The callback function
15060 * @param {Object} scope The scope of the callback
15062 onAvailable : function(id, fn, scope){
15063 all.on("add", function(index, o){
15065 fn.call(scope || o, o);
15066 all.un("add", fn, scope);
15073 * Ext JS Library 1.1.1
15074 * Copyright(c) 2006-2007, Ext JS, LLC.
15076 * Originally Released Under LGPL - original licence link has changed is not relivant.
15079 * <script type="text/javascript">
15083 * @class Roo.Component
15084 * @extends Roo.util.Observable
15085 * Base class for all major Roo components. All subclasses of Component can automatically participate in the standard
15086 * Roo component lifecycle of creation, rendering and destruction. They also have automatic support for basic hide/show
15087 * and enable/disable behavior. Component allows any subclass to be lazy-rendered into any {@link Roo.Container} and
15088 * to be automatically registered with the {@link Roo.ComponentMgr} so that it can be referenced at any time via {@link Roo.getCmp}.
15089 * All visual components (widgets) that require rendering into a layout should subclass Component.
15091 * @param {Roo.Element/String/Object} config The configuration options. If an element is passed, it is set as the internal
15092 * element and its id used as the component id. If a string is passed, it is assumed to be the id of an existing element
15093 * and is used as the component id. Otherwise, it is assumed to be a standard config object and is applied to the component.
15095 Roo.Component = function(config){
15096 config = config || {};
15097 if(config.tagName || config.dom || typeof config == "string"){ // element object
15098 config = {el: config, id: config.id || config};
15100 this.initialConfig = config;
15102 Roo.apply(this, config);
15106 * Fires after the component is disabled.
15107 * @param {Roo.Component} this
15112 * Fires after the component is enabled.
15113 * @param {Roo.Component} this
15117 * @event beforeshow
15118 * Fires before the component is shown. Return false to stop the show.
15119 * @param {Roo.Component} this
15124 * Fires after the component is shown.
15125 * @param {Roo.Component} this
15129 * @event beforehide
15130 * Fires before the component is hidden. Return false to stop the hide.
15131 * @param {Roo.Component} this
15136 * Fires after the component is hidden.
15137 * @param {Roo.Component} this
15141 * @event beforerender
15142 * Fires before the component is rendered. Return false to stop the render.
15143 * @param {Roo.Component} this
15145 beforerender : true,
15148 * Fires after the component is rendered.
15149 * @param {Roo.Component} this
15153 * @event beforedestroy
15154 * Fires before the component is destroyed. Return false to stop the destroy.
15155 * @param {Roo.Component} this
15157 beforedestroy : true,
15160 * Fires after the component is destroyed.
15161 * @param {Roo.Component} this
15166 this.id = "ext-comp-" + (++Roo.Component.AUTO_ID);
15168 Roo.ComponentMgr.register(this);
15169 Roo.Component.superclass.constructor.call(this);
15170 this.initComponent();
15171 if(this.renderTo){ // not supported by all components yet. use at your own risk!
15172 this.render(this.renderTo);
15173 delete this.renderTo;
15178 Roo.Component.AUTO_ID = 1000;
15180 Roo.extend(Roo.Component, Roo.util.Observable, {
15182 * @scope Roo.Component.prototype
15184 * true if this component is hidden. Read-only.
15189 * true if this component is disabled. Read-only.
15194 * true if this component has been rendered. Read-only.
15198 /** @cfg {String} disableClass
15199 * CSS class added to the component when it is disabled (defaults to "x-item-disabled").
15201 disabledClass : "x-item-disabled",
15202 /** @cfg {Boolean} allowDomMove
15203 * Whether the component can move the Dom node when rendering (defaults to true).
15205 allowDomMove : true,
15206 /** @cfg {String} hideMode
15207 * How this component should hidden. Supported values are
15208 * "visibility" (css visibility), "offsets" (negative offset position) and
15209 * "display" (css display) - defaults to "display".
15211 hideMode: 'display',
15214 ctype : "Roo.Component",
15217 * @cfg {String} actionMode
15218 * which property holds the element that used for hide() / show() / disable() / enable()
15224 getActionEl : function(){
15225 return this[this.actionMode];
15228 initComponent : Roo.emptyFn,
15230 * If this is a lazy rendering component, render it to its container element.
15231 * @param {String/HTMLElement/Element} container (optional) The element this component should be rendered into. If it is being applied to existing markup, this should be left off.
15233 render : function(container, position){
15234 if(!this.rendered && this.fireEvent("beforerender", this) !== false){
15235 if(!container && this.el){
15236 this.el = Roo.get(this.el);
15237 container = this.el.dom.parentNode;
15238 this.allowDomMove = false;
15240 this.container = Roo.get(container);
15241 this.rendered = true;
15242 if(position !== undefined){
15243 if(typeof position == 'number'){
15244 position = this.container.dom.childNodes[position];
15246 position = Roo.getDom(position);
15249 this.onRender(this.container, position || null);
15251 this.el.addClass(this.cls);
15255 this.el.applyStyles(this.style);
15258 this.fireEvent("render", this);
15259 this.afterRender(this.container);
15271 // default function is not really useful
15272 onRender : function(ct, position){
15274 this.el = Roo.get(this.el);
15275 if(this.allowDomMove !== false){
15276 ct.dom.insertBefore(this.el.dom, position);
15282 getAutoCreate : function(){
15283 var cfg = typeof this.autoCreate == "object" ?
15284 this.autoCreate : Roo.apply({}, this.defaultAutoCreate);
15285 if(this.id && !cfg.id){
15292 afterRender : Roo.emptyFn,
15295 * Destroys this component by purging any event listeners, removing the component's element from the DOM,
15296 * removing the component from its {@link Roo.Container} (if applicable) and unregistering it from {@link Roo.ComponentMgr}.
15298 destroy : function(){
15299 if(this.fireEvent("beforedestroy", this) !== false){
15300 this.purgeListeners();
15301 this.beforeDestroy();
15303 this.el.removeAllListeners();
15305 if(this.actionMode == "container"){
15306 this.container.remove();
15310 Roo.ComponentMgr.unregister(this);
15311 this.fireEvent("destroy", this);
15316 beforeDestroy : function(){
15321 onDestroy : function(){
15326 * Returns the underlying {@link Roo.Element}.
15327 * @return {Roo.Element} The element
15329 getEl : function(){
15334 * Returns the id of this component.
15337 getId : function(){
15342 * Try to focus this component.
15343 * @param {Boolean} selectText True to also select the text in this component (if applicable)
15344 * @return {Roo.Component} this
15346 focus : function(selectText){
15349 if(selectText === true){
15350 this.el.dom.select();
15365 * Disable this component.
15366 * @return {Roo.Component} this
15368 disable : function(){
15372 this.disabled = true;
15373 this.fireEvent("disable", this);
15378 onDisable : function(){
15379 this.getActionEl().addClass(this.disabledClass);
15380 this.el.dom.disabled = true;
15384 * Enable this component.
15385 * @return {Roo.Component} this
15387 enable : function(){
15391 this.disabled = false;
15392 this.fireEvent("enable", this);
15397 onEnable : function(){
15398 this.getActionEl().removeClass(this.disabledClass);
15399 this.el.dom.disabled = false;
15403 * Convenience function for setting disabled/enabled by boolean.
15404 * @param {Boolean} disabled
15406 setDisabled : function(disabled){
15407 this[disabled ? "disable" : "enable"]();
15411 * Show this component.
15412 * @return {Roo.Component} this
15415 if(this.fireEvent("beforeshow", this) !== false){
15416 this.hidden = false;
15420 this.fireEvent("show", this);
15426 onShow : function(){
15427 var ae = this.getActionEl();
15428 if(this.hideMode == 'visibility'){
15429 ae.dom.style.visibility = "visible";
15430 }else if(this.hideMode == 'offsets'){
15431 ae.removeClass('x-hidden');
15433 ae.dom.style.display = "";
15438 * Hide this component.
15439 * @return {Roo.Component} this
15442 if(this.fireEvent("beforehide", this) !== false){
15443 this.hidden = true;
15447 this.fireEvent("hide", this);
15453 onHide : function(){
15454 var ae = this.getActionEl();
15455 if(this.hideMode == 'visibility'){
15456 ae.dom.style.visibility = "hidden";
15457 }else if(this.hideMode == 'offsets'){
15458 ae.addClass('x-hidden');
15460 ae.dom.style.display = "none";
15465 * Convenience function to hide or show this component by boolean.
15466 * @param {Boolean} visible True to show, false to hide
15467 * @return {Roo.Component} this
15469 setVisible: function(visible){
15479 * Returns true if this component is visible.
15481 isVisible : function(){
15482 return this.getActionEl().isVisible();
15485 cloneConfig : function(overrides){
15486 overrides = overrides || {};
15487 var id = overrides.id || Roo.id();
15488 var cfg = Roo.applyIf(overrides, this.initialConfig);
15489 cfg.id = id; // prevent dup id
15490 return new this.constructor(cfg);
15494 * Ext JS Library 1.1.1
15495 * Copyright(c) 2006-2007, Ext JS, LLC.
15497 * Originally Released Under LGPL - original licence link has changed is not relivant.
15500 * <script type="text/javascript">
15504 * @class Roo.BoxComponent
15505 * @extends Roo.Component
15506 * Base class for any visual {@link Roo.Component} that uses a box container. BoxComponent provides automatic box
15507 * model adjustments for sizing and positioning and will work correctly withnin the Component rendering model. All
15508 * container classes should subclass BoxComponent so that they will work consistently when nested within other Ext
15509 * layout containers.
15511 * @param {Roo.Element/String/Object} config The configuration options.
15513 Roo.BoxComponent = function(config){
15514 Roo.Component.call(this, config);
15518 * Fires after the component is resized.
15519 * @param {Roo.Component} this
15520 * @param {Number} adjWidth The box-adjusted width that was set
15521 * @param {Number} adjHeight The box-adjusted height that was set
15522 * @param {Number} rawWidth The width that was originally specified
15523 * @param {Number} rawHeight The height that was originally specified
15528 * Fires after the component is moved.
15529 * @param {Roo.Component} this
15530 * @param {Number} x The new x position
15531 * @param {Number} y The new y position
15537 Roo.extend(Roo.BoxComponent, Roo.Component, {
15538 // private, set in afterRender to signify that the component has been rendered
15540 // private, used to defer height settings to subclasses
15541 deferHeight: false,
15542 /** @cfg {Number} width
15543 * width (optional) size of component
15545 /** @cfg {Number} height
15546 * height (optional) size of component
15550 * Sets the width and height of the component. This method fires the resize event. This method can accept
15551 * either width and height as separate numeric arguments, or you can pass a size object like {width:10, height:20}.
15552 * @param {Number/Object} width The new width to set, or a size object in the format {width, height}
15553 * @param {Number} height The new height to set (not required if a size object is passed as the first arg)
15554 * @return {Roo.BoxComponent} this
15556 setSize : function(w, h){
15557 // support for standard size objects
15558 if(typeof w == 'object'){
15563 if(!this.boxReady){
15569 // prevent recalcs when not needed
15570 if(this.lastSize && this.lastSize.width == w && this.lastSize.height == h){
15573 this.lastSize = {width: w, height: h};
15575 var adj = this.adjustSize(w, h);
15576 var aw = adj.width, ah = adj.height;
15577 if(aw !== undefined || ah !== undefined){ // this code is nasty but performs better with floaters
15578 var rz = this.getResizeEl();
15579 if(!this.deferHeight && aw !== undefined && ah !== undefined){
15580 rz.setSize(aw, ah);
15581 }else if(!this.deferHeight && ah !== undefined){
15583 }else if(aw !== undefined){
15586 this.onResize(aw, ah, w, h);
15587 this.fireEvent('resize', this, aw, ah, w, h);
15593 * Gets the current size of the component's underlying element.
15594 * @return {Object} An object containing the element's size {width: (element width), height: (element height)}
15596 getSize : function(){
15597 return this.el.getSize();
15601 * Gets the current XY position of the component's underlying element.
15602 * @param {Boolean} local (optional) If true the element's left and top are returned instead of page XY (defaults to false)
15603 * @return {Array} The XY position of the element (e.g., [100, 200])
15605 getPosition : function(local){
15606 if(local === true){
15607 return [this.el.getLeft(true), this.el.getTop(true)];
15609 return this.xy || this.el.getXY();
15613 * Gets the current box measurements of the component's underlying element.
15614 * @param {Boolean} local (optional) If true the element's left and top are returned instead of page XY (defaults to false)
15615 * @returns {Object} box An object in the format {x, y, width, height}
15617 getBox : function(local){
15618 var s = this.el.getSize();
15620 s.x = this.el.getLeft(true);
15621 s.y = this.el.getTop(true);
15623 var xy = this.xy || this.el.getXY();
15631 * Sets the current box measurements of the component's underlying element.
15632 * @param {Object} box An object in the format {x, y, width, height}
15633 * @returns {Roo.BoxComponent} this
15635 updateBox : function(box){
15636 this.setSize(box.width, box.height);
15637 this.setPagePosition(box.x, box.y);
15642 getResizeEl : function(){
15643 return this.resizeEl || this.el;
15647 getPositionEl : function(){
15648 return this.positionEl || this.el;
15652 * Sets the left and top of the component. To set the page XY position instead, use {@link #setPagePosition}.
15653 * This method fires the move event.
15654 * @param {Number} left The new left
15655 * @param {Number} top The new top
15656 * @returns {Roo.BoxComponent} this
15658 setPosition : function(x, y){
15661 if(!this.boxReady){
15664 var adj = this.adjustPosition(x, y);
15665 var ax = adj.x, ay = adj.y;
15667 var el = this.getPositionEl();
15668 if(ax !== undefined || ay !== undefined){
15669 if(ax !== undefined && ay !== undefined){
15670 el.setLeftTop(ax, ay);
15671 }else if(ax !== undefined){
15673 }else if(ay !== undefined){
15676 this.onPosition(ax, ay);
15677 this.fireEvent('move', this, ax, ay);
15683 * Sets the page XY position of the component. To set the left and top instead, use {@link #setPosition}.
15684 * This method fires the move event.
15685 * @param {Number} x The new x position
15686 * @param {Number} y The new y position
15687 * @returns {Roo.BoxComponent} this
15689 setPagePosition : function(x, y){
15692 if(!this.boxReady){
15695 if(x === undefined || y === undefined){ // cannot translate undefined points
15698 var p = this.el.translatePoints(x, y);
15699 this.setPosition(p.left, p.top);
15704 onRender : function(ct, position){
15705 Roo.BoxComponent.superclass.onRender.call(this, ct, position);
15707 this.resizeEl = Roo.get(this.resizeEl);
15709 if(this.positionEl){
15710 this.positionEl = Roo.get(this.positionEl);
15715 afterRender : function(){
15716 Roo.BoxComponent.superclass.afterRender.call(this);
15717 this.boxReady = true;
15718 this.setSize(this.width, this.height);
15719 if(this.x || this.y){
15720 this.setPosition(this.x, this.y);
15722 if(this.pageX || this.pageY){
15723 this.setPagePosition(this.pageX, this.pageY);
15728 * Force the component's size to recalculate based on the underlying element's current height and width.
15729 * @returns {Roo.BoxComponent} this
15731 syncSize : function(){
15732 delete this.lastSize;
15733 this.setSize(this.el.getWidth(), this.el.getHeight());
15738 * Called after the component is resized, this method is empty by default but can be implemented by any
15739 * subclass that needs to perform custom logic after a resize occurs.
15740 * @param {Number} adjWidth The box-adjusted width that was set
15741 * @param {Number} adjHeight The box-adjusted height that was set
15742 * @param {Number} rawWidth The width that was originally specified
15743 * @param {Number} rawHeight The height that was originally specified
15745 onResize : function(adjWidth, adjHeight, rawWidth, rawHeight){
15750 * Called after the component is moved, this method is empty by default but can be implemented by any
15751 * subclass that needs to perform custom logic after a move occurs.
15752 * @param {Number} x The new x position
15753 * @param {Number} y The new y position
15755 onPosition : function(x, y){
15760 adjustSize : function(w, h){
15761 if(this.autoWidth){
15764 if(this.autoHeight){
15767 return {width : w, height: h};
15771 adjustPosition : function(x, y){
15772 return {x : x, y: y};
15775 * Original code for Roojs - LGPL
15776 * <script type="text/javascript">
15780 * @class Roo.XComponent
15781 * A delayed Element creator...
15782 * Or a way to group chunks of interface together.
15783 * technically this is a wrapper around a tree of Roo elements (which defines a 'module'),
15784 * used in conjunction with XComponent.build() it will create an instance of each element,
15785 * then call addxtype() to build the User interface.
15787 * Mypart.xyx = new Roo.XComponent({
15789 parent : 'Mypart.xyz', // empty == document.element.!!
15793 disabled : function() {}
15795 tree : function() { // return an tree of xtype declared components
15799 xtype : 'NestedLayoutPanel',
15806 * It can be used to build a big heiracy, with parent etc.
15807 * or you can just use this to render a single compoent to a dom element
15808 * MYPART.render(Roo.Element | String(id) | dom_element )
15815 * Roo is designed primarily as a single page application, so the UI build for a standard interface will
15816 * expect a single 'TOP' level module normally indicated by the 'parent' of the XComponent definition being defined as false.
15818 * Each sub module is expected to have a parent pointing to the class name of it's parent module.
15820 * When the top level is false, a 'Roo.BorderLayout' is created and the element is flagged as 'topModule'
15821 * - if mulitple topModules exist, the last one is defined as the top module.
15825 * When the top level or multiple modules are to embedded into a existing HTML page,
15826 * the parent element can container '#id' of the element where the module will be drawn.
15830 * Unlike classic Roo, the bootstrap tends not to be used as a single page.
15831 * it relies more on a include mechanism, where sub modules are included into an outer page.
15832 * This is normally managed by the builder tools using Roo.apply( options, Included.Sub.Module )
15834 * Bootstrap Roo Included elements
15836 * Our builder application needs the ability to preview these sub compoennts. They will normally have parent=false set,
15837 * hence confusing the component builder as it thinks there are multiple top level elements.
15841 * @extends Roo.util.Observable
15843 * @param cfg {Object} configuration of component
15846 Roo.XComponent = function(cfg) {
15847 Roo.apply(this, cfg);
15851 * Fires when this the componnt is built
15852 * @param {Roo.XComponent} c the component
15857 this.region = this.region || 'center'; // default..
15858 Roo.XComponent.register(this);
15859 this.modules = false;
15860 this.el = false; // where the layout goes..
15864 Roo.extend(Roo.XComponent, Roo.util.Observable, {
15867 * The created element (with Roo.factory())
15868 * @type {Roo.Layout}
15874 * for BC - use el in new code
15875 * @type {Roo.Layout}
15881 * for BC - use el in new code
15882 * @type {Roo.Layout}
15887 * @cfg {Function|boolean} disabled
15888 * If this module is disabled by some rule, return true from the funtion
15893 * @cfg {String} parent
15894 * Name of parent element which it get xtype added to..
15899 * @cfg {String} order
15900 * Used to set the order in which elements are created (usefull for multiple tabs)
15905 * @cfg {String} name
15906 * String to display while loading.
15910 * @cfg {String} region
15911 * Region to render component to (defaults to center)
15916 * @cfg {Array} items
15917 * A single item array - the first element is the root of the tree..
15918 * It's done this way to stay compatible with the Xtype system...
15924 * The method that retuns the tree of parts that make up this compoennt
15931 * render element to dom or tree
15932 * @param {Roo.Element|String|DomElement} optional render to if parent is not set.
15935 render : function(el)
15939 var hp = this.parent ? 1 : 0;
15942 if (!el && typeof(this.parent) == 'string' && this.parent.substring(0,1) == '#') {
15943 // if parent is a '#.....' string, then let's use that..
15944 var ename = this.parent.substr(1);
15945 this.parent = false;
15948 case 'bootstrap-body' :
15949 if (typeof(Roo.bootstrap.Body) != 'undefined') {
15950 this.parent = { el : new Roo.bootstrap.Body() };
15951 Roo.log("setting el to doc body");
15954 throw "Container is bootstrap body, but Roo.bootstrap.Body is not defined";
15958 this.parent = { el : true};
15961 el = Roo.get(ename);
15966 if (!el && !this.parent) {
15967 Roo.log("Warning - element can not be found :#" + ename );
15971 Roo.log("EL:");Roo.log(el);
15972 Roo.log("this.parent.el:");Roo.log(this.parent.el);
15974 var tree = this._tree ? this._tree() : this.tree();
15976 // altertive root elements ??? - we need a better way to indicate these.
15977 var is_alt = (typeof(Roo.bootstrap) != 'undefined' && tree.xns == Roo.bootstrap) ||
15978 (typeof(Roo.mailer) != 'undefined' && tree.xns == Roo.mailer) ;
15980 if (!this.parent && is_alt) {
15981 //el = Roo.get(document.body);
15982 this.parent = { el : true };
15987 if (!this.parent) {
15989 Roo.log("no parent - creating one");
15991 el = el ? Roo.get(el) : false;
15993 // it's a top level one..
15995 el : new Roo.BorderLayout(el || document.body, {
16001 tabPosition: 'top',
16002 //resizeTabs: true,
16003 alwaysShowTabs: el && hp? false : true,
16004 hideTabs: el || !hp ? true : false,
16011 if (!this.parent.el) {
16012 // probably an old style ctor, which has been disabled.
16016 // The 'tree' method is '_tree now'
16018 tree.region = tree.region || this.region;
16020 if (this.parent.el === true) {
16021 // bootstrap... - body..
16022 this.parent.el = Roo.factory(tree);
16025 this.el = this.parent.el.addxtype(tree);
16026 this.fireEvent('built', this);
16028 this.panel = this.el;
16029 this.layout = this.panel.layout;
16030 this.parentLayout = this.parent.layout || false;
16036 Roo.apply(Roo.XComponent, {
16038 * @property hideProgress
16039 * true to disable the building progress bar.. usefull on single page renders.
16042 hideProgress : false,
16044 * @property buildCompleted
16045 * True when the builder has completed building the interface.
16048 buildCompleted : false,
16051 * @property topModule
16052 * the upper most module - uses document.element as it's constructor.
16059 * @property modules
16060 * array of modules to be created by registration system.
16061 * @type {Array} of Roo.XComponent
16066 * @property elmodules
16067 * array of modules to be created by which use #ID
16068 * @type {Array} of Roo.XComponent
16074 * @property build_from_html
16075 * Build elements from html - used by bootstrap HTML stuff
16076 * - this is cleared after build is completed
16077 * @type {boolean} true (default false)
16080 build_from_html : false,
16083 * Register components to be built later.
16085 * This solves the following issues
16086 * - Building is not done on page load, but after an authentication process has occured.
16087 * - Interface elements are registered on page load
16088 * - Parent Interface elements may not be loaded before child, so this handles that..
16095 module : 'Pman.Tab.projectMgr',
16097 parent : 'Pman.layout',
16098 disabled : false, // or use a function..
16101 * * @param {Object} details about module
16103 register : function(obj) {
16105 Roo.XComponent.event.fireEvent('register', obj);
16106 switch(typeof(obj.disabled) ) {
16112 if ( obj.disabled() ) {
16118 if (obj.disabled) {
16124 this.modules.push(obj);
16128 * convert a string to an object..
16129 * eg. 'AAA.BBB' -> finds AAA.BBB
16133 toObject : function(str)
16135 if (!str || typeof(str) == 'object') {
16138 if (str.substring(0,1) == '#') {
16142 var ar = str.split('.');
16147 eval('if (typeof ' + rt + ' == "undefined"){ o = false;} o = ' + rt + ';');
16149 throw "Module not found : " + str;
16153 throw "Module not found : " + str;
16155 Roo.each(ar, function(e) {
16156 if (typeof(o[e]) == 'undefined') {
16157 throw "Module not found : " + str;
16168 * move modules into their correct place in the tree..
16171 preBuild : function ()
16174 Roo.each(this.modules , function (obj)
16176 Roo.XComponent.event.fireEvent('beforebuild', obj);
16178 var opar = obj.parent;
16180 obj.parent = this.toObject(opar);
16182 Roo.log("parent:toObject failed: " + e.toString());
16187 Roo.debug && Roo.log("GOT top level module");
16188 Roo.debug && Roo.log(obj);
16189 obj.modules = new Roo.util.MixedCollection(false,
16190 function(o) { return o.order + '' }
16192 this.topModule = obj;
16195 // parent is a string (usually a dom element name..)
16196 if (typeof(obj.parent) == 'string') {
16197 this.elmodules.push(obj);
16200 if (obj.parent.constructor != Roo.XComponent) {
16201 Roo.log("Warning : Object Parent is not instance of XComponent:" + obj.name)
16203 if (!obj.parent.modules) {
16204 obj.parent.modules = new Roo.util.MixedCollection(false,
16205 function(o) { return o.order + '' }
16208 if (obj.parent.disabled) {
16209 obj.disabled = true;
16211 obj.parent.modules.add(obj);
16216 * make a list of modules to build.
16217 * @return {Array} list of modules.
16220 buildOrder : function()
16223 var cmp = function(a,b) {
16224 return String(a).toUpperCase() > String(b).toUpperCase() ? 1 : -1;
16226 if ((!this.topModule || !this.topModule.modules) && !this.elmodules.length) {
16227 throw "No top level modules to build";
16230 // make a flat list in order of modules to build.
16231 var mods = this.topModule ? [ this.topModule ] : [];
16234 // elmodules (is a list of DOM based modules )
16235 Roo.each(this.elmodules, function(e) {
16237 if (!this.topModule &&
16238 typeof(e.parent) == 'string' &&
16239 e.parent.substring(0,1) == '#' &&
16240 Roo.get(e.parent.substr(1))
16243 _this.topModule = e;
16249 // add modules to their parents..
16250 var addMod = function(m) {
16251 Roo.debug && Roo.log("build Order: add: " + m.name);
16254 if (m.modules && !m.disabled) {
16255 Roo.debug && Roo.log("build Order: " + m.modules.length + " child modules");
16256 m.modules.keySort('ASC', cmp );
16257 Roo.debug && Roo.log("build Order: " + m.modules.length + " child modules (after sort)");
16259 m.modules.each(addMod);
16261 Roo.debug && Roo.log("build Order: no child modules");
16263 // not sure if this is used any more..
16265 m.finalize.name = m.name + " (clean up) ";
16266 mods.push(m.finalize);
16270 if (this.topModule && this.topModule.modules) {
16271 this.topModule.modules.keySort('ASC', cmp );
16272 this.topModule.modules.each(addMod);
16278 * Build the registered modules.
16279 * @param {Object} parent element.
16280 * @param {Function} optional method to call after module has been added.
16284 build : function(opts)
16287 if (typeof(opts) != 'undefined') {
16288 Roo.apply(this,opts);
16292 var mods = this.buildOrder();
16294 //this.allmods = mods;
16295 //Roo.debug && Roo.log(mods);
16297 if (!mods.length) { // should not happen
16298 throw "NO modules!!!";
16302 var msg = "Building Interface...";
16303 // flash it up as modal - so we store the mask!?
16304 if (!this.hideProgress && Roo.MessageBox) {
16305 Roo.MessageBox.show({ title: 'loading' });
16306 Roo.MessageBox.show({
16307 title: "Please wait...",
16316 var total = mods.length;
16319 var progressRun = function() {
16320 if (!mods.length) {
16321 Roo.debug && Roo.log('hide?');
16322 if (!this.hideProgress && Roo.MessageBox) {
16323 Roo.MessageBox.hide();
16325 Roo.XComponent.build_from_html = false; // reset, so dialogs will be build from javascript
16327 Roo.XComponent.event.fireEvent('buildcomplete', _this.topModule);
16333 var m = mods.shift();
16336 Roo.debug && Roo.log(m);
16337 // not sure if this is supported any more.. - modules that are are just function
16338 if (typeof(m) == 'function') {
16340 return progressRun.defer(10, _this);
16344 msg = "Building Interface " + (total - mods.length) +
16346 (m.name ? (' - ' + m.name) : '');
16347 Roo.debug && Roo.log(msg);
16348 if (!this.hideProgress && Roo.MessageBox) {
16349 Roo.MessageBox.updateProgress( (total - mods.length)/total, msg );
16353 // is the module disabled?
16354 var disabled = (typeof(m.disabled) == 'function') ?
16355 m.disabled.call(m.module.disabled) : m.disabled;
16359 return progressRun(); // we do not update the display!
16367 // it's 10 on top level, and 1 on others??? why...
16368 return progressRun.defer(10, _this);
16371 progressRun.defer(1, _this);
16385 * wrapper for event.on - aliased later..
16386 * Typically use to register a event handler for register:
16388 * eg. Roo.XComponent.on('register', function(comp) { comp.disable = true } );
16397 Roo.XComponent.event = new Roo.util.Observable({
16401 * Fires when an Component is registered,
16402 * set the disable property on the Component to stop registration.
16403 * @param {Roo.XComponent} c the component being registerd.
16408 * @event beforebuild
16409 * Fires before each Component is built
16410 * can be used to apply permissions.
16411 * @param {Roo.XComponent} c the component being registerd.
16414 'beforebuild' : true,
16416 * @event buildcomplete
16417 * Fires on the top level element when all elements have been built
16418 * @param {Roo.XComponent} the top level component.
16420 'buildcomplete' : true
16425 Roo.XComponent.on = Roo.XComponent.event.on.createDelegate(Roo.XComponent.event);