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 isFirefox = ua.indexOf("firefox") > -1,
57 isIE = ua.indexOf("msie") > -1,
58 isIE7 = ua.indexOf("msie 7") > -1,
59 isIE11 = /trident.*rv\:11\./.test(ua),
60 isEdge = ua.indexOf("edge") > -1,
61 isGecko = !isSafari && ua.indexOf("gecko") > -1,
62 isBorderBox = isIE && !isStrict,
63 isWindows = (ua.indexOf("windows") != -1 || ua.indexOf("win32") != -1),
64 isMac = (ua.indexOf("macintosh") != -1 || ua.indexOf("mac os x") != -1),
65 isLinux = (ua.indexOf("linux") != -1),
66 isSecure = window.location.href.toLowerCase().indexOf("https") === 0,
67 isIOS = /iphone|ipad/.test(ua),
68 isAndroid = /android/.test(ua),
69 isTouch = (function() {
71 if (ua.indexOf('chrome') != -1 && ua.indexOf('android') == -1) {
72 window.addEventListener('touchstart', function __set_has_touch__ () {
74 window.removeEventListener('touchstart', __set_has_touch__);
76 return false; // no touch on chrome!?
78 document.createEvent("TouchEvent");
85 // remove css image flicker
88 document.execCommand("BackgroundImageCache", false, true);
94 * True if the browser is in strict mode
99 * True if the page is running over SSL
104 * True when the document is fully initialized and ready for action
109 * Turn on debugging output (currently only the factory uses this)
116 * True to automatically uncache orphaned Roo.Elements periodically (defaults to true)
119 enableGarbageCollector : true,
122 * True to automatically purge event listeners after uncaching an element (defaults to false).
123 * Note: this only happens if enableGarbageCollector is true.
126 enableListenerCollection:false,
129 * URL to a blank file used by Roo when in secure mode for iframe src and onReady src to prevent
130 * the IE insecure content warning (defaults to javascript:false).
133 SSL_SECURE_URL : "javascript:false",
136 * URL to a 1x1 transparent gif image used by Roo to create inline icons with CSS background images. (Defaults to
137 * "http://Roojs.com/s.gif" and you should change this to a URL on your server).
140 BLANK_IMAGE_URL : "http:/"+"/localhost/s.gif",
142 emptyFn : function(){},
145 * Copies all the properties of config to obj if they don't already exist.
146 * @param {Object} obj The receiver of the properties
147 * @param {Object} config The source of the properties
148 * @return {Object} returns obj
150 applyIf : function(o, c){
153 if(typeof o[p] == "undefined"){ o[p] = c[p]; }
160 * Applies event listeners to elements by selectors when the document is ready.
161 * The event name is specified with an @ suffix.
164 // add a listener for click on all anchors in element with id foo
165 '#foo a@click' : function(e, t){
169 // add the same listener to multiple selectors (separated by comma BEFORE the @)
170 '#foo a, #bar span.some-class@mouseover' : function(){
175 * @param {Object} obj The list of behaviors to apply
177 addBehaviors : function(o){
179 Roo.onReady(function(){
184 var cache = {}; // simple cache for applying multiple behaviors to same selector does query multiple times
186 var parts = b.split('@');
187 if(parts[1]){ // for Object prototype breakers
190 cache[s] = Roo.select(s);
192 cache[s].on(parts[1], o[b]);
199 * Generates unique ids. If the element already has an id, it is unchanged
200 * @param {String/HTMLElement/Element} el (optional) The element to generate an id for
201 * @param {String} prefix (optional) Id prefix (defaults "Roo-gen")
202 * @return {String} The generated Id.
204 id : function(el, prefix){
205 prefix = prefix || "roo-gen";
207 var id = prefix + (++idSeed);
208 return el ? (el.id ? el.id : (el.id = id)) : id;
213 * Extends one class with another class and optionally overrides members with the passed literal. This class
214 * also adds the function "override()" to the class that can be used to override
215 * members on an instance.
216 * @param {Object} subclass The class inheriting the functionality
217 * @param {Object} superclass The class being extended
218 * @param {Object} overrides (optional) A literal with members
223 var io = function(o){
228 return function(sb, sp, overrides){
229 if(typeof sp == 'object'){ // eg. prototype, rather than function constructor..
232 sb = function(){sp.apply(this, arguments);};
234 var F = function(){}, sbp, spp = sp.prototype;
236 sbp = sb.prototype = new F();
240 if(spp.constructor == Object.prototype.constructor){
245 sb.override = function(o){
249 Roo.override(sb, overrides);
255 * Adds a list of functions to the prototype of an existing class, overwriting any existing methods with the same name.
257 Roo.override(MyClass, {
258 newMethod1: function(){
261 newMethod2: function(foo){
266 * @param {Object} origclass The class to override
267 * @param {Object} overrides The list of functions to add to origClass. This should be specified as an object literal
268 * containing one or more methods.
271 override : function(origclass, overrides){
273 var p = origclass.prototype;
274 for(var method in overrides){
275 p[method] = overrides[method];
280 * Creates namespaces to be used for scoping variables and classes so that they are not global. Usage:
282 Roo.namespace('Company', 'Company.data');
283 Company.Widget = function() { ... }
284 Company.data.CustomStore = function(config) { ... }
286 * @param {String} namespace1
287 * @param {String} namespace2
288 * @param {String} etc
291 namespace : function(){
292 var a=arguments, o=null, i, j, d, rt;
293 for (i=0; i<a.length; ++i) {
297 eval('if (typeof ' + rt + ' == "undefined"){' + rt + ' = {};} o = ' + rt + ';');
298 for (j=1; j<d.length; ++j) {
299 o[d[j]]=o[d[j]] || {};
305 * Creates namespaces to be used for scoping variables and classes so that they are not global. Usage:
307 Roo.factory({ xns: Roo.data, xtype : 'Store', .....});
308 Roo.factory(conf, Roo.data);
310 * @param {String} classname
311 * @param {String} namespace (optional)
315 factory : function(c, ns)
317 // no xtype, no ns or c.xns - or forced off by c.xns
318 if (!c.xtype || (!ns && !c.xns) || (c.xns === false)) { // not enough info...
321 ns = c.xns ? c.xns : ns; // if c.xns is set, then use that..
322 if (c.constructor == ns[c.xtype]) {// already created...
326 if (Roo.debug) { Roo.log("Roo.Factory(" + c.xtype + ")"); }
327 var ret = new ns[c.xtype](c);
331 c.xns = false; // prevent recursion..
335 * Logs to console if it can.
337 * @param {String|Object} string
342 if ((typeof(console) == 'undefined') || (typeof(console.log) == 'undefined')) {
349 * 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.
353 urlEncode : function(o){
359 var ov = o[key], k = Roo.encodeURIComponent(key);
360 var type = typeof ov;
361 if(type == 'undefined'){
363 }else if(type != "function" && type != "object"){
364 buf.push(k, "=", Roo.encodeURIComponent(ov), "&");
365 }else if(ov instanceof Array){
367 for(var i = 0, len = ov.length; i < len; i++) {
368 buf.push(k, "=", Roo.encodeURIComponent(ov[i] === undefined ? '' : ov[i]), "&");
379 * Safe version of encodeURIComponent
380 * @param {String} data
384 encodeURIComponent : function (data)
387 return encodeURIComponent(data);
388 } catch(e) {} // should be an uri encode error.
390 if (data == '' || data == null){
393 // http://stackoverflow.com/questions/2596483/unicode-and-uri-encoding-decoding-and-escaping-in-javascript
394 function nibble_to_hex(nibble){
395 var chars = '0123456789ABCDEF';
396 return chars.charAt(nibble);
398 data = data.toString();
400 for(var i=0; i<data.length; i++){
401 var c = data.charCodeAt(i);
402 var bs = new Array();
405 bs[0] = 0xF0 | ((c & 0x1C0000) >>> 18);
406 bs[1] = 0x80 | ((c & 0x3F000) >>> 12);
407 bs[2] = 0x80 | ((c & 0xFC0) >>> 6);
408 bs[3] = 0x80 | (c & 0x3F);
409 }else if (c > 0x800){
411 bs[0] = 0xE0 | ((c & 0xF000) >>> 12);
412 bs[1] = 0x80 | ((c & 0xFC0) >>> 6);
413 bs[2] = 0x80 | (c & 0x3F);
416 bs[0] = 0xC0 | ((c & 0x7C0) >>> 6);
417 bs[1] = 0x80 | (c & 0x3F);
422 for(var j=0; j<bs.length; j++){
424 var hex = nibble_to_hex((b & 0xF0) >>> 4)
425 + nibble_to_hex(b &0x0F);
434 * 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]}.
435 * @param {String} string
436 * @param {Boolean} overwrite (optional) Items of the same name will overwrite previous values instead of creating an an array (Defaults to false).
437 * @return {Object} A literal with members
439 urlDecode : function(string, overwrite){
440 if(!string || !string.length){
444 var pairs = string.split('&');
445 var pair, name, value;
446 for(var i = 0, len = pairs.length; i < len; i++){
447 pair = pairs[i].split('=');
448 name = decodeURIComponent(pair[0]);
449 value = decodeURIComponent(pair[1]);
450 if(overwrite !== true){
451 if(typeof obj[name] == "undefined"){
453 }else if(typeof obj[name] == "string"){
454 obj[name] = [obj[name]];
455 obj[name].push(value);
457 obj[name].push(value);
467 * Iterates an array calling the passed function with each item, stopping if your function returns false. If the
468 * passed array is not really an array, your function is called once with it.
469 * The supplied function is called with (Object item, Number index, Array allItems).
470 * @param {Array/NodeList/Mixed} array
471 * @param {Function} fn
472 * @param {Object} scope
474 each : function(array, fn, scope){
475 if(typeof array.length == "undefined" || typeof array == "string"){
478 for(var i = 0, len = array.length; i < len; i++){
479 if(fn.call(scope || array[i], array[i], i, array) === false){ return i; };
484 combine : function(){
485 var as = arguments, l = as.length, r = [];
486 for(var i = 0; i < l; i++){
488 if(a instanceof Array){
490 }else if(a.length !== undefined && !a.substr){
491 r = r.concat(Array.prototype.slice.call(a, 0));
500 * Escapes the passed string for use in a regular expression
501 * @param {String} str
504 escapeRe : function(s) {
505 return s.replace(/([.*+?^${}()|[\]\/\\])/g, "\\$1");
509 callback : function(cb, scope, args, delay){
510 if(typeof cb == "function"){
512 cb.defer(delay, scope, args || []);
514 cb.apply(scope, args || []);
520 * Return the dom node for the passed string (id), dom node, or Roo.Element
521 * @param {String/HTMLElement/Roo.Element} el
522 * @return HTMLElement
524 getDom : function(el){
528 return el.dom ? el.dom : (typeof el == 'string' ? document.getElementById(el) : el);
532 * Shorthand for {@link Roo.ComponentMgr#get}
534 * @return Roo.Component
536 getCmp : function(id){
537 return Roo.ComponentMgr.get(id);
540 num : function(v, defaultValue){
541 if(typeof v != 'number'){
547 destroy : function(){
548 for(var i = 0, a = arguments, len = a.length; i < len; i++) {
552 as.removeAllListeners();
556 if(typeof as.purgeListeners == 'function'){
559 if(typeof as.destroy == 'function'){
566 // inpired by a similar function in mootools library
568 * Returns the type of object that is passed in. If the object passed in is null or undefined it
569 * return false otherwise it returns one of the following values:<ul>
570 * <li><b>string</b>: If the object passed is a string</li>
571 * <li><b>number</b>: If the object passed is a number</li>
572 * <li><b>boolean</b>: If the object passed is a boolean value</li>
573 * <li><b>function</b>: If the object passed is a function reference</li>
574 * <li><b>object</b>: If the object passed is an object</li>
575 * <li><b>array</b>: If the object passed is an array</li>
576 * <li><b>regexp</b>: If the object passed is a regular expression</li>
577 * <li><b>element</b>: If the object passed is a DOM Element</li>
578 * <li><b>nodelist</b>: If the object passed is a DOM NodeList</li>
579 * <li><b>textnode</b>: If the object passed is a DOM text node and contains something other than whitespace</li>
580 * <li><b>whitespace</b>: If the object passed is a DOM text node and contains only whitespace</li>
581 * @param {Mixed} object
585 if(o === undefined || o === null){
592 if(t == 'object' && o.nodeName) {
594 case 1: return 'element';
595 case 3: return (/\S/).test(o.nodeValue) ? 'textnode' : 'whitespace';
598 if(t == 'object' || t == 'function') {
599 switch(o.constructor) {
600 case Array: return 'array';
601 case RegExp: return 'regexp';
603 if(typeof o.length == 'number' && typeof o.item == 'function') {
611 * Returns true if the passed value is null, undefined or an empty string (optional).
612 * @param {Mixed} value The value to test
613 * @param {Boolean} allowBlank (optional) Pass true if an empty string is not considered empty
616 isEmpty : function(v, allowBlank){
617 return v === null || v === undefined || (!allowBlank ? v === '' : false);
625 isFirefox : isFirefox,
637 isBorderBox : isBorderBox,
639 isWindows : isWindows,
647 isAndroid : isAndroid,
652 * By default, Ext intelligently decides whether floating elements should be shimmed. If you are using flash,
653 * you may want to set this to true.
656 useShims : ((isIE && !isIE7) || (isGecko && isMac)),
661 * Selects a single element as a Roo Element
662 * This is about as close as you can get to jQuery's $('do crazy stuff')
663 * @param {String} selector The selector/xpath query
664 * @param {Node} root (optional) The start of the query (defaults to document).
665 * @return {Roo.Element}
667 selectNode : function(selector, root)
669 var node = Roo.DomQuery.selectNode(selector,root);
670 return node ? Roo.get(node) : new Roo.Element(false);
673 * Find the current bootstrap width Grid size
674 * Note xs is the default for smaller.. - this is currently used by grids to render correct columns
675 * @returns {String} (xs|sm|md|lg|xl)
678 getGridSize : function()
680 var w = Roo.lib.Dom.getViewWidth();
701 Roo.namespace("Roo", "Roo.util", "Roo.grid", "Roo.dd", "Roo.tree", "Roo.data",
702 "Roo.form", "Roo.menu", "Roo.state", "Roo.lib", "Roo.layout",
707 * Ext JS Library 1.1.1
708 * Copyright(c) 2006-2007, Ext JS, LLC.
710 * Originally Released Under LGPL - original licence link has changed is not relivant.
713 * <script type="text/javascript">
717 // wrappedn so fnCleanup is not in global scope...
719 function fnCleanUp() {
720 var p = Function.prototype;
721 delete p.createSequence;
723 delete p.createDelegate;
724 delete p.createCallback;
725 delete p.createInterceptor;
727 window.detachEvent("onunload", fnCleanUp);
729 window.attachEvent("onunload", fnCleanUp);
736 * These functions are available on every Function object (any JavaScript function).
738 Roo.apply(Function.prototype, {
740 * Creates a callback that passes arguments[0], arguments[1], arguments[2], ...
741 * Call directly on any function. Example: <code>myFunction.createCallback(myarg, myarg2)</code>
742 * Will create a function that is bound to those 2 args.
743 * @return {Function} The new function
745 createCallback : function(/*args...*/){
746 // make args available, in function below
747 var args = arguments;
750 return method.apply(window, args);
755 * Creates a delegate (callback) that sets the scope to obj.
756 * Call directly on any function. Example: <code>this.myFunction.createDelegate(this)</code>
757 * Will create a function that is automatically scoped to this.
758 * @param {Object} obj (optional) The object for which the scope is set
759 * @param {Array} args (optional) Overrides arguments for the call. (Defaults to the arguments passed by the caller)
760 * @param {Boolean/Number} appendArgs (optional) if True args are appended to call args instead of overriding,
761 * if a number the args are inserted at the specified position
762 * @return {Function} The new function
764 createDelegate : function(obj, args, appendArgs){
767 var callArgs = args || arguments;
768 if(appendArgs === true){
769 callArgs = Array.prototype.slice.call(arguments, 0);
770 callArgs = callArgs.concat(args);
771 }else if(typeof appendArgs == "number"){
772 callArgs = Array.prototype.slice.call(arguments, 0); // copy arguments first
773 var applyArgs = [appendArgs, 0].concat(args); // create method call params
774 Array.prototype.splice.apply(callArgs, applyArgs); // splice them in
776 return method.apply(obj || window, callArgs);
781 * Calls this function after the number of millseconds specified.
782 * @param {Number} millis The number of milliseconds for the setTimeout call (if 0 the function is executed immediately)
783 * @param {Object} obj (optional) The object for which the scope is set
784 * @param {Array} args (optional) Overrides arguments for the call. (Defaults to the arguments passed by the caller)
785 * @param {Boolean/Number} appendArgs (optional) if True args are appended to call args instead of overriding,
786 * if a number the args are inserted at the specified position
787 * @return {Number} The timeout id that can be used with clearTimeout
789 defer : function(millis, obj, args, appendArgs){
790 var fn = this.createDelegate(obj, args, appendArgs);
792 return setTimeout(fn, millis);
798 * Create a combined function call sequence of the original function + the passed function.
799 * The resulting function returns the results of the original function.
800 * The passed fcn is called with the parameters of the original function
801 * @param {Function} fcn The function to sequence
802 * @param {Object} scope (optional) The scope of the passed fcn (Defaults to scope of original function or window)
803 * @return {Function} The new function
805 createSequence : function(fcn, scope){
806 if(typeof fcn != "function"){
811 var retval = method.apply(this || window, arguments);
812 fcn.apply(scope || this || window, arguments);
818 * Creates an interceptor function. The passed fcn is called before the original one. If it returns false, the original one is not called.
819 * The resulting function returns the results of the original function.
820 * The passed fcn is called with the parameters of the original function.
822 * @param {Function} fcn The function to call before the original
823 * @param {Object} scope (optional) The scope of the passed fcn (Defaults to scope of original function or window)
824 * @return {Function} The new function
826 createInterceptor : function(fcn, scope){
827 if(typeof fcn != "function"){
834 if(fcn.apply(scope || this || window, arguments) === false){
837 return method.apply(this || window, arguments);
843 * Ext JS Library 1.1.1
844 * Copyright(c) 2006-2007, Ext JS, LLC.
846 * Originally Released Under LGPL - original licence link has changed is not relivant.
849 * <script type="text/javascript">
852 Roo.applyIf(String, {
857 * Escapes the passed string for ' and \
858 * @param {String} string The string to escape
859 * @return {String} The escaped string
862 escape : function(string) {
863 return string.replace(/('|\\)/g, "\\$1");
867 * Pads the left side of a string with a specified character. This is especially useful
868 * for normalizing number and date strings. Example usage:
870 var s = String.leftPad('123', 5, '0');
871 // s now contains the string: '00123'
873 * @param {String} string The original string
874 * @param {Number} size The total length of the output string
875 * @param {String} char (optional) The character with which to pad the original string (defaults to empty string " ")
876 * @return {String} The padded string
879 leftPad : function (val, size, ch) {
880 var result = new String(val);
881 if(ch === null || ch === undefined || ch === '') {
884 while (result.length < size) {
885 result = ch + result;
891 * Allows you to define a tokenized string and pass an arbitrary number of arguments to replace the tokens. Each
892 * token must be unique, and must increment in the format {0}, {1}, etc. Example usage:
894 var cls = 'my-class', text = 'Some text';
895 var s = String.format('<div class="{0}">{1}</div>', cls, text);
896 // s now contains the string: '<div class="my-class">Some text</div>'
898 * @param {String} string The tokenized string to be formatted
899 * @param {String} value1 The value to replace token {0}
900 * @param {String} value2 Etc...
901 * @return {String} The formatted string
904 format : function(format){
905 var args = Array.prototype.slice.call(arguments, 1);
906 return format.replace(/\{(\d+)\}/g, function(m, i){
907 return Roo.util.Format.htmlEncode(args[i]);
915 * Utility function that allows you to easily switch a string between two alternating values. The passed value
916 * is compared to the current string, and if they are equal, the other value that was passed in is returned. If
917 * they are already different, the first value passed in is returned. Note that this method returns the new value
918 * but does not change the current string.
920 // alternate sort directions
921 sort = sort.toggle('ASC', 'DESC');
923 // instead of conditional logic:
924 sort = (sort == 'ASC' ? 'DESC' : 'ASC');
926 * @param {String} value The value to compare to the current string
927 * @param {String} other The new value to use if the string already equals the first value passed in
928 * @return {String} The new value
931 String.prototype.toggle = function(value, other){
932 return this == value ? other : value;
937 * Remove invalid unicode characters from a string
939 * @return {String} The clean string
941 String.prototype.unicodeClean = function () {
942 return this.replace(/[\s\S]/g,
943 function(character) {
944 if (character.charCodeAt()< 256) {
948 encodeURIComponent(character);
959 * Make the first letter of a string uppercase
961 * @return {String} The new string.
963 String.prototype.toUpperCaseFirst = function () {
964 return this.charAt(0).toUpperCase() + this.slice(1);
969 * Ext JS Library 1.1.1
970 * Copyright(c) 2006-2007, Ext JS, LLC.
972 * Originally Released Under LGPL - original licence link has changed is not relivant.
975 * <script type="text/javascript">
981 Roo.applyIf(Number.prototype, {
983 * Checks whether or not the current number is within a desired range. If the number is already within the
984 * range it is returned, otherwise the min or max value is returned depending on which side of the range is
985 * exceeded. Note that this method returns the constrained value but does not change the current number.
986 * @param {Number} min The minimum number in the range
987 * @param {Number} max The maximum number in the range
988 * @return {Number} The constrained value if outside the range, otherwise the current value
990 constrain : function(min, max){
991 return Math.min(Math.max(this, min), max);
995 * Ext JS Library 1.1.1
996 * Copyright(c) 2006-2007, Ext JS, LLC.
998 * Originally Released Under LGPL - original licence link has changed is not relivant.
1001 * <script type="text/javascript">
1006 Roo.applyIf(Array.prototype, {
1009 * Checks whether or not the specified object exists in the array.
1010 * @param {Object} o The object to check for
1011 * @return {Number} The index of o in the array (or -1 if it is not found)
1013 indexOf : function(o){
1014 for (var i = 0, len = this.length; i < len; i++){
1015 if(this[i] == o) { return i; }
1021 * Removes the specified object from the array. If the object is not found nothing happens.
1022 * @param {Object} o The object to remove
1024 remove : function(o){
1025 var index = this.indexOf(o);
1027 this.splice(index, 1);
1031 * Map (JS 1.6 compatibility)
1032 * @param {Function} function to call
1034 map : function(fun )
1036 var len = this.length >>> 0;
1037 if (typeof fun != "function") {
1038 throw new TypeError();
1040 var res = new Array(len);
1041 var thisp = arguments[1];
1042 for (var i = 0; i < len; i++)
1045 res[i] = fun.call(thisp, this[i], i, this);
1053 * @param {Array} o The array to compare to
1054 * @returns {Boolean} true if the same
1056 equals : function(b)
1058 // https://stackoverflow.com/questions/3115982/how-to-check-if-two-arrays-are-equal-with-javascript
1065 if (this.length !== b.length) {
1069 // sort?? a.sort().equals(b.sort());
1071 for (var i = 0; i < this.length; ++i) {
1072 if (this[i] !== b[i]) {
1084 Roo.applyIf(Array, {
1088 * @param {Array} o Or Array like object (eg. nodelist)
1095 for (var i =0; i < o.length; i++) {
1104 * Ext JS Library 1.1.1
1105 * Copyright(c) 2006-2007, Ext JS, LLC.
1107 * Originally Released Under LGPL - original licence link has changed is not relivant.
1110 * <script type="text/javascript">
1116 * The date parsing and format syntax is a subset of
1117 * <a href="http://www.php.net/date">PHP's date() function</a>, and the formats that are
1118 * supported will provide results equivalent to their PHP versions.
1120 * Following is the list of all currently supported formats:
1123 'Wed Jan 10 2007 15:05:01 GMT-0600 (Central Standard Time)'
1125 Format Output Description
1126 ------ ---------- --------------------------------------------------------------
1127 d 10 Day of the month, 2 digits with leading zeros
1128 D Wed A textual representation of a day, three letters
1129 j 10 Day of the month without leading zeros
1130 l Wednesday A full textual representation of the day of the week
1131 S th English ordinal day of month suffix, 2 chars (use with j)
1132 w 3 Numeric representation of the day of the week
1133 z 9 The julian date, or day of the year (0-365)
1134 W 01 ISO-8601 2-digit week number of year, weeks starting on Monday (00-52)
1135 F January A full textual representation of the month
1136 m 01 Numeric representation of a month, with leading zeros
1137 M Jan Month name abbreviation, three letters
1138 n 1 Numeric representation of a month, without leading zeros
1139 t 31 Number of days in the given month
1140 L 0 Whether it's a leap year (1 if it is a leap year, else 0)
1141 Y 2007 A full numeric representation of a year, 4 digits
1142 y 07 A two digit representation of a year
1143 a pm Lowercase Ante meridiem and Post meridiem
1144 A PM Uppercase Ante meridiem and Post meridiem
1145 g 3 12-hour format of an hour without leading zeros
1146 G 15 24-hour format of an hour without leading zeros
1147 h 03 12-hour format of an hour with leading zeros
1148 H 15 24-hour format of an hour with leading zeros
1149 i 05 Minutes with leading zeros
1150 s 01 Seconds, with leading zeros
1151 O -0600 Difference to Greenwich time (GMT) in hours (Allows +08, without minutes)
1152 P -06:00 Difference to Greenwich time (GMT) with colon between hours and minutes
1153 T CST Timezone setting of the machine running the code
1154 Z -21600 Timezone offset in seconds (negative if west of UTC, positive if east)
1157 * Example usage (note that you must escape format specifiers with '\\' to render them as character literals):
1159 var dt = new Date('1/10/2007 03:05:01 PM GMT-0600');
1160 document.write(dt.format('Y-m-d')); //2007-01-10
1161 document.write(dt.format('F j, Y, g:i a')); //January 10, 2007, 3:05 pm
1162 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
1165 * Here are some standard date/time patterns that you might find helpful. They
1166 * are not part of the source of Date.js, but to use them you can simply copy this
1167 * block of code into any script that is included after Date.js and they will also become
1168 * globally available on the Date object. Feel free to add or remove patterns as needed in your code.
1171 ISO8601Long:"Y-m-d H:i:s",
1172 ISO8601Short:"Y-m-d",
1174 LongDate: "l, F d, Y",
1175 FullDateTime: "l, F d, Y g:i:s A",
1178 LongTime: "g:i:s A",
1179 SortableDateTime: "Y-m-d\\TH:i:s",
1180 UniversalSortableDateTime: "Y-m-d H:i:sO",
1187 var dt = new Date();
1188 document.write(dt.format(Date.patterns.ShortDate));
1193 * Most of the date-formatting functions below are the excellent work of Baron Schwartz.
1194 * They generate precompiled functions from date formats instead of parsing and
1195 * processing the pattern every time you format a date. These functions are available
1196 * on every Date object (any javascript function).
1198 * The original article and download are here:
1199 * http://www.xaprb.com/blog/2005/12/12/javascript-closures-for-runtime-efficiency/
1206 Returns the number of milliseconds between this date and date
1207 @param {Date} date (optional) Defaults to now
1208 @param {Date} date (optional) Defaults to now
1209 @param {String} interval A valid date interval enum value (eg. Date.DAY)
1210 @return {Number} The diff in milliseconds
1211 @member Date getElapsed
1213 Date.prototype.getElapsed = function(date, interval)
1215 date = date || new Date();
1216 var ret = Math.abs(date.getTime()-this.getTime());
1220 return Math.floor(ret / (1000));
1222 return Math.floor(ret / (100*60));
1224 return Math.floor(ret / (100*60*60));
1226 return Math.floor(ret / (100*60*60*24));
1227 case Date.MONTH: // this does not give exact number...??
1228 return ((date.format("Y") - this.format("Y")) * 12) + (date.format("m") - this.format("m"));
1229 case Date.YEAR: // this does not give exact number...??
1230 return (date.format("Y") - this.format("Y"));
1238 // was in date file..
1242 Date.parseFunctions = {count:0};
1244 Date.parseRegexes = [];
1246 Date.formatFunctions = {count:0};
1249 Date.prototype.dateFormat = function(format) {
1250 if (Date.formatFunctions[format] == null) {
1251 Date.createNewFormat(format);
1253 var func = Date.formatFunctions[format];
1254 return this[func]();
1259 * Formats a date given the supplied format string
1260 * @param {String} format The format string
1261 * @return {String} The formatted date
1264 Date.prototype.format = Date.prototype.dateFormat;
1267 Date.createNewFormat = function(format) {
1268 var funcName = "format" + Date.formatFunctions.count++;
1269 Date.formatFunctions[format] = funcName;
1270 var code = "Date.prototype." + funcName + " = function(){return ";
1271 var special = false;
1273 for (var i = 0; i < format.length; ++i) {
1274 ch = format.charAt(i);
1275 if (!special && ch == "\\") {
1280 code += "'" + String.escape(ch) + "' + ";
1283 code += Date.getFormatCode(ch);
1286 /** eval:var:zzzzzzzzzzzzz */
1287 eval(code.substring(0, code.length - 3) + ";}");
1291 Date.getFormatCode = function(character) {
1292 switch (character) {
1294 return "String.leftPad(this.getDate(), 2, '0') + ";
1296 return "Date.dayNames[this.getDay()].substring(0, 3) + ";
1298 return "this.getDate() + ";
1300 return "Date.dayNames[this.getDay()] + ";
1302 return "this.getSuffix() + ";
1304 return "this.getDay() + ";
1306 return "this.getDayOfYear() + ";
1308 return "this.getWeekOfYear() + ";
1310 return "Date.monthNames[this.getMonth()] + ";
1312 return "String.leftPad(this.getMonth() + 1, 2, '0') + ";
1314 return "Date.monthNames[this.getMonth()].substring(0, 3) + ";
1316 return "(this.getMonth() + 1) + ";
1318 return "this.getDaysInMonth() + ";
1320 return "(this.isLeapYear() ? 1 : 0) + ";
1322 return "this.getFullYear() + ";
1324 return "('' + this.getFullYear()).substring(2, 4) + ";
1326 return "(this.getHours() < 12 ? 'am' : 'pm') + ";
1328 return "(this.getHours() < 12 ? 'AM' : 'PM') + ";
1330 return "((this.getHours() % 12) ? this.getHours() % 12 : 12) + ";
1332 return "this.getHours() + ";
1334 return "String.leftPad((this.getHours() % 12) ? this.getHours() % 12 : 12, 2, '0') + ";
1336 return "String.leftPad(this.getHours(), 2, '0') + ";
1338 return "String.leftPad(this.getMinutes(), 2, '0') + ";
1340 return "String.leftPad(this.getSeconds(), 2, '0') + ";
1342 return "this.getGMTOffset() + ";
1344 return "this.getGMTColonOffset() + ";
1346 return "this.getTimezone() + ";
1348 return "(this.getTimezoneOffset() * -60) + ";
1350 return "'" + String.escape(character) + "' + ";
1355 * Parses the passed string using the specified format. Note that this function expects dates in normal calendar
1356 * format, meaning that months are 1-based (1 = January) and not zero-based like in JavaScript dates. Any part of
1357 * the date format that is not specified will default to the current date value for that part. Time parts can also
1358 * be specified, but default to 0. Keep in mind that the input date string must precisely match the specified format
1359 * string or the parse operation will fail.
1362 //dt = Fri May 25 2007 (current date)
1363 var dt = new Date();
1365 //dt = Thu May 25 2006 (today's month/day in 2006)
1366 dt = Date.parseDate("2006", "Y");
1368 //dt = Sun Jan 15 2006 (all date parts specified)
1369 dt = Date.parseDate("2006-1-15", "Y-m-d");
1371 //dt = Sun Jan 15 2006 15:20:01 GMT-0600 (CST)
1372 dt = Date.parseDate("2006-1-15 3:20:01 PM", "Y-m-d h:i:s A" );
1374 * @param {String} input The unparsed date as a string
1375 * @param {String} format The format the date is in
1376 * @return {Date} The parsed date
1379 Date.parseDate = function(input, format) {
1380 if (Date.parseFunctions[format] == null) {
1381 Date.createParser(format);
1383 var func = Date.parseFunctions[format];
1384 return Date[func](input);
1390 Date.createParser = function(format) {
1391 var funcName = "parse" + Date.parseFunctions.count++;
1392 var regexNum = Date.parseRegexes.length;
1393 var currentGroup = 1;
1394 Date.parseFunctions[format] = funcName;
1396 var code = "Date." + funcName + " = function(input){\n"
1397 + "var y = -1, m = -1, d = -1, h = -1, i = -1, s = -1, o, z, v;\n"
1398 + "var d = new Date();\n"
1399 + "y = d.getFullYear();\n"
1400 + "m = d.getMonth();\n"
1401 + "d = d.getDate();\n"
1402 + "if (typeof(input) !== 'string') { input = input.toString(); }\n"
1403 + "var results = input.match(Date.parseRegexes[" + regexNum + "]);\n"
1404 + "if (results && results.length > 0) {";
1407 var special = false;
1409 for (var i = 0; i < format.length; ++i) {
1410 ch = format.charAt(i);
1411 if (!special && ch == "\\") {
1416 regex += String.escape(ch);
1419 var obj = Date.formatCodeToRegex(ch, currentGroup);
1420 currentGroup += obj.g;
1422 if (obj.g && obj.c) {
1428 code += "if (y >= 0 && m >= 0 && d > 0 && h >= 0 && i >= 0 && s >= 0)\n"
1429 + "{v = new Date(y, m, d, h, i, s); v.setFullYear(y);}\n"
1430 + "else if (y >= 0 && m >= 0 && d > 0 && h >= 0 && i >= 0)\n"
1431 + "{v = new Date(y, m, d, h, i); v.setFullYear(y);}\n"
1432 + "else if (y >= 0 && m >= 0 && d > 0 && h >= 0)\n"
1433 + "{v = new Date(y, m, d, h); v.setFullYear(y);}\n"
1434 + "else if (y >= 0 && m >= 0 && d > 0)\n"
1435 + "{v = new Date(y, m, d); v.setFullYear(y);}\n"
1436 + "else if (y >= 0 && m >= 0)\n"
1437 + "{v = new Date(y, m); v.setFullYear(y);}\n"
1438 + "else if (y >= 0)\n"
1439 + "{v = new Date(y); v.setFullYear(y);}\n"
1440 + "}return (v && (z || o))?\n" // favour UTC offset over GMT offset
1441 + " ((z)? v.add(Date.SECOND, (v.getTimezoneOffset() * 60) + (z*1)) :\n" // reset to UTC, then add offset
1442 + " v.add(Date.HOUR, (v.getGMTOffset() / 100) + (o / -100))) : v\n" // reset to GMT, then add offset
1445 Date.parseRegexes[regexNum] = new RegExp("^" + regex + "$");
1446 /** eval:var:zzzzzzzzzzzzz */
1451 Date.formatCodeToRegex = function(character, currentGroup) {
1452 switch (character) {
1456 s:"(?:Sun|Mon|Tue|Wed|Thu|Fri|Sat)"};
1459 c:"d = parseInt(results[" + currentGroup + "], 10);\n",
1460 s:"(\\d{1,2})"}; // day of month without leading zeroes
1463 c:"d = parseInt(results[" + currentGroup + "], 10);\n",
1464 s:"(\\d{2})"}; // day of month with leading zeroes
1468 s:"(?:" + Date.dayNames.join("|") + ")"};
1472 s:"(?:st|nd|rd|th)"};
1487 c:"m = parseInt(Date.monthNumbers[results[" + currentGroup + "].substring(0, 3)], 10);\n",
1488 s:"(" + Date.monthNames.join("|") + ")"};
1491 c:"m = parseInt(Date.monthNumbers[results[" + currentGroup + "]], 10);\n",
1492 s:"(Jan|Feb|Mar|Apr|May|Jun|Jul|Aug|Sep|Oct|Nov|Dec)"};
1495 c:"m = parseInt(results[" + currentGroup + "], 10) - 1;\n",
1496 s:"(\\d{1,2})"}; // Numeric representation of a month, without leading zeros
1499 c:"m = Math.max(0,parseInt(results[" + currentGroup + "], 10) - 1);\n",
1500 s:"(\\d{2})"}; // Numeric representation of a month, with leading zeros
1511 c:"y = parseInt(results[" + currentGroup + "], 10);\n",
1515 c:"var ty = parseInt(results[" + currentGroup + "], 10);\n"
1516 + "y = ty > Date.y2kYear ? 1900 + ty : 2000 + ty;\n",
1520 c:"if (results[" + currentGroup + "] == 'am') {\n"
1521 + "if (h == 12) { h = 0; }\n"
1522 + "} else { if (h < 12) { h += 12; }}",
1526 c:"if (results[" + currentGroup + "] == 'AM') {\n"
1527 + "if (h == 12) { h = 0; }\n"
1528 + "} else { if (h < 12) { h += 12; }}",
1533 c:"h = parseInt(results[" + currentGroup + "], 10);\n",
1534 s:"(\\d{1,2})"}; // 12/24-hr format format of an hour without leading zeroes
1538 c:"h = parseInt(results[" + currentGroup + "], 10);\n",
1539 s:"(\\d{2})"}; // 12/24-hr format format of an hour with leading zeroes
1542 c:"i = parseInt(results[" + currentGroup + "], 10);\n",
1546 c:"s = parseInt(results[" + currentGroup + "], 10);\n",
1551 "o = results[", currentGroup, "];\n",
1552 "var sn = o.substring(0,1);\n", // get + / - sign
1553 "var hr = o.substring(1,3)*1 + Math.floor(o.substring(3,5) / 60);\n", // get hours (performs minutes-to-hour conversion also)
1554 "var mn = o.substring(3,5) % 60;\n", // get minutes
1555 "o = ((-12 <= (hr*60 + mn)/60) && ((hr*60 + mn)/60 <= 14))?\n", // -12hrs <= GMT offset <= 14hrs
1556 " (sn + String.leftPad(hr, 2, 0) + String.leftPad(mn, 2, 0)) : null;\n"
1558 s:"([+\-]\\d{2,4})"};
1564 "o = results[", currentGroup, "];\n",
1565 "var sn = o.substring(0,1);\n",
1566 "var hr = o.substring(1,3)*1 + Math.floor(o.substring(4,6) / 60);\n",
1567 "var mn = o.substring(4,6) % 60;\n",
1568 "o = ((-12 <= (hr*60 + mn)/60) && ((hr*60 + mn)/60 <= 14))?\n",
1569 " (sn + String.leftPad(hr, 2, 0) + String.leftPad(mn, 2, 0)) : null;\n"
1575 s:"[A-Z]{1,4}"}; // timezone abbrev. may be between 1 - 4 chars
1578 c:"z = results[" + currentGroup + "];\n" // -43200 <= UTC offset <= 50400
1579 + "z = (-43200 <= z*1 && z*1 <= 50400)? z : null;\n",
1580 s:"([+\-]?\\d{1,5})"}; // leading '+' sign is optional for UTC offset
1584 s:String.escape(character)};
1589 * Get the timezone abbreviation of the current date (equivalent to the format specifier 'T').
1590 * @return {String} The abbreviated timezone name (e.g. 'CST')
1592 Date.prototype.getTimezone = function() {
1593 return this.toString().replace(/^.*? ([A-Z]{1,4})[\-+][0-9]{4} .*$/, "$1");
1597 * Get the offset from GMT of the current date (equivalent to the format specifier 'O').
1598 * @return {String} The 4-character offset string prefixed with + or - (e.g. '-0600')
1600 Date.prototype.getGMTOffset = function() {
1601 return (this.getTimezoneOffset() > 0 ? "-" : "+")
1602 + String.leftPad(Math.abs(Math.floor(this.getTimezoneOffset() / 60)), 2, "0")
1603 + String.leftPad(this.getTimezoneOffset() % 60, 2, "0");
1607 * Get the offset from GMT of the current date (equivalent to the format specifier 'P').
1608 * @return {String} 2-characters representing hours and 2-characters representing minutes
1609 * seperated by a colon and prefixed with + or - (e.g. '-06:00')
1611 Date.prototype.getGMTColonOffset = function() {
1612 return (this.getTimezoneOffset() > 0 ? "-" : "+")
1613 + String.leftPad(Math.abs(Math.floor(this.getTimezoneOffset() / 60)), 2, "0")
1615 + String.leftPad(this.getTimezoneOffset() %60, 2, "0");
1619 * Get the numeric day number of the year, adjusted for leap year.
1620 * @return {Number} 0 through 364 (365 in leap years)
1622 Date.prototype.getDayOfYear = function() {
1624 Date.daysInMonth[1] = this.isLeapYear() ? 29 : 28;
1625 for (var i = 0; i < this.getMonth(); ++i) {
1626 num += Date.daysInMonth[i];
1628 return num + this.getDate() - 1;
1632 * Get the string representation of the numeric week number of the year
1633 * (equivalent to the format specifier 'W').
1634 * @return {String} '00' through '52'
1636 Date.prototype.getWeekOfYear = function() {
1637 // Skip to Thursday of this week
1638 var now = this.getDayOfYear() + (4 - this.getDay());
1639 // Find the first Thursday of the year
1640 var jan1 = new Date(this.getFullYear(), 0, 1);
1641 var then = (7 - jan1.getDay() + 4);
1642 return String.leftPad(((now - then) / 7) + 1, 2, "0");
1646 * Whether or not the current date is in a leap year.
1647 * @return {Boolean} True if the current date is in a leap year, else false
1649 Date.prototype.isLeapYear = function() {
1650 var year = this.getFullYear();
1651 return ((year & 3) == 0 && (year % 100 || (year % 400 == 0 && year)));
1655 * Get the first day of the current month, adjusted for leap year. The returned value
1656 * is the numeric day index within the week (0-6) which can be used in conjunction with
1657 * the {@link #monthNames} array to retrieve the textual day name.
1660 var dt = new Date('1/10/2007');
1661 document.write(Date.dayNames[dt.getFirstDayOfMonth()]); //output: 'Monday'
1663 * @return {Number} The day number (0-6)
1665 Date.prototype.getFirstDayOfMonth = function() {
1666 var day = (this.getDay() - (this.getDate() - 1)) % 7;
1667 return (day < 0) ? (day + 7) : day;
1671 * Get the last day of the current month, adjusted for leap year. The returned value
1672 * is the numeric day index within the week (0-6) which can be used in conjunction with
1673 * the {@link #monthNames} array to retrieve the textual day name.
1676 var dt = new Date('1/10/2007');
1677 document.write(Date.dayNames[dt.getLastDayOfMonth()]); //output: 'Wednesday'
1679 * @return {Number} The day number (0-6)
1681 Date.prototype.getLastDayOfMonth = function() {
1682 var day = (this.getDay() + (Date.daysInMonth[this.getMonth()] - this.getDate())) % 7;
1683 return (day < 0) ? (day + 7) : day;
1688 * Get the first date of this date's month
1691 Date.prototype.getFirstDateOfMonth = function() {
1692 return new Date(this.getFullYear(), this.getMonth(), 1);
1696 * Get the last date of this date's month
1699 Date.prototype.getLastDateOfMonth = function() {
1700 return new Date(this.getFullYear(), this.getMonth(), this.getDaysInMonth());
1703 * Get the number of days in the current month, adjusted for leap year.
1704 * @return {Number} The number of days in the month
1706 Date.prototype.getDaysInMonth = function() {
1707 Date.daysInMonth[1] = this.isLeapYear() ? 29 : 28;
1708 return Date.daysInMonth[this.getMonth()];
1712 * Get the English ordinal suffix of the current day (equivalent to the format specifier 'S').
1713 * @return {String} 'st, 'nd', 'rd' or 'th'
1715 Date.prototype.getSuffix = function() {
1716 switch (this.getDate()) {
1733 Date.daysInMonth = [31,28,31,30,31,30,31,31,30,31,30,31];
1736 * An array of textual month names.
1737 * Override these values for international dates, for example...
1738 * Date.monthNames = ['JanInYourLang', 'FebInYourLang', ...];
1757 * An array of textual day names.
1758 * Override these values for international dates, for example...
1759 * Date.dayNames = ['SundayInYourLang', 'MondayInYourLang', ...];
1775 Date.monthNumbers = {
1790 * Creates and returns a new Date instance with the exact same date value as the called instance.
1791 * Dates are copied and passed by reference, so if a copied date variable is modified later, the original
1792 * variable will also be changed. When the intention is to create a new variable that will not
1793 * modify the original instance, you should create a clone.
1795 * Example of correctly cloning a date:
1798 var orig = new Date('10/1/2006');
1801 document.write(orig); //returns 'Thu Oct 05 2006'!
1804 var orig = new Date('10/1/2006');
1805 var copy = orig.clone();
1807 document.write(orig); //returns 'Thu Oct 01 2006'
1809 * @return {Date} The new Date instance
1811 Date.prototype.clone = function() {
1812 return new Date(this.getTime());
1816 * Clears any time information from this date
1817 @param {Boolean} clone true to create a clone of this date, clear the time and return it
1818 @return {Date} this or the clone
1820 Date.prototype.clearTime = function(clone){
1822 return this.clone().clearTime();
1827 this.setMilliseconds(0);
1832 // safari setMonth is broken -- check that this is only donw once...
1833 if(Roo.isSafari && typeof(Date.brokenSetMonth) == 'undefined'){
1834 Date.brokenSetMonth = Date.prototype.setMonth;
1835 Date.prototype.setMonth = function(num){
1837 var n = Math.ceil(-num);
1838 var back_year = Math.ceil(n/12);
1839 var month = (n % 12) ? 12 - n % 12 : 0 ;
1840 this.setFullYear(this.getFullYear() - back_year);
1841 return Date.brokenSetMonth.call(this, month);
1843 return Date.brokenSetMonth.apply(this, arguments);
1848 /** Date interval constant
1852 /** Date interval constant
1856 /** Date interval constant
1860 /** Date interval constant
1864 /** Date interval constant
1868 /** Date interval constant
1872 /** Date interval constant
1878 * Provides a convenient method of performing basic date arithmetic. This method
1879 * does not modify the Date instance being called - it creates and returns
1880 * a new Date instance containing the resulting date value.
1885 var dt = new Date('10/29/2006').add(Date.DAY, 5);
1886 document.write(dt); //returns 'Fri Oct 06 2006 00:00:00'
1888 //Negative values will subtract correctly:
1889 var dt2 = new Date('10/1/2006').add(Date.DAY, -5);
1890 document.write(dt2); //returns 'Tue Sep 26 2006 00:00:00'
1892 //You can even chain several calls together in one line!
1893 var dt3 = new Date('10/1/2006').add(Date.DAY, 5).add(Date.HOUR, 8).add(Date.MINUTE, -30);
1894 document.write(dt3); //returns 'Fri Oct 06 2006 07:30:00'
1897 * @param {String} interval A valid date interval enum value
1898 * @param {Number} value The amount to add to the current date
1899 * @return {Date} The new Date instance
1901 Date.prototype.add = function(interval, value){
1902 var d = this.clone();
1903 if (!interval || value === 0) { return d; }
1904 switch(interval.toLowerCase()){
1906 d.setMilliseconds(this.getMilliseconds() + value);
1909 d.setSeconds(this.getSeconds() + value);
1912 d.setMinutes(this.getMinutes() + value);
1915 d.setHours(this.getHours() + value);
1918 d.setDate(this.getDate() + value);
1921 var day = this.getDate();
1923 day = Math.min(day, this.getFirstDateOfMonth().add('mo', value).getLastDateOfMonth().getDate());
1926 d.setMonth(this.getMonth() + value);
1929 d.setFullYear(this.getFullYear() + value);
1935 * @class Roo.lib.Dom
1939 * Dom utils (from YIU afaik)
1945 * Get the view width
1946 * @param {Boolean} full True will get the full document, otherwise it's the view width
1947 * @return {Number} The width
1950 getViewWidth : function(full) {
1951 return full ? this.getDocumentWidth() : this.getViewportWidth();
1954 * Get the view height
1955 * @param {Boolean} full True will get the full document, otherwise it's the view height
1956 * @return {Number} The height
1958 getViewHeight : function(full) {
1959 return full ? this.getDocumentHeight() : this.getViewportHeight();
1962 * Get the Full Document height
1963 * @return {Number} The height
1965 getDocumentHeight: function() {
1966 var scrollHeight = (document.compatMode != "CSS1Compat") ? document.body.scrollHeight : document.documentElement.scrollHeight;
1967 return Math.max(scrollHeight, this.getViewportHeight());
1970 * Get the Full Document width
1971 * @return {Number} The width
1973 getDocumentWidth: function() {
1974 var scrollWidth = (document.compatMode != "CSS1Compat") ? document.body.scrollWidth : document.documentElement.scrollWidth;
1975 return Math.max(scrollWidth, this.getViewportWidth());
1978 * Get the Window Viewport height
1979 * @return {Number} The height
1981 getViewportHeight: function() {
1982 var height = self.innerHeight;
1983 var mode = document.compatMode;
1985 if ((mode || Roo.isIE) && !Roo.isOpera) {
1986 height = (mode == "CSS1Compat") ?
1987 document.documentElement.clientHeight :
1988 document.body.clientHeight;
1994 * Get the Window Viewport width
1995 * @return {Number} The width
1997 getViewportWidth: function() {
1998 var width = self.innerWidth;
1999 var mode = document.compatMode;
2001 if (mode || Roo.isIE) {
2002 width = (mode == "CSS1Compat") ?
2003 document.documentElement.clientWidth :
2004 document.body.clientWidth;
2009 isAncestor : function(p, c) {
2016 if (p.contains && !Roo.isSafari) {
2017 return p.contains(c);
2018 } else if (p.compareDocumentPosition) {
2019 return !!(p.compareDocumentPosition(c) & 16);
2021 var parent = c.parentNode;
2026 else if (!parent.tagName || parent.tagName.toUpperCase() == "HTML") {
2029 parent = parent.parentNode;
2035 getRegion : function(el) {
2036 return Roo.lib.Region.getRegion(el);
2039 getY : function(el) {
2040 return this.getXY(el)[1];
2043 getX : function(el) {
2044 return this.getXY(el)[0];
2047 getXY : function(el) {
2048 var p, pe, b, scroll, bd = document.body;
2049 el = Roo.getDom(el);
2050 var fly = Roo.lib.AnimBase.fly;
2051 if (el.getBoundingClientRect) {
2052 b = el.getBoundingClientRect();
2053 scroll = fly(document).getScroll();
2054 return [b.left + scroll.left, b.top + scroll.top];
2060 var hasAbsolute = fly(el).getStyle("position") == "absolute";
2067 if (!hasAbsolute && fly(p).getStyle("position") == "absolute") {
2074 var bt = parseInt(pe.getStyle("borderTopWidth"), 10) || 0;
2075 var bl = parseInt(pe.getStyle("borderLeftWidth"), 10) || 0;
2082 if (p != el && pe.getStyle('overflow') != 'visible') {
2090 if (Roo.isSafari && hasAbsolute) {
2095 if (Roo.isGecko && !hasAbsolute) {
2097 x += parseInt(dbd.getStyle("borderLeftWidth"), 10) || 0;
2098 y += parseInt(dbd.getStyle("borderTopWidth"), 10) || 0;
2102 while (p && p != bd) {
2103 if (!Roo.isOpera || (p.tagName != 'TR' && fly(p).getStyle("display") != "inline")) {
2115 setXY : function(el, xy) {
2116 el = Roo.fly(el, '_setXY');
2118 var pts = el.translatePoints(xy);
2119 if (xy[0] !== false) {
2120 el.dom.style.left = pts.left + "px";
2122 if (xy[1] !== false) {
2123 el.dom.style.top = pts.top + "px";
2127 setX : function(el, x) {
2128 this.setXY(el, [x, false]);
2131 setY : function(el, y) {
2132 this.setXY(el, [false, y]);
2136 * Portions of this file are based on pieces of Yahoo User Interface Library
2137 * Copyright (c) 2007, Yahoo! Inc. All rights reserved.
2138 * YUI licensed under the BSD License:
2139 * http://developer.yahoo.net/yui/license.txt
2140 * <script type="text/javascript">
2144 Roo.lib.Event = function() {
2145 var loadComplete = false;
2147 var unloadListeners = [];
2149 var onAvailStack = [];
2151 var lastError = null;
2164 startInterval: function() {
2165 if (!this._interval) {
2167 var callback = function() {
2168 self._tryPreloadAttach();
2170 this._interval = setInterval(callback, this.POLL_INTERVAL);
2175 onAvailable: function(p_id, p_fn, p_obj, p_override) {
2176 onAvailStack.push({ id: p_id,
2179 override: p_override,
2180 checkReady: false });
2182 retryCount = this.POLL_RETRYS;
2183 this.startInterval();
2187 addListener: function(el, eventName, fn) {
2188 el = Roo.getDom(el);
2193 if ("unload" == eventName) {
2194 unloadListeners[unloadListeners.length] =
2195 [el, eventName, fn];
2199 var wrappedFn = function(e) {
2200 return fn(Roo.lib.Event.getEvent(e));
2203 var li = [el, eventName, fn, wrappedFn];
2205 var index = listeners.length;
2206 listeners[index] = li;
2208 this.doAdd(el, eventName, wrappedFn, false);
2214 removeListener: function(el, eventName, fn) {
2217 el = Roo.getDom(el);
2220 return this.purgeElement(el, false, eventName);
2224 if ("unload" == eventName) {
2226 for (i = 0,len = unloadListeners.length; i < len; i++) {
2227 var li = unloadListeners[i];
2230 li[1] == eventName &&
2232 unloadListeners.splice(i, 1);
2240 var cacheItem = null;
2243 var index = arguments[3];
2245 if ("undefined" == typeof index) {
2246 index = this._getCacheIndex(el, eventName, fn);
2250 cacheItem = listeners[index];
2253 if (!el || !cacheItem) {
2257 this.doRemove(el, eventName, cacheItem[this.WFN], false);
2259 delete listeners[index][this.WFN];
2260 delete listeners[index][this.FN];
2261 listeners.splice(index, 1);
2268 getTarget: function(ev, resolveTextNode) {
2269 ev = ev.browserEvent || ev;
2270 ev = ev.touches ? (ev.touches[0] || ev.changedTouches[0] || ev ) : ev;
2271 var t = ev.target || ev.srcElement;
2272 return this.resolveTextNode(t);
2276 resolveTextNode: function(node) {
2277 if (Roo.isSafari && node && 3 == node.nodeType) {
2278 return node.parentNode;
2285 getPageX: function(ev) {
2286 ev = ev.browserEvent || ev;
2287 ev = ev.touches ? (ev.touches[0] || ev.changedTouches[0] || ev ) : ev;
2289 if (!x && 0 !== x) {
2290 x = ev.clientX || 0;
2293 x += this.getScroll()[1];
2301 getPageY: function(ev) {
2302 ev = ev.browserEvent || ev;
2303 ev = ev.touches ? (ev.touches[0] || ev.changedTouches[0] || ev ) : ev;
2305 if (!y && 0 !== y) {
2306 y = ev.clientY || 0;
2309 y += this.getScroll()[0];
2318 getXY: function(ev) {
2319 ev = ev.browserEvent || ev;
2320 ev = ev.touches ? (ev.touches[0] || ev.changedTouches[0] || ev ) : ev;
2321 return [this.getPageX(ev), this.getPageY(ev)];
2325 getRelatedTarget: function(ev) {
2326 ev = ev.browserEvent || ev;
2327 ev = ev.touches ? (ev.touches[0] || ev.changedTouches[0] || ev ) : ev;
2328 var t = ev.relatedTarget;
2330 if (ev.type == "mouseout") {
2332 } else if (ev.type == "mouseover") {
2337 return this.resolveTextNode(t);
2341 getTime: function(ev) {
2342 ev = ev.browserEvent || ev;
2343 ev = ev.touches ? (ev.touches[0] || ev.changedTouches[0] || ev ) : ev;
2345 var t = new Date().getTime();
2349 this.lastError = ex;
2358 stopEvent: function(ev) {
2359 this.stopPropagation(ev);
2360 this.preventDefault(ev);
2364 stopPropagation: function(ev) {
2365 ev = ev.browserEvent || ev;
2366 if (ev.stopPropagation) {
2367 ev.stopPropagation();
2369 ev.cancelBubble = true;
2374 preventDefault: function(ev) {
2375 ev = ev.browserEvent || ev;
2376 if(ev.preventDefault) {
2377 ev.preventDefault();
2379 ev.returnValue = false;
2384 getEvent: function(e) {
2385 var ev = e || window.event;
2387 var c = this.getEvent.caller;
2389 ev = c.arguments[0];
2390 if (ev && Event == ev.constructor) {
2400 getCharCode: function(ev) {
2401 ev = ev.browserEvent || ev;
2402 return ev.charCode || ev.keyCode || 0;
2406 _getCacheIndex: function(el, eventName, fn) {
2407 for (var i = 0,len = listeners.length; i < len; ++i) {
2408 var li = listeners[i];
2410 li[this.FN] == fn &&
2411 li[this.EL] == el &&
2412 li[this.TYPE] == eventName) {
2424 getEl: function(id) {
2425 return document.getElementById(id);
2429 clearCache: function() {
2433 _load: function(e) {
2434 loadComplete = true;
2435 var EU = Roo.lib.Event;
2439 EU.doRemove(window, "load", EU._load);
2444 _tryPreloadAttach: function() {
2453 var tryAgain = !loadComplete;
2455 tryAgain = (retryCount > 0);
2460 for (var i = 0,len = onAvailStack.length; i < len; ++i) {
2461 var item = onAvailStack[i];
2463 var el = this.getEl(item.id);
2466 if (!item.checkReady ||
2469 (document && document.body)) {
2472 if (item.override) {
2473 if (item.override === true) {
2476 scope = item.override;
2479 item.fn.call(scope, item.obj);
2480 onAvailStack[i] = null;
2483 notAvail.push(item);
2488 retryCount = (notAvail.length === 0) ? 0 : retryCount - 1;
2492 this.startInterval();
2494 clearInterval(this._interval);
2495 this._interval = null;
2498 this.locked = false;
2505 purgeElement: function(el, recurse, eventName) {
2506 var elListeners = this.getListeners(el, eventName);
2508 for (var i = 0,len = elListeners.length; i < len; ++i) {
2509 var l = elListeners[i];
2510 this.removeListener(el, l.type, l.fn);
2514 if (recurse && el && el.childNodes) {
2515 for (i = 0,len = el.childNodes.length; i < len; ++i) {
2516 this.purgeElement(el.childNodes[i], recurse, eventName);
2522 getListeners: function(el, eventName) {
2523 var results = [], searchLists;
2525 searchLists = [listeners, unloadListeners];
2526 } else if (eventName == "unload") {
2527 searchLists = [unloadListeners];
2529 searchLists = [listeners];
2532 for (var j = 0; j < searchLists.length; ++j) {
2533 var searchList = searchLists[j];
2534 if (searchList && searchList.length > 0) {
2535 for (var i = 0,len = searchList.length; i < len; ++i) {
2536 var l = searchList[i];
2537 if (l && l[this.EL] === el &&
2538 (!eventName || eventName === l[this.TYPE])) {
2543 adjust: l[this.ADJ_SCOPE],
2551 return (results.length) ? results : null;
2555 _unload: function(e) {
2557 var EU = Roo.lib.Event, i, j, l, len, index;
2559 for (i = 0,len = unloadListeners.length; i < len; ++i) {
2560 l = unloadListeners[i];
2563 if (l[EU.ADJ_SCOPE]) {
2564 if (l[EU.ADJ_SCOPE] === true) {
2567 scope = l[EU.ADJ_SCOPE];
2570 l[EU.FN].call(scope, EU.getEvent(e), l[EU.OBJ]);
2571 unloadListeners[i] = null;
2577 unloadListeners = null;
2579 if (listeners && listeners.length > 0) {
2580 j = listeners.length;
2583 l = listeners[index];
2585 EU.removeListener(l[EU.EL], l[EU.TYPE],
2595 EU.doRemove(window, "unload", EU._unload);
2600 getScroll: function() {
2601 var dd = document.documentElement, db = document.body;
2602 if (dd && (dd.scrollTop || dd.scrollLeft)) {
2603 return [dd.scrollTop, dd.scrollLeft];
2605 return [db.scrollTop, db.scrollLeft];
2612 doAdd: function () {
2613 if (window.addEventListener) {
2614 return function(el, eventName, fn, capture) {
2615 el.addEventListener(eventName, fn, (capture));
2617 } else if (window.attachEvent) {
2618 return function(el, eventName, fn, capture) {
2619 el.attachEvent("on" + eventName, fn);
2628 doRemove: function() {
2629 if (window.removeEventListener) {
2630 return function (el, eventName, fn, capture) {
2631 el.removeEventListener(eventName, fn, (capture));
2633 } else if (window.detachEvent) {
2634 return function (el, eventName, fn) {
2635 el.detachEvent("on" + eventName, fn);
2647 var E = Roo.lib.Event;
2648 E.on = E.addListener;
2649 E.un = E.removeListener;
2651 if (document && document.body) {
2654 E.doAdd(window, "load", E._load);
2656 E.doAdd(window, "unload", E._unload);
2657 E._tryPreloadAttach();
2664 * @class Roo.lib.Ajax
2666 * provide a simple Ajax request utility functions
2668 * Portions of this file are based on pieces of Yahoo User Interface Library
2669 * Copyright (c) 2007, Yahoo! Inc. All rights reserved.
2670 * YUI licensed under the BSD License:
2671 * http://developer.yahoo.net/yui/license.txt
2672 * <script type="text/javascript">
2680 request : function(method, uri, cb, data, options) {
2682 var hs = options.headers;
2685 if(hs.hasOwnProperty(h)){
2686 this.initHeader(h, hs[h], false);
2690 if(options.xmlData){
2691 this.initHeader('Content-Type', 'text/xml', false);
2693 data = options.xmlData;
2697 return this.asyncRequest(method, uri, cb, data);
2703 * @param {DomForm} form element
2704 * @return {String} urlencode form output.
2706 serializeForm : function(form) {
2707 if(typeof form == 'string') {
2708 form = (document.getElementById(form) || document.forms[form]);
2711 var el, name, val, disabled, data = '', hasSubmit = false;
2712 for (var i = 0; i < form.elements.length; i++) {
2713 el = form.elements[i];
2714 disabled = form.elements[i].disabled;
2715 name = form.elements[i].name;
2716 val = form.elements[i].value;
2718 if (!disabled && name){
2722 case 'select-multiple':
2723 for (var j = 0; j < el.options.length; j++) {
2724 if (el.options[j].selected) {
2726 data += Roo.encodeURIComponent(name) + '=' + Roo.encodeURIComponent(el.options[j].attributes['value'].specified ? el.options[j].value : el.options[j].text) + '&';
2729 data += Roo.encodeURIComponent(name) + '=' + Roo.encodeURIComponent(el.options[j].hasAttribute('value') ? el.options[j].value : el.options[j].text) + '&';
2737 data += Roo.encodeURIComponent(name) + '=' + Roo.encodeURIComponent(val) + '&';
2750 if(hasSubmit == false) {
2751 data += Roo.encodeURIComponent(name) + '=' + Roo.encodeURIComponent(val) + '&';
2756 data += Roo.encodeURIComponent(name) + '=' + Roo.encodeURIComponent(val) + '&';
2761 data = data.substr(0, data.length - 1);
2769 useDefaultHeader:true,
2771 defaultPostHeader:'application/x-www-form-urlencoded',
2773 useDefaultXhrHeader:true,
2775 defaultXhrHeader:'XMLHttpRequest',
2777 hasDefaultHeaders:true,
2789 setProgId:function(id)
2791 this.activeX.unshift(id);
2794 setDefaultPostHeader:function(b)
2796 this.useDefaultHeader = b;
2799 setDefaultXhrHeader:function(b)
2801 this.useDefaultXhrHeader = b;
2804 setPollingInterval:function(i)
2806 if (typeof i == 'number' && isFinite(i)) {
2807 this.pollInterval = i;
2811 createXhrObject:function(transactionId)
2817 http = new XMLHttpRequest();
2819 obj = { conn:http, tId:transactionId };
2823 for (var i = 0; i < this.activeX.length; ++i) {
2827 http = new ActiveXObject(this.activeX[i]);
2829 obj = { conn:http, tId:transactionId };
2842 getConnectionObject:function()
2845 var tId = this.transactionId;
2849 o = this.createXhrObject(tId);
2851 this.transactionId++;
2862 asyncRequest:function(method, uri, callback, postData)
2864 var o = this.getConnectionObject();
2870 o.conn.open(method, uri, true);
2872 if (this.useDefaultXhrHeader) {
2873 if (!this.defaultHeaders['X-Requested-With']) {
2874 this.initHeader('X-Requested-With', this.defaultXhrHeader, true);
2878 if(postData && this.useDefaultHeader){
2879 this.initHeader('Content-Type', this.defaultPostHeader);
2882 if (this.hasDefaultHeaders || this.hasHeaders) {
2886 this.handleReadyState(o, callback);
2887 o.conn.send(postData || null);
2893 handleReadyState:function(o, callback)
2897 if (callback && callback.timeout) {
2899 this.timeout[o.tId] = window.setTimeout(function() {
2900 oConn.abort(o, callback, true);
2901 }, callback.timeout);
2904 this.poll[o.tId] = window.setInterval(
2906 if (o.conn && o.conn.readyState == 4) {
2907 window.clearInterval(oConn.poll[o.tId]);
2908 delete oConn.poll[o.tId];
2910 if(callback && callback.timeout) {
2911 window.clearTimeout(oConn.timeout[o.tId]);
2912 delete oConn.timeout[o.tId];
2915 oConn.handleTransactionResponse(o, callback);
2918 , this.pollInterval);
2921 handleTransactionResponse:function(o, callback, isAbort)
2925 this.releaseObject(o);
2929 var httpStatus, responseObject;
2933 if (o.conn.status !== undefined && o.conn.status != 0) {
2934 httpStatus = o.conn.status;
2946 if (httpStatus >= 200 && httpStatus < 300) {
2947 responseObject = this.createResponseObject(o, callback.argument);
2948 if (callback.success) {
2949 if (!callback.scope) {
2950 callback.success(responseObject);
2955 callback.success.apply(callback.scope, [responseObject]);
2960 switch (httpStatus) {
2968 responseObject = this.createExceptionObject(o.tId, callback.argument, (isAbort ? isAbort : false));
2969 if (callback.failure) {
2970 if (!callback.scope) {
2971 callback.failure(responseObject);
2974 callback.failure.apply(callback.scope, [responseObject]);
2979 responseObject = this.createResponseObject(o, callback.argument);
2980 if (callback.failure) {
2981 if (!callback.scope) {
2982 callback.failure(responseObject);
2985 callback.failure.apply(callback.scope, [responseObject]);
2991 this.releaseObject(o);
2992 responseObject = null;
2995 createResponseObject:function(o, callbackArg)
3002 var headerStr = o.conn.getAllResponseHeaders();
3003 var header = headerStr.split('\n');
3004 for (var i = 0; i < header.length; i++) {
3005 var delimitPos = header[i].indexOf(':');
3006 if (delimitPos != -1) {
3007 headerObj[header[i].substring(0, delimitPos)] = header[i].substring(delimitPos + 2);
3015 obj.status = o.conn.status;
3016 obj.statusText = o.conn.statusText;
3017 obj.getResponseHeader = headerObj;
3018 obj.getAllResponseHeaders = headerStr;
3019 obj.responseText = o.conn.responseText;
3020 obj.responseXML = o.conn.responseXML;
3022 if (typeof callbackArg !== undefined) {
3023 obj.argument = callbackArg;
3029 createExceptionObject:function(tId, callbackArg, isAbort)
3032 var COMM_ERROR = 'communication failure';
3033 var ABORT_CODE = -1;
3034 var ABORT_ERROR = 'transaction aborted';
3040 obj.status = ABORT_CODE;
3041 obj.statusText = ABORT_ERROR;
3044 obj.status = COMM_CODE;
3045 obj.statusText = COMM_ERROR;
3049 obj.argument = callbackArg;
3055 initHeader:function(label, value, isDefault)
3057 var headerObj = (isDefault) ? this.defaultHeaders : this.headers;
3059 if (headerObj[label] === undefined) {
3060 headerObj[label] = value;
3065 headerObj[label] = value + "," + headerObj[label];
3069 this.hasDefaultHeaders = true;
3072 this.hasHeaders = true;
3077 setHeader:function(o)
3079 if (this.hasDefaultHeaders) {
3080 for (var prop in this.defaultHeaders) {
3081 if (this.defaultHeaders.hasOwnProperty(prop)) {
3082 o.conn.setRequestHeader(prop, this.defaultHeaders[prop]);
3087 if (this.hasHeaders) {
3088 for (var prop in this.headers) {
3089 if (this.headers.hasOwnProperty(prop)) {
3090 o.conn.setRequestHeader(prop, this.headers[prop]);
3094 this.hasHeaders = false;
3098 resetDefaultHeaders:function() {
3099 delete this.defaultHeaders;
3100 this.defaultHeaders = {};
3101 this.hasDefaultHeaders = false;
3104 abort:function(o, callback, isTimeout)
3106 if(this.isCallInProgress(o)) {
3108 window.clearInterval(this.poll[o.tId]);
3109 delete this.poll[o.tId];
3111 delete this.timeout[o.tId];
3114 this.handleTransactionResponse(o, callback, true);
3124 isCallInProgress:function(o)
3127 return o.conn.readyState != 4 && o.conn.readyState != 0;
3136 releaseObject:function(o)
3145 'MSXML2.XMLHTTP.3.0',
3153 * Portions of this file are based on pieces of Yahoo User Interface Library
3154 * Copyright (c) 2007, Yahoo! Inc. All rights reserved.
3155 * YUI licensed under the BSD License:
3156 * http://developer.yahoo.net/yui/license.txt
3157 * <script type="text/javascript">
3161 Roo.lib.Region = function(t, r, b, l) {
3171 Roo.lib.Region.prototype = {
3172 contains : function(region) {
3173 return ( region.left >= this.left &&
3174 region.right <= this.right &&
3175 region.top >= this.top &&
3176 region.bottom <= this.bottom );
3180 getArea : function() {
3181 return ( (this.bottom - this.top) * (this.right - this.left) );
3184 intersect : function(region) {
3185 var t = Math.max(this.top, region.top);
3186 var r = Math.min(this.right, region.right);
3187 var b = Math.min(this.bottom, region.bottom);
3188 var l = Math.max(this.left, region.left);
3190 if (b >= t && r >= l) {
3191 return new Roo.lib.Region(t, r, b, l);
3196 union : function(region) {
3197 var t = Math.min(this.top, region.top);
3198 var r = Math.max(this.right, region.right);
3199 var b = Math.max(this.bottom, region.bottom);
3200 var l = Math.min(this.left, region.left);
3202 return new Roo.lib.Region(t, r, b, l);
3205 adjust : function(t, l, b, r) {
3214 Roo.lib.Region.getRegion = function(el) {
3215 var p = Roo.lib.Dom.getXY(el);
3218 var r = p[0] + el.offsetWidth;
3219 var b = p[1] + el.offsetHeight;
3222 return new Roo.lib.Region(t, r, b, l);
3225 * Portions of this file are based on pieces of Yahoo User Interface Library
3226 * Copyright (c) 2007, Yahoo! Inc. All rights reserved.
3227 * YUI licensed under the BSD License:
3228 * http://developer.yahoo.net/yui/license.txt
3229 * <script type="text/javascript">
3232 //@@dep Roo.lib.Region
3235 Roo.lib.Point = function(x, y) {
3236 if (x instanceof Array) {
3240 this.x = this.right = this.left = this[0] = x;
3241 this.y = this.top = this.bottom = this[1] = y;
3244 Roo.lib.Point.prototype = new Roo.lib.Region();
3246 * Portions of this file are based on pieces of Yahoo User Interface Library
3247 * Copyright (c) 2007, Yahoo! Inc. All rights reserved.
3248 * YUI licensed under the BSD License:
3249 * http://developer.yahoo.net/yui/license.txt
3250 * <script type="text/javascript">
3257 scroll : function(el, args, duration, easing, cb, scope) {
3258 this.run(el, args, duration, easing, cb, scope, Roo.lib.Scroll);
3261 motion : function(el, args, duration, easing, cb, scope) {
3262 this.run(el, args, duration, easing, cb, scope, Roo.lib.Motion);
3265 color : function(el, args, duration, easing, cb, scope) {
3266 this.run(el, args, duration, easing, cb, scope, Roo.lib.ColorAnim);
3269 run : function(el, args, duration, easing, cb, scope, type) {
3270 type = type || Roo.lib.AnimBase;
3271 if (typeof easing == "string") {
3272 easing = Roo.lib.Easing[easing];
3274 var anim = new type(el, args, duration, easing);
3275 anim.animateX(function() {
3276 Roo.callback(cb, scope);
3282 * Portions of this file are based on pieces of Yahoo User Interface Library
3283 * Copyright (c) 2007, Yahoo! Inc. All rights reserved.
3284 * YUI licensed under the BSD License:
3285 * http://developer.yahoo.net/yui/license.txt
3286 * <script type="text/javascript">
3294 if (!libFlyweight) {
3295 libFlyweight = new Roo.Element.Flyweight();
3297 libFlyweight.dom = el;
3298 return libFlyweight;
3301 // since this uses fly! - it cant be in DOM (which does not have fly yet..)
3305 Roo.lib.AnimBase = function(el, attributes, duration, method) {
3307 this.init(el, attributes, duration, method);
3311 Roo.lib.AnimBase.fly = fly;
3315 Roo.lib.AnimBase.prototype = {
3317 toString: function() {
3318 var el = this.getEl();
3319 var id = el.id || el.tagName;
3320 return ("Anim " + id);
3324 noNegatives: /width|height|opacity|padding/i,
3325 offsetAttribute: /^((width|height)|(top|left))$/,
3326 defaultUnit: /width|height|top$|bottom$|left$|right$/i,
3327 offsetUnit: /\d+(em|%|en|ex|pt|in|cm|mm|pc)$/i
3331 doMethod: function(attr, start, end) {
3332 return this.method(this.currentFrame, start, end - start, this.totalFrames);
3336 setAttribute: function(attr, val, unit) {
3337 if (this.patterns.noNegatives.test(attr)) {
3338 val = (val > 0) ? val : 0;
3341 Roo.fly(this.getEl(), '_anim').setStyle(attr, val + unit);
3345 getAttribute: function(attr) {
3346 var el = this.getEl();
3347 var val = fly(el).getStyle(attr);
3349 if (val !== 'auto' && !this.patterns.offsetUnit.test(val)) {
3350 return parseFloat(val);
3353 var a = this.patterns.offsetAttribute.exec(attr) || [];
3354 var pos = !!( a[3] );
3355 var box = !!( a[2] );
3358 if (box || (fly(el).getStyle('position') == 'absolute' && pos)) {
3359 val = el['offset' + a[0].charAt(0).toUpperCase() + a[0].substr(1)];
3368 getDefaultUnit: function(attr) {
3369 if (this.patterns.defaultUnit.test(attr)) {
3376 animateX : function(callback, scope) {
3377 var f = function() {
3378 this.onComplete.removeListener(f);
3379 if (typeof callback == "function") {
3380 callback.call(scope || this, this);
3383 this.onComplete.addListener(f, this);
3388 setRuntimeAttribute: function(attr) {
3391 var attributes = this.attributes;
3393 this.runtimeAttributes[attr] = {};
3395 var isset = function(prop) {
3396 return (typeof prop !== 'undefined');
3399 if (!isset(attributes[attr]['to']) && !isset(attributes[attr]['by'])) {
3403 start = ( isset(attributes[attr]['from']) ) ? attributes[attr]['from'] : this.getAttribute(attr);
3406 if (isset(attributes[attr]['to'])) {
3407 end = attributes[attr]['to'];
3408 } else if (isset(attributes[attr]['by'])) {
3409 if (start.constructor == Array) {
3411 for (var i = 0, len = start.length; i < len; ++i) {
3412 end[i] = start[i] + attributes[attr]['by'][i];
3415 end = start + attributes[attr]['by'];
3419 this.runtimeAttributes[attr].start = start;
3420 this.runtimeAttributes[attr].end = end;
3423 this.runtimeAttributes[attr].unit = ( isset(attributes[attr].unit) ) ? attributes[attr]['unit'] : this.getDefaultUnit(attr);
3427 init: function(el, attributes, duration, method) {
3429 var isAnimated = false;
3432 var startTime = null;
3435 var actualFrames = 0;
3438 el = Roo.getDom(el);
3441 this.attributes = attributes || {};
3444 this.duration = duration || 1;
3447 this.method = method || Roo.lib.Easing.easeNone;
3450 this.useSeconds = true;
3453 this.currentFrame = 0;
3456 this.totalFrames = Roo.lib.AnimMgr.fps;
3459 this.getEl = function() {
3464 this.isAnimated = function() {
3469 this.getStartTime = function() {
3473 this.runtimeAttributes = {};
3476 this.animate = function() {
3477 if (this.isAnimated()) {
3481 this.currentFrame = 0;
3483 this.totalFrames = ( this.useSeconds ) ? Math.ceil(Roo.lib.AnimMgr.fps * this.duration) : this.duration;
3485 Roo.lib.AnimMgr.registerElement(this);
3489 this.stop = function(finish) {
3491 this.currentFrame = this.totalFrames;
3492 this._onTween.fire();
3494 Roo.lib.AnimMgr.stop(this);
3497 var onStart = function() {
3498 this.onStart.fire();
3500 this.runtimeAttributes = {};
3501 for (var attr in this.attributes) {
3502 this.setRuntimeAttribute(attr);
3507 startTime = new Date();
3511 var onTween = function() {
3513 duration: new Date() - this.getStartTime(),
3514 currentFrame: this.currentFrame
3517 data.toString = function() {
3519 'duration: ' + data.duration +
3520 ', currentFrame: ' + data.currentFrame
3524 this.onTween.fire(data);
3526 var runtimeAttributes = this.runtimeAttributes;
3528 for (var attr in runtimeAttributes) {
3529 this.setAttribute(attr, this.doMethod(attr, runtimeAttributes[attr].start, runtimeAttributes[attr].end), runtimeAttributes[attr].unit);
3535 var onComplete = function() {
3536 var actual_duration = (new Date() - startTime) / 1000 ;
3539 duration: actual_duration,
3540 frames: actualFrames,
3541 fps: actualFrames / actual_duration
3544 data.toString = function() {
3546 'duration: ' + data.duration +
3547 ', frames: ' + data.frames +
3548 ', fps: ' + data.fps
3554 this.onComplete.fire(data);
3558 this._onStart = new Roo.util.Event(this);
3559 this.onStart = new Roo.util.Event(this);
3560 this.onTween = new Roo.util.Event(this);
3561 this._onTween = new Roo.util.Event(this);
3562 this.onComplete = new Roo.util.Event(this);
3563 this._onComplete = new Roo.util.Event(this);
3564 this._onStart.addListener(onStart);
3565 this._onTween.addListener(onTween);
3566 this._onComplete.addListener(onComplete);
3571 * Portions of this file are based on pieces of Yahoo User Interface Library
3572 * Copyright (c) 2007, Yahoo! Inc. All rights reserved.
3573 * YUI licensed under the BSD License:
3574 * http://developer.yahoo.net/yui/license.txt
3575 * <script type="text/javascript">
3579 Roo.lib.AnimMgr = new function() {
3596 this.registerElement = function(tween) {
3597 queue[queue.length] = tween;
3599 tween._onStart.fire();
3604 this.unRegister = function(tween, index) {
3605 tween._onComplete.fire();
3606 index = index || getIndex(tween);
3608 queue.splice(index, 1);
3612 if (tweenCount <= 0) {
3618 this.start = function() {
3619 if (thread === null) {
3620 thread = setInterval(this.run, this.delay);
3625 this.stop = function(tween) {
3627 clearInterval(thread);
3629 for (var i = 0, len = queue.length; i < len; ++i) {
3630 if (queue[0].isAnimated()) {
3631 this.unRegister(queue[0], 0);
3640 this.unRegister(tween);
3645 this.run = function() {
3646 for (var i = 0, len = queue.length; i < len; ++i) {
3647 var tween = queue[i];
3648 if (!tween || !tween.isAnimated()) {
3652 if (tween.currentFrame < tween.totalFrames || tween.totalFrames === null)
3654 tween.currentFrame += 1;
3656 if (tween.useSeconds) {
3657 correctFrame(tween);
3659 tween._onTween.fire();
3662 Roo.lib.AnimMgr.stop(tween, i);
3667 var getIndex = function(anim) {
3668 for (var i = 0, len = queue.length; i < len; ++i) {
3669 if (queue[i] == anim) {
3677 var correctFrame = function(tween) {
3678 var frames = tween.totalFrames;
3679 var frame = tween.currentFrame;
3680 var expected = (tween.currentFrame * tween.duration * 1000 / tween.totalFrames);
3681 var elapsed = (new Date() - tween.getStartTime());
3684 if (elapsed < tween.duration * 1000) {
3685 tweak = Math.round((elapsed / expected - 1) * tween.currentFrame);
3687 tweak = frames - (frame + 1);
3689 if (tweak > 0 && isFinite(tweak)) {
3690 if (tween.currentFrame + tweak >= frames) {
3691 tweak = frames - (frame + 1);
3694 tween.currentFrame += tweak;
3700 * Portions of this file are based on pieces of Yahoo User Interface Library
3701 * Copyright (c) 2007, Yahoo! Inc. All rights reserved.
3702 * YUI licensed under the BSD License:
3703 * http://developer.yahoo.net/yui/license.txt
3704 * <script type="text/javascript">
3707 Roo.lib.Bezier = new function() {
3709 this.getPosition = function(points, t) {
3710 var n = points.length;
3713 for (var i = 0; i < n; ++i) {
3714 tmp[i] = [points[i][0], points[i][1]];
3717 for (var j = 1; j < n; ++j) {
3718 for (i = 0; i < n - j; ++i) {
3719 tmp[i][0] = (1 - t) * tmp[i][0] + t * tmp[parseInt(i + 1, 10)][0];
3720 tmp[i][1] = (1 - t) * tmp[i][1] + t * tmp[parseInt(i + 1, 10)][1];
3724 return [ tmp[0][0], tmp[0][1] ];
3730 * @class Roo.lib.Color
3732 * An abstract Color implementation. Concrete Color implementations should use
3733 * an instance of this function as their prototype, and implement the getRGB and
3734 * getHSL functions. getRGB should return an object representing the RGB
3735 * components of this Color, with the red, green, and blue components in the
3736 * range [0,255] and the alpha component in the range [0,100]. getHSL should
3737 * return an object representing the HSL components of this Color, with the hue
3738 * component in the range [0,360), the saturation and lightness components in
3739 * the range [0,100], and the alpha component in the range [0,1].
3744 * Functions for Color handling and processing.
3746 * http://www.safalra.com/web-design/javascript/Color-handling-and-processing/
3748 * The author of this program, Safalra (Stephen Morley), irrevocably releases all
3749 * rights to this program, with the intention of it becoming part of the public
3750 * domain. Because this program is released into the public domain, it comes with
3751 * no warranty either expressed or implied, to the extent permitted by law.
3753 * For more free and public domain JavaScript code by the same author, visit:
3754 * http://www.safalra.com/web-design/javascript/
3757 Roo.lib.Color = function() { }
3760 Roo.apply(Roo.lib.Color.prototype, {
3768 * @return {Object} an object representing the RGBA components of this Color. The red,
3769 * green, and blue components are converted to integers in the range [0,255].
3770 * The alpha is a value in the range [0,1].
3772 getIntegerRGB : function(){
3774 // get the RGB components of this Color
3775 var rgb = this.getRGB();
3777 // return the integer components
3779 'r' : Math.round(rgb.r),
3780 'g' : Math.round(rgb.g),
3781 'b' : Math.round(rgb.b),
3789 * @return {Object} an object representing the RGBA components of this Color. The red,
3790 * green, and blue components are converted to numbers in the range [0,100].
3791 * The alpha is a value in the range [0,1].
3793 getPercentageRGB : function(){
3795 // get the RGB components of this Color
3796 var rgb = this.getRGB();
3798 // return the percentage components
3800 'r' : 100 * rgb.r / 255,
3801 'g' : 100 * rgb.g / 255,
3802 'b' : 100 * rgb.b / 255,
3809 * getCSSHexadecimalRGB
3810 * @return {String} a string representing this Color as a CSS hexadecimal RGB Color
3811 * value - that is, a string of the form #RRGGBB where each of RR, GG, and BB
3812 * are two-digit hexadecimal numbers.
3814 getCSSHexadecimalRGB : function()
3817 // get the integer RGB components
3818 var rgb = this.getIntegerRGB();
3820 // determine the hexadecimal equivalents
3821 var r16 = rgb.r.toString(16);
3822 var g16 = rgb.g.toString(16);
3823 var b16 = rgb.b.toString(16);
3825 // return the CSS RGB Color value
3827 + (r16.length == 2 ? r16 : '0' + r16)
3828 + (g16.length == 2 ? g16 : '0' + g16)
3829 + (b16.length == 2 ? b16 : '0' + b16);
3835 * @return {String} a string representing this Color as a CSS integer RGB Color
3836 * value - that is, a string of the form rgb(r,g,b) where each of r, g, and b
3837 * are integers in the range [0,255].
3839 getCSSIntegerRGB : function(){
3841 // get the integer RGB components
3842 var rgb = this.getIntegerRGB();
3844 // return the CSS RGB Color value
3845 return 'rgb(' + rgb.r + ',' + rgb.g + ',' + rgb.b + ')';
3851 * @return {String} Returns a string representing this Color as a CSS integer RGBA Color
3852 * value - that is, a string of the form rgba(r,g,b,a) where each of r, g, and
3853 * b are integers in the range [0,255] and a is in the range [0,1].
3855 getCSSIntegerRGBA : function(){
3857 // get the integer RGB components
3858 var rgb = this.getIntegerRGB();
3860 // return the CSS integer RGBA Color value
3861 return 'rgb(' + rgb.r + ',' + rgb.g + ',' + rgb.b + ',' + rgb.a + ')';
3866 * getCSSPercentageRGB
3867 * @return {String} a string representing this Color as a CSS percentage RGB Color
3868 * value - that is, a string of the form rgb(r%,g%,b%) where each of r, g, and
3869 * b are in the range [0,100].
3871 getCSSPercentageRGB : function(){
3873 // get the percentage RGB components
3874 var rgb = this.getPercentageRGB();
3876 // return the CSS RGB Color value
3877 return 'rgb(' + rgb.r + '%,' + rgb.g + '%,' + rgb.b + '%)';
3882 * getCSSPercentageRGBA
3883 * @return {String} a string representing this Color as a CSS percentage RGBA Color
3884 * value - that is, a string of the form rgba(r%,g%,b%,a) where each of r, g,
3885 * and b are in the range [0,100] and a is in the range [0,1].
3887 getCSSPercentageRGBA : function(){
3889 // get the percentage RGB components
3890 var rgb = this.getPercentageRGB();
3892 // return the CSS percentage RGBA Color value
3893 return 'rgb(' + rgb.r + '%,' + rgb.g + '%,' + rgb.b + '%,' + rgb.a + ')';
3899 * @return {String} a string representing this Color as a CSS HSL Color value - that
3900 * is, a string of the form hsl(h,s%,l%) where h is in the range [0,100] and
3901 * s and l are in the range [0,100].
3903 getCSSHSL : function(){
3905 // get the HSL components
3906 var hsl = this.getHSL();
3908 // return the CSS HSL Color value
3909 return 'hsl(' + hsl.h + ',' + hsl.s + '%,' + hsl.l + '%)';
3915 * @return {String} a string representing this Color as a CSS HSLA Color value - that
3916 * is, a string of the form hsla(h,s%,l%,a) where h is in the range [0,100],
3917 * s and l are in the range [0,100], and a is in the range [0,1].
3919 getCSSHSLA : function(){
3921 // get the HSL components
3922 var hsl = this.getHSL();
3924 // return the CSS HSL Color value
3925 return 'hsl(' + hsl.h + ',' + hsl.s + '%,' + hsl.l + '%,' + hsl.a + ')';
3930 * Sets the Color of the specified node to this Color. This functions sets
3931 * the CSS 'color' property for the node. The parameter is:
3933 * @param {DomElement} node - the node whose Color should be set
3935 setNodeColor : function(node){
3937 // set the Color of the node
3938 node.style.color = this.getCSSHexadecimalRGB();
3943 * Sets the background Color of the specified node to this Color. This
3944 * functions sets the CSS 'background-color' property for the node. The
3947 * @param {DomElement} node - the node whose background Color should be set
3949 setNodeBackgroundColor : function(node){
3951 // set the background Color of the node
3952 node.style.backgroundColor = this.getCSSHexadecimalRGB();
3955 // convert between formats..
3958 var r = this.getIntegerRGB();
3959 return new Roo.lib.RGBColor(r.r,r.g,r.b,r.a);
3964 var hsl = this.getHSL();
3965 // return the CSS HSL Color value
3966 return new Roo.lib.HSLColor(hsl.h, hsl.s, hsl.l , hsl.a );
3972 var rgb = this.toRGB();
3973 var hsv = rgb.getHSV();
3974 // return the CSS HSL Color value
3975 return new Roo.lib.HSVColor(hsv.h, hsv.s, hsv.v , hsv.a );
3979 // modify v = 0 ... 1 (eg. 0.5)
3980 saturate : function(v)
3982 var rgb = this.toRGB();
3983 var hsv = rgb.getHSV();
3984 return new Roo.lib.HSVColor(hsv.h, hsv.s * v, hsv.v , hsv.a );
3992 * @return {Object} the RGB and alpha components of this Color as an object with r,
3993 * g, b, and a properties. r, g, and b are in the range [0,255] and a is in
3998 // return the RGB components
4010 * @return {Object} the HSV and alpha components of this Color as an object with h,
4011 * s, v, and a properties. h is in the range [0,360), s and v are in the range
4012 * [0,100], and a is in the range [0,1].
4017 // calculate the HSV components if necessary
4018 if (this.hsv == null) {
4019 this.calculateHSV();
4022 // return the HSV components
4034 * @return {Object} the HSL and alpha components of this Color as an object with h,
4035 * s, l, and a properties. h is in the range [0,360), s and l are in the range
4036 * [0,100], and a is in the range [0,1].
4038 getHSL : function(){
4041 // calculate the HSV components if necessary
4042 if (this.hsl == null) { this.calculateHSL(); }
4044 // return the HSL components
4059 * @class Roo.lib.RGBColor
4060 * @extends Roo.lib.Color
4061 * Creates a Color specified in the RGB Color space, with an optional alpha
4062 * component. The parameters are:
4066 * @param {Number} r - the red component, clipped to the range [0,255]
4067 * @param {Number} g - the green component, clipped to the range [0,255]
4068 * @param {Number} b - the blue component, clipped to the range [0,255]
4069 * @param {Number} a - the alpha component, clipped to the range [0,1] - this parameter is
4070 * optional and defaults to 1
4072 Roo.lib.RGBColor = function (r, g, b, a){
4074 // store the alpha component after clipping it if necessary
4075 this.alpha = (a === undefined ? 1 : Math.max(0, Math.min(1, a)));
4077 // store the RGB components after clipping them if necessary
4080 'r' : Math.max(0, Math.min(255, r)),
4081 'g' : Math.max(0, Math.min(255, g)),
4082 'b' : Math.max(0, Math.min(255, b))
4085 // initialise the HSV and HSL components to null
4089 * //private returns the HSV or HSL hue component of this RGBColor. The hue is in the
4090 * range [0,360). The parameters are:
4092 * maximum - the maximum of the RGB component values
4093 * range - the range of the RGB component values
4098 // this does an 'exteds'
4099 Roo.extend(Roo.lib.RGBColor, Roo.lib.Color, {
4102 getHue : function(maximum, range)
4106 // check whether the range is zero
4109 // set the hue to zero (any hue is acceptable as the Color is grey)
4114 // determine which of the components has the highest value and set the hue
4117 // red has the highest value
4119 var hue = (rgb.g - rgb.b) / range * 60;
4120 if (hue < 0) { hue += 360; }
4123 // green has the highest value
4125 var hue = (rgb.b - rgb.r) / range * 60 + 120;
4128 // blue has the highest value
4130 var hue = (rgb.r - rgb.g) / range * 60 + 240;
4142 /* //private Calculates and stores the HSV components of this RGBColor so that they can
4143 * be returned be the getHSV function.
4145 calculateHSV : function(){
4147 // get the maximum and range of the RGB component values
4148 var maximum = Math.max(rgb.r, rgb.g, rgb.b);
4149 var range = maximum - Math.min(rgb.r, rgb.g, rgb.b);
4151 // store the HSV components
4154 'h' : this.getHue(maximum, range),
4155 's' : (maximum == 0 ? 0 : 100 * range / maximum),
4156 'v' : maximum / 2.55
4161 /* //private Calculates and stores the HSL components of this RGBColor so that they can
4162 * be returned be the getHSL function.
4164 calculateHSL : function(){
4166 // get the maximum and range of the RGB component values
4167 var maximum = Math.max(rgb.r, rgb.g, rgb.b);
4168 var range = maximum - Math.min(rgb.r, rgb.g, rgb.b);
4170 // determine the lightness in the range [0,1]
4171 var l = maximum / 255 - range / 510;
4173 // store the HSL components
4176 'h' : this.getHue(maximum, range),
4177 's' : (range == 0 ? 0 : range / 2.55 / (l < 0.5 ? l * 2 : 2 - l * 2)),
4186 * @class Roo.lib.HSVColor
4187 * @extends Roo.lib.Color
4188 * Creates a Color specified in the HSV Color space, with an optional alpha
4189 * component. The parameters are:
4192 * @param {Number} h - the hue component, wrapped to the range [0,360)
4193 * @param {Number} s - the saturation component, clipped to the range [0,100]
4194 * @param {Number} v - the value component, clipped to the range [0,100]
4195 * @param {Number} a - the alpha component, clipped to the range [0,1] - this parameter is
4196 * optional and defaults to 1
4198 Roo.lib.HSVColor = function (h, s, v, a){
4200 // store the alpha component after clipping it if necessary
4201 this.alpha = (a === undefined ? 1 : Math.max(0, Math.min(1, a)));
4203 // store the HSV components after clipping or wrapping them if necessary
4206 'h' : (h % 360 + 360) % 360,
4207 's' : Math.max(0, Math.min(100, s)),
4208 'v' : Math.max(0, Math.min(100, v))
4211 // initialise the RGB and HSL components to null
4216 Roo.extend(Roo.lib.HSVColor, Roo.lib.Color, {
4217 /* Calculates and stores the RGB components of this HSVColor so that they can
4218 * be returned be the getRGB function.
4220 calculateRGB: function ()
4223 // check whether the saturation is zero
4226 // set the Color to the appropriate shade of grey
4233 // set some temporary values
4234 var f = hsv.h / 60 - Math.floor(hsv.h / 60);
4235 var p = hsv.v * (1 - hsv.s / 100);
4236 var q = hsv.v * (1 - hsv.s / 100 * f);
4237 var t = hsv.v * (1 - hsv.s / 100 * (1 - f));
4239 // set the RGB Color components to their temporary values
4240 switch (Math.floor(hsv.h / 60)){
4241 case 0: var r = hsv.v; var g = t; var b = p; break;
4242 case 1: var r = q; var g = hsv.v; var b = p; break;
4243 case 2: var r = p; var g = hsv.v; var b = t; break;
4244 case 3: var r = p; var g = q; var b = hsv.v; break;
4245 case 4: var r = t; var g = p; var b = hsv.v; break;
4246 case 5: var r = hsv.v; var g = p; var b = q; break;
4251 // store the RGB components
4261 /* Calculates and stores the HSL components of this HSVColor so that they can
4262 * be returned be the getHSL function.
4264 calculateHSL : function (){
4267 // determine the lightness in the range [0,100]
4268 var l = (2 - hsv.s / 100) * hsv.v / 2;
4270 // store the HSL components
4274 's' : hsv.s * hsv.v / (l < 50 ? l * 2 : 200 - l * 2),
4278 // correct a division-by-zero error
4279 if (isNaN(hsl.s)) { hsl.s = 0; }
4288 * @class Roo.lib.HSLColor
4289 * @extends Roo.lib.Color
4292 * Creates a Color specified in the HSL Color space, with an optional alpha
4293 * component. The parameters are:
4295 * @param {Number} h - the hue component, wrapped to the range [0,360)
4296 * @param {Number} s - the saturation component, clipped to the range [0,100]
4297 * @param {Number} l - the lightness component, clipped to the range [0,100]
4298 * @param {Number} a - the alpha component, clipped to the range [0,1] - this parameter is
4299 * optional and defaults to 1
4302 Roo.lib.HSLColor = function(h, s, l, a){
4304 // store the alpha component after clipping it if necessary
4305 this.alpha = (a === undefined ? 1 : Math.max(0, Math.min(1, a)));
4307 // store the HSL components after clipping or wrapping them if necessary
4310 'h' : (h % 360 + 360) % 360,
4311 's' : Math.max(0, Math.min(100, s)),
4312 'l' : Math.max(0, Math.min(100, l))
4315 // initialise the RGB and HSV components to null
4318 Roo.extend(Roo.lib.HSLColor, Roo.lib.Color, {
4320 /* Calculates and stores the RGB components of this HSLColor so that they can
4321 * be returned be the getRGB function.
4323 calculateRGB: function (){
4325 // check whether the saturation is zero
4326 if (this.hsl.s == 0){
4328 // store the RGB components representing the appropriate shade of grey
4331 'r' : this.hsl.l * 2.55,
4332 'g' : this.hsl.l * 2.55,
4333 'b' : this.hsl.l * 2.55
4338 // set some temporary values
4339 var p = this.hsl.l < 50
4340 ? this.hsl.l * (1 + hsl.s / 100)
4341 : this.hsl.l + hsl.s - hsl.l * hsl.s / 100;
4342 var q = 2 * hsl.l - p;
4344 // initialise the RGB components
4347 'r' : (h + 120) / 60 % 6,
4349 'b' : (h + 240) / 60 % 6
4352 // loop over the RGB components
4353 for (var key in this.rgb){
4355 // ensure that the property is not inherited from the root object
4356 if (this.rgb.hasOwnProperty(key)){
4358 // set the component to its value in the range [0,100]
4359 if (this.rgb[key] < 1){
4360 this.rgb[key] = q + (p - q) * this.rgb[key];
4361 }else if (this.rgb[key] < 3){
4363 }else if (this.rgb[key] < 4){
4364 this.rgb[key] = q + (p - q) * (4 - this.rgb[key]);
4369 // set the component to its value in the range [0,255]
4370 this.rgb[key] *= 2.55;
4380 /* Calculates and stores the HSV components of this HSLColor so that they can
4381 * be returned be the getHSL function.
4383 calculateHSV : function(){
4385 // set a temporary value
4386 var t = this.hsl.s * (this.hsl.l < 50 ? this.hsl.l : 100 - this.hsl.l) / 100;
4388 // store the HSV components
4392 's' : 200 * t / (this.hsl.l + t),
4393 'v' : t + this.hsl.l
4396 // correct a division-by-zero error
4397 if (isNaN(this.hsv.s)) { this.hsv.s = 0; }
4404 * Portions of this file are based on pieces of Yahoo User Interface Library
4405 * Copyright (c) 2007, Yahoo! Inc. All rights reserved.
4406 * YUI licensed under the BSD License:
4407 * http://developer.yahoo.net/yui/license.txt
4408 * <script type="text/javascript">
4413 Roo.lib.ColorAnim = function(el, attributes, duration, method) {
4414 Roo.lib.ColorAnim.superclass.constructor.call(this, el, attributes, duration, method);
4417 Roo.extend(Roo.lib.ColorAnim, Roo.lib.AnimBase);
4419 var fly = Roo.lib.AnimBase.fly;
4421 var superclass = Y.ColorAnim.superclass;
4422 var proto = Y.ColorAnim.prototype;
4424 proto.toString = function() {
4425 var el = this.getEl();
4426 var id = el.id || el.tagName;
4427 return ("ColorAnim " + id);
4430 proto.patterns.color = /color$/i;
4431 proto.patterns.rgb = /^rgb\(([0-9]+)\s*,\s*([0-9]+)\s*,\s*([0-9]+)\)$/i;
4432 proto.patterns.hex = /^#?([0-9A-F]{2})([0-9A-F]{2})([0-9A-F]{2})$/i;
4433 proto.patterns.hex3 = /^#?([0-9A-F]{1})([0-9A-F]{1})([0-9A-F]{1})$/i;
4434 proto.patterns.transparent = /^transparent|rgba\(0, 0, 0, 0\)$/;
4437 proto.parseColor = function(s) {
4438 if (s.length == 3) {
4442 var c = this.patterns.hex.exec(s);
4443 if (c && c.length == 4) {
4444 return [ parseInt(c[1], 16), parseInt(c[2], 16), parseInt(c[3], 16) ];
4447 c = this.patterns.rgb.exec(s);
4448 if (c && c.length == 4) {
4449 return [ parseInt(c[1], 10), parseInt(c[2], 10), parseInt(c[3], 10) ];
4452 c = this.patterns.hex3.exec(s);
4453 if (c && c.length == 4) {
4454 return [ parseInt(c[1] + c[1], 16), parseInt(c[2] + c[2], 16), parseInt(c[3] + c[3], 16) ];
4459 // since this uses fly! - it cant be in ColorAnim (which does not have fly yet..)
4460 proto.getAttribute = function(attr) {
4461 var el = this.getEl();
4462 if (this.patterns.color.test(attr)) {
4463 var val = fly(el).getStyle(attr);
4465 if (this.patterns.transparent.test(val)) {
4466 var parent = el.parentNode;
4467 val = fly(parent).getStyle(attr);
4469 while (parent && this.patterns.transparent.test(val)) {
4470 parent = parent.parentNode;
4471 val = fly(parent).getStyle(attr);
4472 if (parent.tagName.toUpperCase() == 'HTML') {
4478 val = superclass.getAttribute.call(this, attr);
4483 proto.getAttribute = function(attr) {
4484 var el = this.getEl();
4485 if (this.patterns.color.test(attr)) {
4486 var val = fly(el).getStyle(attr);
4488 if (this.patterns.transparent.test(val)) {
4489 var parent = el.parentNode;
4490 val = fly(parent).getStyle(attr);
4492 while (parent && this.patterns.transparent.test(val)) {
4493 parent = parent.parentNode;
4494 val = fly(parent).getStyle(attr);
4495 if (parent.tagName.toUpperCase() == 'HTML') {
4501 val = superclass.getAttribute.call(this, attr);
4507 proto.doMethod = function(attr, start, end) {
4510 if (this.patterns.color.test(attr)) {
4512 for (var i = 0, len = start.length; i < len; ++i) {
4513 val[i] = superclass.doMethod.call(this, attr, start[i], end[i]);
4516 val = 'rgb(' + Math.floor(val[0]) + ',' + Math.floor(val[1]) + ',' + Math.floor(val[2]) + ')';
4519 val = superclass.doMethod.call(this, attr, start, end);
4525 proto.setRuntimeAttribute = function(attr) {
4526 superclass.setRuntimeAttribute.call(this, attr);
4528 if (this.patterns.color.test(attr)) {
4529 var attributes = this.attributes;
4530 var start = this.parseColor(this.runtimeAttributes[attr].start);
4531 var end = this.parseColor(this.runtimeAttributes[attr].end);
4533 if (typeof attributes[attr]['to'] === 'undefined' && typeof attributes[attr]['by'] !== 'undefined') {
4534 end = this.parseColor(attributes[attr].by);
4536 for (var i = 0, len = start.length; i < len; ++i) {
4537 end[i] = start[i] + end[i];
4541 this.runtimeAttributes[attr].start = start;
4542 this.runtimeAttributes[attr].end = end;
4548 * Portions of this file are based on pieces of Yahoo User Interface Library
4549 * Copyright (c) 2007, Yahoo! Inc. All rights reserved.
4550 * YUI licensed under the BSD License:
4551 * http://developer.yahoo.net/yui/license.txt
4552 * <script type="text/javascript">
4558 easeNone: function (t, b, c, d) {
4559 return c * t / d + b;
4563 easeIn: function (t, b, c, d) {
4564 return c * (t /= d) * t + b;
4568 easeOut: function (t, b, c, d) {
4569 return -c * (t /= d) * (t - 2) + b;
4573 easeBoth: function (t, b, c, d) {
4574 if ((t /= d / 2) < 1) {
4575 return c / 2 * t * t + b;
4578 return -c / 2 * ((--t) * (t - 2) - 1) + b;
4582 easeInStrong: function (t, b, c, d) {
4583 return c * (t /= d) * t * t * t + b;
4587 easeOutStrong: function (t, b, c, d) {
4588 return -c * ((t = t / d - 1) * t * t * t - 1) + b;
4592 easeBothStrong: function (t, b, c, d) {
4593 if ((t /= d / 2) < 1) {
4594 return c / 2 * t * t * t * t + b;
4597 return -c / 2 * ((t -= 2) * t * t * t - 2) + b;
4602 elasticIn: function (t, b, c, d, a, p) {
4606 if ((t /= d) == 1) {
4613 if (!a || a < Math.abs(c)) {
4618 var s = p / (2 * Math.PI) * Math.asin(c / a);
4621 return -(a * Math.pow(2, 10 * (t -= 1)) * Math.sin((t * d - s) * (2 * Math.PI) / p)) + b;
4625 elasticOut: function (t, b, c, d, a, p) {
4629 if ((t /= d) == 1) {
4636 if (!a || a < Math.abs(c)) {
4641 var s = p / (2 * Math.PI) * Math.asin(c / a);
4644 return a * Math.pow(2, -10 * t) * Math.sin((t * d - s) * (2 * Math.PI) / p) + c + b;
4648 elasticBoth: function (t, b, c, d, a, p) {
4653 if ((t /= d / 2) == 2) {
4661 if (!a || a < Math.abs(c)) {
4666 var s = p / (2 * Math.PI) * Math.asin(c / a);
4670 return -.5 * (a * Math.pow(2, 10 * (t -= 1)) *
4671 Math.sin((t * d - s) * (2 * Math.PI) / p)) + b;
4673 return a * Math.pow(2, -10 * (t -= 1)) *
4674 Math.sin((t * d - s) * (2 * Math.PI) / p) * .5 + c + b;
4679 backIn: function (t, b, c, d, s) {
4680 if (typeof s == 'undefined') {
4683 return c * (t /= d) * t * ((s + 1) * t - s) + b;
4687 backOut: function (t, b, c, d, s) {
4688 if (typeof s == 'undefined') {
4691 return c * ((t = t / d - 1) * t * ((s + 1) * t + s) + 1) + b;
4695 backBoth: function (t, b, c, d, s) {
4696 if (typeof s == 'undefined') {
4700 if ((t /= d / 2 ) < 1) {
4701 return c / 2 * (t * t * (((s *= (1.525)) + 1) * t - s)) + b;
4703 return c / 2 * ((t -= 2) * t * (((s *= (1.525)) + 1) * t + s) + 2) + b;
4707 bounceIn: function (t, b, c, d) {
4708 return c - Roo.lib.Easing.bounceOut(d - t, 0, c, d) + b;
4712 bounceOut: function (t, b, c, d) {
4713 if ((t /= d) < (1 / 2.75)) {
4714 return c * (7.5625 * t * t) + b;
4715 } else if (t < (2 / 2.75)) {
4716 return c * (7.5625 * (t -= (1.5 / 2.75)) * t + .75) + b;
4717 } else if (t < (2.5 / 2.75)) {
4718 return c * (7.5625 * (t -= (2.25 / 2.75)) * t + .9375) + b;
4720 return c * (7.5625 * (t -= (2.625 / 2.75)) * t + .984375) + b;
4724 bounceBoth: function (t, b, c, d) {
4726 return Roo.lib.Easing.bounceIn(t * 2, 0, c, d) * .5 + b;
4728 return Roo.lib.Easing.bounceOut(t * 2 - d, 0, c, d) * .5 + c * .5 + b;
4731 * Portions of this file are based on pieces of Yahoo User Interface Library
4732 * Copyright (c) 2007, Yahoo! Inc. All rights reserved.
4733 * YUI licensed under the BSD License:
4734 * http://developer.yahoo.net/yui/license.txt
4735 * <script type="text/javascript">
4739 Roo.lib.Motion = function(el, attributes, duration, method) {
4741 Roo.lib.Motion.superclass.constructor.call(this, el, attributes, duration, method);
4745 Roo.extend(Roo.lib.Motion, Roo.lib.ColorAnim);
4749 var superclass = Y.Motion.superclass;
4750 var proto = Y.Motion.prototype;
4752 proto.toString = function() {
4753 var el = this.getEl();
4754 var id = el.id || el.tagName;
4755 return ("Motion " + id);
4758 proto.patterns.points = /^points$/i;
4760 proto.setAttribute = function(attr, val, unit) {
4761 if (this.patterns.points.test(attr)) {
4762 unit = unit || 'px';
4763 superclass.setAttribute.call(this, 'left', val[0], unit);
4764 superclass.setAttribute.call(this, 'top', val[1], unit);
4766 superclass.setAttribute.call(this, attr, val, unit);
4770 proto.getAttribute = function(attr) {
4771 if (this.patterns.points.test(attr)) {
4773 superclass.getAttribute.call(this, 'left'),
4774 superclass.getAttribute.call(this, 'top')
4777 val = superclass.getAttribute.call(this, attr);
4783 proto.doMethod = function(attr, start, end) {
4786 if (this.patterns.points.test(attr)) {
4787 var t = this.method(this.currentFrame, 0, 100, this.totalFrames) / 100;
4788 val = Y.Bezier.getPosition(this.runtimeAttributes[attr], t);
4790 val = superclass.doMethod.call(this, attr, start, end);
4795 proto.setRuntimeAttribute = function(attr) {
4796 if (this.patterns.points.test(attr)) {
4797 var el = this.getEl();
4798 var attributes = this.attributes;
4800 var control = attributes['points']['control'] || [];
4804 if (control.length > 0 && !(control[0] instanceof Array)) {
4805 control = [control];
4808 for (i = 0,len = control.length; i < len; ++i) {
4809 tmp[i] = control[i];
4814 Roo.fly(el).position();
4816 if (isset(attributes['points']['from'])) {
4817 Roo.lib.Dom.setXY(el, attributes['points']['from']);
4820 Roo.lib.Dom.setXY(el, Roo.lib.Dom.getXY(el));
4823 start = this.getAttribute('points');
4826 if (isset(attributes['points']['to'])) {
4827 end = translateValues.call(this, attributes['points']['to'], start);
4829 var pageXY = Roo.lib.Dom.getXY(this.getEl());
4830 for (i = 0,len = control.length; i < len; ++i) {
4831 control[i] = translateValues.call(this, control[i], start);
4835 } else if (isset(attributes['points']['by'])) {
4836 end = [ start[0] + attributes['points']['by'][0], start[1] + attributes['points']['by'][1] ];
4838 for (i = 0,len = control.length; i < len; ++i) {
4839 control[i] = [ start[0] + control[i][0], start[1] + control[i][1] ];
4843 this.runtimeAttributes[attr] = [start];
4845 if (control.length > 0) {
4846 this.runtimeAttributes[attr] = this.runtimeAttributes[attr].concat(control);
4849 this.runtimeAttributes[attr][this.runtimeAttributes[attr].length] = end;
4852 superclass.setRuntimeAttribute.call(this, attr);
4856 var translateValues = function(val, start) {
4857 var pageXY = Roo.lib.Dom.getXY(this.getEl());
4858 val = [ val[0] - pageXY[0] + start[0], val[1] - pageXY[1] + start[1] ];
4863 var isset = function(prop) {
4864 return (typeof prop !== 'undefined');
4868 * Portions of this file are based on pieces of Yahoo User Interface Library
4869 * Copyright (c) 2007, Yahoo! Inc. All rights reserved.
4870 * YUI licensed under the BSD License:
4871 * http://developer.yahoo.net/yui/license.txt
4872 * <script type="text/javascript">
4876 Roo.lib.Scroll = function(el, attributes, duration, method) {
4878 Roo.lib.Scroll.superclass.constructor.call(this, el, attributes, duration, method);
4882 Roo.extend(Roo.lib.Scroll, Roo.lib.ColorAnim);
4886 var superclass = Y.Scroll.superclass;
4887 var proto = Y.Scroll.prototype;
4889 proto.toString = function() {
4890 var el = this.getEl();
4891 var id = el.id || el.tagName;
4892 return ("Scroll " + id);
4895 proto.doMethod = function(attr, start, end) {
4898 if (attr == 'scroll') {
4900 this.method(this.currentFrame, start[0], end[0] - start[0], this.totalFrames),
4901 this.method(this.currentFrame, start[1], end[1] - start[1], this.totalFrames)
4905 val = superclass.doMethod.call(this, attr, start, end);
4910 proto.getAttribute = function(attr) {
4912 var el = this.getEl();
4914 if (attr == 'scroll') {
4915 val = [ el.scrollLeft, el.scrollTop ];
4917 val = superclass.getAttribute.call(this, attr);
4923 proto.setAttribute = function(attr, val, unit) {
4924 var el = this.getEl();
4926 if (attr == 'scroll') {
4927 el.scrollLeft = val[0];
4928 el.scrollTop = val[1];
4930 superclass.setAttribute.call(this, attr, val, unit);
4935 * Originally based of this code... - refactored for Roo...
4936 * https://github.com/aaalsaleh/undo-manager
4939 * @author Abdulrahman Alsaleh
4940 * @copyright 2015 Abdulrahman Alsaleh
4941 * @license MIT License (c)
4943 * Hackily modifyed by alan@roojs.com
4948 * TOTALLY UNTESTED...
4950 * Documentation to be done....
4955 * @class Roo.lib.UndoManager
4956 * An undo manager implementation in JavaScript. It follows the W3C UndoManager and DOM Transaction
4957 * Draft and the undocumented and disabled Mozilla Firefox's UndoManager implementation.
4963 editor.undoManager = new Roo.lib.UndoManager(1000, editor);
4967 * For more information see this blog post with examples:
4968 * <a href="http://www.cnitblog.com/seeyeah/archive/2011/12/30/38728.html/">DomHelper
4969 - Create Elements using DOM, HTML fragments and Templates</a>.
4971 * @param {Number} limit how far back to go ... use 1000?
4972 * @param {Object} scope usually use document..
4975 Roo.lib.UndoManager = function (limit, undoScopeHost)
4979 this.scope = undoScopeHost;
4980 this.fireEvent = typeof CustomEvent != 'undefined' && undoScopeHost && undoScopeHost.dispatchEvent;
4981 if (this.fireEvent) {
4988 Roo.lib.UndoManager.prototype = {
4999 * To push and execute a transaction, the method undoManager.transact
5000 * must be called by passing a transaction object as the first argument, and a merge
5001 * flag as the second argument. A transaction object has the following properties:
5005 undoManager.transact({
5007 execute: function() { ... },
5008 undo: function() { ... },
5009 // redo same as execute
5010 redo: function() { this.execute(); }
5013 // merge transaction
5014 undoManager.transact({
5016 execute: function() { ... }, // this will be run...
5017 undo: function() { ... }, // what to do when undo is run.
5018 // redo same as execute
5019 redo: function() { this.execute(); }
5024 * @param {Object} transaction The transaction to add to the stack.
5025 * @return {String} The HTML fragment
5029 transact : function (transaction, merge)
5031 if (arguments.length < 2) {
5032 throw new TypeError('Not enough arguments to UndoManager.transact.');
5035 transaction.execute();
5037 this.stack.splice(0, this.position);
5038 if (merge && this.length) {
5039 this.stack[0].push(transaction);
5041 this.stack.unshift([transaction]);
5046 if (this.limit && this.stack.length > this.limit) {
5047 this.length = this.stack.length = this.limit;
5049 this.length = this.stack.length;
5052 if (this.fireEvent) {
5053 this.scope.dispatchEvent(
5054 new CustomEvent('DOMTransaction', {
5056 transactions: this.stack[0].slice()
5064 //Roo.log("transaction: pos:" + this.position + " len: " + this.length + " slen:" + this.stack.length);
5071 //Roo.log("undo: pos:" + this.position + " len: " + this.length + " slen:" + this.stack.length);
5073 if (this.position < this.length) {
5074 for (var i = this.stack[this.position].length - 1; i >= 0; i--) {
5075 this.stack[this.position][i].undo();
5079 if (this.fireEvent) {
5080 this.scope.dispatchEvent(
5081 new CustomEvent('undo', {
5083 transactions: this.stack[this.position - 1].slice()
5095 if (this.position > 0) {
5096 for (var i = 0, n = this.stack[this.position - 1].length; i < n; i++) {
5097 this.stack[this.position - 1][i].redo();
5101 if (this.fireEvent) {
5102 this.scope.dispatchEvent(
5103 new CustomEvent('redo', {
5105 transactions: this.stack[this.position].slice()
5115 item : function (index)
5117 if (index >= 0 && index < this.length) {
5118 return this.stack[index].slice();
5123 clearUndo : function () {
5124 this.stack.length = this.length = this.position;
5127 clearRedo : function () {
5128 this.stack.splice(0, this.position);
5130 this.length = this.stack.length;
5133 * Reset the undo - probaly done on load to clear all history.
5140 this.current_html = this.scope.innerHTML;
5141 if (this.timer !== false) {
5142 clearTimeout(this.timer);
5154 // this will handle the undo/redo on the element.?
5155 bindEvents : function()
5157 var el = this.scope;
5158 el.undoManager = this;
5161 this.scope.addEventListener('keydown', function(e) {
5162 if ((e.ctrlKey || e.metaKey) && e.keyCode === 90) {
5164 el.undoManager.redo(); // Ctrl/Command + Shift + Z
5166 el.undoManager.undo(); // Ctrl/Command + Z
5173 this.scope.addEventListener('keyup', function(e) {
5174 if ((e.ctrlKey || e.metaKey) && e.keyCode === 90) {
5183 el.addEventListener('input', function(e) {
5184 if(el.innerHTML == t.current_html) {
5187 // only record events every second.
5188 if (t.timer !== false) {
5189 clearTimeout(t.timer);
5192 t.timer = setTimeout(function() { t.merge = false; }, 1000);
5194 t.addEvent(t.merge);
5195 t.merge = true; // ignore changes happening every second..
5199 * Manually add an event.
5200 * Normall called without arguements - and it will just get added to the stack.
5204 addEvent : function(merge)
5206 //Roo.log("undomanager +" + (merge ? 'Y':'n'));
5207 // not sure if this should clear the timer
5208 merge = typeof(merge) == 'undefined' ? false : merge;
5210 this.scope.undoManager.transact({
5212 oldHTML: this.current_html,
5213 newHTML: this.scope.innerHTML,
5214 // nothing to execute (content already changed when input is fired)
5215 execute: function() { },
5217 this.scope.innerHTML = this.current_html = this.oldHTML;
5220 this.scope.innerHTML = this.current_html = this.newHTML;
5222 }, false); //merge);
5226 this.current_html = this.scope.innerHTML;
5236 * @class Roo.lib.Range
5238 * This is a toolkit, normally used to copy features into a Dom Range element
5239 * Roo.lib.Range.wrap(x);
5244 Roo.lib.Range = function() { };
5247 * Wrap a Dom Range object, to give it new features...
5249 * @param {Range} the range to wrap
5251 Roo.lib.Range.wrap = function(r) {
5252 return Roo.apply(r, Roo.lib.Range.prototype);
5255 * find a parent node eg. LI / OL
5256 * @param {string|Array} node name or array of nodenames
5257 * @return {DomElement|false}
5259 Roo.apply(Roo.lib.Range.prototype,
5262 closest : function(str)
5264 if (typeof(str) != 'string') {
5265 // assume it's a array.
5266 for(var i = 0;i < str.length;i++) {
5267 var r = this.closest(str[i]);
5275 str = str.toLowerCase();
5276 var n = this.commonAncestorContainer; // might not be a node
5277 while (n.nodeType != 1) {
5281 if (n.nodeName.toLowerCase() == str ) {
5284 if (n.nodeName.toLowerCase() == 'body') {
5288 return n.closest(str) || false;
5291 cloneRange : function()
5293 return Roo.lib.Range.wrap(Range.prototype.cloneRange.call(this));
5296 * @class Roo.lib.Selection
5298 * This is a toolkit, normally used to copy features into a Dom Selection element
5299 * Roo.lib.Selection.wrap(x);
5304 Roo.lib.Selection = function() { };
5307 * Wrap a Dom Range object, to give it new features...
5309 * @param {Range} the range to wrap
5311 Roo.lib.Selection.wrap = function(r, doc) {
5312 Roo.apply(r, Roo.lib.Selection.prototype);
5313 r.ownerDocument = doc; // usefull so we dont have to keep referening to it.
5317 * find a parent node eg. LI / OL
5318 * @param {string|Array} node name or array of nodenames
5319 * @return {DomElement|false}
5321 Roo.apply(Roo.lib.Selection.prototype,
5324 * the owner document
5326 ownerDocument : false,
5328 getRangeAt : function(n)
5330 return Roo.lib.Range.wrap(Selection.prototype.getRangeAt.call(this,n));
5334 * insert node at selection
5335 * @param {DomElement|string} node
5336 * @param {string} cursor (after|in|none) where to place the cursor after inserting.
5338 insertNode: function(node, cursor)
5340 if (typeof(node) == 'string') {
5341 node = this.ownerDocument.createElement(node);
5342 if (cursor == 'in') {
5343 node.innerHTML = ' ';
5347 var range = this.getRangeAt(0);
5349 if (this.type != 'Caret') {
5350 range.deleteContents();
5352 var sn = node.childNodes[0]; // select the contents.
5356 range.insertNode(node);
5357 if (cursor == 'after') {
5358 node.insertAdjacentHTML('afterend', ' ');
5359 sn = node.nextSibling;
5362 if (cursor == 'none') {
5366 this.cursorText(sn);
5369 cursorText : function(n)
5372 //var range = this.getRangeAt(0);
5373 range = Roo.lib.Range.wrap(new Range());
5374 //range.selectNode(n);
5376 var ix = Array.from(n.parentNode.childNodes).indexOf(n);
5377 range.setStart(n.parentNode,ix);
5378 range.setEnd(n.parentNode,ix+1);
5379 //range.collapse(false);
5381 this.removeAllRanges();
5382 this.addRange(range);
5384 Roo.log([n, range, this,this.baseOffset,this.extentOffset, this.type]);
5386 cursorAfter : function(n)
5388 if (!n.nextSibling || n.nextSibling.nodeValue != ' ') {
5389 n.insertAdjacentHTML('afterend', ' ');
5391 this.cursorText (n.nextSibling);
5397 * Ext JS Library 1.1.1
5398 * Copyright(c) 2006-2007, Ext JS, LLC.
5400 * Originally Released Under LGPL - original licence link has changed is not relivant.
5403 * <script type="text/javascript">
5407 // nasty IE9 hack - what a pile of crap that is..
5409 if (typeof Range != "undefined" && typeof Range.prototype.createContextualFragment == "undefined") {
5410 Range.prototype.createContextualFragment = function (html) {
5411 var doc = window.document;
5412 var container = doc.createElement("div");
5413 container.innerHTML = html;
5414 var frag = doc.createDocumentFragment(), n;
5415 while ((n = container.firstChild)) {
5416 frag.appendChild(n);
5423 * @class Roo.DomHelper
5424 * Utility class for working with DOM and/or Templates. It transparently supports using HTML fragments or DOM.
5425 * 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>.
5428 Roo.DomHelper = function(){
5429 var tempTableEl = null;
5430 var emptyTags = /^(?:br|frame|hr|img|input|link|meta|range|spacer|wbr|area|param|col)$/i;
5431 var tableRe = /^table|tbody|tr|td$/i;
5433 // build as innerHTML where available
5435 var createHtml = function(o){
5436 if(typeof o == 'string'){
5445 if(attr == "tag" || attr == "children" || attr == "cn" || attr == "html" || typeof o[attr] == "function") { continue; }
5446 if(attr == "style"){
5448 if(typeof s == "function"){
5451 if(typeof s == "string"){
5452 b += ' style="' + s + '"';
5453 }else if(typeof s == "object"){
5456 if(typeof s[key] != "function"){
5457 b += key + ":" + s[key] + ";";
5464 b += ' class="' + o["cls"] + '"';
5465 }else if(attr == "htmlFor"){
5466 b += ' for="' + o["htmlFor"] + '"';
5468 b += " " + attr + '="' + o[attr] + '"';
5472 if(emptyTags.test(o.tag)){
5476 var cn = o.children || o.cn;
5478 //http://bugs.kde.org/show_bug.cgi?id=71506
5479 if((cn instanceof Array) || (Roo.isSafari && typeof(cn.join) == "function")){
5480 for(var i = 0, len = cn.length; i < len; i++) {
5481 b += createHtml(cn[i], b);
5484 b += createHtml(cn, b);
5490 b += "</" + o.tag + ">";
5497 var createDom = function(o, parentNode){
5499 // defininition craeted..
5501 if (o.ns && o.ns != 'html') {
5503 if (o.xmlns && typeof(xmlns[o.ns]) == 'undefined') {
5504 xmlns[o.ns] = o.xmlns;
5507 if (typeof(xmlns[o.ns]) == 'undefined') {
5508 console.log("Trying to create namespace element " + o.ns + ", however no xmlns was sent to builder previously");
5514 if (typeof(o) == 'string') {
5515 return parentNode.appendChild(document.createTextNode(o));
5517 o.tag = o.tag || div;
5518 if (o.ns && Roo.isIE) {
5520 o.tag = o.ns + ':' + o.tag;
5523 var el = ns ? document.createElementNS( ns, o.tag||'div') : document.createElement(o.tag||'div');
5524 var useSet = el.setAttribute ? true : false; // In IE some elements don't have setAttribute
5527 if(attr == "tag" || attr == "ns" ||attr == "xmlns" ||attr == "children" || attr == "cn" || attr == "html" ||
5528 attr == "style" || typeof o[attr] == "function") { continue; }
5530 if(attr=="cls" && Roo.isIE){
5531 el.className = o["cls"];
5533 if(useSet) { el.setAttribute(attr=="cls" ? 'class' : attr, o[attr]);}
5539 Roo.DomHelper.applyStyles(el, o.style);
5540 var cn = o.children || o.cn;
5542 //http://bugs.kde.org/show_bug.cgi?id=71506
5543 if((cn instanceof Array) || (Roo.isSafari && typeof(cn.join) == "function")){
5544 for(var i = 0, len = cn.length; i < len; i++) {
5545 createDom(cn[i], el);
5552 el.innerHTML = o.html;
5555 parentNode.appendChild(el);
5560 var ieTable = function(depth, s, h, e){
5561 tempTableEl.innerHTML = [s, h, e].join('');
5562 var i = -1, el = tempTableEl;
5563 while(++i < depth && el.firstChild){
5569 // kill repeat to save bytes
5573 tbe = '</tbody>'+te,
5579 * Nasty code for IE's broken table implementation
5581 var insertIntoTable = function(tag, where, el, html){
5583 tempTableEl = document.createElement('div');
5588 if(where == 'afterbegin' || where == 'beforeend'){ // INTO a TD
5591 if(where == 'beforebegin'){
5595 before = el.nextSibling;
5598 node = ieTable(4, trs, html, tre);
5600 else if(tag == 'tr'){
5601 if(where == 'beforebegin'){
5604 node = ieTable(3, tbs, html, tbe);
5605 } else if(where == 'afterend'){
5606 before = el.nextSibling;
5608 node = ieTable(3, tbs, html, tbe);
5609 } else{ // INTO a TR
5610 if(where == 'afterbegin'){
5611 before = el.firstChild;
5613 node = ieTable(4, trs, html, tre);
5615 } else if(tag == 'tbody'){
5616 if(where == 'beforebegin'){
5619 node = ieTable(2, ts, html, te);
5620 } else if(where == 'afterend'){
5621 before = el.nextSibling;
5623 node = ieTable(2, ts, html, te);
5625 if(where == 'afterbegin'){
5626 before = el.firstChild;
5628 node = ieTable(3, tbs, html, tbe);
5631 if(where == 'beforebegin' || where == 'afterend'){ // OUTSIDE the table
5634 if(where == 'afterbegin'){
5635 before = el.firstChild;
5637 node = ieTable(2, ts, html, te);
5639 el.insertBefore(node, before);
5643 // this is a bit like the react update code...
5646 var updateNode = function(from, to)
5648 // should we handle non-standard elements?
5649 Roo.log(["UpdateNode" , from, to]);
5650 if (from.nodeType != to.nodeType) {
5651 Roo.log(["ReplaceChild - mismatch notType" , to, from ]);
5652 from.parentNode.replaceChild(to, from);
5655 if (from.nodeType == 3) {
5656 // assume it's text?!
5657 if (from.data == to.data) {
5660 from.data = to.data;
5663 if (!from.parentNode) {
5664 // not sure why this is happening?
5667 // assume 'to' doesnt have '1/3 nodetypes!
5668 // not sure why, by from, parent node might not exist?
5669 if (from.nodeType !=1 || from.tagName != to.tagName) {
5670 Roo.log(["ReplaceChild" , from, to ]);
5672 from.parentNode.replaceChild(to, from);
5675 // compare attributes
5676 var ar = Array.from(from.attributes);
5677 for(var i = 0; i< ar.length;i++) {
5678 if (to.hasAttribute(ar[i].name)) {
5681 if (ar[i].name == 'id') { // always keep ids?
5684 //if (ar[i].name == 'style') {
5685 // throw "style removed?";
5687 Roo.log("removeAttribute" + ar[i].name);
5688 from.removeAttribute(ar[i].name);
5691 for(var i = 0; i< ar.length;i++) {
5692 if (from.getAttribute(ar[i].name) == to.getAttribute(ar[i].name)) {
5693 Roo.log("skipAttribute " + ar[i].name + '=' + to.getAttribute(ar[i].name));
5696 Roo.log("updateAttribute " + ar[i].name + '=>' + to.getAttribute(ar[i].name));
5697 from.setAttribute(ar[i].name, to.getAttribute(ar[i].name));
5700 var far = Array.from(from.childNodes);
5701 var tar = Array.from(to.childNodes);
5702 // if the lengths are different.. then it's probably a editable content change, rather than
5703 // a change of the block definition..
5705 // this did notwork , as our rebuilt nodes did not include ID's so did not match at all.
5706 /*if (from.innerHTML == to.innerHTML) {
5709 if (far.length != tar.length) {
5710 from.innerHTML = to.innerHTML;
5715 for(var i = 0; i < Math.max(tar.length, far.length); i++) {
5716 if (i >= far.length) {
5717 from.appendChild(tar[i]);
5718 Roo.log(["add", tar[i]]);
5720 } else if ( i >= tar.length) {
5721 from.removeChild(far[i]);
5722 Roo.log(["remove", far[i]]);
5725 updateNode(far[i], tar[i]);
5737 /** True to force the use of DOM instead of html fragments @type Boolean */
5741 * Returns the markup for the passed Element(s) config
5742 * @param {Object} o The Dom object spec (and children)
5745 markup : function(o){
5746 return createHtml(o);
5750 * Applies a style specification to an element
5751 * @param {String/HTMLElement} el The element to apply styles to
5752 * @param {String/Object/Function} styles A style specification string eg "width:100px", or object in the form {width:"100px"}, or
5753 * a function which returns such a specification.
5755 applyStyles : function(el, styles){
5758 if(typeof styles == "string"){
5759 var re = /\s?([a-z\-]*)\:\s?([^;]*);?/gi;
5761 while ((matches = re.exec(styles)) != null){
5762 el.setStyle(matches[1], matches[2]);
5764 }else if (typeof styles == "object"){
5765 for (var style in styles){
5766 el.setStyle(style, styles[style]);
5768 }else if (typeof styles == "function"){
5769 Roo.DomHelper.applyStyles(el, styles.call());
5775 * Inserts an HTML fragment into the Dom
5776 * @param {String} where Where to insert the html in relation to el - beforeBegin, afterBegin, beforeEnd, afterEnd.
5777 * @param {HTMLElement} el The context element
5778 * @param {String} html The HTML fragmenet
5779 * @return {HTMLElement} The new node
5781 insertHtml : function(where, el, html){
5782 where = where.toLowerCase();
5783 if(el.insertAdjacentHTML){
5784 if(tableRe.test(el.tagName)){
5786 if(rs = insertIntoTable(el.tagName.toLowerCase(), where, el, html)){
5792 el.insertAdjacentHTML('BeforeBegin', html);
5793 return el.previousSibling;
5795 el.insertAdjacentHTML('AfterBegin', html);
5796 return el.firstChild;
5798 el.insertAdjacentHTML('BeforeEnd', html);
5799 return el.lastChild;
5801 el.insertAdjacentHTML('AfterEnd', html);
5802 return el.nextSibling;
5804 throw 'Illegal insertion point -> "' + where + '"';
5806 var range = el.ownerDocument.createRange();
5810 range.setStartBefore(el);
5811 frag = range.createContextualFragment(html);
5812 el.parentNode.insertBefore(frag, el);
5813 return el.previousSibling;
5816 range.setStartBefore(el.firstChild);
5817 frag = range.createContextualFragment(html);
5818 el.insertBefore(frag, el.firstChild);
5819 return el.firstChild;
5821 el.innerHTML = html;
5822 return el.firstChild;
5826 range.setStartAfter(el.lastChild);
5827 frag = range.createContextualFragment(html);
5828 el.appendChild(frag);
5829 return el.lastChild;
5831 el.innerHTML = html;
5832 return el.lastChild;
5835 range.setStartAfter(el);
5836 frag = range.createContextualFragment(html);
5837 el.parentNode.insertBefore(frag, el.nextSibling);
5838 return el.nextSibling;
5840 throw 'Illegal insertion point -> "' + where + '"';
5844 * Creates new Dom element(s) and inserts them before el
5845 * @param {String/HTMLElement/Element} el The context element
5846 * @param {Object/String} o The Dom object spec (and children) or raw HTML blob
5847 * @param {Boolean} returnElement (optional) true to return a Roo.Element
5848 * @return {HTMLElement/Roo.Element} The new node
5850 insertBefore : function(el, o, returnElement){
5851 return this.doInsert(el, o, returnElement, "beforeBegin");
5855 * Creates new Dom element(s) and inserts them after el
5856 * @param {String/HTMLElement/Element} el The context element
5857 * @param {Object} o The Dom object spec (and children)
5858 * @param {Boolean} returnElement (optional) true to return a Roo.Element
5859 * @return {HTMLElement/Roo.Element} The new node
5861 insertAfter : function(el, o, returnElement){
5862 return this.doInsert(el, o, returnElement, "afterEnd", "nextSibling");
5866 * Creates new Dom element(s) and inserts them as the first child of el
5867 * @param {String/HTMLElement/Element} el The context element
5868 * @param {Object/String} o The Dom object spec (and children) or raw HTML blob
5869 * @param {Boolean} returnElement (optional) true to return a Roo.Element
5870 * @return {HTMLElement/Roo.Element} The new node
5872 insertFirst : function(el, o, returnElement){
5873 return this.doInsert(el, o, returnElement, "afterBegin");
5877 doInsert : function(el, o, returnElement, pos, sibling){
5878 el = Roo.getDom(el);
5880 if(this.useDom || o.ns){
5881 newNode = createDom(o, null);
5882 el.parentNode.insertBefore(newNode, sibling ? el[sibling] : el);
5884 var html = createHtml(o);
5885 newNode = this.insertHtml(pos, el, html);
5887 return returnElement ? Roo.get(newNode, true) : newNode;
5891 * Creates new Dom element(s) and appends them to el
5892 * @param {String/HTMLElement/Element} el The context element
5893 * @param {Object/String} o The Dom object spec (and children) or raw HTML blob
5894 * @param {Boolean} returnElement (optional) true to return a Roo.Element
5895 * @return {HTMLElement/Roo.Element} The new node
5897 append : function(el, o, returnElement){
5898 el = Roo.getDom(el);
5900 if(this.useDom || o.ns){
5901 newNode = createDom(o, null);
5902 el.appendChild(newNode);
5904 var html = createHtml(o);
5905 newNode = this.insertHtml("beforeEnd", el, html);
5907 return returnElement ? Roo.get(newNode, true) : newNode;
5911 * Creates new Dom element(s) and overwrites the contents of el with them
5912 * @param {String/HTMLElement/Element} el The context element
5913 * @param {Object/String} o The Dom object spec (and children) or raw HTML blob
5914 * @param {Boolean} returnElement (optional) true to return a Roo.Element
5915 * @return {HTMLElement/Roo.Element} The new node
5917 overwrite : function(el, o, returnElement)
5919 el = Roo.getDom(el);
5922 while (el.childNodes.length) {
5923 el.removeChild(el.firstChild);
5927 el.innerHTML = createHtml(o);
5930 return returnElement ? Roo.get(el.firstChild, true) : el.firstChild;
5934 * Creates a new Roo.DomHelper.Template from the Dom object spec
5935 * @param {Object} o The Dom object spec (and children)
5936 * @return {Roo.DomHelper.Template} The new template
5938 createTemplate : function(o){
5939 var html = createHtml(o);
5940 return new Roo.Template(html);
5943 * Updates the first element with the spec from the o (replacing if necessary)
5944 * This iterates through the children, and updates attributes / children etc..
5945 * @param {String/HTMLElement/Element} el The context element
5946 * @param {Object/String} o The Dom object spec (and children) or raw HTML blob
5949 update : function(el, o)
5951 updateNode(Roo.getDom(el), createDom(o));
5960 * Ext JS Library 1.1.1
5961 * Copyright(c) 2006-2007, Ext JS, LLC.
5963 * Originally Released Under LGPL - original licence link has changed is not relivant.
5966 * <script type="text/javascript">
5970 * @class Roo.Template
5971 * Represents an HTML fragment template. Templates can be precompiled for greater performance.
5972 * For a list of available format functions, see {@link Roo.util.Format}.<br />
5975 var t = new Roo.Template({
5976 html : '<div name="{id}">' +
5977 '<span class="{cls}">{name:trim} {someval:this.myformat}{value:ellipsis(10)}</span>' +
5979 myformat: function (value, allValues) {
5980 return 'XX' + value;
5983 t.append('some-element', {id: 'myid', cls: 'myclass', name: 'foo', value: 'bar'});
5985 * For more information see this blog post with examples:
5986 * <a href="http://www.cnitblog.com/seeyeah/archive/2011/12/30/38728.html/">DomHelper
5987 - Create Elements using DOM, HTML fragments and Templates</a>.
5989 * @param {Object} cfg - Configuration object.
5991 Roo.Template = function(cfg){
5993 if(cfg instanceof Array){
5995 }else if(arguments.length > 1){
5996 cfg = Array.prototype.join.call(arguments, "");
6000 if (typeof(cfg) == 'object') {
6011 Roo.Template.prototype = {
6014 * @cfg {Function} onLoad Called after the template has been loaded and complied (usually from a remove source)
6020 * @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..
6021 * it should be fixed so that template is observable...
6025 * @cfg {String} html The HTML fragment or an array of fragments to join("") or multiple arguments to join("")
6033 * Returns an HTML fragment of this template with the specified values applied.
6034 * @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'})
6035 * @return {String} The HTML fragment
6040 applyTemplate : function(values){
6041 //Roo.log(["applyTemplate", values]);
6045 return this.compiled(values);
6047 var useF = this.disableFormats !== true;
6048 var fm = Roo.util.Format, tpl = this;
6049 var fn = function(m, name, format, args){
6051 if(format.substr(0, 5) == "this."){
6052 return tpl.call(format.substr(5), values[name], values);
6055 // quoted values are required for strings in compiled templates,
6056 // but for non compiled we need to strip them
6057 // quoted reversed for jsmin
6058 var re = /^\s*['"](.*)["']\s*$/;
6059 args = args.split(',');
6060 for(var i = 0, len = args.length; i < len; i++){
6061 args[i] = args[i].replace(re, "$1");
6063 args = [values[name]].concat(args);
6065 args = [values[name]];
6067 return fm[format].apply(fm, args);
6070 return values[name] !== undefined ? values[name] : "";
6073 return this.html.replace(this.re, fn);
6091 this.loading = true;
6092 this.compiled = false;
6094 var cx = new Roo.data.Connection();
6098 success : function (response) {
6102 _t.set(response.responseText,true);
6108 failure : function(response) {
6109 Roo.log("Template failed to load from " + _t.url);
6116 * Sets the HTML used as the template and optionally compiles it.
6117 * @param {String} html
6118 * @param {Boolean} compile (optional) True to compile the template (defaults to undefined)
6119 * @return {Roo.Template} this
6121 set : function(html, compile){
6123 this.compiled = false;
6131 * True to disable format functions (defaults to false)
6134 disableFormats : false,
6137 * The regular expression used to match template variables
6141 re : /\{([\w-]+)(?:\:([\w\.]*)(?:\((.*?)?\))?)?\}/g,
6144 * Compiles the template into an internal function, eliminating the RegEx overhead.
6145 * @return {Roo.Template} this
6147 compile : function(){
6148 var fm = Roo.util.Format;
6149 var useF = this.disableFormats !== true;
6150 var sep = Roo.isGecko ? "+" : ",";
6151 var fn = function(m, name, format, args){
6153 args = args ? ',' + args : "";
6154 if(format.substr(0, 5) != "this."){
6155 format = "fm." + format + '(';
6157 format = 'this.call("'+ format.substr(5) + '", ';
6161 args= ''; format = "(values['" + name + "'] == undefined ? '' : ";
6163 return "'"+ sep + format + "values['" + name + "']" + args + ")"+sep+"'";
6166 // branched to use + in gecko and [].join() in others
6168 body = "this.compiled = function(values){ return '" +
6169 this.html.replace(/\\/g, '\\\\').replace(/(\r\n|\n)/g, '\\n').replace(/'/g, "\\'").replace(this.re, fn) +
6172 body = ["this.compiled = function(values){ return ['"];
6173 body.push(this.html.replace(/\\/g, '\\\\').replace(/(\r\n|\n)/g, '\\n').replace(/'/g, "\\'").replace(this.re, fn));
6174 body.push("'].join('');};");
6175 body = body.join('');
6185 // private function used to call members
6186 call : function(fnName, value, allValues){
6187 return this[fnName](value, allValues);
6191 * Applies the supplied values to the template and inserts the new node(s) as the first child of el.
6192 * @param {String/HTMLElement/Roo.Element} el The context element
6193 * @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'})
6194 * @param {Boolean} returnElement (optional) true to return a Roo.Element (defaults to undefined)
6195 * @return {HTMLElement/Roo.Element} The new node or Element
6197 insertFirst: function(el, values, returnElement){
6198 return this.doInsert('afterBegin', el, values, returnElement);
6202 * Applies the supplied values to the template and inserts the new node(s) before el.
6203 * @param {String/HTMLElement/Roo.Element} el The context element
6204 * @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'})
6205 * @param {Boolean} returnElement (optional) true to return a Roo.Element (defaults to undefined)
6206 * @return {HTMLElement/Roo.Element} The new node or Element
6208 insertBefore: function(el, values, returnElement){
6209 return this.doInsert('beforeBegin', el, values, returnElement);
6213 * Applies the supplied values to the template and inserts the new node(s) after el.
6214 * @param {String/HTMLElement/Roo.Element} el The context element
6215 * @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'})
6216 * @param {Boolean} returnElement (optional) true to return a Roo.Element (defaults to undefined)
6217 * @return {HTMLElement/Roo.Element} The new node or Element
6219 insertAfter : function(el, values, returnElement){
6220 return this.doInsert('afterEnd', el, values, returnElement);
6224 * Applies the supplied values to the template and appends the new node(s) to el.
6225 * @param {String/HTMLElement/Roo.Element} el The context element
6226 * @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'})
6227 * @param {Boolean} returnElement (optional) true to return a Roo.Element (defaults to undefined)
6228 * @return {HTMLElement/Roo.Element} The new node or Element
6230 append : function(el, values, returnElement){
6231 return this.doInsert('beforeEnd', el, values, returnElement);
6234 doInsert : function(where, el, values, returnEl){
6235 el = Roo.getDom(el);
6236 var newNode = Roo.DomHelper.insertHtml(where, el, this.applyTemplate(values));
6237 return returnEl ? Roo.get(newNode, true) : newNode;
6241 * Applies the supplied values to the template and overwrites the content of el with the new node(s).
6242 * @param {String/HTMLElement/Roo.Element} el The context element
6243 * @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'})
6244 * @param {Boolean} returnElement (optional) true to return a Roo.Element (defaults to undefined)
6245 * @return {HTMLElement/Roo.Element} The new node or Element
6247 overwrite : function(el, values, returnElement){
6248 el = Roo.getDom(el);
6249 el.innerHTML = this.applyTemplate(values);
6250 return returnElement ? Roo.get(el.firstChild, true) : el.firstChild;
6254 * Alias for {@link #applyTemplate}
6257 Roo.Template.prototype.apply = Roo.Template.prototype.applyTemplate;
6260 Roo.DomHelper.Template = Roo.Template;
6263 * Creates a template from the passed element's value (<i>display:none</i> textarea, preferred) or innerHTML.
6264 * @param {String/HTMLElement} el A DOM element or its id
6265 * @returns {Roo.Template} The created template
6268 Roo.Template.from = function(el){
6269 el = Roo.getDom(el);
6270 return new Roo.Template(el.value || el.innerHTML);
6273 * Ext JS Library 1.1.1
6274 * Copyright(c) 2006-2007, Ext JS, LLC.
6276 * Originally Released Under LGPL - original licence link has changed is not relivant.
6279 * <script type="text/javascript">
6284 * This is code is also distributed under MIT license for use
6285 * with jQuery and prototype JavaScript libraries.
6288 * @class Roo.DomQuery
6289 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).
6291 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>
6294 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.
6296 <h4>Element Selectors:</h4>
6298 <li> <b>*</b> any element</li>
6299 <li> <b>E</b> an element with the tag E</li>
6300 <li> <b>E F</b> All descendent elements of E that have the tag F</li>
6301 <li> <b>E > F</b> or <b>E/F</b> all direct children elements of E that have the tag F</li>
6302 <li> <b>E + F</b> all elements with the tag F that are immediately preceded by an element with the tag E</li>
6303 <li> <b>E ~ F</b> all elements with the tag F that are preceded by a sibling element with the tag E</li>
6305 <h4>Attribute Selectors:</h4>
6306 <p>The use of @ and quotes are optional. For example, div[@foo='bar'] is also a valid attribute selector.</p>
6308 <li> <b>E[foo]</b> has an attribute "foo"</li>
6309 <li> <b>E[foo=bar]</b> has an attribute "foo" that equals "bar"</li>
6310 <li> <b>E[foo^=bar]</b> has an attribute "foo" that starts with "bar"</li>
6311 <li> <b>E[foo$=bar]</b> has an attribute "foo" that ends with "bar"</li>
6312 <li> <b>E[foo*=bar]</b> has an attribute "foo" that contains the substring "bar"</li>
6313 <li> <b>E[foo%=2]</b> has an attribute "foo" that is evenly divisible by 2</li>
6314 <li> <b>E[foo!=bar]</b> has an attribute "foo" that does not equal "bar"</li>
6316 <h4>Pseudo Classes:</h4>
6318 <li> <b>E:first-child</b> E is the first child of its parent</li>
6319 <li> <b>E:last-child</b> E is the last child of its parent</li>
6320 <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>
6321 <li> <b>E:nth-child(odd)</b> E is an odd child of its parent</li>
6322 <li> <b>E:nth-child(even)</b> E is an even child of its parent</li>
6323 <li> <b>E:only-child</b> E is the only child of its parent</li>
6324 <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>
6325 <li> <b>E:first</b> the first E in the resultset</li>
6326 <li> <b>E:last</b> the last E in the resultset</li>
6327 <li> <b>E:nth(<i>n</i>)</b> the <i>n</i>th E in the resultset (1 based)</li>
6328 <li> <b>E:odd</b> shortcut for :nth-child(odd)</li>
6329 <li> <b>E:even</b> shortcut for :nth-child(even)</li>
6330 <li> <b>E:contains(foo)</b> E's innerHTML contains the substring "foo"</li>
6331 <li> <b>E:nodeValue(foo)</b> E contains a textNode with a nodeValue that equals "foo"</li>
6332 <li> <b>E:not(S)</b> an E element that does not match simple selector S</li>
6333 <li> <b>E:has(S)</b> an E element that has a descendent that matches simple selector S</li>
6334 <li> <b>E:next(S)</b> an E element whose next sibling matches simple selector S</li>
6335 <li> <b>E:prev(S)</b> an E element whose previous sibling matches simple selector S</li>
6337 <h4>CSS Value Selectors:</h4>
6339 <li> <b>E{display=none}</b> css value "display" that equals "none"</li>
6340 <li> <b>E{display^=none}</b> css value "display" that starts with "none"</li>
6341 <li> <b>E{display$=none}</b> css value "display" that ends with "none"</li>
6342 <li> <b>E{display*=none}</b> css value "display" that contains the substring "none"</li>
6343 <li> <b>E{display%=2}</b> css value "display" that is evenly divisible by 2</li>
6344 <li> <b>E{display!=none}</b> css value "display" that does not equal "none"</li>
6348 Roo.DomQuery = function(){
6349 var cache = {}, simpleCache = {}, valueCache = {};
6350 var nonSpace = /\S/;
6351 var trimRe = /^\s+|\s+$/g;
6352 var tplRe = /\{(\d+)\}/g;
6353 var modeRe = /^(\s?[\/>+~]\s?|\s|$)/;
6354 var tagTokenRe = /^(#)?([\w-\*]+)/;
6355 var nthRe = /(\d*)n\+?(\d*)/, nthRe2 = /\D/;
6357 function child(p, index){
6359 var n = p.firstChild;
6361 if(n.nodeType == 1){
6372 while((n = n.nextSibling) && n.nodeType != 1);
6377 while((n = n.previousSibling) && n.nodeType != 1);
6381 function children(d){
6382 var n = d.firstChild, ni = -1;
6384 var nx = n.nextSibling;
6385 if(n.nodeType == 3 && !nonSpace.test(n.nodeValue)){
6395 function byClassName(c, a, v){
6399 var r = [], ri = -1, cn;
6400 for(var i = 0, ci; ci = c[i]; i++){
6404 ( (ci instanceof SVGElement) ? ci.className.baseVal : ci.className)
6405 +' ').indexOf(v) != -1){
6412 function attrValue(n, attr){
6413 if(!n.tagName && typeof n.length != "undefined"){
6422 if(attr == "class" || attr == "className"){
6423 return (n instanceof SVGElement) ? n.className.baseVal : n.className;
6425 return n.getAttribute(attr) || n[attr];
6429 function getNodes(ns, mode, tagName){
6430 var result = [], ri = -1, cs;
6434 tagName = tagName || "*";
6435 if(typeof ns.getElementsByTagName != "undefined"){
6439 for(var i = 0, ni; ni = ns[i]; i++){
6440 cs = ni.getElementsByTagName(tagName);
6441 for(var j = 0, ci; ci = cs[j]; j++){
6445 }else if(mode == "/" || mode == ">"){
6446 var utag = tagName.toUpperCase();
6447 for(var i = 0, ni, cn; ni = ns[i]; i++){
6448 cn = ni.children || ni.childNodes;
6449 for(var j = 0, cj; cj = cn[j]; j++){
6450 if(cj.nodeName == utag || cj.nodeName == tagName || tagName == '*'){
6455 }else if(mode == "+"){
6456 var utag = tagName.toUpperCase();
6457 for(var i = 0, n; n = ns[i]; i++){
6458 while((n = n.nextSibling) && n.nodeType != 1);
6459 if(n && (n.nodeName == utag || n.nodeName == tagName || tagName == '*')){
6463 }else if(mode == "~"){
6464 for(var i = 0, n; n = ns[i]; i++){
6465 while((n = n.nextSibling) && (n.nodeType != 1 || (tagName == '*' || n.tagName.toLowerCase()!=tagName)));
6474 function concat(a, b){
6478 for(var i = 0, l = b.length; i < l; i++){
6484 function byTag(cs, tagName){
6485 if(cs.tagName || cs == document){
6491 var r = [], ri = -1;
6492 tagName = tagName.toLowerCase();
6493 for(var i = 0, ci; ci = cs[i]; i++){
6494 if(ci.nodeType == 1 && ci.tagName.toLowerCase()==tagName){
6501 function byId(cs, attr, id){
6502 if(cs.tagName || cs == document){
6508 var r = [], ri = -1;
6509 for(var i = 0,ci; ci = cs[i]; i++){
6510 if(ci && ci.id == id){
6518 function byAttribute(cs, attr, value, op, custom){
6519 var r = [], ri = -1, st = custom=="{";
6520 var f = Roo.DomQuery.operators[op];
6521 for(var i = 0, ci; ci = cs[i]; i++){
6524 a = Roo.DomQuery.getStyle(ci, attr);
6526 else if(attr == "class" || attr == "className"){
6527 a = (ci instanceof SVGElement) ? ci.className.baseVal : ci.className;
6528 }else if(attr == "for"){
6530 }else if(attr == "href"){
6531 a = ci.getAttribute("href", 2);
6533 a = ci.getAttribute(attr);
6535 if((f && f(a, value)) || (!f && a)){
6542 function byPseudo(cs, name, value){
6543 return Roo.DomQuery.pseudos[name](cs, value);
6546 // This is for IE MSXML which does not support expandos.
6547 // IE runs the same speed using setAttribute, however FF slows way down
6548 // and Safari completely fails so they need to continue to use expandos.
6549 var isIE = window.ActiveXObject ? true : false;
6551 // this eval is stop the compressor from
6552 // renaming the variable to something shorter
6554 /** eval:var:batch */
6559 function nodupIEXml(cs){
6561 cs[0].setAttribute("_nodup", d);
6563 for(var i = 1, len = cs.length; i < len; i++){
6565 if(!c.getAttribute("_nodup") != d){
6566 c.setAttribute("_nodup", d);
6570 for(var i = 0, len = cs.length; i < len; i++){
6571 cs[i].removeAttribute("_nodup");
6580 var len = cs.length, c, i, r = cs, cj, ri = -1;
6581 if(!len || typeof cs.nodeType != "undefined" || len == 1){
6584 if(isIE && typeof cs[0].selectSingleNode != "undefined"){
6585 return nodupIEXml(cs);
6589 for(i = 1; c = cs[i]; i++){
6594 for(var j = 0; j < i; j++){
6597 for(j = i+1; cj = cs[j]; j++){
6609 function quickDiffIEXml(c1, c2){
6611 for(var i = 0, len = c1.length; i < len; i++){
6612 c1[i].setAttribute("_qdiff", d);
6615 for(var i = 0, len = c2.length; i < len; i++){
6616 if(c2[i].getAttribute("_qdiff") != d){
6617 r[r.length] = c2[i];
6620 for(var i = 0, len = c1.length; i < len; i++){
6621 c1[i].removeAttribute("_qdiff");
6626 function quickDiff(c1, c2){
6627 var len1 = c1.length;
6631 if(isIE && c1[0].selectSingleNode){
6632 return quickDiffIEXml(c1, c2);
6635 for(var i = 0; i < len1; i++){
6639 for(var i = 0, len = c2.length; i < len; i++){
6640 if(c2[i]._qdiff != d){
6641 r[r.length] = c2[i];
6647 function quickId(ns, mode, root, id){
6649 var d = root.ownerDocument || root;
6650 return d.getElementById(id);
6652 ns = getNodes(ns, mode, "*");
6653 return byId(ns, null, id);
6657 getStyle : function(el, name){
6658 return Roo.fly(el).getStyle(name);
6661 * Compiles a selector/xpath query into a reusable function. The returned function
6662 * takes one parameter "root" (optional), which is the context node from where the query should start.
6663 * @param {String} selector The selector/xpath query
6664 * @param {String} type (optional) Either "select" (the default) or "simple" for a simple selector match
6665 * @return {Function}
6667 compile : function(path, type){
6668 type = type || "select";
6670 var fn = ["var f = function(root){\n var mode; ++batch; var n = root || document;\n"];
6671 var q = path, mode, lq;
6672 var tk = Roo.DomQuery.matchers;
6673 var tklen = tk.length;
6676 // accept leading mode switch
6677 var lmode = q.match(modeRe);
6678 if(lmode && lmode[1]){
6679 fn[fn.length] = 'mode="'+lmode[1].replace(trimRe, "")+'";';
6680 q = q.replace(lmode[1], "");
6682 // strip leading slashes
6683 while(path.substr(0, 1)=="/"){
6684 path = path.substr(1);
6687 while(q && lq != q){
6689 var tm = q.match(tagTokenRe);
6690 if(type == "select"){
6693 fn[fn.length] = 'n = quickId(n, mode, root, "'+tm[2]+'");';
6695 fn[fn.length] = 'n = getNodes(n, mode, "'+tm[2]+'");';
6697 q = q.replace(tm[0], "");
6698 }else if(q.substr(0, 1) != '@'){
6699 fn[fn.length] = 'n = getNodes(n, mode, "*");';
6704 fn[fn.length] = 'n = byId(n, null, "'+tm[2]+'");';
6706 fn[fn.length] = 'n = byTag(n, "'+tm[2]+'");';
6708 q = q.replace(tm[0], "");
6711 while(!(mm = q.match(modeRe))){
6712 var matched = false;
6713 for(var j = 0; j < tklen; j++){
6715 var m = q.match(t.re);
6717 fn[fn.length] = t.select.replace(tplRe, function(x, i){
6720 q = q.replace(m[0], "");
6725 // prevent infinite loop on bad selector
6727 throw 'Error parsing selector, parsing failed at "' + q + '"';
6731 fn[fn.length] = 'mode="'+mm[1].replace(trimRe, "")+'";';
6732 q = q.replace(mm[1], "");
6735 fn[fn.length] = "return nodup(n);\n}";
6738 * list of variables that need from compression as they are used by eval.
6748 * eval:var:byClassName
6750 * eval:var:byAttribute
6751 * eval:var:attrValue
6759 * Selects a group of elements.
6760 * @param {String} selector The selector/xpath query (can be a comma separated list of selectors)
6761 * @param {Node} root (optional) The start of the query (defaults to document).
6764 select : function(path, root, type){
6765 if(!root || root == document){
6768 if(typeof root == "string"){
6769 root = document.getElementById(root);
6771 var paths = path.split(",");
6773 for(var i = 0, len = paths.length; i < len; i++){
6774 var p = paths[i].replace(trimRe, "");
6776 cache[p] = Roo.DomQuery.compile(p);
6778 throw p + " is not a valid selector";
6781 var result = cache[p](root);
6782 if(result && result != document){
6783 results = results.concat(result);
6786 if(paths.length > 1){
6787 return nodup(results);
6793 * Selects a single element.
6794 * @param {String} selector The selector/xpath query
6795 * @param {Node} root (optional) The start of the query (defaults to document).
6798 selectNode : function(path, root){
6799 return Roo.DomQuery.select(path, root)[0];
6803 * Selects the value of a node, optionally replacing null with the defaultValue.
6804 * @param {String} selector The selector/xpath query
6805 * @param {Node} root (optional) The start of the query (defaults to document).
6806 * @param {String} defaultValue
6808 selectValue : function(path, root, defaultValue){
6809 path = path.replace(trimRe, "");
6810 if(!valueCache[path]){
6811 valueCache[path] = Roo.DomQuery.compile(path, "select");
6813 var n = valueCache[path](root);
6814 n = n[0] ? n[0] : n;
6815 var v = (n && n.firstChild ? n.firstChild.nodeValue : null);
6816 return ((v === null||v === undefined||v==='') ? defaultValue : v);
6820 * Selects the value of a node, parsing integers and floats.
6821 * @param {String} selector The selector/xpath query
6822 * @param {Node} root (optional) The start of the query (defaults to document).
6823 * @param {Number} defaultValue
6826 selectNumber : function(path, root, defaultValue){
6827 var v = Roo.DomQuery.selectValue(path, root, defaultValue || 0);
6828 return parseFloat(v);
6832 * Returns true if the passed element(s) match the passed simple selector (e.g. div.some-class or span:first-child)
6833 * @param {String/HTMLElement/Array} el An element id, element or array of elements
6834 * @param {String} selector The simple selector to test
6837 is : function(el, ss){
6838 if(typeof el == "string"){
6839 el = document.getElementById(el);
6841 var isArray = (el instanceof Array);
6842 var result = Roo.DomQuery.filter(isArray ? el : [el], ss);
6843 return isArray ? (result.length == el.length) : (result.length > 0);
6847 * Filters an array of elements to only include matches of a simple selector (e.g. div.some-class or span:first-child)
6848 * @param {Array} el An array of elements to filter
6849 * @param {String} selector The simple selector to test
6850 * @param {Boolean} nonMatches If true, it returns the elements that DON'T match
6851 * the selector instead of the ones that match
6854 filter : function(els, ss, nonMatches){
6855 ss = ss.replace(trimRe, "");
6856 if(!simpleCache[ss]){
6857 simpleCache[ss] = Roo.DomQuery.compile(ss, "simple");
6859 var result = simpleCache[ss](els);
6860 return nonMatches ? quickDiff(result, els) : result;
6864 * Collection of matching regular expressions and code snippets.
6868 select: 'n = byClassName(n, null, " {1} ");'
6870 re: /^\:([\w-]+)(?:\(((?:[^\s>\/]*|.*?))\))?/,
6871 select: 'n = byPseudo(n, "{1}", "{2}");'
6873 re: /^(?:([\[\{])(?:@)?([\w-]+)\s?(?:(=|.=)\s?['"]?(.*?)["']?)?[\]\}])/,
6874 select: 'n = byAttribute(n, "{2}", "{4}", "{3}", "{1}");'
6877 select: 'n = byId(n, null, "{1}");'
6880 select: 'return {firstChild:{nodeValue:attrValue(n, "{1}")}};'
6885 * Collection of operator comparison functions. The default operators are =, !=, ^=, $=, *=, %=, |= and ~=.
6886 * 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, > <.
6889 "=" : function(a, v){
6892 "!=" : function(a, v){
6895 "^=" : function(a, v){
6896 return a && a.substr(0, v.length) == v;
6898 "$=" : function(a, v){
6899 return a && a.substr(a.length-v.length) == v;
6901 "*=" : function(a, v){
6902 return a && a.indexOf(v) !== -1;
6904 "%=" : function(a, v){
6905 return (a % v) == 0;
6907 "|=" : function(a, v){
6908 return a && (a == v || a.substr(0, v.length+1) == v+'-');
6910 "~=" : function(a, v){
6911 return a && (' '+a+' ').indexOf(' '+v+' ') != -1;
6916 * Collection of "pseudo class" processors. Each processor is passed the current nodeset (array)
6917 * and the argument (if any) supplied in the selector.
6920 "first-child" : function(c){
6921 var r = [], ri = -1, n;
6922 for(var i = 0, ci; ci = n = c[i]; i++){
6923 while((n = n.previousSibling) && n.nodeType != 1);
6931 "last-child" : function(c){
6932 var r = [], ri = -1, n;
6933 for(var i = 0, ci; ci = n = c[i]; i++){
6934 while((n = n.nextSibling) && n.nodeType != 1);
6942 "nth-child" : function(c, a) {
6943 var r = [], ri = -1;
6944 var m = nthRe.exec(a == "even" && "2n" || a == "odd" && "2n+1" || !nthRe2.test(a) && "n+" + a || a);
6945 var f = (m[1] || 1) - 0, l = m[2] - 0;
6946 for(var i = 0, n; n = c[i]; i++){
6947 var pn = n.parentNode;
6948 if (batch != pn._batch) {
6950 for(var cn = pn.firstChild; cn; cn = cn.nextSibling){
6951 if(cn.nodeType == 1){
6958 if (l == 0 || n.nodeIndex == l){
6961 } else if ((n.nodeIndex + l) % f == 0){
6969 "only-child" : function(c){
6970 var r = [], ri = -1;;
6971 for(var i = 0, ci; ci = c[i]; i++){
6972 if(!prev(ci) && !next(ci)){
6979 "empty" : function(c){
6980 var r = [], ri = -1;
6981 for(var i = 0, ci; ci = c[i]; i++){
6982 var cns = ci.childNodes, j = 0, cn, empty = true;
6985 if(cn.nodeType == 1 || cn.nodeType == 3){
6997 "contains" : function(c, v){
6998 var r = [], ri = -1;
6999 for(var i = 0, ci; ci = c[i]; i++){
7000 if((ci.textContent||ci.innerText||'').indexOf(v) != -1){
7007 "nodeValue" : function(c, v){
7008 var r = [], ri = -1;
7009 for(var i = 0, ci; ci = c[i]; i++){
7010 if(ci.firstChild && ci.firstChild.nodeValue == v){
7017 "checked" : function(c){
7018 var r = [], ri = -1;
7019 for(var i = 0, ci; ci = c[i]; i++){
7020 if(ci.checked == true){
7027 "not" : function(c, ss){
7028 return Roo.DomQuery.filter(c, ss, true);
7031 "odd" : function(c){
7032 return this["nth-child"](c, "odd");
7035 "even" : function(c){
7036 return this["nth-child"](c, "even");
7039 "nth" : function(c, a){
7040 return c[a-1] || [];
7043 "first" : function(c){
7047 "last" : function(c){
7048 return c[c.length-1] || [];
7051 "has" : function(c, ss){
7052 var s = Roo.DomQuery.select;
7053 var r = [], ri = -1;
7054 for(var i = 0, ci; ci = c[i]; i++){
7055 if(s(ss, ci).length > 0){
7062 "next" : function(c, ss){
7063 var is = Roo.DomQuery.is;
7064 var r = [], ri = -1;
7065 for(var i = 0, ci; ci = c[i]; i++){
7074 "prev" : function(c, ss){
7075 var is = Roo.DomQuery.is;
7076 var r = [], ri = -1;
7077 for(var i = 0, ci; ci = c[i]; i++){
7090 * Selects an array of DOM nodes by CSS/XPath selector. Shorthand of {@link Roo.DomQuery#select}
7091 * @param {String} path The selector/xpath query
7092 * @param {Node} root (optional) The start of the query (defaults to document).
7097 Roo.query = Roo.DomQuery.select;
7100 * Ext JS Library 1.1.1
7101 * Copyright(c) 2006-2007, Ext JS, LLC.
7103 * Originally Released Under LGPL - original licence link has changed is not relivant.
7106 * <script type="text/javascript">
7110 * @class Roo.util.Observable
7111 * Base class that provides a common interface for publishing events. Subclasses are expected to
7112 * to have a property "events" with all the events defined.<br>
7115 Employee = function(name){
7122 Roo.extend(Employee, Roo.util.Observable);
7124 * @param {Object} config properties to use (incuding events / listeners)
7127 Roo.util.Observable = function(cfg){
7130 this.addEvents(cfg.events || {});
7132 delete cfg.events; // make sure
7135 Roo.apply(this, cfg);
7138 this.on(this.listeners);
7139 delete this.listeners;
7142 Roo.util.Observable.prototype = {
7144 * @cfg {Object} listeners list of events and functions to call for this object,
7148 'click' : function(e) {
7158 * Fires the specified event with the passed parameters (minus the event name).
7159 * @param {String} eventName
7160 * @param {Object...} args Variable number of parameters are passed to handlers
7161 * @return {Boolean} returns false if any of the handlers return false otherwise it returns true
7163 fireEvent : function(){
7164 var ce = this.events[arguments[0].toLowerCase()];
7165 if(typeof ce == "object"){
7166 return ce.fire.apply(ce, Array.prototype.slice.call(arguments, 1));
7173 filterOptRe : /^(?:scope|delay|buffer|single)$/,
7176 * Appends an event handler to this component
7177 * @param {String} eventName The type of event to listen for
7178 * @param {Function} handler The method the event invokes
7179 * @param {Object} scope (optional) The scope in which to execute the handler
7180 * function. The handler function's "this" context.
7181 * @param {Object} options (optional) An object containing handler configuration
7182 * properties. This may contain any of the following properties:<ul>
7183 * <li>scope {Object} The scope in which to execute the handler function. The handler function's "this" context.</li>
7184 * <li>delay {Number} The number of milliseconds to delay the invocation of the handler after te event fires.</li>
7185 * <li>single {Boolean} True to add a handler to handle just the next firing of the event, and then remove itself.</li>
7186 * <li>buffer {Number} Causes the handler to be scheduled to run in an {@link Roo.util.DelayedTask} delayed
7187 * by the specified number of milliseconds. If the event fires again within that time, the original
7188 * handler is <em>not</em> invoked, but the new handler is scheduled in its place.</li>
7191 * <b>Combining Options</b><br>
7192 * Using the options argument, it is possible to combine different types of listeners:<br>
7194 * A normalized, delayed, one-time listener that auto stops the event and passes a custom argument (forumId)
7196 el.on('click', this.onClick, this, {
7203 * <b>Attaching multiple handlers in 1 call</b><br>
7204 * The method also allows for a single argument to be passed which is a config object containing properties
7205 * which specify multiple handlers.
7214 fn: this.onMouseOver,
7218 fn: this.onMouseOut,
7224 * Or a shorthand syntax which passes the same scope object to all handlers:
7227 'click': this.onClick,
7228 'mouseover': this.onMouseOver,
7229 'mouseout': this.onMouseOut,
7234 addListener : function(eventName, fn, scope, o){
7235 if(typeof eventName == "object"){
7238 if(this.filterOptRe.test(e)){
7241 if(typeof o[e] == "function"){
7243 this.addListener(e, o[e], o.scope, o);
7245 // individual options
7246 this.addListener(e, o[e].fn, o[e].scope, o[e]);
7251 o = (!o || typeof o == "boolean") ? {} : o;
7252 eventName = eventName.toLowerCase();
7253 var ce = this.events[eventName] || true;
7254 if(typeof ce == "boolean"){
7255 ce = new Roo.util.Event(this, eventName);
7256 this.events[eventName] = ce;
7258 ce.addListener(fn, scope, o);
7262 * Removes a listener
7263 * @param {String} eventName The type of event to listen for
7264 * @param {Function} handler The handler to remove
7265 * @param {Object} scope (optional) The scope (this object) for the handler
7267 removeListener : function(eventName, fn, scope){
7268 var ce = this.events[eventName.toLowerCase()];
7269 if(typeof ce == "object"){
7270 ce.removeListener(fn, scope);
7275 * Removes all listeners for this object
7277 purgeListeners : function(){
7278 for(var evt in this.events){
7279 if(typeof this.events[evt] == "object"){
7280 this.events[evt].clearListeners();
7285 relayEvents : function(o, events){
7286 var createHandler = function(ename){
7289 return this.fireEvent.apply(this, Roo.combine(ename, Array.prototype.slice.call(arguments, 0)));
7292 for(var i = 0, len = events.length; i < len; i++){
7293 var ename = events[i];
7294 if(!this.events[ename]){
7295 this.events[ename] = true;
7297 o.on(ename, createHandler(ename), this);
7302 * Used to define events on this Observable
7303 * @param {Object} object The object with the events defined
7305 addEvents : function(o){
7309 Roo.applyIf(this.events, o);
7313 * Checks to see if this object has any listeners for a specified event
7314 * @param {String} eventName The name of the event to check for
7315 * @return {Boolean} True if the event is being listened for, else false
7317 hasListener : function(eventName){
7318 var e = this.events[eventName];
7319 return typeof e == "object" && e.listeners.length > 0;
7323 * Appends an event handler to this element (shorthand for addListener)
7324 * @param {String} eventName The type of event to listen for
7325 * @param {Function} handler The method the event invokes
7326 * @param {Object} scope (optional) The scope in which to execute the handler
7327 * function. The handler function's "this" context.
7328 * @param {Object} options (optional)
7331 Roo.util.Observable.prototype.on = Roo.util.Observable.prototype.addListener;
7333 * Removes a listener (shorthand for removeListener)
7334 * @param {String} eventName The type of event to listen for
7335 * @param {Function} handler The handler to remove
7336 * @param {Object} scope (optional) The scope (this object) for the handler
7339 Roo.util.Observable.prototype.un = Roo.util.Observable.prototype.removeListener;
7342 * Starts capture on the specified Observable. All events will be passed
7343 * to the supplied function with the event name + standard signature of the event
7344 * <b>before</b> the event is fired. If the supplied function returns false,
7345 * the event will not fire.
7346 * @param {Observable} o The Observable to capture
7347 * @param {Function} fn The function to call
7348 * @param {Object} scope (optional) The scope (this object) for the fn
7351 Roo.util.Observable.capture = function(o, fn, scope){
7352 o.fireEvent = o.fireEvent.createInterceptor(fn, scope);
7356 * Removes <b>all</b> added captures from the Observable.
7357 * @param {Observable} o The Observable to release
7360 Roo.util.Observable.releaseCapture = function(o){
7361 o.fireEvent = Roo.util.Observable.prototype.fireEvent;
7366 var createBuffered = function(h, o, scope){
7367 var task = new Roo.util.DelayedTask();
7369 task.delay(o.buffer, h, scope, Array.prototype.slice.call(arguments, 0));
7373 var createSingle = function(h, e, fn, scope){
7375 e.removeListener(fn, scope);
7376 return h.apply(scope, arguments);
7380 var createDelayed = function(h, o, scope){
7382 var args = Array.prototype.slice.call(arguments, 0);
7383 setTimeout(function(){
7384 h.apply(scope, args);
7389 Roo.util.Event = function(obj, name){
7392 this.listeners = [];
7395 Roo.util.Event.prototype = {
7396 addListener : function(fn, scope, options){
7397 var o = options || {};
7398 scope = scope || this.obj;
7399 if(!this.isListening(fn, scope)){
7400 var l = {fn: fn, scope: scope, options: o};
7403 h = createDelayed(h, o, scope);
7406 h = createSingle(h, this, fn, scope);
7409 h = createBuffered(h, o, scope);
7412 if(!this.firing){ // if we are currently firing this event, don't disturb the listener loop
7413 this.listeners.push(l);
7415 this.listeners = this.listeners.slice(0);
7416 this.listeners.push(l);
7421 findListener : function(fn, scope){
7422 scope = scope || this.obj;
7423 var ls = this.listeners;
7424 for(var i = 0, len = ls.length; i < len; i++){
7426 if(l.fn == fn && l.scope == scope){
7433 isListening : function(fn, scope){
7434 return this.findListener(fn, scope) != -1;
7437 removeListener : function(fn, scope){
7439 if((index = this.findListener(fn, scope)) != -1){
7441 this.listeners.splice(index, 1);
7443 this.listeners = this.listeners.slice(0);
7444 this.listeners.splice(index, 1);
7451 clearListeners : function(){
7452 this.listeners = [];
7456 var ls = this.listeners, scope, len = ls.length;
7459 var args = Array.prototype.slice.call(arguments, 0);
7460 for(var i = 0; i < len; i++){
7462 if(l.fireFn.apply(l.scope||this.obj||window, args) === false){
7463 this.firing = false;
7467 this.firing = false;
7474 * Copyright(c) 2007-2017, Roo J Solutions Ltd
7481 * @class Roo.Document
7482 * @extends Roo.util.Observable
7483 * This is a convience class to wrap up the main document loading code.. , rather than adding Roo.onReady(......)
7485 * @param {Object} config the methods and properties of the 'base' class for the application.
7487 * Generic Page handler - implement this to start your app..
7490 * MyProject = new Roo.Document({
7492 'load' : true // your events..
7495 'ready' : function() {
7496 // fired on Roo.onReady()
7501 Roo.Document = function(cfg) {
7506 Roo.util.Observable.call(this,cfg);
7510 Roo.onReady(function() {
7511 _this.fireEvent('ready');
7517 Roo.extend(Roo.Document, Roo.util.Observable, {});/*
7519 * Ext JS Library 1.1.1
7520 * Copyright(c) 2006-2007, Ext JS, LLC.
7522 * Originally Released Under LGPL - original licence link has changed is not relivant.
7525 * <script type="text/javascript">
7529 * @class Roo.EventManager
7530 * Registers event handlers that want to receive a normalized EventObject instead of the standard browser event and provides
7531 * several useful events directly.
7532 * See {@link Roo.EventObject} for more details on normalized event objects.
7535 Roo.EventManager = function(){
7536 var docReadyEvent, docReadyProcId, docReadyState = false;
7537 var resizeEvent, resizeTask, textEvent, textSize;
7538 var E = Roo.lib.Event;
7539 var D = Roo.lib.Dom;
7544 var fireDocReady = function(){
7546 docReadyState = true;
7549 clearInterval(docReadyProcId);
7551 if(Roo.isGecko || Roo.isOpera) {
7552 document.removeEventListener("DOMContentLoaded", fireDocReady, false);
7555 var defer = document.getElementById("ie-deferred-loader");
7557 defer.onreadystatechange = null;
7558 defer.parentNode.removeChild(defer);
7562 docReadyEvent.fire();
7563 docReadyEvent.clearListeners();
7568 var initDocReady = function(){
7569 docReadyEvent = new Roo.util.Event();
7570 if(Roo.isGecko || Roo.isOpera) {
7571 document.addEventListener("DOMContentLoaded", fireDocReady, false);
7573 document.write("<s"+'cript id="ie-deferred-loader" defer="defer" src="/'+'/:"></s'+"cript>");
7574 var defer = document.getElementById("ie-deferred-loader");
7575 defer.onreadystatechange = function(){
7576 if(this.readyState == "complete"){
7580 }else if(Roo.isSafari){
7581 docReadyProcId = setInterval(function(){
7582 var rs = document.readyState;
7583 if(rs == "complete") {
7588 // no matter what, make sure it fires on load
7589 E.on(window, "load", fireDocReady);
7592 var createBuffered = function(h, o){
7593 var task = new Roo.util.DelayedTask(h);
7595 // create new event object impl so new events don't wipe out properties
7596 e = new Roo.EventObjectImpl(e);
7597 task.delay(o.buffer, h, null, [e]);
7601 var createSingle = function(h, el, ename, fn){
7603 Roo.EventManager.removeListener(el, ename, fn);
7608 var createDelayed = function(h, o){
7610 // create new event object impl so new events don't wipe out properties
7611 e = new Roo.EventObjectImpl(e);
7612 setTimeout(function(){
7617 var transitionEndVal = false;
7619 var transitionEnd = function()
7621 if (transitionEndVal) {
7622 return transitionEndVal;
7624 var el = document.createElement('div');
7626 var transEndEventNames = {
7627 WebkitTransition : 'webkitTransitionEnd',
7628 MozTransition : 'transitionend',
7629 OTransition : 'oTransitionEnd otransitionend',
7630 transition : 'transitionend'
7633 for (var name in transEndEventNames) {
7634 if (el.style[name] !== undefined) {
7635 transitionEndVal = transEndEventNames[name];
7636 return transitionEndVal ;
7643 var listen = function(element, ename, opt, fn, scope)
7645 var o = (!opt || typeof opt == "boolean") ? {} : opt;
7646 fn = fn || o.fn; scope = scope || o.scope;
7647 var el = Roo.getDom(element);
7651 throw "Error listening for \"" + ename + '\". Element "' + element + '" doesn\'t exist.';
7654 if (ename == 'transitionend') {
7655 ename = transitionEnd();
7657 var h = function(e){
7658 e = Roo.EventObject.setEvent(e);
7661 t = e.getTarget(o.delegate, el);
7668 if(o.stopEvent === true){
7671 if(o.preventDefault === true){
7674 if(o.stopPropagation === true){
7675 e.stopPropagation();
7678 if(o.normalized === false){
7682 fn.call(scope || el, e, t, o);
7685 h = createDelayed(h, o);
7688 h = createSingle(h, el, ename, fn);
7691 h = createBuffered(h, o);
7694 fn._handlers = fn._handlers || [];
7697 fn._handlers.push([Roo.id(el), ename, h]);
7701 E.on(el, ename, h); // this adds the actuall listener to the object..
7704 if(ename == "mousewheel" && el.addEventListener){ // workaround for jQuery
7705 el.addEventListener("DOMMouseScroll", h, false);
7706 E.on(window, 'unload', function(){
7707 el.removeEventListener("DOMMouseScroll", h, false);
7710 if(ename == "mousedown" && el == document){ // fix stopped mousedowns on the document
7711 Roo.EventManager.stoppedMouseDownEvent.addListener(h);
7716 var stopListening = function(el, ename, fn){
7717 var id = Roo.id(el), hds = fn._handlers, hd = fn;
7719 for(var i = 0, len = hds.length; i < len; i++){
7721 if(h[0] == id && h[1] == ename){
7728 E.un(el, ename, hd);
7729 el = Roo.getDom(el);
7730 if(ename == "mousewheel" && el.addEventListener){
7731 el.removeEventListener("DOMMouseScroll", hd, false);
7733 if(ename == "mousedown" && el == document){ // fix stopped mousedowns on the document
7734 Roo.EventManager.stoppedMouseDownEvent.removeListener(hd);
7738 var propRe = /^(?:scope|delay|buffer|single|stopEvent|preventDefault|stopPropagation|normalized|args|delegate)$/;
7745 * @scope Roo.EventManager
7750 * This is no longer needed and is deprecated. Places a simple wrapper around an event handler to override the browser event
7751 * object with a Roo.EventObject
7752 * @param {Function} fn The method the event invokes
7753 * @param {Object} scope An object that becomes the scope of the handler
7754 * @param {boolean} override If true, the obj passed in becomes
7755 * the execution scope of the listener
7756 * @return {Function} The wrapped function
7759 wrap : function(fn, scope, override){
7761 Roo.EventObject.setEvent(e);
7762 fn.call(override ? scope || window : window, Roo.EventObject, scope);
7767 * Appends an event handler to an element (shorthand for addListener)
7768 * @param {String/HTMLElement} element The html element or id to assign the
7769 * @param {String} eventName The type of event to listen for
7770 * @param {Function} handler The method the event invokes
7771 * @param {Object} scope (optional) The scope in which to execute the handler
7772 * function. The handler function's "this" context.
7773 * @param {Object} options (optional) An object containing handler configuration
7774 * properties. This may contain any of the following properties:<ul>
7775 * <li>scope {Object} The scope in which to execute the handler function. The handler function's "this" context.</li>
7776 * <li>delegate {String} A simple selector to filter the target or look for a descendant of the target</li>
7777 * <li>stopEvent {Boolean} True to stop the event. That is stop propagation, and prevent the default action.</li>
7778 * <li>preventDefault {Boolean} True to prevent the default action</li>
7779 * <li>stopPropagation {Boolean} True to prevent event propagation</li>
7780 * <li>normalized {Boolean} False to pass a browser event to the handler function instead of an Roo.EventObject</li>
7781 * <li>delay {Number} The number of milliseconds to delay the invocation of the handler after te event fires.</li>
7782 * <li>single {Boolean} True to add a handler to handle just the next firing of the event, and then remove itself.</li>
7783 * <li>buffer {Number} Causes the handler to be scheduled to run in an {@link Roo.util.DelayedTask} delayed
7784 * by the specified number of milliseconds. If the event fires again within that time, the original
7785 * handler is <em>not</em> invoked, but the new handler is scheduled in its place.</li>
7788 * <b>Combining Options</b><br>
7789 * Using the options argument, it is possible to combine different types of listeners:<br>
7791 * A normalized, delayed, one-time listener that auto stops the event and passes a custom argument (forumId)<div style="margin: 5px 20px 20px;">
7793 el.on('click', this.onClick, this, {
7800 * <b>Attaching multiple handlers in 1 call</b><br>
7801 * The method also allows for a single argument to be passed which is a config object containing properties
7802 * which specify multiple handlers.
7812 fn: this.onMouseOver
7821 * Or a shorthand syntax:<br>
7824 'click' : this.onClick,
7825 'mouseover' : this.onMouseOver,
7826 'mouseout' : this.onMouseOut
7830 addListener : function(element, eventName, fn, scope, options){
7831 if(typeof eventName == "object"){
7837 if(typeof o[e] == "function"){
7839 listen(element, e, o, o[e], o.scope);
7841 // individual options
7842 listen(element, e, o[e]);
7847 return listen(element, eventName, options, fn, scope);
7851 * Removes an event handler
7853 * @param {String/HTMLElement} element The id or html element to remove the
7855 * @param {String} eventName The type of event
7856 * @param {Function} fn
7857 * @return {Boolean} True if a listener was actually removed
7859 removeListener : function(element, eventName, fn){
7860 return stopListening(element, eventName, fn);
7864 * Fires when the document is ready (before onload and before images are loaded). Can be
7865 * accessed shorthanded Roo.onReady().
7866 * @param {Function} fn The method the event invokes
7867 * @param {Object} scope An object that becomes the scope of the handler
7868 * @param {boolean} options
7870 onDocumentReady : function(fn, scope, options){
7871 if(docReadyState){ // if it already fired
7872 docReadyEvent.addListener(fn, scope, options);
7873 docReadyEvent.fire();
7874 docReadyEvent.clearListeners();
7880 docReadyEvent.addListener(fn, scope, options);
7884 * Fires when the window is resized and provides resize event buffering (50 milliseconds), passes new viewport width and height to handlers.
7885 * @param {Function} fn The method the event invokes
7886 * @param {Object} scope An object that becomes the scope of the handler
7887 * @param {boolean} options
7889 onWindowResize : function(fn, scope, options)
7892 resizeEvent = new Roo.util.Event();
7893 resizeTask = new Roo.util.DelayedTask(function(){
7894 resizeEvent.fire(D.getViewWidth(), D.getViewHeight());
7896 E.on(window, "resize", function()
7899 resizeTask.delay(50);
7901 resizeEvent.fire(D.getViewWidth(), D.getViewHeight());
7905 resizeEvent.addListener(fn, scope, options);
7909 * Fires when the user changes the active text size. Handler gets called with 2 params, the old size and the new size.
7910 * @param {Function} fn The method the event invokes
7911 * @param {Object} scope An object that becomes the scope of the handler
7912 * @param {boolean} options
7914 onTextResize : function(fn, scope, options){
7916 textEvent = new Roo.util.Event();
7917 var textEl = new Roo.Element(document.createElement('div'));
7918 textEl.dom.className = 'x-text-resize';
7919 textEl.dom.innerHTML = 'X';
7920 textEl.appendTo(document.body);
7921 textSize = textEl.dom.offsetHeight;
7922 setInterval(function(){
7923 if(textEl.dom.offsetHeight != textSize){
7924 textEvent.fire(textSize, textSize = textEl.dom.offsetHeight);
7926 }, this.textResizeInterval);
7928 textEvent.addListener(fn, scope, options);
7932 * Removes the passed window resize listener.
7933 * @param {Function} fn The method the event invokes
7934 * @param {Object} scope The scope of handler
7936 removeResizeListener : function(fn, scope){
7938 resizeEvent.removeListener(fn, scope);
7943 fireResize : function(){
7945 resizeEvent.fire(D.getViewWidth(), D.getViewHeight());
7949 * Url used for onDocumentReady with using SSL (defaults to Roo.SSL_SECURE_URL)
7953 * The frequency, in milliseconds, to check for text resize events (defaults to 50)
7955 textResizeInterval : 50
7960 * @scopeAlias pub=Roo.EventManager
7964 * Appends an event handler to an element (shorthand for addListener)
7965 * @param {String/HTMLElement} element The html element or id to assign the
7966 * @param {String} eventName The type of event to listen for
7967 * @param {Function} handler The method the event invokes
7968 * @param {Object} scope (optional) The scope in which to execute the handler
7969 * function. The handler function's "this" context.
7970 * @param {Object} options (optional) An object containing handler configuration
7971 * properties. This may contain any of the following properties:<ul>
7972 * <li>scope {Object} The scope in which to execute the handler function. The handler function's "this" context.</li>
7973 * <li>delegate {String} A simple selector to filter the target or look for a descendant of the target</li>
7974 * <li>stopEvent {Boolean} True to stop the event. That is stop propagation, and prevent the default action.</li>
7975 * <li>preventDefault {Boolean} True to prevent the default action</li>
7976 * <li>stopPropagation {Boolean} True to prevent event propagation</li>
7977 * <li>normalized {Boolean} False to pass a browser event to the handler function instead of an Roo.EventObject</li>
7978 * <li>delay {Number} The number of milliseconds to delay the invocation of the handler after te event fires.</li>
7979 * <li>single {Boolean} True to add a handler to handle just the next firing of the event, and then remove itself.</li>
7980 * <li>buffer {Number} Causes the handler to be scheduled to run in an {@link Roo.util.DelayedTask} delayed
7981 * by the specified number of milliseconds. If the event fires again within that time, the original
7982 * handler is <em>not</em> invoked, but the new handler is scheduled in its place.</li>
7985 * <b>Combining Options</b><br>
7986 * Using the options argument, it is possible to combine different types of listeners:<br>
7988 * A normalized, delayed, one-time listener that auto stops the event and passes a custom argument (forumId)<div style="margin: 5px 20px 20px;">
7990 el.on('click', this.onClick, this, {
7997 * <b>Attaching multiple handlers in 1 call</b><br>
7998 * The method also allows for a single argument to be passed which is a config object containing properties
7999 * which specify multiple handlers.
8009 fn: this.onMouseOver
8018 * Or a shorthand syntax:<br>
8021 'click' : this.onClick,
8022 'mouseover' : this.onMouseOver,
8023 'mouseout' : this.onMouseOut
8027 pub.on = pub.addListener;
8028 pub.un = pub.removeListener;
8030 pub.stoppedMouseDownEvent = new Roo.util.Event();
8034 * Fires when the document is ready (before onload and before images are loaded). Shorthand of {@link Roo.EventManager#onDocumentReady}.
8035 * @param {Function} fn The method the event invokes
8036 * @param {Object} scope An object that becomes the scope of the handler
8037 * @param {boolean} override If true, the obj passed in becomes
8038 * the execution scope of the listener
8042 Roo.onReady = Roo.EventManager.onDocumentReady;
8044 Roo.onReady(function(){
8045 var bd = Roo.get(document.body);
8050 : Roo.isIE11 ? "roo-ie11"
8051 : Roo.isEdge ? "roo-edge"
8052 : Roo.isGecko ? "roo-gecko"
8053 : Roo.isOpera ? "roo-opera"
8054 : Roo.isSafari ? "roo-safari" : ""];
8057 cls.push("roo-mac");
8060 cls.push("roo-linux");
8063 cls.push("roo-ios");
8066 cls.push("roo-touch");
8068 if(Roo.isBorderBox){
8069 cls.push('roo-border-box');
8071 if(Roo.isStrict){ // add to the parent to allow for selectors like ".ext-strict .ext-ie"
8072 var p = bd.dom.parentNode;
8074 p.className += ' roo-strict';
8077 bd.addClass(cls.join(' '));
8081 * @class Roo.EventObject
8082 * EventObject exposes the Yahoo! UI Event functionality directly on the object
8083 * passed to your event handler. It exists mostly for convenience. It also fixes the annoying null checks automatically to cleanup your code
8086 function handleClick(e){ // e is not a standard event object, it is a Roo.EventObject
8088 var target = e.getTarget();
8091 var myDiv = Roo.get("myDiv");
8092 myDiv.on("click", handleClick);
8094 Roo.EventManager.on("myDiv", 'click', handleClick);
8095 Roo.EventManager.addListener("myDiv", 'click', handleClick);
8099 Roo.EventObject = function(){
8101 var E = Roo.lib.Event;
8103 // safari keypress events for special keys return bad keycodes
8106 63235 : 39, // right
8109 63276 : 33, // page up
8110 63277 : 34, // page down
8111 63272 : 46, // delete
8116 // normalize button clicks
8117 var btnMap = Roo.isIE ? {1:0,4:1,2:2} :
8118 (Roo.isSafari ? {1:0,2:1,3:2} : {0:0,1:1,2:2});
8120 Roo.EventObjectImpl = function(e){
8122 this.setEvent(e.browserEvent || e);
8125 Roo.EventObjectImpl.prototype = {
8127 * Used to fix doc tools.
8128 * @scope Roo.EventObject.prototype
8134 /** The normal browser event */
8135 browserEvent : null,
8136 /** The button pressed in a mouse event */
8138 /** True if the shift key was down during the event */
8140 /** True if the control key was down during the event */
8142 /** True if the alt key was down during the event */
8201 setEvent : function(e){
8202 if(e == this || (e && e.browserEvent)){ // already wrapped
8205 this.browserEvent = e;
8207 // normalize buttons
8208 this.button = e.button ? btnMap[e.button] : (e.which ? e.which-1 : -1);
8209 if(e.type == 'click' && this.button == -1){
8213 this.shiftKey = e.shiftKey;
8214 // mac metaKey behaves like ctrlKey
8215 this.ctrlKey = e.ctrlKey || e.metaKey;
8216 this.altKey = e.altKey;
8217 // in getKey these will be normalized for the mac
8218 this.keyCode = e.keyCode;
8219 // keyup warnings on firefox.
8220 this.charCode = (e.type == 'keyup' || e.type == 'keydown') ? 0 : e.charCode;
8221 // cache the target for the delayed and or buffered events
8222 this.target = E.getTarget(e);
8224 this.xy = E.getXY(e);
8227 this.shiftKey = false;
8228 this.ctrlKey = false;
8229 this.altKey = false;
8239 * Stop the event (preventDefault and stopPropagation)
8241 stopEvent : function(){
8242 if(this.browserEvent){
8243 if(this.browserEvent.type == 'mousedown'){
8244 Roo.EventManager.stoppedMouseDownEvent.fire(this);
8246 E.stopEvent(this.browserEvent);
8251 * Prevents the browsers default handling of the event.
8253 preventDefault : function(){
8254 if(this.browserEvent){
8255 E.preventDefault(this.browserEvent);
8260 isNavKeyPress : function(){
8261 var k = this.keyCode;
8262 k = Roo.isSafari ? (safariKeys[k] || k) : k;
8263 return (k >= 33 && k <= 40) || k == this.RETURN || k == this.TAB || k == this.ESC;
8266 isSpecialKey : function(){
8267 var k = this.keyCode;
8268 return (this.type == 'keypress' && this.ctrlKey) || k == 9 || k == 13 || k == 40 || k == 27 ||
8269 (k == 16) || (k == 17) ||
8270 (k >= 18 && k <= 20) ||
8271 (k >= 33 && k <= 35) ||
8272 (k >= 36 && k <= 39) ||
8273 (k >= 44 && k <= 45);
8276 * Cancels bubbling of the event.
8278 stopPropagation : function(){
8279 if(this.browserEvent){
8280 if(this.type == 'mousedown'){
8281 Roo.EventManager.stoppedMouseDownEvent.fire(this);
8283 E.stopPropagation(this.browserEvent);
8288 * Gets the key code for the event.
8291 getCharCode : function(){
8292 return this.charCode || this.keyCode;
8296 * Returns a normalized keyCode for the event.
8297 * @return {Number} The key code
8299 getKey : function(){
8300 var k = this.keyCode || this.charCode;
8301 return Roo.isSafari ? (safariKeys[k] || k) : k;
8305 * Gets the x coordinate of the event.
8308 getPageX : function(){
8313 * Gets the y coordinate of the event.
8316 getPageY : function(){
8321 * Gets the time of the event.
8324 getTime : function(){
8325 if(this.browserEvent){
8326 return E.getTime(this.browserEvent);
8332 * Gets the page coordinates of the event.
8333 * @return {Array} The xy values like [x, y]
8340 * Gets the target for the event.
8341 * @param {String} selector (optional) A simple selector to filter the target or look for an ancestor of the target
8342 * @param {Number/String/HTMLElement/Element} maxDepth (optional) The max depth to
8343 search as a number or element (defaults to 10 || document.body)
8344 * @param {Boolean} returnEl (optional) True to return a Roo.Element object instead of DOM node
8345 * @return {HTMLelement}
8347 getTarget : function(selector, maxDepth, returnEl){
8348 return selector ? Roo.fly(this.target).findParent(selector, maxDepth, returnEl) : this.target;
8351 * Gets the related target.
8352 * @return {HTMLElement}
8354 getRelatedTarget : function(){
8355 if(this.browserEvent){
8356 return E.getRelatedTarget(this.browserEvent);
8362 * Normalizes mouse wheel delta across browsers
8363 * @return {Number} The delta
8365 getWheelDelta : function(){
8366 var e = this.browserEvent;
8368 if(e.wheelDelta){ /* IE/Opera. */
8369 delta = e.wheelDelta/120;
8370 }else if(e.detail){ /* Mozilla case. */
8371 delta = -e.detail/3;
8377 * Returns true if the control, meta, shift or alt key was pressed during this event.
8380 hasModifier : function(){
8381 return !!((this.ctrlKey || this.altKey) || this.shiftKey);
8385 * Returns true if the target of this event equals el or is a child of el
8386 * @param {String/HTMLElement/Element} el
8387 * @param {Boolean} related (optional) true to test if the related target is within el instead of the target
8390 within : function(el, related){
8391 var t = this[related ? "getRelatedTarget" : "getTarget"]();
8392 return t && Roo.fly(el).contains(t);
8395 getPoint : function(){
8396 return new Roo.lib.Point(this.xy[0], this.xy[1]);
8400 return new Roo.EventObjectImpl();
8405 * Ext JS Library 1.1.1
8406 * Copyright(c) 2006-2007, Ext JS, LLC.
8408 * Originally Released Under LGPL - original licence link has changed is not relivant.
8411 * <script type="text/javascript">
8415 // was in Composite Element!??!?!
8418 var D = Roo.lib.Dom;
8419 var E = Roo.lib.Event;
8420 var A = Roo.lib.Anim;
8422 // local style camelizing for speed
8424 var camelRe = /(-[a-z])/gi;
8425 var camelFn = function(m, a){ return a.charAt(1).toUpperCase(); };
8426 var view = document.defaultView;
8429 * @class Roo.Element
8430 * Represents an Element in the DOM.<br><br>
8433 var el = Roo.get("my-div");
8436 var el = getEl("my-div");
8438 // or with a DOM element
8439 var el = Roo.get(myDivElement);
8441 * Using Roo.get() or getEl() instead of calling the constructor directly ensures you get the same object
8442 * each call instead of constructing a new one.<br><br>
8443 * <b>Animations</b><br />
8444 * Many of the functions for manipulating an element have an optional "animate" parameter. The animate parameter
8445 * should either be a boolean (true) or an object literal with animation options. The animation options are:
8447 Option Default Description
8448 --------- -------- ---------------------------------------------
8449 duration .35 The duration of the animation in seconds
8450 easing easeOut The YUI easing method
8451 callback none A function to execute when the anim completes
8452 scope this The scope (this) of the callback function
8454 * Also, the Anim object being used for the animation will be set on your options object as "anim", which allows you to stop or
8455 * manipulate the animation. Here's an example:
8457 var el = Roo.get("my-div");
8462 // default animation
8463 el.setWidth(100, true);
8465 // animation with some options set
8472 // using the "anim" property to get the Anim object
8478 el.setWidth(100, opt);
8480 if(opt.anim.isAnimated()){
8484 * <b> Composite (Collections of) Elements</b><br />
8485 * For working with collections of Elements, see <a href="Roo.CompositeElement.html">Roo.CompositeElement</a>
8486 * @constructor Create a new Element directly.
8487 * @param {String/HTMLElement} element
8488 * @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).
8490 Roo.Element = function(element, forceNew)
8492 var dom = typeof element == "string" ?
8493 document.getElementById(element) : element;
8495 this.listeners = {};
8497 if(!dom){ // invalid id/element
8501 if(forceNew !== true && id && Roo.Element.cache[id]){ // element object already exists
8502 return Roo.Element.cache[id];
8512 * The DOM element ID
8515 this.id = id || Roo.id(dom);
8517 return this; // assumed for cctor?
8520 var El = Roo.Element;
8524 * The element's default display mode (defaults to "")
8527 originalDisplay : "",
8530 // note this is overridden in BS version..
8533 * The default unit to append to CSS values where a unit isn't provided (defaults to px).
8539 * Sets the element's visibility mode. When setVisible() is called it
8540 * will use this to determine whether to set the visibility or the display property.
8541 * @param visMode Element.VISIBILITY or Element.DISPLAY
8542 * @return {Roo.Element} this
8544 setVisibilityMode : function(visMode){
8545 this.visibilityMode = visMode;
8549 * Convenience method for setVisibilityMode(Element.DISPLAY)
8550 * @param {String} display (optional) What to set display to when visible
8551 * @return {Roo.Element} this
8553 enableDisplayMode : function(display){
8554 this.setVisibilityMode(El.DISPLAY);
8555 if(typeof display != "undefined") { this.originalDisplay = display; }
8560 * 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)
8561 * @param {String} selector The simple selector to test
8562 * @param {Number/String/HTMLElement/Element} maxDepth (optional) The max depth to
8563 search as a number or element (defaults to 10 || document.body)
8564 * @param {Boolean} returnEl (optional) True to return a Roo.Element object instead of DOM node
8565 * @return {HTMLElement} The matching DOM node (or null if no match was found)
8567 findParent : function(simpleSelector, maxDepth, returnEl){
8568 var p = this.dom, b = document.body, depth = 0, dq = Roo.DomQuery, stopEl;
8569 maxDepth = maxDepth || 50;
8570 if(typeof maxDepth != "number"){
8571 stopEl = Roo.getDom(maxDepth);
8574 while(p && p.nodeType == 1 && depth < maxDepth && p != b && p != stopEl){
8575 if(dq.is(p, simpleSelector)){
8576 return returnEl ? Roo.get(p) : p;
8586 * Looks at parent nodes for a match of the passed simple selector (e.g. div.some-class or span:first-child)
8587 * @param {String} selector The simple selector to test
8588 * @param {Number/String/HTMLElement/Element} maxDepth (optional) The max depth to
8589 search as a number or element (defaults to 10 || document.body)
8590 * @param {Boolean} returnEl (optional) True to return a Roo.Element object instead of DOM node
8591 * @return {HTMLElement} The matching DOM node (or null if no match was found)
8593 findParentNode : function(simpleSelector, maxDepth, returnEl){
8594 var p = Roo.fly(this.dom.parentNode, '_internal');
8595 return p ? p.findParent(simpleSelector, maxDepth, returnEl) : null;
8599 * Looks at the scrollable parent element
8601 findScrollableParent : function()
8603 var overflowRegex = /(auto|scroll)/;
8605 if(this.getStyle('position') === 'fixed'){
8606 return Roo.isAndroid ? Roo.get(document.documentElement) : Roo.get(document.body);
8609 var excludeStaticParent = this.getStyle('position') === "absolute";
8611 for (var parent = this; (parent = Roo.get(parent.dom.parentNode));){
8613 if (excludeStaticParent && parent.getStyle('position') === "static") {
8617 if (overflowRegex.test(parent.getStyle('overflow') + parent.getStyle('overflow-x') + parent.getStyle('overflow-y'))){
8621 if(parent.dom.nodeName.toLowerCase() == 'body'){
8622 return Roo.isAndroid ? Roo.get(document.documentElement) : Roo.get(document.body);
8626 return Roo.isAndroid ? Roo.get(document.documentElement) : Roo.get(document.body);
8630 * Walks up the dom looking for a parent node that matches the passed simple selector (e.g. div.some-class or span:first-child).
8631 * This is a shortcut for findParentNode() that always returns an Roo.Element.
8632 * @param {String} selector The simple selector to test
8633 * @param {Number/String/HTMLElement/Element} maxDepth (optional) The max depth to
8634 search as a number or element (defaults to 10 || document.body)
8635 * @return {Roo.Element} The matching DOM node (or null if no match was found)
8637 up : function(simpleSelector, maxDepth){
8638 return this.findParentNode(simpleSelector, maxDepth, true);
8644 * Returns true if this element matches the passed simple selector (e.g. div.some-class or span:first-child)
8645 * @param {String} selector The simple selector to test
8646 * @return {Boolean} True if this element matches the selector, else false
8648 is : function(simpleSelector){
8649 return Roo.DomQuery.is(this.dom, simpleSelector);
8653 * Perform animation on this element.
8654 * @param {Object} args The YUI animation control args
8655 * @param {Float} duration (optional) How long the animation lasts in seconds (defaults to .35)
8656 * @param {Function} onComplete (optional) Function to call when animation completes
8657 * @param {String} easing (optional) Easing method to use (defaults to 'easeOut')
8658 * @param {String} animType (optional) 'run' is the default. Can also be 'color', 'motion', or 'scroll'
8659 * @return {Roo.Element} this
8661 animate : function(args, duration, onComplete, easing, animType){
8662 this.anim(args, {duration: duration, callback: onComplete, easing: easing}, animType);
8667 * @private Internal animation call
8669 anim : function(args, opt, animType, defaultDur, defaultEase, cb){
8670 animType = animType || 'run';
8672 var anim = Roo.lib.Anim[animType](
8674 (opt.duration || defaultDur) || .35,
8675 (opt.easing || defaultEase) || 'easeOut',
8677 Roo.callback(cb, this);
8678 Roo.callback(opt.callback, opt.scope || this, [this, opt]);
8686 // private legacy anim prep
8687 preanim : function(a, i){
8688 return !a[i] ? false : (typeof a[i] == "object" ? a[i]: {duration: a[i+1], callback: a[i+2], easing: a[i+3]});
8692 * Removes worthless text nodes
8693 * @param {Boolean} forceReclean (optional) By default the element
8694 * keeps track if it has been cleaned already so
8695 * you can call this over and over. However, if you update the element and
8696 * need to force a reclean, you can pass true.
8698 clean : function(forceReclean){
8699 if(this.isCleaned && forceReclean !== true){
8703 var d = this.dom, n = d.firstChild, ni = -1;
8705 var nx = n.nextSibling;
8706 if(n.nodeType == 3 && !ns.test(n.nodeValue)){
8713 this.isCleaned = true;
8718 calcOffsetsTo : function(el){
8721 var restorePos = false;
8722 if(el.getStyle('position') == 'static'){
8723 el.position('relative');
8728 while(op && op != d && op.tagName != 'HTML'){
8731 op = op.offsetParent;
8734 el.position('static');
8740 * Scrolls this element into view within the passed container.
8741 * @param {String/HTMLElement/Element} container (optional) The container element to scroll (defaults to document.body)
8742 * @param {Boolean} hscroll (optional) False to disable horizontal scroll (defaults to true)
8743 * @return {Roo.Element} this
8745 scrollIntoView : function(container, hscroll){
8746 var c = Roo.getDom(container) || document.body;
8749 var o = this.calcOffsetsTo(c),
8752 b = t+el.offsetHeight,
8753 r = l+el.offsetWidth;
8755 var ch = c.clientHeight;
8756 var ct = parseInt(c.scrollTop, 10);
8757 var cl = parseInt(c.scrollLeft, 10);
8759 var cr = cl + c.clientWidth;
8767 if(hscroll !== false){
8771 c.scrollLeft = r-c.clientWidth;
8778 scrollChildIntoView : function(child, hscroll){
8779 Roo.fly(child, '_scrollChildIntoView').scrollIntoView(this, hscroll);
8783 * Measures the element's content height and updates height to match. Note: this function uses setTimeout so
8784 * the new height may not be available immediately.
8785 * @param {Boolean} animate (optional) Animate the transition (defaults to false)
8786 * @param {Float} duration (optional) Length of the animation in seconds (defaults to .35)
8787 * @param {Function} onComplete (optional) Function to call when animation completes
8788 * @param {String} easing (optional) Easing method to use (defaults to easeOut)
8789 * @return {Roo.Element} this
8791 autoHeight : function(animate, duration, onComplete, easing){
8792 var oldHeight = this.getHeight();
8794 this.setHeight(1); // force clipping
8795 setTimeout(function(){
8796 var height = parseInt(this.dom.scrollHeight, 10); // parseInt for Safari
8798 this.setHeight(height);
8800 if(typeof onComplete == "function"){
8804 this.setHeight(oldHeight); // restore original height
8805 this.setHeight(height, animate, duration, function(){
8807 if(typeof onComplete == "function") { onComplete(); }
8808 }.createDelegate(this), easing);
8810 }.createDelegate(this), 0);
8815 * Returns true if this element is an ancestor of the passed element
8816 * @param {HTMLElement/String} el The element to check
8817 * @return {Boolean} True if this element is an ancestor of el, else false
8819 contains : function(el){
8820 if(!el){return false;}
8821 return D.isAncestor(this.dom, el.dom ? el.dom : el);
8825 * Checks whether the element is currently visible using both visibility and display properties.
8826 * @param {Boolean} deep (optional) True to walk the dom and see if parent elements are hidden (defaults to false)
8827 * @return {Boolean} True if the element is currently visible, else false
8829 isVisible : function(deep) {
8830 var vis = !(this.getStyle("visibility") == "hidden" || this.getStyle("display") == "none");
8831 if(deep !== true || !vis){
8834 var p = this.dom.parentNode;
8835 while(p && p.tagName.toLowerCase() != "body"){
8836 if(!Roo.fly(p, '_isVisible').isVisible()){
8845 * Creates a {@link Roo.CompositeElement} for child nodes based on the passed CSS selector (the selector should not contain an id).
8846 * @param {String} selector The CSS selector
8847 * @param {Boolean} unique (optional) True to create a unique Roo.Element for each child (defaults to false, which creates a single shared flyweight object)
8848 * @return {CompositeElement/CompositeElementLite} The composite element
8850 select : function(selector, unique){
8851 return El.select(selector, unique, this.dom);
8855 * Selects child nodes based on the passed CSS selector (the selector should not contain an id).
8856 * @param {String} selector The CSS selector
8857 * @return {Array} An array of the matched nodes
8859 query : function(selector, unique){
8860 return Roo.DomQuery.select(selector, this.dom);
8864 * Selects a single child at any depth below this element based on the passed CSS selector (the selector should not contain an id).
8865 * @param {String} selector The CSS selector
8866 * @param {Boolean} returnDom (optional) True to return the DOM node instead of Roo.Element (defaults to false)
8867 * @return {HTMLElement/Roo.Element} The child Roo.Element (or DOM node if returnDom = true)
8869 child : function(selector, returnDom){
8870 var n = Roo.DomQuery.selectNode(selector, this.dom);
8871 return returnDom ? n : Roo.get(n);
8875 * Selects a single *direct* child based on the passed CSS selector (the selector should not contain an id).
8876 * @param {String} selector The CSS selector
8877 * @param {Boolean} returnDom (optional) True to return the DOM node instead of Roo.Element (defaults to false)
8878 * @return {HTMLElement/Roo.Element} The child Roo.Element (or DOM node if returnDom = true)
8880 down : function(selector, returnDom){
8881 var n = Roo.DomQuery.selectNode(" > " + selector, this.dom);
8882 return returnDom ? n : Roo.get(n);
8886 * Initializes a {@link Roo.dd.DD} drag drop object for this element.
8887 * @param {String} group The group the DD object is member of
8888 * @param {Object} config The DD config object
8889 * @param {Object} overrides An object containing methods to override/implement on the DD object
8890 * @return {Roo.dd.DD} The DD object
8892 initDD : function(group, config, overrides){
8893 var dd = new Roo.dd.DD(Roo.id(this.dom), group, config);
8894 return Roo.apply(dd, overrides);
8898 * Initializes a {@link Roo.dd.DDProxy} object for this element.
8899 * @param {String} group The group the DDProxy object is member of
8900 * @param {Object} config The DDProxy config object
8901 * @param {Object} overrides An object containing methods to override/implement on the DDProxy object
8902 * @return {Roo.dd.DDProxy} The DDProxy object
8904 initDDProxy : function(group, config, overrides){
8905 var dd = new Roo.dd.DDProxy(Roo.id(this.dom), group, config);
8906 return Roo.apply(dd, overrides);
8910 * Initializes a {@link Roo.dd.DDTarget} object for this element.
8911 * @param {String} group The group the DDTarget object is member of
8912 * @param {Object} config The DDTarget config object
8913 * @param {Object} overrides An object containing methods to override/implement on the DDTarget object
8914 * @return {Roo.dd.DDTarget} The DDTarget object
8916 initDDTarget : function(group, config, overrides){
8917 var dd = new Roo.dd.DDTarget(Roo.id(this.dom), group, config);
8918 return Roo.apply(dd, overrides);
8922 * Sets the visibility of the element (see details). If the visibilityMode is set to Element.DISPLAY, it will use
8923 * the display property to hide the element, otherwise it uses visibility. The default is to hide and show using the visibility property.
8924 * @param {Boolean} visible Whether the element is visible
8925 * @param {Boolean/Object} animate (optional) True for the default animation, or a standard Element animation config object
8926 * @return {Roo.Element} this
8928 setVisible : function(visible, animate){
8930 if(this.visibilityMode == El.DISPLAY){
8931 this.setDisplayed(visible);
8934 this.dom.style.visibility = visible ? "visible" : "hidden";
8937 // closure for composites
8939 var visMode = this.visibilityMode;
8941 this.setOpacity(.01);
8942 this.setVisible(true);
8944 this.anim({opacity: { to: (visible?1:0) }},
8945 this.preanim(arguments, 1),
8946 null, .35, 'easeIn', function(){
8948 if(visMode == El.DISPLAY){
8949 dom.style.display = "none";
8951 dom.style.visibility = "hidden";
8953 Roo.get(dom).setOpacity(1);
8961 * Returns true if display is not "none"
8964 isDisplayed : function() {
8965 return this.getStyle("display") != "none";
8969 * Toggles the element's visibility or display, depending on visibility mode.
8970 * @param {Boolean/Object} animate (optional) True for the default animation, or a standard Element animation config object
8971 * @return {Roo.Element} this
8973 toggle : function(animate){
8974 this.setVisible(!this.isVisible(), this.preanim(arguments, 0));
8979 * Sets the CSS display property. Uses originalDisplay if the specified value is a boolean true.
8980 * @param {Boolean} value Boolean value to display the element using its default display, or a string to set the display directly
8981 * @return {Roo.Element} this
8983 setDisplayed : function(value) {
8984 if(typeof value == "boolean"){
8985 value = value ? this.originalDisplay : "none";
8987 this.setStyle("display", value);
8992 * Tries to focus the element. Any exceptions are caught and ignored.
8993 * @return {Roo.Element} this
8995 focus : function() {
9003 * Tries to blur the element. Any exceptions are caught and ignored.
9004 * @return {Roo.Element} this
9014 * Adds one or more CSS classes to the element. Duplicate classes are automatically filtered out.
9015 * @param {String/Array} className The CSS class to add, or an array of classes
9016 * @return {Roo.Element} this
9018 addClass : function(className){
9019 if(className instanceof Array){
9020 for(var i = 0, len = className.length; i < len; i++) {
9021 this.addClass(className[i]);
9024 if(className && !this.hasClass(className)){
9025 if (this.dom instanceof SVGElement) {
9026 this.dom.className.baseVal =this.dom.className.baseVal + " " + className;
9028 this.dom.className = this.dom.className + " " + className;
9036 * Adds one or more CSS classes to this element and removes the same class(es) from all siblings.
9037 * @param {String/Array} className The CSS class to add, or an array of classes
9038 * @return {Roo.Element} this
9040 radioClass : function(className){
9041 var siblings = this.dom.parentNode.childNodes;
9042 for(var i = 0; i < siblings.length; i++) {
9043 var s = siblings[i];
9044 if(s.nodeType == 1){
9045 Roo.get(s).removeClass(className);
9048 this.addClass(className);
9053 * Removes one or more CSS classes from the element.
9054 * @param {String/Array} className The CSS class to remove, or an array of classes
9055 * @return {Roo.Element} this
9057 removeClass : function(className){
9059 var cn = this.dom instanceof SVGElement ? this.dom.className.baseVal : this.dom.className;
9060 if(!className || !cn){
9063 if(className instanceof Array){
9064 for(var i = 0, len = className.length; i < len; i++) {
9065 this.removeClass(className[i]);
9068 if(this.hasClass(className)){
9069 var re = this.classReCache[className];
9071 re = new RegExp('(?:^|\\s+)' + className + '(?:\\s+|$)', "g");
9072 this.classReCache[className] = re;
9074 if (this.dom instanceof SVGElement) {
9075 this.dom.className.baseVal = cn.replace(re, " ");
9077 this.dom.className = cn.replace(re, " ");
9088 * Toggles the specified CSS class on this element (removes it if it already exists, otherwise adds it).
9089 * @param {String} className The CSS class to toggle
9090 * @return {Roo.Element} this
9092 toggleClass : function(className){
9093 if(this.hasClass(className)){
9094 this.removeClass(className);
9096 this.addClass(className);
9102 * Checks if the specified CSS class exists on this element's DOM node.
9103 * @param {String} className The CSS class to check for
9104 * @return {Boolean} True if the class exists, else false
9106 hasClass : function(className){
9107 if (this.dom instanceof SVGElement) {
9108 return className && (' '+this.dom.className.baseVal +' ').indexOf(' '+className+' ') != -1;
9110 return className && (' '+this.dom.className+' ').indexOf(' '+className+' ') != -1;
9114 * Replaces a CSS class on the element with another. If the old name does not exist, the new name will simply be added.
9115 * @param {String} oldClassName The CSS class to replace
9116 * @param {String} newClassName The replacement CSS class
9117 * @return {Roo.Element} this
9119 replaceClass : function(oldClassName, newClassName){
9120 this.removeClass(oldClassName);
9121 this.addClass(newClassName);
9126 * Returns an object with properties matching the styles requested.
9127 * For example, el.getStyles('color', 'font-size', 'width') might return
9128 * {'color': '#FFFFFF', 'font-size': '13px', 'width': '100px'}.
9129 * @param {String} style1 A style name
9130 * @param {String} style2 A style name
9131 * @param {String} etc.
9132 * @return {Object} The style object
9134 getStyles : function(){
9135 var a = arguments, len = a.length, r = {};
9136 for(var i = 0; i < len; i++){
9137 r[a[i]] = this.getStyle(a[i]);
9143 * Normalizes currentStyle and computedStyle. This is not YUI getStyle, it is an optimised version.
9144 * @param {String} property The style property whose value is returned.
9145 * @return {String} The current value of the style property for this element.
9147 getStyle : function(){
9148 return view && view.getComputedStyle ?
9150 var el = this.dom, v, cs, camel;
9151 if(prop == 'float'){
9154 if(el.style && (v = el.style[prop])){
9157 if(cs = view.getComputedStyle(el, "")){
9158 if(!(camel = propCache[prop])){
9159 camel = propCache[prop] = prop.replace(camelRe, camelFn);
9166 var el = this.dom, v, cs, camel;
9167 if(prop == 'opacity'){
9168 if(typeof el.style.filter == 'string'){
9169 var m = el.style.filter.match(/alpha\(opacity=(.*)\)/i);
9171 var fv = parseFloat(m[1]);
9173 return fv ? fv / 100 : 0;
9178 }else if(prop == 'float'){
9179 prop = "styleFloat";
9181 if(!(camel = propCache[prop])){
9182 camel = propCache[prop] = prop.replace(camelRe, camelFn);
9184 if(v = el.style[camel]){
9187 if(cs = el.currentStyle){
9195 * Wrapper for setting style properties, also takes single object parameter of multiple styles.
9196 * @param {String/Object} property The style property to be set, or an object of multiple styles.
9197 * @param {String} value (optional) The value to apply to the given property, or null if an object was passed.
9198 * @return {Roo.Element} this
9200 setStyle : function(prop, value){
9201 if(typeof prop == "string"){
9203 if (prop == 'float') {
9204 this.setStyle(Roo.isIE ? 'styleFloat' : 'cssFloat', value);
9209 if(!(camel = propCache[prop])){
9210 camel = propCache[prop] = prop.replace(camelRe, camelFn);
9213 if(camel == 'opacity') {
9214 this.setOpacity(value);
9216 this.dom.style[camel] = value;
9219 for(var style in prop){
9220 if(typeof prop[style] != "function"){
9221 this.setStyle(style, prop[style]);
9229 * More flexible version of {@link #setStyle} for setting style properties.
9230 * @param {String/Object/Function} styles A style specification string, e.g. "width:100px", or object in the form {width:"100px"}, or
9231 * a function which returns such a specification.
9232 * @return {Roo.Element} this
9234 applyStyles : function(style){
9235 Roo.DomHelper.applyStyles(this.dom, style);
9240 * 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).
9241 * @return {Number} The X position of the element
9244 return D.getX(this.dom);
9248 * 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).
9249 * @return {Number} The Y position of the element
9252 return D.getY(this.dom);
9256 * 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).
9257 * @return {Array} The XY position of the element
9260 return D.getXY(this.dom);
9264 * 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).
9265 * @param {Number} The X position of the element
9266 * @param {Boolean/Object} animate (optional) True for the default animation, or a standard Element animation config object
9267 * @return {Roo.Element} this
9269 setX : function(x, animate){
9271 D.setX(this.dom, x);
9273 this.setXY([x, this.getY()], this.preanim(arguments, 1));
9279 * 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).
9280 * @param {Number} The Y position of the element
9281 * @param {Boolean/Object} animate (optional) True for the default animation, or a standard Element animation config object
9282 * @return {Roo.Element} this
9284 setY : function(y, animate){
9286 D.setY(this.dom, y);
9288 this.setXY([this.getX(), y], this.preanim(arguments, 1));
9294 * Sets the element's left position directly using CSS style (instead of {@link #setX}).
9295 * @param {String} left The left CSS property value
9296 * @return {Roo.Element} this
9298 setLeft : function(left){
9299 this.setStyle("left", this.addUnits(left));
9304 * Sets the element's top position directly using CSS style (instead of {@link #setY}).
9305 * @param {String} top The top CSS property value
9306 * @return {Roo.Element} this
9308 setTop : function(top){
9309 this.setStyle("top", this.addUnits(top));
9314 * Sets the element's CSS right style.
9315 * @param {String} right The right CSS property value
9316 * @return {Roo.Element} this
9318 setRight : function(right){
9319 this.setStyle("right", this.addUnits(right));
9324 * Sets the element's CSS bottom style.
9325 * @param {String} bottom The bottom CSS property value
9326 * @return {Roo.Element} this
9328 setBottom : function(bottom){
9329 this.setStyle("bottom", this.addUnits(bottom));
9334 * Sets the position of the element in page coordinates, regardless of how the element is positioned.
9335 * The element must be part of the DOM tree to have page coordinates (display:none or elements not appended return false).
9336 * @param {Array} pos Contains X & Y [x, y] values for new position (coordinates are page-based)
9337 * @param {Boolean/Object} animate (optional) True for the default animation, or a standard Element animation config object
9338 * @return {Roo.Element} this
9340 setXY : function(pos, animate){
9342 D.setXY(this.dom, pos);
9344 this.anim({points: {to: pos}}, this.preanim(arguments, 1), 'motion');
9350 * Sets the position of the element in page coordinates, regardless of how the element is positioned.
9351 * The element must be part of the DOM tree to have page coordinates (display:none or elements not appended return false).
9352 * @param {Number} x X value for new position (coordinates are page-based)
9353 * @param {Number} y Y value for new position (coordinates are page-based)
9354 * @param {Boolean/Object} animate (optional) True for the default animation, or a standard Element animation config object
9355 * @return {Roo.Element} this
9357 setLocation : function(x, y, animate){
9358 this.setXY([x, y], this.preanim(arguments, 2));
9363 * Sets the position of the element in page coordinates, regardless of how the element is positioned.
9364 * The element must be part of the DOM tree to have page coordinates (display:none or elements not appended return false).
9365 * @param {Number} x X value for new position (coordinates are page-based)
9366 * @param {Number} y Y value for new position (coordinates are page-based)
9367 * @param {Boolean/Object} animate (optional) True for the default animation, or a standard Element animation config object
9368 * @return {Roo.Element} this
9370 moveTo : function(x, y, animate){
9371 this.setXY([x, y], this.preanim(arguments, 2));
9376 * Returns the region of the given element.
9377 * The element must be part of the DOM tree to have a region (display:none or elements not appended return false).
9378 * @return {Region} A Roo.lib.Region containing "top, left, bottom, right" member data.
9380 getRegion : function(){
9381 return D.getRegion(this.dom);
9385 * Returns the offset height of the element
9386 * @param {Boolean} contentHeight (optional) true to get the height minus borders and padding
9387 * @return {Number} The element's height
9389 getHeight : function(contentHeight){
9390 var h = this.dom.offsetHeight || 0;
9391 return contentHeight !== true ? h : h-this.getBorderWidth("tb")-this.getPadding("tb");
9395 * Returns the offset width of the element
9396 * @param {Boolean} contentWidth (optional) true to get the width minus borders and padding
9397 * @return {Number} The element's width
9399 getWidth : function(contentWidth){
9400 var w = this.dom.offsetWidth || 0;
9401 return contentWidth !== true ? w : w-this.getBorderWidth("lr")-this.getPadding("lr");
9405 * Returns either the offsetHeight or the height of this element based on CSS height adjusted by padding or borders
9406 * when needed to simulate offsetHeight when offsets aren't available. This may not work on display:none elements
9407 * if a height has not been set using CSS.
9410 getComputedHeight : function(){
9411 var h = Math.max(this.dom.offsetHeight, this.dom.clientHeight);
9413 h = parseInt(this.getStyle('height'), 10) || 0;
9414 if(!this.isBorderBox()){
9415 h += this.getFrameWidth('tb');
9422 * Returns either the offsetWidth or the width of this element based on CSS width adjusted by padding or borders
9423 * when needed to simulate offsetWidth when offsets aren't available. This may not work on display:none elements
9424 * if a width has not been set using CSS.
9427 getComputedWidth : function(){
9428 var w = Math.max(this.dom.offsetWidth, this.dom.clientWidth);
9430 w = parseInt(this.getStyle('width'), 10) || 0;
9431 if(!this.isBorderBox()){
9432 w += this.getFrameWidth('lr');
9439 * Returns the size of the element.
9440 * @param {Boolean} contentSize (optional) true to get the width/size minus borders and padding
9441 * @return {Object} An object containing the element's size {width: (element width), height: (element height)}
9443 getSize : function(contentSize){
9444 return {width: this.getWidth(contentSize), height: this.getHeight(contentSize)};
9448 * Returns the width and height of the viewport.
9449 * @return {Object} An object containing the viewport's size {width: (viewport width), height: (viewport height)}
9451 getViewSize : function(){
9452 var d = this.dom, doc = document, aw = 0, ah = 0;
9453 if(d == doc || d == doc.body){
9454 return {width : D.getViewWidth(), height: D.getViewHeight()};
9457 width : d.clientWidth,
9458 height: d.clientHeight
9464 * Returns the value of the "value" attribute
9465 * @param {Boolean} asNumber true to parse the value as a number
9466 * @return {String/Number}
9468 getValue : function(asNumber){
9469 return asNumber ? parseInt(this.dom.value, 10) : this.dom.value;
9473 adjustWidth : function(width){
9474 if(typeof width == "number"){
9475 if(this.autoBoxAdjust && !this.isBorderBox()){
9476 width -= (this.getBorderWidth("lr") + this.getPadding("lr"));
9486 adjustHeight : function(height){
9487 if(typeof height == "number"){
9488 if(this.autoBoxAdjust && !this.isBorderBox()){
9489 height -= (this.getBorderWidth("tb") + this.getPadding("tb"));
9499 * Set the width of the element
9500 * @param {Number} width The new width
9501 * @param {Boolean/Object} animate (optional) true for the default animation or a standard Element animation config object
9502 * @return {Roo.Element} this
9504 setWidth : function(width, animate){
9505 width = this.adjustWidth(width);
9507 this.dom.style.width = this.addUnits(width);
9509 this.anim({width: {to: width}}, this.preanim(arguments, 1));
9515 * Set the height of the element
9516 * @param {Number} height The new height
9517 * @param {Boolean/Object} animate (optional) true for the default animation or a standard Element animation config object
9518 * @return {Roo.Element} this
9520 setHeight : function(height, animate){
9521 height = this.adjustHeight(height);
9523 this.dom.style.height = this.addUnits(height);
9525 this.anim({height: {to: height}}, this.preanim(arguments, 1));
9531 * Set the size of the element. If animation is true, both width an height will be animated concurrently.
9532 * @param {Number} width The new width
9533 * @param {Number} height The new height
9534 * @param {Boolean/Object} animate (optional) true for the default animation or a standard Element animation config object
9535 * @return {Roo.Element} this
9537 setSize : function(width, height, animate){
9538 if(typeof width == "object"){ // in case of object from getSize()
9539 height = width.height; width = width.width;
9541 width = this.adjustWidth(width); height = this.adjustHeight(height);
9543 this.dom.style.width = this.addUnits(width);
9544 this.dom.style.height = this.addUnits(height);
9546 this.anim({width: {to: width}, height: {to: height}}, this.preanim(arguments, 2));
9552 * Sets the element's position and size in one shot. If animation is true then width, height, x and y will be animated concurrently.
9553 * @param {Number} x X value for new position (coordinates are page-based)
9554 * @param {Number} y Y value for new position (coordinates are page-based)
9555 * @param {Number} width The new width
9556 * @param {Number} height The new height
9557 * @param {Boolean/Object} animate (optional) true for the default animation or a standard Element animation config object
9558 * @return {Roo.Element} this
9560 setBounds : function(x, y, width, height, animate){
9562 this.setSize(width, height);
9563 this.setLocation(x, y);
9565 width = this.adjustWidth(width); height = this.adjustHeight(height);
9566 this.anim({points: {to: [x, y]}, width: {to: width}, height: {to: height}},
9567 this.preanim(arguments, 4), 'motion');
9573 * 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.
9574 * @param {Roo.lib.Region} region The region to fill
9575 * @param {Boolean/Object} animate (optional) true for the default animation or a standard Element animation config object
9576 * @return {Roo.Element} this
9578 setRegion : function(region, animate){
9579 this.setBounds(region.left, region.top, region.right-region.left, region.bottom-region.top, this.preanim(arguments, 1));
9584 * Appends an event handler
9586 * @param {String} eventName The type of event to append
9587 * @param {Function} fn The method the event invokes
9588 * @param {Object} scope (optional) The scope (this object) of the fn
9589 * @param {Object} options (optional)An object with standard {@link Roo.EventManager#addListener} options
9591 addListener : function(eventName, fn, scope, options)
9593 if (eventName == 'dblclick') { // doublclick (touchstart) - faked on touch.
9594 this.addListener('touchstart', this.onTapHandler, this);
9597 // we need to handle a special case where dom element is a svg element.
9598 // in this case we do not actua
9603 if (this.dom instanceof SVGElement && !(this.dom instanceof SVGSVGElement)) {
9604 if (typeof(this.listeners[eventName]) == 'undefined') {
9605 this.listeners[eventName] = new Roo.util.Event(this, eventName);
9607 this.listeners[eventName].addListener(fn, scope, options);
9612 Roo.EventManager.on(this.dom, eventName, fn, scope || this, options);
9617 onTapHandler : function(event)
9619 if(!this.tapedTwice) {
9620 this.tapedTwice = true;
9622 setTimeout( function() {
9623 s.tapedTwice = false;
9627 event.preventDefault();
9628 var revent = new MouseEvent('dblclick', {
9634 this.dom.dispatchEvent(revent);
9635 //action on double tap goes below
9640 * Removes an event handler from this element
9641 * @param {String} eventName the type of event to remove
9642 * @param {Function} fn the method the event invokes
9643 * @param {Function} scope (needed for svg fake listeners)
9644 * @return {Roo.Element} this
9646 removeListener : function(eventName, fn, scope){
9647 Roo.EventManager.removeListener(this.dom, eventName, fn);
9648 if (typeof(this.listeners) == 'undefined' || typeof(this.listeners[eventName]) == 'undefined') {
9651 this.listeners[eventName].removeListener(fn, scope);
9656 * Removes all previous added listeners from this element
9657 * @return {Roo.Element} this
9659 removeAllListeners : function(){
9660 E.purgeElement(this.dom);
9661 this.listeners = {};
9665 relayEvent : function(eventName, observable){
9666 this.on(eventName, function(e){
9667 observable.fireEvent(eventName, e);
9673 * Set the opacity of the element
9674 * @param {Float} opacity The new opacity. 0 = transparent, .5 = 50% visibile, 1 = fully visible, etc
9675 * @param {Boolean/Object} animate (optional) true for the default animation or a standard Element animation config object
9676 * @return {Roo.Element} this
9678 setOpacity : function(opacity, animate){
9680 var s = this.dom.style;
9683 s.filter = (s.filter || '').replace(/alpha\([^\)]*\)/gi,"") +
9684 (opacity == 1 ? "" : "alpha(opacity=" + opacity * 100 + ")");
9686 s.opacity = opacity;
9689 this.anim({opacity: {to: opacity}}, this.preanim(arguments, 1), null, .35, 'easeIn');
9695 * Gets the left X coordinate
9696 * @param {Boolean} local True to get the local css position instead of page coordinate
9699 getLeft : function(local){
9703 return parseInt(this.getStyle("left"), 10) || 0;
9708 * Gets the right X coordinate of the element (element X position + element width)
9709 * @param {Boolean} local True to get the local css position instead of page coordinate
9712 getRight : function(local){
9714 return this.getX() + this.getWidth();
9716 return (this.getLeft(true) + this.getWidth()) || 0;
9721 * Gets the top Y coordinate
9722 * @param {Boolean} local True to get the local css position instead of page coordinate
9725 getTop : function(local) {
9729 return parseInt(this.getStyle("top"), 10) || 0;
9734 * Gets the bottom Y coordinate of the element (element Y position + element height)
9735 * @param {Boolean} local True to get the local css position instead of page coordinate
9738 getBottom : function(local){
9740 return this.getY() + this.getHeight();
9742 return (this.getTop(true) + this.getHeight()) || 0;
9747 * Initializes positioning on this element. If a desired position is not passed, it will make the
9748 * the element positioned relative IF it is not already positioned.
9749 * @param {String} pos (optional) Positioning to use "relative", "absolute" or "fixed"
9750 * @param {Number} zIndex (optional) The zIndex to apply
9751 * @param {Number} x (optional) Set the page X position
9752 * @param {Number} y (optional) Set the page Y position
9754 position : function(pos, zIndex, x, y){
9756 if(this.getStyle('position') == 'static'){
9757 this.setStyle('position', 'relative');
9760 this.setStyle("position", pos);
9763 this.setStyle("z-index", zIndex);
9765 if(x !== undefined && y !== undefined){
9767 }else if(x !== undefined){
9769 }else if(y !== undefined){
9775 * Clear positioning back to the default when the document was loaded
9776 * @param {String} value (optional) The value to use for the left,right,top,bottom, defaults to '' (empty string). You could use 'auto'.
9777 * @return {Roo.Element} this
9779 clearPositioning : function(value){
9787 "position" : "static"
9793 * Gets an object with all CSS positioning properties. Useful along with setPostioning to get
9794 * snapshot before performing an update and then restoring the element.
9797 getPositioning : function(){
9798 var l = this.getStyle("left");
9799 var t = this.getStyle("top");
9801 "position" : this.getStyle("position"),
9803 "right" : l ? "" : this.getStyle("right"),
9805 "bottom" : t ? "" : this.getStyle("bottom"),
9806 "z-index" : this.getStyle("z-index")
9811 * Gets the width of the border(s) for the specified side(s)
9812 * @param {String} side Can be t, l, r, b or any combination of those to add multiple values. For example,
9813 * passing lr would get the border (l)eft width + the border (r)ight width.
9814 * @return {Number} The width of the sides passed added together
9816 getBorderWidth : function(side){
9817 return this.addStyles(side, El.borders);
9821 * Gets the width of the padding(s) for the specified side(s)
9822 * @param {String} side Can be t, l, r, b or any combination of those to add multiple values. For example,
9823 * passing lr would get the padding (l)eft + the padding (r)ight.
9824 * @return {Number} The padding of the sides passed added together
9826 getPadding : function(side){
9827 return this.addStyles(side, El.paddings);
9831 * Set positioning with an object returned by getPositioning().
9832 * @param {Object} posCfg
9833 * @return {Roo.Element} this
9835 setPositioning : function(pc){
9836 this.applyStyles(pc);
9837 if(pc.right == "auto"){
9838 this.dom.style.right = "";
9840 if(pc.bottom == "auto"){
9841 this.dom.style.bottom = "";
9847 fixDisplay : function(){
9848 if(this.getStyle("display") == "none"){
9849 this.setStyle("visibility", "hidden");
9850 this.setStyle("display", this.originalDisplay); // first try reverting to default
9851 if(this.getStyle("display") == "none"){ // if that fails, default to block
9852 this.setStyle("display", "block");
9858 * Quick set left and top adding default units
9859 * @param {String} left The left CSS property value
9860 * @param {String} top The top CSS property value
9861 * @return {Roo.Element} this
9863 setLeftTop : function(left, top){
9864 this.dom.style.left = this.addUnits(left);
9865 this.dom.style.top = this.addUnits(top);
9870 * Move this element relative to its current position.
9871 * @param {String} direction Possible values are: "l","left" - "r","right" - "t","top","up" - "b","bottom","down".
9872 * @param {Number} distance How far to move the element in pixels
9873 * @param {Boolean/Object} animate (optional) true for the default animation or a standard Element animation config object
9874 * @return {Roo.Element} this
9876 move : function(direction, distance, animate){
9877 var xy = this.getXY();
9878 direction = direction.toLowerCase();
9882 this.moveTo(xy[0]-distance, xy[1], this.preanim(arguments, 2));
9886 this.moveTo(xy[0]+distance, xy[1], this.preanim(arguments, 2));
9891 this.moveTo(xy[0], xy[1]-distance, this.preanim(arguments, 2));
9896 this.moveTo(xy[0], xy[1]+distance, this.preanim(arguments, 2));
9903 * Store the current overflow setting and clip overflow on the element - use {@link #unclip} to remove
9904 * @return {Roo.Element} this
9907 if(!this.isClipped){
9908 this.isClipped = true;
9909 this.originalClip = {
9910 "o": this.getStyle("overflow"),
9911 "x": this.getStyle("overflow-x"),
9912 "y": this.getStyle("overflow-y")
9914 this.setStyle("overflow", "hidden");
9915 this.setStyle("overflow-x", "hidden");
9916 this.setStyle("overflow-y", "hidden");
9922 * Return clipping (overflow) to original clipping before clip() was called
9923 * @return {Roo.Element} this
9925 unclip : function(){
9927 this.isClipped = false;
9928 var o = this.originalClip;
9929 if(o.o){this.setStyle("overflow", o.o);}
9930 if(o.x){this.setStyle("overflow-x", o.x);}
9931 if(o.y){this.setStyle("overflow-y", o.y);}
9938 * Gets the x,y coordinates specified by the anchor position on the element.
9939 * @param {String} anchor (optional) The specified anchor position (defaults to "c"). See {@link #alignTo} for details on supported anchor positions.
9940 * @param {Object} size (optional) An object containing the size to use for calculating anchor position
9941 * {width: (target width), height: (target height)} (defaults to the element's current size)
9942 * @param {Boolean} local (optional) True to get the local (element top/left-relative) anchor position instead of page coordinates
9943 * @return {Array} [x, y] An array containing the element's x and y coordinates
9945 getAnchorXY : function(anchor, local, s){
9946 //Passing a different size is useful for pre-calculating anchors,
9947 //especially for anchored animations that change the el size.
9949 var w, h, vp = false;
9952 if(d == document.body || d == document){
9954 w = D.getViewWidth(); h = D.getViewHeight();
9956 w = this.getWidth(); h = this.getHeight();
9959 w = s.width; h = s.height;
9961 var x = 0, y = 0, r = Math.round;
9962 switch((anchor || "tl").toLowerCase()){
10000 if(local === true){
10004 var sc = this.getScroll();
10005 return [x + sc.left, y + sc.top];
10007 //Add the element's offset xy
10008 var o = this.getXY();
10009 return [x+o[0], y+o[1]];
10013 * Gets the x,y coordinates to align this element with another element. See {@link #alignTo} for more info on the
10014 * supported position values.
10015 * @param {String/HTMLElement/Roo.Element} element The element to align to.
10016 * @param {String} position The position to align to.
10017 * @param {Array} offsets (optional) Offset the positioning by [x, y]
10018 * @return {Array} [x, y]
10020 getAlignToXY : function(el, p, o)
10025 throw "Element.alignTo with an element that doesn't exist";
10027 var c = false; //constrain to viewport
10028 var p1 = "", p2 = "";
10033 }else if(p == "?"){
10035 }else if(p.indexOf("-") == -1){
10038 p = p.toLowerCase();
10039 var m = p.match(/^([a-z]+)-([a-z]+)(\?)?$/);
10041 throw "Element.alignTo with an invalid alignment " + p;
10043 p1 = m[1]; p2 = m[2]; c = !!m[3];
10045 //Subtract the aligned el's internal xy from the target's offset xy
10046 //plus custom offset to get the aligned el's new offset xy
10047 var a1 = this.getAnchorXY(p1, true);
10048 var a2 = el.getAnchorXY(p2, false);
10049 var x = a2[0] - a1[0] + o[0];
10050 var y = a2[1] - a1[1] + o[1];
10052 //constrain the aligned el to viewport if necessary
10053 var w = this.getWidth(), h = this.getHeight(), r = el.getRegion();
10054 // 5px of margin for ie
10055 var dw = D.getViewWidth()-5, dh = D.getViewHeight()-5;
10057 //If we are at a viewport boundary and the aligned el is anchored on a target border that is
10058 //perpendicular to the vp border, allow the aligned el to slide on that border,
10059 //otherwise swap the aligned el to the opposite border of the target.
10060 var p1y = p1.charAt(0), p1x = p1.charAt(p1.length-1);
10061 var p2y = p2.charAt(0), p2x = p2.charAt(p2.length-1);
10062 var swapY = ((p1y=="t" && p2y=="b") || (p1y=="b" && p2y=="t") );
10063 var swapX = ((p1x=="r" && p2x=="l") || (p1x=="l" && p2x=="r"));
10065 var doc = document;
10066 var scrollX = (doc.documentElement.scrollLeft || doc.body.scrollLeft || 0)+5;
10067 var scrollY = (doc.documentElement.scrollTop || doc.body.scrollTop || 0)+5;
10069 if((x+w) > dw + scrollX){
10070 x = swapX ? r.left-w : dw+scrollX-w;
10073 x = swapX ? r.right : scrollX;
10075 if((y+h) > dh + scrollY){
10076 y = swapY ? r.top-h : dh+scrollY-h;
10079 y = swapY ? r.bottom : scrollY;
10086 getConstrainToXY : function(){
10087 var os = {top:0, left:0, bottom:0, right: 0};
10089 return function(el, local, offsets, proposedXY){
10091 offsets = offsets ? Roo.applyIf(offsets, os) : os;
10093 var vw, vh, vx = 0, vy = 0;
10094 if(el.dom == document.body || el.dom == document){
10095 vw = Roo.lib.Dom.getViewWidth();
10096 vh = Roo.lib.Dom.getViewHeight();
10098 vw = el.dom.clientWidth;
10099 vh = el.dom.clientHeight;
10101 var vxy = el.getXY();
10107 var s = el.getScroll();
10109 vx += offsets.left + s.left;
10110 vy += offsets.top + s.top;
10112 vw -= offsets.right;
10113 vh -= offsets.bottom;
10118 var xy = proposedXY || (!local ? this.getXY() : [this.getLeft(true), this.getTop(true)]);
10119 var x = xy[0], y = xy[1];
10120 var w = this.dom.offsetWidth, h = this.dom.offsetHeight;
10122 // only move it if it needs it
10125 // first validate right/bottom
10134 // then make sure top/left isn't negative
10143 return moved ? [x, y] : false;
10148 adjustForConstraints : function(xy, parent, offsets){
10149 return this.getConstrainToXY(parent || document, false, offsets, xy) || xy;
10153 * Aligns this element with another element relative to the specified anchor points. If the other element is the
10154 * document it aligns it to the viewport.
10155 * The position parameter is optional, and can be specified in any one of the following formats:
10157 * <li><b>Blank</b>: Defaults to aligning the element's top-left corner to the target's bottom-left corner ("tl-bl").</li>
10158 * <li><b>One anchor (deprecated)</b>: The passed anchor position is used as the target element's anchor point.
10159 * The element being aligned will position its top-left corner (tl) to that point. <i>This method has been
10160 * deprecated in favor of the newer two anchor syntax below</i>.</li>
10161 * <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
10162 * element's anchor point, and the second value is used as the target's anchor point.</li>
10164 * In addition to the anchor points, the position parameter also supports the "?" character. If "?" is passed at the end of
10165 * the position string, the element will attempt to align as specified, but the position will be adjusted to constrain to
10166 * the viewport if necessary. Note that the element being aligned might be swapped to align to a different position than
10167 * that specified in order to enforce the viewport constraints.
10168 * Following are all of the supported anchor positions:
10171 ----- -----------------------------
10172 tl The top left corner (default)
10173 t The center of the top edge
10174 tr The top right corner
10175 l The center of the left edge
10176 c In the center of the element
10177 r The center of the right edge
10178 bl The bottom left corner
10179 b The center of the bottom edge
10180 br The bottom right corner
10184 // align el to other-el using the default positioning ("tl-bl", non-constrained)
10185 el.alignTo("other-el");
10187 // align the top left corner of el with the top right corner of other-el (constrained to viewport)
10188 el.alignTo("other-el", "tr?");
10190 // align the bottom right corner of el with the center left edge of other-el
10191 el.alignTo("other-el", "br-l?");
10193 // align the center of el with the bottom left corner of other-el and
10194 // adjust the x position by -6 pixels (and the y position by 0)
10195 el.alignTo("other-el", "c-bl", [-6, 0]);
10197 * @param {String/HTMLElement/Roo.Element} element The element to align to.
10198 * @param {String} position The position to align to.
10199 * @param {Array} offsets (optional) Offset the positioning by [x, y]
10200 * @param {Boolean/Object} animate (optional) true for the default animation or a standard Element animation config object
10201 * @return {Roo.Element} this
10203 alignTo : function(element, position, offsets, animate){
10204 var xy = this.getAlignToXY(element, position, offsets);
10205 this.setXY(xy, this.preanim(arguments, 3));
10210 * Anchors an element to another element and realigns it when the window is resized.
10211 * @param {String/HTMLElement/Roo.Element} element The element to align to.
10212 * @param {String} position The position to align to.
10213 * @param {Array} offsets (optional) Offset the positioning by [x, y]
10214 * @param {Boolean/Object} animate (optional) True for the default animation or a standard Element animation config object
10215 * @param {Boolean/Number} monitorScroll (optional) True to monitor body scroll and reposition. If this parameter
10216 * is a number, it is used as the buffer delay (defaults to 50ms).
10217 * @param {Function} callback The function to call after the animation finishes
10218 * @return {Roo.Element} this
10220 anchorTo : function(el, alignment, offsets, animate, monitorScroll, callback){
10221 var action = function(){
10222 this.alignTo(el, alignment, offsets, animate);
10223 Roo.callback(callback, this);
10225 Roo.EventManager.onWindowResize(action, this);
10226 var tm = typeof monitorScroll;
10227 if(tm != 'undefined'){
10228 Roo.EventManager.on(window, 'scroll', action, this,
10229 {buffer: tm == 'number' ? monitorScroll : 50});
10231 action.call(this); // align immediately
10235 * Clears any opacity settings from this element. Required in some cases for IE.
10236 * @return {Roo.Element} this
10238 clearOpacity : function(){
10239 if (window.ActiveXObject) {
10240 if(typeof this.dom.style.filter == 'string' && (/alpha/i).test(this.dom.style.filter)){
10241 this.dom.style.filter = "";
10244 this.dom.style.opacity = "";
10245 this.dom.style["-moz-opacity"] = "";
10246 this.dom.style["-khtml-opacity"] = "";
10252 * Hide this element - Uses display mode to determine whether to use "display" or "visibility". See {@link #setVisible}.
10253 * @param {Boolean/Object} animate (optional) true for the default animation or a standard Element animation config object
10254 * @return {Roo.Element} this
10256 hide : function(animate){
10257 this.setVisible(false, this.preanim(arguments, 0));
10262 * Show this element - Uses display mode to determine whether to use "display" or "visibility". See {@link #setVisible}.
10263 * @param {Boolean/Object} animate (optional) true for the default animation or a standard Element animation config object
10264 * @return {Roo.Element} this
10266 show : function(animate){
10267 this.setVisible(true, this.preanim(arguments, 0));
10272 * @private Test if size has a unit, otherwise appends the default
10274 addUnits : function(size){
10275 return Roo.Element.addUnits(size, this.defaultUnit);
10279 * Temporarily enables offsets (width,height,x,y) for an element with display:none, use endMeasure() when done.
10280 * @return {Roo.Element} this
10282 beginMeasure : function(){
10284 if(el.offsetWidth || el.offsetHeight){
10285 return this; // offsets work already
10288 var p = this.dom, b = document.body; // start with this element
10289 while((!el.offsetWidth && !el.offsetHeight) && p && p.tagName && p != b){
10290 var pe = Roo.get(p);
10291 if(pe.getStyle('display') == 'none'){
10292 changed.push({el: p, visibility: pe.getStyle("visibility")});
10293 p.style.visibility = "hidden";
10294 p.style.display = "block";
10298 this._measureChanged = changed;
10304 * Restores displays to before beginMeasure was called
10305 * @return {Roo.Element} this
10307 endMeasure : function(){
10308 var changed = this._measureChanged;
10310 for(var i = 0, len = changed.length; i < len; i++) {
10311 var r = changed[i];
10312 r.el.style.visibility = r.visibility;
10313 r.el.style.display = "none";
10315 this._measureChanged = null;
10321 * Update the innerHTML of this element, optionally searching for and processing scripts
10322 * @param {String} html The new HTML
10323 * @param {Boolean} loadScripts (optional) true to look for and process scripts
10324 * @param {Function} callback For async script loading you can be noticed when the update completes
10325 * @return {Roo.Element} this
10327 update : function(html, loadScripts, callback){
10328 if(typeof html == "undefined"){
10331 if(loadScripts !== true){
10332 this.dom.innerHTML = html;
10333 if(typeof callback == "function"){
10339 var dom = this.dom;
10341 html += '<span id="' + id + '"></span>';
10343 E.onAvailable(id, function(){
10344 var hd = document.getElementsByTagName("head")[0];
10345 var re = /(?:<script([^>]*)?>)((\n|\r|.)*?)(?:<\/script>)/ig;
10346 var srcRe = /\ssrc=([\'\"])(.*?)\1/i;
10347 var typeRe = /\stype=([\'\"])(.*?)\1/i;
10350 while(match = re.exec(html)){
10351 var attrs = match[1];
10352 var srcMatch = attrs ? attrs.match(srcRe) : false;
10353 if(srcMatch && srcMatch[2]){
10354 var s = document.createElement("script");
10355 s.src = srcMatch[2];
10356 var typeMatch = attrs.match(typeRe);
10357 if(typeMatch && typeMatch[2]){
10358 s.type = typeMatch[2];
10361 }else if(match[2] && match[2].length > 0){
10362 if(window.execScript) {
10363 window.execScript(match[2]);
10371 window.eval(match[2]);
10375 var el = document.getElementById(id);
10376 if(el){el.parentNode.removeChild(el);}
10377 if(typeof callback == "function"){
10381 dom.innerHTML = html.replace(/(?:<script.*?>)((\n|\r|.)*?)(?:<\/script>)/ig, "");
10386 * Direct access to the UpdateManager update() method (takes the same parameters).
10387 * @param {String/Function} url The url for this request or a function to call to get the url
10388 * @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}
10389 * @param {Function} callback (optional) Callback when transaction is complete - called with signature (oElement, bSuccess)
10390 * @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.
10391 * @return {Roo.Element} this
10394 var um = this.getUpdateManager();
10395 um.update.apply(um, arguments);
10400 * Gets this element's UpdateManager
10401 * @return {Roo.UpdateManager} The UpdateManager
10403 getUpdateManager : function(){
10404 if(!this.updateManager){
10405 this.updateManager = new Roo.UpdateManager(this);
10407 return this.updateManager;
10411 * Disables text selection for this element (normalized across browsers)
10412 * @return {Roo.Element} this
10414 unselectable : function(){
10415 this.dom.unselectable = "on";
10416 this.swallowEvent("selectstart", true);
10417 this.applyStyles("-moz-user-select:none;-khtml-user-select:none;");
10418 this.addClass("x-unselectable");
10423 * Calculates the x, y to center this element on the screen
10424 * @return {Array} The x, y values [x, y]
10426 getCenterXY : function(){
10427 return this.getAlignToXY(document, 'c-c');
10431 * Centers the Element in either the viewport, or another Element.
10432 * @param {String/HTMLElement/Roo.Element} centerIn (optional) The element in which to center the element.
10434 center : function(centerIn){
10435 this.alignTo(centerIn || document, 'c-c');
10440 * Tests various css rules/browsers to determine if this element uses a border box
10441 * @return {Boolean}
10443 isBorderBox : function(){
10444 return noBoxAdjust[this.dom.tagName.toLowerCase()] || Roo.isBorderBox;
10448 * Return a box {x, y, width, height} that can be used to set another elements
10449 * size/location to match this element.
10450 * @param {Boolean} contentBox (optional) If true a box for the content of the element is returned.
10451 * @param {Boolean} local (optional) If true the element's left and top are returned instead of page x/y.
10452 * @return {Object} box An object in the format {x, y, width, height}
10454 getBox : function(contentBox, local){
10459 var left = parseInt(this.getStyle("left"), 10) || 0;
10460 var top = parseInt(this.getStyle("top"), 10) || 0;
10463 var el = this.dom, w = el.offsetWidth, h = el.offsetHeight, bx;
10465 bx = {x: xy[0], y: xy[1], 0: xy[0], 1: xy[1], width: w, height: h};
10467 var l = this.getBorderWidth("l")+this.getPadding("l");
10468 var r = this.getBorderWidth("r")+this.getPadding("r");
10469 var t = this.getBorderWidth("t")+this.getPadding("t");
10470 var b = this.getBorderWidth("b")+this.getPadding("b");
10471 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)};
10473 bx.right = bx.x + bx.width;
10474 bx.bottom = bx.y + bx.height;
10479 * Returns the sum width of the padding and borders for the passed "sides". See getBorderWidth()
10480 for more information about the sides.
10481 * @param {String} sides
10484 getFrameWidth : function(sides, onlyContentBox){
10485 return onlyContentBox && Roo.isBorderBox ? 0 : (this.getPadding(sides) + this.getBorderWidth(sides));
10489 * 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.
10490 * @param {Object} box The box to fill {x, y, width, height}
10491 * @param {Boolean} adjust (optional) Whether to adjust for box-model issues automatically
10492 * @param {Boolean/Object} animate (optional) true for the default animation or a standard Element animation config object
10493 * @return {Roo.Element} this
10495 setBox : function(box, adjust, animate){
10496 var w = box.width, h = box.height;
10497 if((adjust && !this.autoBoxAdjust) && !this.isBorderBox()){
10498 w -= (this.getBorderWidth("lr") + this.getPadding("lr"));
10499 h -= (this.getBorderWidth("tb") + this.getPadding("tb"));
10501 this.setBounds(box.x, box.y, w, h, this.preanim(arguments, 2));
10506 * Forces the browser to repaint this element
10507 * @return {Roo.Element} this
10509 repaint : function(){
10510 var dom = this.dom;
10511 this.addClass("x-repaint");
10512 setTimeout(function(){
10513 Roo.get(dom).removeClass("x-repaint");
10519 * Returns an object with properties top, left, right and bottom representing the margins of this element unless sides is passed,
10520 * then it returns the calculated width of the sides (see getPadding)
10521 * @param {String} sides (optional) Any combination of l, r, t, b to get the sum of those sides
10522 * @return {Object/Number}
10524 getMargins : function(side){
10527 top: parseInt(this.getStyle("margin-top"), 10) || 0,
10528 left: parseInt(this.getStyle("margin-left"), 10) || 0,
10529 bottom: parseInt(this.getStyle("margin-bottom"), 10) || 0,
10530 right: parseInt(this.getStyle("margin-right"), 10) || 0
10533 return this.addStyles(side, El.margins);
10538 addStyles : function(sides, styles){
10540 for(var i = 0, len = sides.length; i < len; i++){
10541 v = this.getStyle(styles[sides.charAt(i)]);
10543 w = parseInt(v, 10);
10551 * Creates a proxy element of this element
10552 * @param {String/Object} config The class name of the proxy element or a DomHelper config object
10553 * @param {String/HTMLElement} renderTo (optional) The element or element id to render the proxy to (defaults to document.body)
10554 * @param {Boolean} matchBox (optional) True to align and size the proxy to this element now (defaults to false)
10555 * @return {Roo.Element} The new proxy element
10557 createProxy : function(config, renderTo, matchBox){
10559 renderTo = Roo.getDom(renderTo);
10561 renderTo = document.body;
10563 config = typeof config == "object" ?
10564 config : {tag : "div", cls: config};
10565 var proxy = Roo.DomHelper.append(renderTo, config, true);
10567 proxy.setBox(this.getBox());
10573 * Puts a mask over this element to disable user interaction. Requires core.css.
10574 * This method can only be applied to elements which accept child nodes.
10575 * @param {String} msg (optional) A message to display in the mask
10576 * @param {String} msgCls (optional) A css class to apply to the msg element - use no-spinner to hide the spinner on bootstrap
10577 * @return {Element} The mask element
10579 mask : function(msg, msgCls)
10581 if(this.getStyle("position") == "static" && this.dom.tagName !== 'BODY'){
10582 this.setStyle("position", "relative");
10585 this._mask = Roo.DomHelper.append(this.dom, {cls:"roo-el-mask"}, true);
10588 this.addClass("x-masked");
10589 this._mask.setDisplayed(true);
10593 var dom = this.dom;
10594 while (dom && dom.style) {
10595 if (!isNaN(parseInt(dom.style.zIndex))) {
10596 z = Math.max(z, parseInt(dom.style.zIndex));
10598 dom = dom.parentNode;
10600 // if we are masking the body - then it hides everything..
10601 if (this.dom == document.body) {
10603 this._mask.setWidth(Roo.lib.Dom.getDocumentWidth());
10604 this._mask.setHeight(Roo.lib.Dom.getDocumentHeight());
10607 if(typeof msg == 'string'){
10608 if(!this._maskMsg){
10609 this._maskMsg = Roo.DomHelper.append(this.dom, {
10610 cls: "roo-el-mask-msg",
10614 cls: 'fa fa-spinner fa-spin'
10622 var mm = this._maskMsg;
10623 mm.dom.className = msgCls ? "roo-el-mask-msg " + msgCls : "roo-el-mask-msg";
10624 if (mm.dom.lastChild) { // weird IE issue?
10625 mm.dom.lastChild.innerHTML = msg;
10627 mm.setDisplayed(true);
10629 mm.setStyle('z-index', z + 102);
10631 if(Roo.isIE && !(Roo.isIE7 && Roo.isStrict) && this.getStyle('height') == 'auto'){ // ie will not expand full height automatically
10632 this._mask.setHeight(this.getHeight());
10634 this._mask.setStyle('z-index', z + 100);
10640 * Removes a previously applied mask. If removeEl is true the mask overlay is destroyed, otherwise
10641 * it is cached for reuse.
10643 unmask : function(removeEl){
10645 if(removeEl === true){
10646 this._mask.remove();
10649 this._maskMsg.remove();
10650 delete this._maskMsg;
10653 this._mask.setDisplayed(false);
10655 this._maskMsg.setDisplayed(false);
10659 this.removeClass("x-masked");
10663 * Returns true if this element is masked
10664 * @return {Boolean}
10666 isMasked : function(){
10667 return this._mask && this._mask.isVisible();
10671 * Creates an iframe shim for this element to keep selects and other windowed objects from
10673 * @return {Roo.Element} The new shim element
10675 createShim : function(){
10676 var el = document.createElement('iframe');
10677 el.frameBorder = 'no';
10678 el.className = 'roo-shim';
10679 if(Roo.isIE && Roo.isSecure){
10680 el.src = Roo.SSL_SECURE_URL;
10682 var shim = Roo.get(this.dom.parentNode.insertBefore(el, this.dom));
10683 shim.autoBoxAdjust = false;
10688 * Removes this element from the DOM and deletes it from the cache
10690 remove : function(){
10691 if(this.dom.parentNode){
10692 this.dom.parentNode.removeChild(this.dom);
10694 delete El.cache[this.dom.id];
10698 * Sets up event handlers to add and remove a css class when the mouse is over this element
10699 * @param {String} className
10700 * @param {Boolean} preventFlicker (optional) If set to true, it prevents flickering by filtering
10701 * mouseout events for children elements
10702 * @return {Roo.Element} this
10704 addClassOnOver : function(className, preventFlicker){
10705 this.on("mouseover", function(){
10706 Roo.fly(this, '_internal').addClass(className);
10708 var removeFn = function(e){
10709 if(preventFlicker !== true || !e.within(this, true)){
10710 Roo.fly(this, '_internal').removeClass(className);
10713 this.on("mouseout", removeFn, this.dom);
10718 * Sets up event handlers to add and remove a css class when this element has the focus
10719 * @param {String} className
10720 * @return {Roo.Element} this
10722 addClassOnFocus : function(className){
10723 this.on("focus", function(){
10724 Roo.fly(this, '_internal').addClass(className);
10726 this.on("blur", function(){
10727 Roo.fly(this, '_internal').removeClass(className);
10732 * 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)
10733 * @param {String} className
10734 * @return {Roo.Element} this
10736 addClassOnClick : function(className){
10737 var dom = this.dom;
10738 this.on("mousedown", function(){
10739 Roo.fly(dom, '_internal').addClass(className);
10740 var d = Roo.get(document);
10741 var fn = function(){
10742 Roo.fly(dom, '_internal').removeClass(className);
10743 d.removeListener("mouseup", fn);
10745 d.on("mouseup", fn);
10751 * Stops the specified event from bubbling and optionally prevents the default action
10752 * @param {String} eventName
10753 * @param {Boolean} preventDefault (optional) true to prevent the default action too
10754 * @return {Roo.Element} this
10756 swallowEvent : function(eventName, preventDefault){
10757 var fn = function(e){
10758 e.stopPropagation();
10759 if(preventDefault){
10760 e.preventDefault();
10763 if(eventName instanceof Array){
10764 for(var i = 0, len = eventName.length; i < len; i++){
10765 this.on(eventName[i], fn);
10769 this.on(eventName, fn);
10776 fitToParentDelegate : Roo.emptyFn, // keep a reference to the fitToParent delegate
10779 * Sizes this element to its parent element's dimensions performing
10780 * neccessary box adjustments.
10781 * @param {Boolean} monitorResize (optional) If true maintains the fit when the browser window is resized.
10782 * @param {String/HTMLElment/Element} targetParent (optional) The target parent, default to the parentNode.
10783 * @return {Roo.Element} this
10785 fitToParent : function(monitorResize, targetParent) {
10786 Roo.EventManager.removeResizeListener(this.fitToParentDelegate); // always remove previous fitToParent delegate from onWindowResize
10787 this.fitToParentDelegate = Roo.emptyFn; // remove reference to previous delegate
10788 if (monitorResize === true && !this.dom.parentNode) { // check if this Element still exists
10791 var p = Roo.get(targetParent || this.dom.parentNode);
10792 this.setSize(p.getComputedWidth() - p.getFrameWidth('lr'), p.getComputedHeight() - p.getFrameWidth('tb'));
10793 if (monitorResize === true) {
10794 this.fitToParentDelegate = this.fitToParent.createDelegate(this, [true, targetParent]);
10795 Roo.EventManager.onWindowResize(this.fitToParentDelegate);
10801 * Gets the next sibling, skipping text nodes
10802 * @return {HTMLElement} The next sibling or null
10804 getNextSibling : function(){
10805 var n = this.dom.nextSibling;
10806 while(n && n.nodeType != 1){
10813 * Gets the previous sibling, skipping text nodes
10814 * @return {HTMLElement} The previous sibling or null
10816 getPrevSibling : function(){
10817 var n = this.dom.previousSibling;
10818 while(n && n.nodeType != 1){
10819 n = n.previousSibling;
10826 * Appends the passed element(s) to this element
10827 * @param {String/HTMLElement/Array/Element/CompositeElement} el
10828 * @return {Roo.Element} this
10830 appendChild: function(el){
10837 * Creates the passed DomHelper config and appends it to this element or optionally inserts it before the passed child element.
10838 * @param {Object} config DomHelper element config object. If no tag is specified (e.g., {tag:'input'}) then a div will be
10839 * automatically generated with the specified attributes.
10840 * @param {HTMLElement} insertBefore (optional) a child element of this element
10841 * @param {Boolean} returnDom (optional) true to return the dom node instead of creating an Element
10842 * @return {Roo.Element} The new child element
10844 createChild: function(config, insertBefore, returnDom){
10845 config = config || {tag:'div'};
10847 return Roo.DomHelper.insertBefore(insertBefore, config, returnDom !== true);
10849 return Roo.DomHelper[!this.dom.firstChild ? 'overwrite' : 'append'](this.dom, config, returnDom !== true);
10853 * Appends this element to the passed element
10854 * @param {String/HTMLElement/Element} el The new parent element
10855 * @return {Roo.Element} this
10857 appendTo: function(el){
10858 el = Roo.getDom(el);
10859 el.appendChild(this.dom);
10864 * Inserts this element before the passed element in the DOM
10865 * @param {String/HTMLElement/Element} el The element to insert before
10866 * @return {Roo.Element} this
10868 insertBefore: function(el){
10869 el = Roo.getDom(el);
10870 el.parentNode.insertBefore(this.dom, el);
10875 * Inserts this element after the passed element in the DOM
10876 * @param {String/HTMLElement/Element} el The element to insert after
10877 * @return {Roo.Element} this
10879 insertAfter: function(el){
10880 el = Roo.getDom(el);
10881 el.parentNode.insertBefore(this.dom, el.nextSibling);
10886 * Inserts (or creates) an element (or DomHelper config) as the first child of the this element
10887 * @param {String/HTMLElement/Element/Object} el The id or element to insert or a DomHelper config to create and insert
10888 * @return {Roo.Element} The new child
10890 insertFirst: function(el, returnDom){
10892 if(typeof el == 'object' && !el.nodeType){ // dh config
10893 return this.createChild(el, this.dom.firstChild, returnDom);
10895 el = Roo.getDom(el);
10896 this.dom.insertBefore(el, this.dom.firstChild);
10897 return !returnDom ? Roo.get(el) : el;
10902 * Inserts (or creates) the passed element (or DomHelper config) as a sibling of this element
10903 * @param {String/HTMLElement/Element/Object} el The id or element to insert or a DomHelper config to create and insert
10904 * @param {String} where (optional) 'before' or 'after' defaults to before
10905 * @param {Boolean} returnDom (optional) True to return the raw DOM element instead of Roo.Element
10906 * @return {Roo.Element} the inserted Element
10908 insertSibling: function(el, where, returnDom){
10909 where = where ? where.toLowerCase() : 'before';
10911 var rt, refNode = where == 'before' ? this.dom : this.dom.nextSibling;
10913 if(typeof el == 'object' && !el.nodeType){ // dh config
10914 if(where == 'after' && !this.dom.nextSibling){
10915 rt = Roo.DomHelper.append(this.dom.parentNode, el, !returnDom);
10917 rt = Roo.DomHelper[where == 'after' ? 'insertAfter' : 'insertBefore'](this.dom, el, !returnDom);
10921 rt = this.dom.parentNode.insertBefore(Roo.getDom(el),
10922 where == 'before' ? this.dom : this.dom.nextSibling);
10931 * Creates and wraps this element with another element
10932 * @param {Object} config (optional) DomHelper element config object for the wrapper element or null for an empty div
10933 * @param {Boolean} returnDom (optional) True to return the raw DOM element instead of Roo.Element
10934 * @return {HTMLElement/Element} The newly created wrapper element
10936 wrap: function(config, returnDom){
10938 config = {tag: "div"};
10940 var newEl = Roo.DomHelper.insertBefore(this.dom, config, !returnDom);
10941 newEl.dom ? newEl.dom.appendChild(this.dom) : newEl.appendChild(this.dom);
10946 * Replaces the passed element with this element
10947 * @param {String/HTMLElement/Element} el The element to replace
10948 * @return {Roo.Element} this
10950 replace: function(el){
10952 this.insertBefore(el);
10958 * Inserts an html fragment into this element
10959 * @param {String} where Where to insert the html in relation to the this element - beforeBegin, afterBegin, beforeEnd, afterEnd.
10960 * @param {String} html The HTML fragment
10961 * @param {Boolean} returnEl True to return an Roo.Element
10962 * @return {HTMLElement/Roo.Element} The inserted node (or nearest related if more than 1 inserted)
10964 insertHtml : function(where, html, returnEl){
10965 var el = Roo.DomHelper.insertHtml(where, this.dom, html);
10966 return returnEl ? Roo.get(el) : el;
10970 * Sets the passed attributes as attributes of this element (a style attribute can be a string, object or function)
10971 * @param {Object} o The object with the attributes
10972 * @param {Boolean} useSet (optional) false to override the default setAttribute to use expandos.
10973 * @return {Roo.Element} this
10975 set : function(o, useSet){
10977 useSet = typeof useSet == 'undefined' ? (el.setAttribute ? true : false) : useSet;
10978 for(var attr in o){
10979 if(attr == "style" || typeof o[attr] == "function") { continue; }
10981 el.className = o["cls"];
10984 el.setAttribute(attr, o[attr]);
10986 el[attr] = o[attr];
10991 Roo.DomHelper.applyStyles(el, o.style);
10997 * Convenience method for constructing a KeyMap
10998 * @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:
10999 * {key: (number or array), shift: (true/false), ctrl: (true/false), alt: (true/false)}
11000 * @param {Function} fn The function to call
11001 * @param {Object} scope (optional) The scope of the function
11002 * @return {Roo.KeyMap} The KeyMap created
11004 addKeyListener : function(key, fn, scope){
11006 if(typeof key != "object" || key instanceof Array){
11022 return new Roo.KeyMap(this, config);
11026 * Creates a KeyMap for this element
11027 * @param {Object} config The KeyMap config. See {@link Roo.KeyMap} for more details
11028 * @return {Roo.KeyMap} The KeyMap created
11030 addKeyMap : function(config){
11031 return new Roo.KeyMap(this, config);
11035 * Returns true if this element is scrollable.
11036 * @return {Boolean}
11038 isScrollable : function(){
11039 var dom = this.dom;
11040 return dom.scrollHeight > dom.clientHeight || dom.scrollWidth > dom.clientWidth;
11044 * 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().
11045 * @param {String} side Either "left" for scrollLeft values or "top" for scrollTop values.
11046 * @param {Number} value The new scroll value
11047 * @param {Boolean/Object} animate (optional) true for the default animation or a standard Element animation config object
11048 * @return {Element} this
11051 scrollTo : function(side, value, animate){
11052 var prop = side.toLowerCase() == "left" ? "scrollLeft" : "scrollTop";
11053 if(!animate || !A){
11054 this.dom[prop] = value;
11056 var to = prop == "scrollLeft" ? [value, this.dom.scrollTop] : [this.dom.scrollLeft, value];
11057 this.anim({scroll: {"to": to}}, this.preanim(arguments, 2), 'scroll');
11063 * Scrolls this element the specified direction. Does bounds checking to make sure the scroll is
11064 * within this element's scrollable range.
11065 * @param {String} direction Possible values are: "l","left" - "r","right" - "t","top","up" - "b","bottom","down".
11066 * @param {Number} distance How far to scroll the element in pixels
11067 * @param {Boolean/Object} animate (optional) true for the default animation or a standard Element animation config object
11068 * @return {Boolean} Returns true if a scroll was triggered or false if the element
11069 * was scrolled as far as it could go.
11071 scroll : function(direction, distance, animate){
11072 if(!this.isScrollable()){
11076 var l = el.scrollLeft, t = el.scrollTop;
11077 var w = el.scrollWidth, h = el.scrollHeight;
11078 var cw = el.clientWidth, ch = el.clientHeight;
11079 direction = direction.toLowerCase();
11080 var scrolled = false;
11081 var a = this.preanim(arguments, 2);
11086 var v = Math.min(l + distance, w-cw);
11087 this.scrollTo("left", v, a);
11094 var v = Math.max(l - distance, 0);
11095 this.scrollTo("left", v, a);
11103 var v = Math.max(t - distance, 0);
11104 this.scrollTo("top", v, a);
11112 var v = Math.min(t + distance, h-ch);
11113 this.scrollTo("top", v, a);
11122 * Translates the passed page coordinates into left/top css values for this element
11123 * @param {Number/Array} x The page x or an array containing [x, y]
11124 * @param {Number} y The page y
11125 * @return {Object} An object with left and top properties. e.g. {left: (value), top: (value)}
11127 translatePoints : function(x, y){
11128 if(typeof x == 'object' || x instanceof Array){
11129 y = x[1]; x = x[0];
11131 var p = this.getStyle('position');
11132 var o = this.getXY();
11134 var l = parseInt(this.getStyle('left'), 10);
11135 var t = parseInt(this.getStyle('top'), 10);
11138 l = (p == "relative") ? 0 : this.dom.offsetLeft;
11141 t = (p == "relative") ? 0 : this.dom.offsetTop;
11144 return {left: (x - o[0] + l), top: (y - o[1] + t)};
11148 * Returns the current scroll position of the element.
11149 * @return {Object} An object containing the scroll position in the format {left: (scrollLeft), top: (scrollTop)}
11151 getScroll : function(){
11152 var d = this.dom, doc = document;
11153 if(d == doc || d == doc.body){
11154 var l = window.pageXOffset || doc.documentElement.scrollLeft || doc.body.scrollLeft || 0;
11155 var t = window.pageYOffset || doc.documentElement.scrollTop || doc.body.scrollTop || 0;
11156 return {left: l, top: t};
11158 return {left: d.scrollLeft, top: d.scrollTop};
11163 * Return the CSS color for the specified CSS attribute. rgb, 3 digit (like #fff) and valid values
11164 * are convert to standard 6 digit hex color.
11165 * @param {String} attr The css attribute
11166 * @param {String} defaultValue The default value to use when a valid color isn't found
11167 * @param {String} prefix (optional) defaults to #. Use an empty string when working with
11170 getColor : function(attr, defaultValue, prefix){
11171 var v = this.getStyle(attr);
11172 if(!v || v == "transparent" || v == "inherit") {
11173 return defaultValue;
11175 var color = typeof prefix == "undefined" ? "#" : prefix;
11176 if(v.substr(0, 4) == "rgb("){
11177 var rvs = v.slice(4, v.length -1).split(",");
11178 for(var i = 0; i < 3; i++){
11179 var h = parseInt(rvs[i]).toString(16);
11186 if(v.substr(0, 1) == "#"){
11187 if(v.length == 4) {
11188 for(var i = 1; i < 4; i++){
11189 var c = v.charAt(i);
11192 }else if(v.length == 7){
11193 color += v.substr(1);
11197 return(color.length > 5 ? color.toLowerCase() : defaultValue);
11201 * Wraps the specified element with a special markup/CSS block that renders by default as a gray container with a
11202 * gradient background, rounded corners and a 4-way shadow.
11203 * @param {String} class (optional) A base CSS class to apply to the containing wrapper element (defaults to 'x-box').
11204 * Note that there are a number of CSS rules that are dependent on this name to make the overall effect work,
11205 * so if you supply an alternate base class, make sure you also supply all of the necessary rules.
11206 * @return {Roo.Element} this
11208 boxWrap : function(cls){
11209 cls = cls || 'x-box';
11210 var el = Roo.get(this.insertHtml('beforeBegin', String.format('<div class="{0}">'+El.boxMarkup+'</div>', cls)));
11211 el.child('.'+cls+'-mc').dom.appendChild(this.dom);
11216 * Returns the value of a namespaced attribute from the element's underlying DOM node.
11217 * @param {String} namespace The namespace in which to look for the attribute
11218 * @param {String} name The attribute name
11219 * @return {String} The attribute value
11221 getAttributeNS : Roo.isIE ? function(ns, name){
11223 var type = typeof d[ns+":"+name];
11224 if(type != 'undefined' && type != 'unknown'){
11225 return d[ns+":"+name];
11228 } : function(ns, name){
11230 return d.getAttributeNS(ns, name) || d.getAttribute(ns+":"+name) || d.getAttribute(name) || d[name];
11235 * Sets or Returns the value the dom attribute value
11236 * @param {String|Object} name The attribute name (or object to set multiple attributes)
11237 * @param {String} value (optional) The value to set the attribute to
11238 * @return {String} The attribute value
11240 attr : function(name){
11241 if (arguments.length > 1) {
11242 this.dom.setAttribute(name, arguments[1]);
11243 return arguments[1];
11245 if (typeof(name) == 'object') {
11246 for(var i in name) {
11247 this.attr(i, name[i]);
11253 if (!this.dom.hasAttribute(name)) {
11256 return this.dom.getAttribute(name);
11263 var ep = El.prototype;
11266 * Appends an event handler (Shorthand for addListener)
11267 * @param {String} eventName The type of event to append
11268 * @param {Function} fn The method the event invokes
11269 * @param {Object} scope (optional) The scope (this object) of the fn
11270 * @param {Object} options (optional)An object with standard {@link Roo.EventManager#addListener} options
11273 ep.on = ep.addListener;
11274 // backwards compat
11275 ep.mon = ep.addListener;
11278 * Removes an event handler from this element (shorthand for removeListener)
11279 * @param {String} eventName the type of event to remove
11280 * @param {Function} fn the method the event invokes
11281 * @return {Roo.Element} this
11284 ep.un = ep.removeListener;
11287 * true to automatically adjust width and height settings for box-model issues (default to true)
11289 ep.autoBoxAdjust = true;
11292 El.unitPattern = /\d+(px|em|%|en|ex|pt|in|cm|mm|pc)$/i;
11295 El.addUnits = function(v, defaultUnit){
11296 if(v === "" || v == "auto"){
11299 if(v === undefined){
11302 if(typeof v == "number" || !El.unitPattern.test(v)){
11303 return v + (defaultUnit || 'px');
11308 // special markup used throughout Roo when box wrapping elements
11309 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>';
11311 * Visibility mode constant - Use visibility to hide element
11317 * Visibility mode constant - Use display to hide element
11323 El.borders = {l: "border-left-width", r: "border-right-width", t: "border-top-width", b: "border-bottom-width"};
11324 El.paddings = {l: "padding-left", r: "padding-right", t: "padding-top", b: "padding-bottom"};
11325 El.margins = {l: "margin-left", r: "margin-right", t: "margin-top", b: "margin-bottom"};
11337 * Static method to retrieve Element objects. Uses simple caching to consistently return the same object.
11338 * Automatically fixes if an object was recreated with the same id via AJAX or DOM.
11339 * @param {String/HTMLElement/Element} el The id of the node, a DOM Node or an existing Element.
11340 * @return {Element} The Element object
11343 El.get = function(el){
11345 if(!el){ return null; }
11346 if(typeof el == "string"){ // element id
11347 if(!(elm = document.getElementById(el))){
11350 if(ex = El.cache[el]){
11353 ex = El.cache[el] = new El(elm);
11356 }else if(el.tagName){ // dom element
11360 if(ex = El.cache[id]){
11363 ex = El.cache[id] = new El(el);
11366 }else if(el instanceof El){
11368 el.dom = document.getElementById(el.id) || el.dom; // refresh dom element in case no longer valid,
11369 // catch case where it hasn't been appended
11370 El.cache[el.id] = el; // in case it was created directly with Element(), let's cache it
11373 }else if(el.isComposite){
11375 }else if(el instanceof Array){
11376 return El.select(el);
11377 }else if(el == document){
11378 // create a bogus element object representing the document object
11380 var f = function(){};
11381 f.prototype = El.prototype;
11383 docEl.dom = document;
11391 El.uncache = function(el){
11392 for(var i = 0, a = arguments, len = a.length; i < len; i++) {
11394 delete El.cache[a[i].id || a[i]];
11400 // Garbage collection - uncache elements/purge listeners on orphaned elements
11401 // so we don't hold a reference and cause the browser to retain them
11402 El.garbageCollect = function(){
11403 if(!Roo.enableGarbageCollector){
11404 clearInterval(El.collectorThread);
11407 for(var eid in El.cache){
11408 var el = El.cache[eid], d = el.dom;
11409 // -------------------------------------------------------
11410 // Determining what is garbage:
11411 // -------------------------------------------------------
11413 // dom node is null, definitely garbage
11414 // -------------------------------------------------------
11416 // no parentNode == direct orphan, definitely garbage
11417 // -------------------------------------------------------
11418 // !d.offsetParent && !document.getElementById(eid)
11419 // display none elements have no offsetParent so we will
11420 // also try to look it up by it's id. However, check
11421 // offsetParent first so we don't do unneeded lookups.
11422 // This enables collection of elements that are not orphans
11423 // directly, but somewhere up the line they have an orphan
11425 // -------------------------------------------------------
11426 if(!d || !d.parentNode || (!d.offsetParent && !document.getElementById(eid))){
11427 delete El.cache[eid];
11428 if(d && Roo.enableListenerCollection){
11434 El.collectorThreadId = setInterval(El.garbageCollect, 30000);
11438 El.Flyweight = function(dom){
11441 El.Flyweight.prototype = El.prototype;
11443 El._flyweights = {};
11445 * Gets the globally shared flyweight Element, with the passed node as the active element. Do not store a reference to this element -
11446 * the dom node can be overwritten by other code.
11447 * @param {String/HTMLElement} el The dom node or id
11448 * @param {String} named (optional) Allows for creation of named reusable flyweights to
11449 * prevent conflicts (e.g. internally Roo uses "_internal")
11451 * @return {Element} The shared Element object
11453 El.fly = function(el, named){
11454 named = named || '_global';
11455 el = Roo.getDom(el);
11459 if(!El._flyweights[named]){
11460 El._flyweights[named] = new El.Flyweight();
11462 El._flyweights[named].dom = el;
11463 return El._flyweights[named];
11467 * Static method to retrieve Element objects. Uses simple caching to consistently return the same object.
11468 * Automatically fixes if an object was recreated with the same id via AJAX or DOM.
11469 * Shorthand of {@link Roo.Element#get}
11470 * @param {String/HTMLElement/Element} el The id of the node, a DOM Node or an existing Element.
11471 * @return {Element} The Element object
11477 * Gets the globally shared flyweight Element, with the passed node as the active element. Do not store a reference to this element -
11478 * the dom node can be overwritten by other code.
11479 * Shorthand of {@link Roo.Element#fly}
11480 * @param {String/HTMLElement} el The dom node or id
11481 * @param {String} named (optional) Allows for creation of named reusable flyweights to
11482 * prevent conflicts (e.g. internally Roo uses "_internal")
11484 * @return {Element} The shared Element object
11490 // speedy lookup for elements never to box adjust
11491 var noBoxAdjust = Roo.isStrict ? {
11494 input:1, select:1, textarea:1
11496 if(Roo.isIE || Roo.isGecko){
11497 noBoxAdjust['button'] = 1;
11501 Roo.EventManager.on(window, 'unload', function(){
11503 delete El._flyweights;
11511 Roo.Element.selectorFunction = Roo.DomQuery.select;
11514 Roo.Element.select = function(selector, unique, root){
11516 if(typeof selector == "string"){
11517 els = Roo.Element.selectorFunction(selector, root);
11518 }else if(selector.length !== undefined){
11521 throw "Invalid selector";
11523 if(unique === true){
11524 return new Roo.CompositeElement(els);
11526 return new Roo.CompositeElementLite(els);
11530 * Selects elements based on the passed CSS selector to enable working on them as 1.
11531 * @param {String/Array} selector The CSS selector or an array of elements
11532 * @param {Boolean} unique (optional) true to create a unique Roo.Element for each element (defaults to a shared flyweight object)
11533 * @param {HTMLElement/String} root (optional) The root element of the query or id of the root
11534 * @return {CompositeElementLite/CompositeElement}
11538 Roo.select = Roo.Element.select;
11555 * Ext JS Library 1.1.1
11556 * Copyright(c) 2006-2007, Ext JS, LLC.
11558 * Originally Released Under LGPL - original licence link has changed is not relivant.
11561 * <script type="text/javascript">
11566 //Notifies Element that fx methods are available
11567 Roo.enableFx = true;
11571 * <p>A class to provide basic animation and visual effects support. <b>Note:</b> This class is automatically applied
11572 * to the {@link Roo.Element} interface when included, so all effects calls should be performed via Element.
11573 * Conversely, since the effects are not actually defined in Element, Roo.Fx <b>must</b> be included in order for the
11574 * Element effects to work.</p><br/>
11576 * <p>It is important to note that although the Fx methods and many non-Fx Element methods support "method chaining" in that
11577 * they return the Element object itself as the method return value, it is not always possible to mix the two in a single
11578 * method chain. The Fx methods use an internal effects queue so that each effect can be properly timed and sequenced.
11579 * Non-Fx methods, on the other hand, have no such internal queueing and will always execute immediately. For this reason,
11580 * while it may be possible to mix certain Fx and non-Fx method calls in a single chain, it may not always provide the
11581 * expected results and should be done with care.</p><br/>
11583 * <p>Motion effects support 8-way anchoring, meaning that you can choose one of 8 different anchor points on the Element
11584 * that will serve as either the start or end point of the animation. Following are all of the supported anchor positions:</p>
11587 ----- -----------------------------
11588 tl The top left corner
11589 t The center of the top edge
11590 tr The top right corner
11591 l The center of the left edge
11592 r The center of the right edge
11593 bl The bottom left corner
11594 b The center of the bottom edge
11595 br The bottom right corner
11597 * <b>Although some Fx methods accept specific custom config parameters, the ones shown in the Config Options section
11598 * below are common options that can be passed to any Fx method.</b>
11599 * @cfg {Function} callback A function called when the effect is finished
11600 * @cfg {Object} scope The scope of the effect function
11601 * @cfg {String} easing A valid Easing value for the effect
11602 * @cfg {String} afterCls A css class to apply after the effect
11603 * @cfg {Number} duration The length of time (in seconds) that the effect should last
11604 * @cfg {Boolean} remove Whether the Element should be removed from the DOM and destroyed after the effect finishes
11605 * @cfg {Boolean} useDisplay Whether to use the <i>display</i> CSS property instead of <i>visibility</i> when hiding Elements (only applies to
11606 * effects that end with the element being visually hidden, ignored otherwise)
11607 * @cfg {String/Object/Function} afterStyle A style specification string, e.g. "width:100px", or an object in the form {width:"100px"}, or
11608 * a function which returns such a specification that will be applied to the Element after the effect finishes
11609 * @cfg {Boolean} block Whether the effect should block other effects from queueing while it runs
11610 * @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
11611 * @cfg {Boolean} stopFx Whether subsequent effects should be stopped and removed after the current effect finishes
11615 * Slides the element into view. An anchor point can be optionally passed to set the point of
11616 * origin for the slide effect. This function automatically handles wrapping the element with
11617 * a fixed-size container if needed. See the Fx class overview for valid anchor point options.
11620 // default: slide the element in from the top
11623 // custom: slide the element in from the right with a 2-second duration
11624 el.slideIn('r', { duration: 2 });
11626 // common config options shown with default values
11632 * @param {String} anchor (optional) One of the valid Fx anchor positions (defaults to top: 't')
11633 * @param {Object} options (optional) Object literal with any of the Fx config options
11634 * @return {Roo.Element} The Element
11636 slideIn : function(anchor, o){
11637 var el = this.getFxEl();
11640 el.queueFx(o, function(){
11642 anchor = anchor || "t";
11644 // fix display to visibility
11647 // restore values after effect
11648 var r = this.getFxRestore();
11649 var b = this.getBox();
11650 // fixed size for slide
11654 var wrap = this.fxWrap(r.pos, o, "hidden");
11656 var st = this.dom.style;
11657 st.visibility = "visible";
11658 st.position = "absolute";
11660 // clear out temp styles after slide and unwrap
11661 var after = function(){
11662 el.fxUnwrap(wrap, r.pos, o);
11663 st.width = r.width;
11664 st.height = r.height;
11667 // time to calc the positions
11668 var a, pt = {to: [b.x, b.y]}, bw = {to: b.width}, bh = {to: b.height};
11670 switch(anchor.toLowerCase()){
11672 wrap.setSize(b.width, 0);
11673 st.left = st.bottom = "0";
11677 wrap.setSize(0, b.height);
11678 st.right = st.top = "0";
11682 wrap.setSize(0, b.height);
11683 wrap.setX(b.right);
11684 st.left = st.top = "0";
11685 a = {width: bw, points: pt};
11688 wrap.setSize(b.width, 0);
11689 wrap.setY(b.bottom);
11690 st.left = st.top = "0";
11691 a = {height: bh, points: pt};
11694 wrap.setSize(0, 0);
11695 st.right = st.bottom = "0";
11696 a = {width: bw, height: bh};
11699 wrap.setSize(0, 0);
11700 wrap.setY(b.y+b.height);
11701 st.right = st.top = "0";
11702 a = {width: bw, height: bh, points: pt};
11705 wrap.setSize(0, 0);
11706 wrap.setXY([b.right, b.bottom]);
11707 st.left = st.top = "0";
11708 a = {width: bw, height: bh, points: pt};
11711 wrap.setSize(0, 0);
11712 wrap.setX(b.x+b.width);
11713 st.left = st.bottom = "0";
11714 a = {width: bw, height: bh, points: pt};
11717 this.dom.style.visibility = "visible";
11720 arguments.callee.anim = wrap.fxanim(a,
11730 * Slides the element out of view. An anchor point can be optionally passed to set the end point
11731 * for the slide effect. When the effect is completed, the element will be hidden (visibility =
11732 * 'hidden') but block elements will still take up space in the document. The element must be removed
11733 * from the DOM using the 'remove' config option if desired. This function automatically handles
11734 * wrapping the element with a fixed-size container if needed. See the Fx class overview for valid anchor point options.
11737 // default: slide the element out to the top
11740 // custom: slide the element out to the right with a 2-second duration
11741 el.slideOut('r', { duration: 2 });
11743 // common config options shown with default values
11751 * @param {String} anchor (optional) One of the valid Fx anchor positions (defaults to top: 't')
11752 * @param {Object} options (optional) Object literal with any of the Fx config options
11753 * @return {Roo.Element} The Element
11755 slideOut : function(anchor, o){
11756 var el = this.getFxEl();
11759 el.queueFx(o, function(){
11761 anchor = anchor || "t";
11763 // restore values after effect
11764 var r = this.getFxRestore();
11766 var b = this.getBox();
11767 // fixed size for slide
11771 var wrap = this.fxWrap(r.pos, o, "visible");
11773 var st = this.dom.style;
11774 st.visibility = "visible";
11775 st.position = "absolute";
11779 var after = function(){
11781 el.setDisplayed(false);
11786 el.fxUnwrap(wrap, r.pos, o);
11788 st.width = r.width;
11789 st.height = r.height;
11794 var a, zero = {to: 0};
11795 switch(anchor.toLowerCase()){
11797 st.left = st.bottom = "0";
11798 a = {height: zero};
11801 st.right = st.top = "0";
11805 st.left = st.top = "0";
11806 a = {width: zero, points: {to:[b.right, b.y]}};
11809 st.left = st.top = "0";
11810 a = {height: zero, points: {to:[b.x, b.bottom]}};
11813 st.right = st.bottom = "0";
11814 a = {width: zero, height: zero};
11817 st.right = st.top = "0";
11818 a = {width: zero, height: zero, points: {to:[b.x, b.bottom]}};
11821 st.left = st.top = "0";
11822 a = {width: zero, height: zero, points: {to:[b.x+b.width, b.bottom]}};
11825 st.left = st.bottom = "0";
11826 a = {width: zero, height: zero, points: {to:[b.right, b.y]}};
11830 arguments.callee.anim = wrap.fxanim(a,
11840 * Fades the element out while slowly expanding it in all directions. When the effect is completed, the
11841 * element will be hidden (visibility = 'hidden') but block elements will still take up space in the document.
11842 * The element must be removed from the DOM using the 'remove' config option if desired.
11848 // common config options shown with default values
11856 * @param {Object} options (optional) Object literal with any of the Fx config options
11857 * @return {Roo.Element} The Element
11859 puff : function(o){
11860 var el = this.getFxEl();
11863 el.queueFx(o, function(){
11864 this.clearOpacity();
11867 // restore values after effect
11868 var r = this.getFxRestore();
11869 var st = this.dom.style;
11871 var after = function(){
11873 el.setDisplayed(false);
11880 el.setPositioning(r.pos);
11881 st.width = r.width;
11882 st.height = r.height;
11887 var width = this.getWidth();
11888 var height = this.getHeight();
11890 arguments.callee.anim = this.fxanim({
11891 width : {to: this.adjustWidth(width * 2)},
11892 height : {to: this.adjustHeight(height * 2)},
11893 points : {by: [-(width * .5), -(height * .5)]},
11895 fontSize: {to:200, unit: "%"}
11906 * Blinks the element as if it was clicked and then collapses on its center (similar to switching off a television).
11907 * When the effect is completed, the element will be hidden (visibility = 'hidden') but block elements will still
11908 * take up space in the document. The element must be removed from the DOM using the 'remove' config option if desired.
11914 // all config options shown with default values
11922 * @param {Object} options (optional) Object literal with any of the Fx config options
11923 * @return {Roo.Element} The Element
11925 switchOff : function(o){
11926 var el = this.getFxEl();
11929 el.queueFx(o, function(){
11930 this.clearOpacity();
11933 // restore values after effect
11934 var r = this.getFxRestore();
11935 var st = this.dom.style;
11937 var after = function(){
11939 el.setDisplayed(false);
11945 el.setPositioning(r.pos);
11946 st.width = r.width;
11947 st.height = r.height;
11952 this.fxanim({opacity:{to:0.3}}, null, null, .1, null, function(){
11953 this.clearOpacity();
11957 points:{by:[0, this.getHeight() * .5]}
11958 }, o, 'motion', 0.3, 'easeIn', after);
11959 }).defer(100, this);
11966 * Highlights the Element by setting a color (applies to the background-color by default, but can be
11967 * changed using the "attr" config option) and then fading back to the original color. If no original
11968 * color is available, you should provide the "endColor" config option which will be cleared after the animation.
11971 // default: highlight background to yellow
11974 // custom: highlight foreground text to blue for 2 seconds
11975 el.highlight("0000ff", { attr: 'color', duration: 2 });
11977 // common config options shown with default values
11978 el.highlight("ffff9c", {
11979 attr: "background-color", //can be any valid CSS property (attribute) that supports a color value
11980 endColor: (current color) or "ffffff",
11985 * @param {String} color (optional) The highlight color. Should be a 6 char hex color without the leading # (defaults to yellow: 'ffff9c')
11986 * @param {Object} options (optional) Object literal with any of the Fx config options
11987 * @return {Roo.Element} The Element
11989 highlight : function(color, o){
11990 var el = this.getFxEl();
11993 el.queueFx(o, function(){
11994 color = color || "ffff9c";
11995 attr = o.attr || "backgroundColor";
11997 this.clearOpacity();
12000 var origColor = this.getColor(attr);
12001 var restoreColor = this.dom.style[attr];
12002 endColor = (o.endColor || origColor) || "ffffff";
12004 var after = function(){
12005 el.dom.style[attr] = restoreColor;
12010 a[attr] = {from: color, to: endColor};
12011 arguments.callee.anim = this.fxanim(a,
12021 * Shows a ripple of exploding, attenuating borders to draw attention to an Element.
12024 // default: a single light blue ripple
12027 // custom: 3 red ripples lasting 3 seconds total
12028 el.frame("ff0000", 3, { duration: 3 });
12030 // common config options shown with default values
12031 el.frame("C3DAF9", 1, {
12032 duration: 1 //duration of entire animation (not each individual ripple)
12033 // Note: Easing is not configurable and will be ignored if included
12036 * @param {String} color (optional) The color of the border. Should be a 6 char hex color without the leading # (defaults to light blue: 'C3DAF9').
12037 * @param {Number} count (optional) The number of ripples to display (defaults to 1)
12038 * @param {Object} options (optional) Object literal with any of the Fx config options
12039 * @return {Roo.Element} The Element
12041 frame : function(color, count, o){
12042 var el = this.getFxEl();
12045 el.queueFx(o, function(){
12046 color = color || "#C3DAF9";
12047 if(color.length == 6){
12048 color = "#" + color;
12050 count = count || 1;
12051 duration = o.duration || 1;
12054 var b = this.getBox();
12055 var animFn = function(){
12056 var proxy = this.createProxy({
12059 visbility:"hidden",
12060 position:"absolute",
12061 "z-index":"35000", // yee haw
12062 border:"0px solid " + color
12065 var scale = Roo.isBorderBox ? 2 : 1;
12067 top:{from:b.y, to:b.y - 20},
12068 left:{from:b.x, to:b.x - 20},
12069 borderWidth:{from:0, to:10},
12070 opacity:{from:1, to:0},
12071 height:{from:b.height, to:(b.height + (20*scale))},
12072 width:{from:b.width, to:(b.width + (20*scale))}
12073 }, duration, function(){
12077 animFn.defer((duration/2)*1000, this);
12088 * Creates a pause before any subsequent queued effects begin. If there are
12089 * no effects queued after the pause it will have no effect.
12094 * @param {Number} seconds The length of time to pause (in seconds)
12095 * @return {Roo.Element} The Element
12097 pause : function(seconds){
12098 var el = this.getFxEl();
12101 el.queueFx(o, function(){
12102 setTimeout(function(){
12104 }, seconds * 1000);
12110 * Fade an element in (from transparent to opaque). The ending opacity can be specified
12111 * using the "endOpacity" config option.
12114 // default: fade in from opacity 0 to 100%
12117 // custom: fade in from opacity 0 to 75% over 2 seconds
12118 el.fadeIn({ endOpacity: .75, duration: 2});
12120 // common config options shown with default values
12122 endOpacity: 1, //can be any value between 0 and 1 (e.g. .5)
12127 * @param {Object} options (optional) Object literal with any of the Fx config options
12128 * @return {Roo.Element} The Element
12130 fadeIn : function(o){
12131 var el = this.getFxEl();
12133 el.queueFx(o, function(){
12134 this.setOpacity(0);
12136 this.dom.style.visibility = 'visible';
12137 var to = o.endOpacity || 1;
12138 arguments.callee.anim = this.fxanim({opacity:{to:to}},
12139 o, null, .5, "easeOut", function(){
12141 this.clearOpacity();
12150 * Fade an element out (from opaque to transparent). The ending opacity can be specified
12151 * using the "endOpacity" config option.
12154 // default: fade out from the element's current opacity to 0
12157 // custom: fade out from the element's current opacity to 25% over 2 seconds
12158 el.fadeOut({ endOpacity: .25, duration: 2});
12160 // common config options shown with default values
12162 endOpacity: 0, //can be any value between 0 and 1 (e.g. .5)
12169 * @param {Object} options (optional) Object literal with any of the Fx config options
12170 * @return {Roo.Element} The Element
12172 fadeOut : function(o){
12173 var el = this.getFxEl();
12175 el.queueFx(o, function(){
12176 arguments.callee.anim = this.fxanim({opacity:{to:o.endOpacity || 0}},
12177 o, null, .5, "easeOut", function(){
12178 if(this.visibilityMode == Roo.Element.DISPLAY || o.useDisplay){
12179 this.dom.style.display = "none";
12181 this.dom.style.visibility = "hidden";
12183 this.clearOpacity();
12191 * Animates the transition of an element's dimensions from a starting height/width
12192 * to an ending height/width.
12195 // change height and width to 100x100 pixels
12196 el.scale(100, 100);
12198 // common config options shown with default values. The height and width will default to
12199 // the element's existing values if passed as null.
12202 [element's height], {
12207 * @param {Number} width The new width (pass undefined to keep the original width)
12208 * @param {Number} height The new height (pass undefined to keep the original height)
12209 * @param {Object} options (optional) Object literal with any of the Fx config options
12210 * @return {Roo.Element} The Element
12212 scale : function(w, h, o){
12213 this.shift(Roo.apply({}, o, {
12221 * Animates the transition of any combination of an element's dimensions, xy position and/or opacity.
12222 * Any of these properties not specified in the config object will not be changed. This effect
12223 * requires that at least one new dimension, position or opacity setting must be passed in on
12224 * the config object in order for the function to have any effect.
12227 // slide the element horizontally to x position 200 while changing the height and opacity
12228 el.shift({ x: 200, height: 50, opacity: .8 });
12230 // common config options shown with default values.
12232 width: [element's width],
12233 height: [element's height],
12234 x: [element's x position],
12235 y: [element's y position],
12236 opacity: [element's opacity],
12241 * @param {Object} options Object literal with any of the Fx config options
12242 * @return {Roo.Element} The Element
12244 shift : function(o){
12245 var el = this.getFxEl();
12247 el.queueFx(o, function(){
12248 var a = {}, w = o.width, h = o.height, x = o.x, y = o.y, op = o.opacity;
12249 if(w !== undefined){
12250 a.width = {to: this.adjustWidth(w)};
12252 if(h !== undefined){
12253 a.height = {to: this.adjustHeight(h)};
12255 if(x !== undefined || y !== undefined){
12257 x !== undefined ? x : this.getX(),
12258 y !== undefined ? y : this.getY()
12261 if(op !== undefined){
12262 a.opacity = {to: op};
12264 if(o.xy !== undefined){
12265 a.points = {to: o.xy};
12267 arguments.callee.anim = this.fxanim(a,
12268 o, 'motion', .35, "easeOut", function(){
12276 * Slides the element while fading it out of view. An anchor point can be optionally passed to set the
12277 * ending point of the effect.
12280 // default: slide the element downward while fading out
12283 // custom: slide the element out to the right with a 2-second duration
12284 el.ghost('r', { duration: 2 });
12286 // common config options shown with default values
12294 * @param {String} anchor (optional) One of the valid Fx anchor positions (defaults to bottom: 'b')
12295 * @param {Object} options (optional) Object literal with any of the Fx config options
12296 * @return {Roo.Element} The Element
12298 ghost : function(anchor, o){
12299 var el = this.getFxEl();
12302 el.queueFx(o, function(){
12303 anchor = anchor || "b";
12305 // restore values after effect
12306 var r = this.getFxRestore();
12307 var w = this.getWidth(),
12308 h = this.getHeight();
12310 var st = this.dom.style;
12312 var after = function(){
12314 el.setDisplayed(false);
12320 el.setPositioning(r.pos);
12321 st.width = r.width;
12322 st.height = r.height;
12327 var a = {opacity: {to: 0}, points: {}}, pt = a.points;
12328 switch(anchor.toLowerCase()){
12355 arguments.callee.anim = this.fxanim(a,
12365 * Ensures that all effects queued after syncFx is called on the element are
12366 * run concurrently. This is the opposite of {@link #sequenceFx}.
12367 * @return {Roo.Element} The Element
12369 syncFx : function(){
12370 this.fxDefaults = Roo.apply(this.fxDefaults || {}, {
12379 * Ensures that all effects queued after sequenceFx is called on the element are
12380 * run in sequence. This is the opposite of {@link #syncFx}.
12381 * @return {Roo.Element} The Element
12383 sequenceFx : function(){
12384 this.fxDefaults = Roo.apply(this.fxDefaults || {}, {
12386 concurrent : false,
12393 nextFx : function(){
12394 var ef = this.fxQueue[0];
12401 * Returns true if the element has any effects actively running or queued, else returns false.
12402 * @return {Boolean} True if element has active effects, else false
12404 hasActiveFx : function(){
12405 return this.fxQueue && this.fxQueue[0];
12409 * Stops any running effects and clears the element's internal effects queue if it contains
12410 * any additional effects that haven't started yet.
12411 * @return {Roo.Element} The Element
12413 stopFx : function(){
12414 if(this.hasActiveFx()){
12415 var cur = this.fxQueue[0];
12416 if(cur && cur.anim && cur.anim.isAnimated()){
12417 this.fxQueue = [cur]; // clear out others
12418 cur.anim.stop(true);
12425 beforeFx : function(o){
12426 if(this.hasActiveFx() && !o.concurrent){
12437 * Returns true if the element is currently blocking so that no other effect can be queued
12438 * until this effect is finished, else returns false if blocking is not set. This is commonly
12439 * used to ensure that an effect initiated by a user action runs to completion prior to the
12440 * same effect being restarted (e.g., firing only one effect even if the user clicks several times).
12441 * @return {Boolean} True if blocking, else false
12443 hasFxBlock : function(){
12444 var q = this.fxQueue;
12445 return q && q[0] && q[0].block;
12449 queueFx : function(o, fn){
12453 if(!this.hasFxBlock()){
12454 Roo.applyIf(o, this.fxDefaults);
12456 var run = this.beforeFx(o);
12457 fn.block = o.block;
12458 this.fxQueue.push(fn);
12470 fxWrap : function(pos, o, vis){
12472 if(!o.wrap || !(wrap = Roo.get(o.wrap))){
12475 wrapXY = this.getXY();
12477 var div = document.createElement("div");
12478 div.style.visibility = vis;
12479 wrap = Roo.get(this.dom.parentNode.insertBefore(div, this.dom));
12480 wrap.setPositioning(pos);
12481 if(wrap.getStyle("position") == "static"){
12482 wrap.position("relative");
12484 this.clearPositioning('auto');
12486 wrap.dom.appendChild(this.dom);
12488 wrap.setXY(wrapXY);
12495 fxUnwrap : function(wrap, pos, o){
12496 this.clearPositioning();
12497 this.setPositioning(pos);
12499 wrap.dom.parentNode.insertBefore(this.dom, wrap.dom);
12505 getFxRestore : function(){
12506 var st = this.dom.style;
12507 return {pos: this.getPositioning(), width: st.width, height : st.height};
12511 afterFx : function(o){
12513 this.applyStyles(o.afterStyle);
12516 this.addClass(o.afterCls);
12518 if(o.remove === true){
12521 Roo.callback(o.callback, o.scope, [this]);
12523 this.fxQueue.shift();
12529 getFxEl : function(){ // support for composite element fx
12530 return Roo.get(this.dom);
12534 fxanim : function(args, opt, animType, defaultDur, defaultEase, cb){
12535 animType = animType || 'run';
12537 var anim = Roo.lib.Anim[animType](
12539 (opt.duration || defaultDur) || .35,
12540 (opt.easing || defaultEase) || 'easeOut',
12542 Roo.callback(cb, this);
12551 // backwords compat
12552 Roo.Fx.resize = Roo.Fx.scale;
12554 //When included, Roo.Fx is automatically applied to Element so that all basic
12555 //effects are available directly via the Element API
12556 Roo.apply(Roo.Element.prototype, Roo.Fx);/*
12558 * Ext JS Library 1.1.1
12559 * Copyright(c) 2006-2007, Ext JS, LLC.
12561 * Originally Released Under LGPL - original licence link has changed is not relivant.
12564 * <script type="text/javascript">
12569 * @class Roo.CompositeElement
12570 * Standard composite class. Creates a Roo.Element for every element in the collection.
12572 * <b>NOTE: Although they are not listed, this class supports all of the set/update methods of Roo.Element. All Roo.Element
12573 * actions will be performed on all the elements in this collection.</b>
12575 * All methods return <i>this</i> and can be chained.
12577 var els = Roo.select("#some-el div.some-class", true);
12578 // or select directly from an existing element
12579 var el = Roo.get('some-el');
12580 el.select('div.some-class', true);
12582 els.setWidth(100); // all elements become 100 width
12583 els.hide(true); // all elements fade out and hide
12585 els.setWidth(100).hide(true);
12588 Roo.CompositeElement = function(els){
12589 this.elements = [];
12590 this.addElements(els);
12592 Roo.CompositeElement.prototype = {
12594 addElements : function(els){
12598 if(typeof els == "string"){
12599 els = Roo.Element.selectorFunction(els);
12601 var yels = this.elements;
12602 var index = yels.length-1;
12603 for(var i = 0, len = els.length; i < len; i++) {
12604 yels[++index] = Roo.get(els[i]);
12610 * Clears this composite and adds the elements returned by the passed selector.
12611 * @param {String/Array} els A string CSS selector, an array of elements or an element
12612 * @return {CompositeElement} this
12614 fill : function(els){
12615 this.elements = [];
12621 * Filters this composite to only elements that match the passed selector.
12622 * @param {String} selector A string CSS selector
12623 * @param {Boolean} inverse return inverse filter (not matches)
12624 * @return {CompositeElement} this
12626 filter : function(selector, inverse){
12628 inverse = inverse || false;
12629 this.each(function(el){
12630 var match = inverse ? !el.is(selector) : el.is(selector);
12632 els[els.length] = el.dom;
12639 invoke : function(fn, args){
12640 var els = this.elements;
12641 for(var i = 0, len = els.length; i < len; i++) {
12642 Roo.Element.prototype[fn].apply(els[i], args);
12647 * Adds elements to this composite.
12648 * @param {String/Array} els A string CSS selector, an array of elements or an element
12649 * @return {CompositeElement} this
12651 add : function(els){
12652 if(typeof els == "string"){
12653 this.addElements(Roo.Element.selectorFunction(els));
12654 }else if(els.length !== undefined){
12655 this.addElements(els);
12657 this.addElements([els]);
12662 * Calls the passed function passing (el, this, index) for each element in this composite.
12663 * @param {Function} fn The function to call
12664 * @param {Object} scope (optional) The <i>this</i> object (defaults to the element)
12665 * @return {CompositeElement} this
12667 each : function(fn, scope){
12668 var els = this.elements;
12669 for(var i = 0, len = els.length; i < len; i++){
12670 if(fn.call(scope || els[i], els[i], this, i) === false) {
12678 * Returns the Element object at the specified index
12679 * @param {Number} index
12680 * @return {Roo.Element}
12682 item : function(index){
12683 return this.elements[index] || null;
12687 * Returns the first Element
12688 * @return {Roo.Element}
12690 first : function(){
12691 return this.item(0);
12695 * Returns the last Element
12696 * @return {Roo.Element}
12699 return this.item(this.elements.length-1);
12703 * Returns the number of elements in this composite
12706 getCount : function(){
12707 return this.elements.length;
12711 * Returns true if this composite contains the passed element
12714 contains : function(el){
12715 return this.indexOf(el) !== -1;
12719 * Returns true if this composite contains the passed element
12722 indexOf : function(el){
12723 return this.elements.indexOf(Roo.get(el));
12728 * Removes the specified element(s).
12729 * @param {Mixed} el The id of an element, the Element itself, the index of the element in this composite
12730 * or an array of any of those.
12731 * @param {Boolean} removeDom (optional) True to also remove the element from the document
12732 * @return {CompositeElement} this
12734 removeElement : function(el, removeDom){
12735 if(el instanceof Array){
12736 for(var i = 0, len = el.length; i < len; i++){
12737 this.removeElement(el[i]);
12741 var index = typeof el == 'number' ? el : this.indexOf(el);
12744 var d = this.elements[index];
12748 d.parentNode.removeChild(d);
12751 this.elements.splice(index, 1);
12757 * Replaces the specified element with the passed element.
12758 * @param {String/HTMLElement/Element/Number} el The id of an element, the Element itself, the index of the element in this composite
12760 * @param {String/HTMLElement/Element} replacement The id of an element or the Element itself.
12761 * @param {Boolean} domReplace (Optional) True to remove and replace the element in the document too.
12762 * @return {CompositeElement} this
12764 replaceElement : function(el, replacement, domReplace){
12765 var index = typeof el == 'number' ? el : this.indexOf(el);
12768 this.elements[index].replaceWith(replacement);
12770 this.elements.splice(index, 1, Roo.get(replacement))
12777 * Removes all elements.
12779 clear : function(){
12780 this.elements = [];
12784 Roo.CompositeElement.createCall = function(proto, fnName){
12785 if(!proto[fnName]){
12786 proto[fnName] = function(){
12787 return this.invoke(fnName, arguments);
12791 for(var fnName in Roo.Element.prototype){
12792 if(typeof Roo.Element.prototype[fnName] == "function"){
12793 Roo.CompositeElement.createCall(Roo.CompositeElement.prototype, fnName);
12799 * Ext JS Library 1.1.1
12800 * Copyright(c) 2006-2007, Ext JS, LLC.
12802 * Originally Released Under LGPL - original licence link has changed is not relivant.
12805 * <script type="text/javascript">
12809 * @class Roo.CompositeElementLite
12810 * @extends Roo.CompositeElement
12811 * Flyweight composite class. Reuses the same Roo.Element for element operations.
12813 var els = Roo.select("#some-el div.some-class");
12814 // or select directly from an existing element
12815 var el = Roo.get('some-el');
12816 el.select('div.some-class');
12818 els.setWidth(100); // all elements become 100 width
12819 els.hide(true); // all elements fade out and hide
12821 els.setWidth(100).hide(true);
12822 </code></pre><br><br>
12823 * <b>NOTE: Although they are not listed, this class supports all of the set/update methods of Roo.Element. All Roo.Element
12824 * actions will be performed on all the elements in this collection.</b>
12826 Roo.CompositeElementLite = function(els){
12827 Roo.CompositeElementLite.superclass.constructor.call(this, els);
12828 this.el = new Roo.Element.Flyweight();
12830 Roo.extend(Roo.CompositeElementLite, Roo.CompositeElement, {
12831 addElements : function(els){
12833 if(els instanceof Array){
12834 this.elements = this.elements.concat(els);
12836 var yels = this.elements;
12837 var index = yels.length-1;
12838 for(var i = 0, len = els.length; i < len; i++) {
12839 yels[++index] = els[i];
12845 invoke : function(fn, args){
12846 var els = this.elements;
12848 for(var i = 0, len = els.length; i < len; i++) {
12850 Roo.Element.prototype[fn].apply(el, args);
12855 * Returns a flyweight Element of the dom element object at the specified index
12856 * @param {Number} index
12857 * @return {Roo.Element}
12859 item : function(index){
12860 if(!this.elements[index]){
12863 this.el.dom = this.elements[index];
12867 // fixes scope with flyweight
12868 addListener : function(eventName, handler, scope, opt){
12869 var els = this.elements;
12870 for(var i = 0, len = els.length; i < len; i++) {
12871 Roo.EventManager.on(els[i], eventName, handler, scope || els[i], opt);
12877 * Calls the passed function passing (el, this, index) for each element in this composite. <b>The element
12878 * passed is the flyweight (shared) Roo.Element instance, so if you require a
12879 * a reference to the dom node, use el.dom.</b>
12880 * @param {Function} fn The function to call
12881 * @param {Object} scope (optional) The <i>this</i> object (defaults to the element)
12882 * @return {CompositeElement} this
12884 each : function(fn, scope){
12885 var els = this.elements;
12887 for(var i = 0, len = els.length; i < len; i++){
12889 if(fn.call(scope || el, el, this, i) === false){
12896 indexOf : function(el){
12897 return this.elements.indexOf(Roo.getDom(el));
12900 replaceElement : function(el, replacement, domReplace){
12901 var index = typeof el == 'number' ? el : this.indexOf(el);
12903 replacement = Roo.getDom(replacement);
12905 var d = this.elements[index];
12906 d.parentNode.insertBefore(replacement, d);
12907 d.parentNode.removeChild(d);
12909 this.elements.splice(index, 1, replacement);
12914 Roo.CompositeElementLite.prototype.on = Roo.CompositeElementLite.prototype.addListener;
12918 * Ext JS Library 1.1.1
12919 * Copyright(c) 2006-2007, Ext JS, LLC.
12921 * Originally Released Under LGPL - original licence link has changed is not relivant.
12924 * <script type="text/javascript">
12930 * @class Roo.data.Connection
12931 * @extends Roo.util.Observable
12932 * The class encapsulates a connection to the page's originating domain, allowing requests to be made
12933 * either to a configured URL, or to a URL specified at request time.
12935 * Requests made by this class are asynchronous, and will return immediately. No data from
12936 * the server will be available to the statement immediately following the {@link #request} call.
12937 * To process returned data, use a callback in the request options object, or an event listener.
12939 * Note: If you are doing a file upload, you will not get a normal response object sent back to
12940 * your callback or event handler. Since the upload is handled via in IFRAME, there is no XMLHttpRequest.
12941 * The response object is created using the innerHTML of the IFRAME's document as the responseText
12942 * property and, if present, the IFRAME's XML document as the responseXML property.
12944 * This means that a valid XML or HTML document must be returned. If JSON data is required, it is suggested
12945 * that it be placed either inside a <textarea> in an HTML document and retrieved from the responseText
12946 * using a regex, or inside a CDATA section in an XML document and retrieved from the responseXML using
12947 * standard DOM methods.
12949 * @param {Object} config a configuration object.
12951 Roo.data.Connection = function(config){
12952 Roo.apply(this, config);
12955 * @event beforerequest
12956 * Fires before a network request is made to retrieve a data object.
12957 * @param {Connection} conn This Connection object.
12958 * @param {Object} options The options config object passed to the {@link #request} method.
12960 "beforerequest" : true,
12962 * @event requestcomplete
12963 * Fires if the request was successfully completed.
12964 * @param {Connection} conn This Connection object.
12965 * @param {Object} response The XHR object containing the response data.
12966 * See {@link http://www.w3.org/TR/XMLHttpRequest/} for details.
12967 * @param {Object} options The options config object passed to the {@link #request} method.
12969 "requestcomplete" : true,
12971 * @event requestexception
12972 * Fires if an error HTTP status was returned from the server.
12973 * See {@link http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html} for details of HTTP status codes.
12974 * @param {Connection} conn This Connection object.
12975 * @param {Object} response The XHR object containing the response data.
12976 * See {@link http://www.w3.org/TR/XMLHttpRequest/} for details.
12977 * @param {Object} options The options config object passed to the {@link #request} method.
12979 "requestexception" : true
12981 Roo.data.Connection.superclass.constructor.call(this);
12984 Roo.extend(Roo.data.Connection, Roo.util.Observable, {
12986 * @cfg {String} url (Optional) The default URL to be used for requests to the server. (defaults to undefined)
12989 * @cfg {Object} extraParams (Optional) An object containing properties which are used as
12990 * extra parameters to each request made by this object. (defaults to undefined)
12993 * @cfg {Object} defaultHeaders (Optional) An object containing request headers which are added
12994 * to each request made by this object. (defaults to undefined)
12997 * @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)
13000 * @cfg {Number} timeout (Optional) The timeout in milliseconds to be used for requests. (defaults to 30000)
13004 * @cfg {Boolean} autoAbort (Optional) Whether this request should abort any pending requests. (defaults to false)
13010 * @cfg {Boolean} disableCaching (Optional) True to add a unique cache-buster param to GET requests. (defaults to true)
13013 disableCaching: true,
13016 * Sends an HTTP request to a remote server.
13017 * @param {Object} options An object which may contain the following properties:<ul>
13018 * <li><b>url</b> {String} (Optional) The URL to which to send the request. Defaults to configured URL</li>
13019 * <li><b>params</b> {Object/String/Function} (Optional) An object containing properties which are used as parameters to the
13020 * request, a url encoded string or a function to call to get either.</li>
13021 * <li><b>method</b> {String} (Optional) The HTTP method to use for the request. Defaults to the configured method, or
13022 * if no method was configured, "GET" if no parameters are being sent, and "POST" if parameters are being sent.</li>
13023 * <li><b>callback</b> {Function} (Optional) The function to be called upon receipt of the HTTP response.
13024 * The callback is called regardless of success or failure and is passed the following parameters:<ul>
13025 * <li>options {Object} The parameter to the request call.</li>
13026 * <li>success {Boolean} True if the request succeeded.</li>
13027 * <li>response {Object} The XMLHttpRequest object containing the response data.</li>
13029 * <li><b>success</b> {Function} (Optional) The function to be called upon success of the request.
13030 * The callback is passed the following parameters:<ul>
13031 * <li>response {Object} The XMLHttpRequest object containing the response data.</li>
13032 * <li>options {Object} The parameter to the request call.</li>
13034 * <li><b>failure</b> {Function} (Optional) The function to be called upon failure of the request.
13035 * The callback is passed the following parameters:<ul>
13036 * <li>response {Object} The XMLHttpRequest object containing the response data.</li>
13037 * <li>options {Object} The parameter to the request call.</li>
13039 * <li><b>scope</b> {Object} (Optional) The scope in which to execute the callbacks: The "this" object
13040 * for the callback function. Defaults to the browser window.</li>
13041 * <li><b>form</b> {Object/String} (Optional) A form object or id to pull parameters from.</li>
13042 * <li><b>isUpload</b> {Boolean} (Optional) True if the form object is a file upload (will usually be automatically detected).</li>
13043 * <li><b>headers</b> {Object} (Optional) Request headers to set for the request.</li>
13044 * <li><b>xmlData</b> {Object} (Optional) XML document to use for the post. Note: This will be used instead of
13045 * params for the post data. Any params will be appended to the URL.</li>
13046 * <li><b>disableCaching</b> {Boolean} (Optional) True to add a unique cache-buster param to GET requests.</li>
13048 * @return {Number} transactionId
13050 request : function(o){
13051 if(this.fireEvent("beforerequest", this, o) !== false){
13054 if(typeof p == "function"){
13055 p = p.call(o.scope||window, o);
13057 if(typeof p == "object"){
13058 p = Roo.urlEncode(o.params);
13060 if(this.extraParams){
13061 var extras = Roo.urlEncode(this.extraParams);
13062 p = p ? (p + '&' + extras) : extras;
13065 var url = o.url || this.url;
13066 if(typeof url == 'function'){
13067 url = url.call(o.scope||window, o);
13071 var form = Roo.getDom(o.form);
13072 url = url || form.action;
13074 var enctype = form.getAttribute("enctype");
13077 return this.doFormDataUpload(o, url);
13080 if(o.isUpload || (enctype && enctype.toLowerCase() == 'multipart/form-data')){
13081 return this.doFormUpload(o, p, url);
13083 var f = Roo.lib.Ajax.serializeForm(form);
13084 p = p ? (p + '&' + f) : f;
13087 if (!o.form && o.formData) {
13088 o.formData = o.formData === true ? new FormData() : o.formData;
13089 for (var k in o.params) {
13090 o.formData.append(k,o.params[k]);
13093 return this.doFormDataUpload(o, url);
13097 var hs = o.headers;
13098 if(this.defaultHeaders){
13099 hs = Roo.apply(hs || {}, this.defaultHeaders);
13106 success: this.handleResponse,
13107 failure: this.handleFailure,
13109 argument: {options: o},
13110 timeout : o.timeout || this.timeout
13113 var method = o.method||this.method||(p ? "POST" : "GET");
13115 if(method == 'GET' && (this.disableCaching && o.disableCaching !== false) || o.disableCaching === true){
13116 url += (url.indexOf('?') != -1 ? '&' : '?') + '_dc=' + (new Date().getTime());
13119 if(typeof o.autoAbort == 'boolean'){ // options gets top priority
13123 }else if(this.autoAbort !== false){
13127 if((method == 'GET' && p) || o.xmlData){
13128 url += (url.indexOf('?') != -1 ? '&' : '?') + p;
13131 Roo.lib.Ajax.useDefaultHeader = typeof(o.headers) == 'undefined' || typeof(o.headers['Content-Type']) == 'undefined';
13132 this.transId = Roo.lib.Ajax.request(method, url, cb, p, o);
13133 Roo.lib.Ajax.useDefaultHeader == true;
13134 return this.transId;
13136 Roo.callback(o.callback, o.scope, [o, null, null]);
13142 * Determine whether this object has a request outstanding.
13143 * @param {Number} transactionId (Optional) defaults to the last transaction
13144 * @return {Boolean} True if there is an outstanding request.
13146 isLoading : function(transId){
13148 return Roo.lib.Ajax.isCallInProgress(transId);
13150 return this.transId ? true : false;
13155 * Aborts any outstanding request.
13156 * @param {Number} transactionId (Optional) defaults to the last transaction
13158 abort : function(transId){
13159 if(transId || this.isLoading()){
13160 Roo.lib.Ajax.abort(transId || this.transId);
13165 handleResponse : function(response){
13166 this.transId = false;
13167 var options = response.argument.options;
13168 response.argument = options ? options.argument : null;
13169 this.fireEvent("requestcomplete", this, response, options);
13170 Roo.callback(options.success, options.scope, [response, options]);
13171 Roo.callback(options.callback, options.scope, [options, true, response]);
13175 handleFailure : function(response, e){
13176 this.transId = false;
13177 var options = response.argument.options;
13178 response.argument = options ? options.argument : null;
13179 this.fireEvent("requestexception", this, response, options, e);
13180 Roo.callback(options.failure, options.scope, [response, options]);
13181 Roo.callback(options.callback, options.scope, [options, false, response]);
13185 doFormUpload : function(o, ps, url){
13187 var frame = document.createElement('iframe');
13190 frame.className = 'x-hidden';
13192 frame.src = Roo.SSL_SECURE_URL;
13194 document.body.appendChild(frame);
13197 document.frames[id].name = id;
13200 var form = Roo.getDom(o.form);
13202 form.method = 'POST';
13203 form.enctype = form.encoding = 'multipart/form-data';
13209 if(ps){ // add dynamic params
13211 ps = Roo.urlDecode(ps, false);
13213 if(ps.hasOwnProperty(k)){
13214 hd = document.createElement('input');
13215 hd.type = 'hidden';
13218 form.appendChild(hd);
13225 var r = { // bogus response object
13230 r.argument = o ? o.argument : null;
13235 doc = frame.contentWindow.document;
13237 doc = (frame.contentDocument || window.frames[id].document);
13239 if(doc && doc.body){
13240 r.responseText = doc.body.innerHTML;
13242 if(doc && doc.XMLDocument){
13243 r.responseXML = doc.XMLDocument;
13245 r.responseXML = doc;
13252 Roo.EventManager.removeListener(frame, 'load', cb, this);
13254 this.fireEvent("requestcomplete", this, r, o);
13255 Roo.callback(o.success, o.scope, [r, o]);
13256 Roo.callback(o.callback, o.scope, [o, true, r]);
13258 setTimeout(function(){document.body.removeChild(frame);}, 100);
13261 Roo.EventManager.on(frame, 'load', cb, this);
13264 if(hiddens){ // remove dynamic params
13265 for(var i = 0, len = hiddens.length; i < len; i++){
13266 form.removeChild(hiddens[i]);
13270 // this is a 'formdata version???'
13273 doFormDataUpload : function(o, url)
13277 var form = Roo.getDom(o.form);
13278 form.enctype = form.encoding = 'multipart/form-data';
13279 formData = o.formData === true ? new FormData(form) : o.formData;
13281 formData = o.formData === true ? new FormData() : o.formData;
13286 success: this.handleResponse,
13287 failure: this.handleFailure,
13289 argument: {options: o},
13290 timeout : o.timeout || this.timeout
13293 if(typeof o.autoAbort == 'boolean'){ // options gets top priority
13297 }else if(this.autoAbort !== false){
13301 //Roo.lib.Ajax.defaultPostHeader = null;
13302 Roo.lib.Ajax.useDefaultHeader = false;
13303 this.transId = Roo.lib.Ajax.request( "POST", url, cb, formData, o);
13304 Roo.lib.Ajax.useDefaultHeader = true;
13312 * Ext JS Library 1.1.1
13313 * Copyright(c) 2006-2007, Ext JS, LLC.
13315 * Originally Released Under LGPL - original licence link has changed is not relivant.
13318 * <script type="text/javascript">
13322 * Global Ajax request class.
13325 * @extends Roo.data.Connection
13328 * @cfg {String} url The default URL to be used for requests to the server. (defaults to undefined)
13329 * @cfg {Object} extraParams An object containing properties which are used as extra parameters to each request made by this object. (defaults to undefined)
13330 * @cfg {Object} defaultHeaders An object containing request headers which are added to each request made by this object. (defaults to undefined)
13331 * @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)
13332 * @cfg {Number} timeout (Optional) The timeout in milliseconds to be used for requests. (defaults to 30000)
13333 * @cfg {Boolean} autoAbort (Optional) Whether a new request should abort any pending requests. (defaults to false)
13334 * @cfg {Boolean} disableCaching (Optional) True to add a unique cache-buster param to GET requests. (defaults to true)
13336 Roo.Ajax = new Roo.data.Connection({
13345 * Serialize the passed form into a url encoded string
13347 * @param {String/HTMLElement} form
13350 serializeForm : function(form){
13351 return Roo.lib.Ajax.serializeForm(form);
13355 * Ext JS Library 1.1.1
13356 * Copyright(c) 2006-2007, Ext JS, LLC.
13358 * Originally Released Under LGPL - original licence link has changed is not relivant.
13361 * <script type="text/javascript">
13366 * @class Roo.UpdateManager
13367 * @extends Roo.util.Observable
13368 * Provides AJAX-style update for Element object.<br><br>
13371 * // Get it from a Roo.Element object
13372 * var el = Roo.get("foo");
13373 * var mgr = el.getUpdateManager();
13374 * mgr.update("http://myserver.com/index.php", "param1=1&param2=2");
13376 * mgr.formUpdate("myFormId", "http://myserver.com/index.php");
13378 * // or directly (returns the same UpdateManager instance)
13379 * var mgr = new Roo.UpdateManager("myElementId");
13380 * mgr.startAutoRefresh(60, "http://myserver.com/index.php");
13381 * mgr.on("update", myFcnNeedsToKnow);
13383 // short handed call directly from the element object
13384 Roo.get("foo").load({
13388 text: "Loading Foo..."
13392 * Create new UpdateManager directly.
13393 * @param {String/HTMLElement/Roo.Element} el The element to update
13394 * @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).
13396 Roo.UpdateManager = function(el, forceNew){
13398 if(!forceNew && el.updateManager){
13399 return el.updateManager;
13402 * The Element object
13403 * @type Roo.Element
13407 * Cached url to use for refreshes. Overwritten every time update() is called unless "discardUrl" param is set to true.
13410 this.defaultUrl = null;
13414 * @event beforeupdate
13415 * Fired before an update is made, return false from your handler and the update is cancelled.
13416 * @param {Roo.Element} el
13417 * @param {String/Object/Function} url
13418 * @param {String/Object} params
13420 "beforeupdate": true,
13423 * Fired after successful update is made.
13424 * @param {Roo.Element} el
13425 * @param {Object} oResponseObject The response Object
13430 * Fired on update failure.
13431 * @param {Roo.Element} el
13432 * @param {Object} oResponseObject The response Object
13436 var d = Roo.UpdateManager.defaults;
13438 * Blank page URL to use with SSL file uploads (Defaults to Roo.UpdateManager.defaults.sslBlankUrl or "about:blank").
13441 this.sslBlankUrl = d.sslBlankUrl;
13443 * Whether to append unique parameter on get request to disable caching (Defaults to Roo.UpdateManager.defaults.disableCaching or false).
13446 this.disableCaching = d.disableCaching;
13448 * Text for loading indicator (Defaults to Roo.UpdateManager.defaults.indicatorText or '<div class="loading-indicator">Loading...</div>').
13451 this.indicatorText = d.indicatorText;
13453 * Whether to show indicatorText when loading (Defaults to Roo.UpdateManager.defaults.showLoadIndicator or true).
13456 this.showLoadIndicator = d.showLoadIndicator;
13458 * Timeout for requests or form posts in seconds (Defaults to Roo.UpdateManager.defaults.timeout or 30 seconds).
13461 this.timeout = d.timeout;
13464 * True to process scripts in the output (Defaults to Roo.UpdateManager.defaults.loadScripts (false)).
13467 this.loadScripts = d.loadScripts;
13470 * Transaction object of current executing transaction
13472 this.transaction = null;
13477 this.autoRefreshProcId = null;
13479 * Delegate for refresh() prebound to "this", use myUpdater.refreshDelegate.createCallback(arg1, arg2) to bind arguments
13482 this.refreshDelegate = this.refresh.createDelegate(this);
13484 * Delegate for update() prebound to "this", use myUpdater.updateDelegate.createCallback(arg1, arg2) to bind arguments
13487 this.updateDelegate = this.update.createDelegate(this);
13489 * Delegate for formUpdate() prebound to "this", use myUpdater.formUpdateDelegate.createCallback(arg1, arg2) to bind arguments
13492 this.formUpdateDelegate = this.formUpdate.createDelegate(this);
13496 this.successDelegate = this.processSuccess.createDelegate(this);
13500 this.failureDelegate = this.processFailure.createDelegate(this);
13502 if(!this.renderer){
13504 * The renderer for this UpdateManager. Defaults to {@link Roo.UpdateManager.BasicRenderer}.
13506 this.renderer = new Roo.UpdateManager.BasicRenderer();
13509 Roo.UpdateManager.superclass.constructor.call(this);
13512 Roo.extend(Roo.UpdateManager, Roo.util.Observable, {
13514 * Get the Element this UpdateManager is bound to
13515 * @return {Roo.Element} The element
13517 getEl : function(){
13521 * Performs an async request, updating this element with the response. If params are specified it uses POST, otherwise it uses GET.
13522 * @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:
13525 url: "your-url.php",<br/>
13526 params: {param1: "foo", param2: "bar"}, // or a URL encoded string<br/>
13527 callback: yourFunction,<br/>
13528 scope: yourObject, //(optional scope) <br/>
13529 discardUrl: false, <br/>
13530 nocache: false,<br/>
13531 text: "Loading...",<br/>
13533 scripts: false<br/>
13536 * The only required property is url. The optional properties nocache, text and scripts
13537 * are shorthand for disableCaching, indicatorText and loadScripts and are used to set their associated property on this UpdateManager instance.
13538 * @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}
13539 * @param {Function} callback (optional) Callback when transaction is complete - called with signature (oElement, bSuccess, oResponse)
13540 * @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.
13542 update : function(url, params, callback, discardUrl){
13543 if(this.fireEvent("beforeupdate", this.el, url, params) !== false){
13544 var method = this.method,
13546 if(typeof url == "object"){ // must be config object
13549 params = params || cfg.params;
13550 callback = callback || cfg.callback;
13551 discardUrl = discardUrl || cfg.discardUrl;
13552 if(callback && cfg.scope){
13553 callback = callback.createDelegate(cfg.scope);
13555 if(typeof cfg.method != "undefined"){method = cfg.method;};
13556 if(typeof cfg.nocache != "undefined"){this.disableCaching = cfg.nocache;};
13557 if(typeof cfg.text != "undefined"){this.indicatorText = '<div class="loading-indicator">'+cfg.text+"</div>";};
13558 if(typeof cfg.scripts != "undefined"){this.loadScripts = cfg.scripts;};
13559 if(typeof cfg.timeout != "undefined"){this.timeout = cfg.timeout;};
13561 this.showLoading();
13563 this.defaultUrl = url;
13565 if(typeof url == "function"){
13566 url = url.call(this);
13569 method = method || (params ? "POST" : "GET");
13570 if(method == "GET"){
13571 url = this.prepareUrl(url);
13574 var o = Roo.apply(cfg ||{}, {
13577 success: this.successDelegate,
13578 failure: this.failureDelegate,
13579 callback: undefined,
13580 timeout: (this.timeout*1000),
13581 argument: {"url": url, "form": null, "callback": callback, "params": params}
13583 Roo.log("updated manager called with timeout of " + o.timeout);
13584 this.transaction = Roo.Ajax.request(o);
13589 * 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.
13590 * Uses this.sslBlankUrl for SSL file uploads to prevent IE security warning.
13591 * @param {String/HTMLElement} form The form Id or form element
13592 * @param {String} url (optional) The url to pass the form to. If omitted the action attribute on the form will be used.
13593 * @param {Boolean} reset (optional) Whether to try to reset the form after the update
13594 * @param {Function} callback (optional) Callback when transaction is complete - called with signature (oElement, bSuccess, oResponse)
13596 formUpdate : function(form, url, reset, callback){
13597 if(this.fireEvent("beforeupdate", this.el, form, url) !== false){
13598 if(typeof url == "function"){
13599 url = url.call(this);
13601 form = Roo.getDom(form);
13602 this.transaction = Roo.Ajax.request({
13605 success: this.successDelegate,
13606 failure: this.failureDelegate,
13607 timeout: (this.timeout*1000),
13608 argument: {"url": url, "form": form, "callback": callback, "reset": reset}
13610 this.showLoading.defer(1, this);
13615 * Refresh the element with the last used url or defaultUrl. If there is no url, it returns immediately
13616 * @param {Function} callback (optional) Callback when transaction is complete - called with signature (oElement, bSuccess)
13618 refresh : function(callback){
13619 if(this.defaultUrl == null){
13622 this.update(this.defaultUrl, null, callback, true);
13626 * Set this element to auto refresh.
13627 * @param {Number} interval How often to update (in seconds).
13628 * @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)
13629 * @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}
13630 * @param {Function} callback (optional) Callback when transaction is complete - called with signature (oElement, bSuccess)
13631 * @param {Boolean} refreshNow (optional) Whether to execute the refresh now, or wait the interval
13633 startAutoRefresh : function(interval, url, params, callback, refreshNow){
13635 this.update(url || this.defaultUrl, params, callback, true);
13637 if(this.autoRefreshProcId){
13638 clearInterval(this.autoRefreshProcId);
13640 this.autoRefreshProcId = setInterval(this.update.createDelegate(this, [url || this.defaultUrl, params, callback, true]), interval*1000);
13644 * Stop auto refresh on this element.
13646 stopAutoRefresh : function(){
13647 if(this.autoRefreshProcId){
13648 clearInterval(this.autoRefreshProcId);
13649 delete this.autoRefreshProcId;
13653 isAutoRefreshing : function(){
13654 return this.autoRefreshProcId ? true : false;
13657 * Called to update the element to "Loading" state. Override to perform custom action.
13659 showLoading : function(){
13660 if(this.showLoadIndicator){
13661 this.el.update(this.indicatorText);
13666 * Adds unique parameter to query string if disableCaching = true
13669 prepareUrl : function(url){
13670 if(this.disableCaching){
13671 var append = "_dc=" + (new Date().getTime());
13672 if(url.indexOf("?") !== -1){
13673 url += "&" + append;
13675 url += "?" + append;
13684 processSuccess : function(response){
13685 this.transaction = null;
13686 if(response.argument.form && response.argument.reset){
13687 try{ // put in try/catch since some older FF releases had problems with this
13688 response.argument.form.reset();
13691 if(this.loadScripts){
13692 this.renderer.render(this.el, response, this,
13693 this.updateComplete.createDelegate(this, [response]));
13695 this.renderer.render(this.el, response, this);
13696 this.updateComplete(response);
13700 updateComplete : function(response){
13701 this.fireEvent("update", this.el, response);
13702 if(typeof response.argument.callback == "function"){
13703 response.argument.callback(this.el, true, response);
13710 processFailure : function(response){
13711 this.transaction = null;
13712 this.fireEvent("failure", this.el, response);
13713 if(typeof response.argument.callback == "function"){
13714 response.argument.callback(this.el, false, response);
13719 * Set the content renderer for this UpdateManager. See {@link Roo.UpdateManager.BasicRenderer#render} for more details.
13720 * @param {Object} renderer The object implementing the render() method
13722 setRenderer : function(renderer){
13723 this.renderer = renderer;
13726 getRenderer : function(){
13727 return this.renderer;
13731 * Set the defaultUrl used for updates
13732 * @param {String/Function} defaultUrl The url or a function to call to get the url
13734 setDefaultUrl : function(defaultUrl){
13735 this.defaultUrl = defaultUrl;
13739 * Aborts the executing transaction
13741 abort : function(){
13742 if(this.transaction){
13743 Roo.Ajax.abort(this.transaction);
13748 * Returns true if an update is in progress
13749 * @return {Boolean}
13751 isUpdating : function(){
13752 if(this.transaction){
13753 return Roo.Ajax.isLoading(this.transaction);
13760 * @class Roo.UpdateManager.defaults
13761 * @static (not really - but it helps the doc tool)
13762 * The defaults collection enables customizing the default properties of UpdateManager
13764 Roo.UpdateManager.defaults = {
13766 * Timeout for requests or form posts in seconds (Defaults 30 seconds).
13772 * True to process scripts by default (Defaults to false).
13775 loadScripts : false,
13778 * Blank page URL to use with SSL file uploads (Defaults to "javascript:false").
13781 sslBlankUrl : (Roo.SSL_SECURE_URL || "javascript:false"),
13783 * Whether to append unique parameter on get request to disable caching (Defaults to false).
13786 disableCaching : false,
13788 * Whether to show indicatorText when loading (Defaults to true).
13791 showLoadIndicator : true,
13793 * Text for loading indicator (Defaults to '<div class="loading-indicator">Loading...</div>').
13796 indicatorText : '<div class="loading-indicator">Loading...</div>'
13800 * Static convenience method. This method is deprecated in favor of el.load({url:'foo.php', ...}).
13802 * <pre><code>Roo.UpdateManager.updateElement("my-div", "stuff.php");</code></pre>
13803 * @param {String/HTMLElement/Roo.Element} el The element to update
13804 * @param {String} url The url
13805 * @param {String/Object} params (optional) Url encoded param string or an object of name/value pairs
13806 * @param {Object} options (optional) A config object with any of the UpdateManager properties you want to set - for example: {disableCaching:true, indicatorText: "Loading data..."}
13809 * @member Roo.UpdateManager
13811 Roo.UpdateManager.updateElement = function(el, url, params, options){
13812 var um = Roo.get(el, true).getUpdateManager();
13813 Roo.apply(um, options);
13814 um.update(url, params, options ? options.callback : null);
13816 // alias for backwards compat
13817 Roo.UpdateManager.update = Roo.UpdateManager.updateElement;
13819 * @class Roo.UpdateManager.BasicRenderer
13820 * Default Content renderer. Updates the elements innerHTML with the responseText.
13822 Roo.UpdateManager.BasicRenderer = function(){};
13824 Roo.UpdateManager.BasicRenderer.prototype = {
13826 * This is called when the transaction is completed and it's time to update the element - The BasicRenderer
13827 * updates the elements innerHTML with the responseText - To perform a custom render (i.e. XML or JSON processing),
13828 * create an object with a "render(el, response)" method and pass it to setRenderer on the UpdateManager.
13829 * @param {Roo.Element} el The element being rendered
13830 * @param {Object} response The YUI Connect response object
13831 * @param {UpdateManager} updateManager The calling update manager
13832 * @param {Function} callback A callback that will need to be called if loadScripts is true on the UpdateManager
13834 render : function(el, response, updateManager, callback){
13835 el.update(response.responseText, updateManager.loadScripts, callback);
13841 * (c)) Alan Knowles
13847 * @class Roo.DomTemplate
13848 * @extends Roo.Template
13849 * An effort at a dom based template engine..
13851 * Similar to XTemplate, except it uses dom parsing to create the template..
13853 * Supported features:
13858 {a_variable} - output encoded.
13859 {a_variable.format:("Y-m-d")} - call a method on the variable
13860 {a_variable:raw} - unencoded output
13861 {a_variable:toFixed(1,2)} - Roo.util.Format."toFixed"
13862 {a_variable:this.method_on_template(...)} - call a method on the template object.
13867 <div roo-for="a_variable or condition.."></div>
13868 <div roo-if="a_variable or condition"></div>
13869 <div roo-exec="some javascript"></div>
13870 <div roo-name="named_template"></div>
13875 Roo.DomTemplate = function()
13877 Roo.DomTemplate.superclass.constructor.apply(this, arguments);
13884 Roo.extend(Roo.DomTemplate, Roo.Template, {
13886 * id counter for sub templates.
13890 * flag to indicate if dom parser is inside a pre,
13891 * it will strip whitespace if not.
13896 * The various sub templates
13904 * basic tag replacing syntax
13907 * // you can fake an object call by doing this
13911 re : /(\{|\%7B)([\w-\.]+)(?:\:([\w\.]*)(?:\(([^)]*?)?\))?)?(\}|\%7D)/g,
13912 //re : /\{([\w-\.]+)(?:\:([\w\.]*)(?:\((.*?)?\))?)?\}/g,
13914 iterChild : function (node, method) {
13916 var oldPre = this.inPre;
13917 if (node.tagName == 'PRE') {
13920 for( var i = 0; i < node.childNodes.length; i++) {
13921 method.call(this, node.childNodes[i]);
13923 this.inPre = oldPre;
13929 * compile the template
13931 * This is not recursive, so I'm not sure how nested templates are really going to be handled..
13934 compile: function()
13938 // covert the html into DOM...
13942 doc = document.implementation.createHTMLDocument("");
13943 doc.documentElement.innerHTML = this.html ;
13944 div = doc.documentElement;
13946 // old IE... - nasty -- it causes all sorts of issues.. with
13947 // images getting pulled from server..
13948 div = document.createElement('div');
13949 div.innerHTML = this.html;
13951 //doc.documentElement.innerHTML = htmlBody
13957 this.iterChild(div, function(n) {_t.compileNode(n, true); });
13959 var tpls = this.tpls;
13961 // create a top level template from the snippet..
13963 //Roo.log(div.innerHTML);
13970 body : div.innerHTML,
13983 Roo.each(tpls, function(tp){
13984 this.compileTpl(tp);
13985 this.tpls[tp.id] = tp;
13988 this.master = tpls[0];
13994 compileNode : function(node, istop) {
13999 // skip anything not a tag..
14000 if (node.nodeType != 1) {
14001 if (node.nodeType == 3 && !this.inPre) {
14002 // reduce white space..
14003 node.nodeValue = node.nodeValue.replace(/\s+/g, ' ');
14026 case (node.hasAttribute('roo-for')): tpl.attr = 'for'; break;
14027 case (node.hasAttribute('roo-if')): tpl.attr = 'if'; break;
14028 case (node.hasAttribute('roo-name')): tpl.attr = 'name'; break;
14029 case (node.hasAttribute('roo-exec')): tpl.attr = 'exec'; break;
14035 // just itterate children..
14036 this.iterChild(node,this.compileNode);
14039 tpl.uid = this.id++;
14040 tpl.value = node.getAttribute('roo-' + tpl.attr);
14041 node.removeAttribute('roo-'+ tpl.attr);
14042 if (tpl.attr != 'name') {
14043 var placeholder = document.createTextNode('{domtpl' + tpl.uid + '}');
14044 node.parentNode.replaceChild(placeholder, node);
14047 var placeholder = document.createElement('span');
14048 placeholder.className = 'roo-tpl-' + tpl.value;
14049 node.parentNode.replaceChild(placeholder, node);
14052 // parent now sees '{domtplXXXX}
14053 this.iterChild(node,this.compileNode);
14055 // we should now have node body...
14056 var div = document.createElement('div');
14057 div.appendChild(node);
14059 // this has the unfortunate side effect of converting tagged attributes
14060 // eg. href="{...}" into %7C...%7D
14061 // this has been fixed by searching for those combo's although it's a bit hacky..
14064 tpl.body = div.innerHTML;
14071 switch (tpl.value) {
14072 case '.': tpl.forCall = new Function('values', 'parent', 'with(values){ return values; }'); break;
14073 case '..': tpl.forCall= new Function('values', 'parent', 'with(values){ return parent; }'); break;
14074 default: tpl.forCall= new Function('values', 'parent', 'with(values){ return '+tpl.value+'; }');
14079 tpl.execCall = new Function('values', 'parent', 'with(values){ '+(Roo.util.Format.htmlDecode(tpl.value))+'; }');
14083 tpl.ifCall = new Function('values', 'parent', 'with(values){ return '+(Roo.util.Format.htmlDecode(tpl.value))+'; }');
14087 tpl.id = tpl.value; // replace non characters???
14093 this.tpls.push(tpl);
14103 * Compile a segment of the template into a 'sub-template'
14109 compileTpl : function(tpl)
14111 var fm = Roo.util.Format;
14112 var useF = this.disableFormats !== true;
14114 var sep = Roo.isGecko ? "+\n" : ",\n";
14116 var undef = function(str) {
14117 Roo.debug && Roo.log("Property not found :" + str);
14121 //Roo.log(tpl.body);
14125 var fn = function(m, lbrace, name, format, args)
14128 //Roo.log(arguments);
14129 args = args ? args.replace(/\\'/g,"'") : args;
14130 //["{TEST:(a,b,c)}", "TEST", "", "a,b,c", 0, "{TEST:(a,b,c)}"]
14131 if (typeof(format) == 'undefined') {
14132 format = 'htmlEncode';
14134 if (format == 'raw' ) {
14138 if(name.substr(0, 6) == 'domtpl'){
14139 return "'"+ sep +'this.applySubTemplate('+name.substr(6)+', values, parent)'+sep+"'";
14142 // build an array of options to determine if value is undefined..
14144 // basically get 'xxxx.yyyy' then do
14145 // (typeof(xxxx) == 'undefined' || typeof(xxx.yyyy) == 'undefined') ?
14146 // (function () { Roo.log("Property not found"); return ''; })() :
14151 Roo.each(name.split('.'), function(st) {
14152 lookfor += (lookfor.length ? '.': '') + st;
14153 udef_ar.push( "(typeof(" + lookfor + ") == 'undefined')" );
14156 var udef_st = '((' + udef_ar.join(" || ") +") ? undef('" + name + "') : "; // .. needs )
14159 if(format && useF){
14161 args = args ? ',' + args : "";
14163 if(format.substr(0, 5) != "this."){
14164 format = "fm." + format + '(';
14166 format = 'this.call("'+ format.substr(5) + '", ';
14170 return "'"+ sep + udef_st + format + name + args + "))"+sep+"'";
14173 if (args && args.length) {
14174 // called with xxyx.yuu:(test,test)
14176 return "'"+ sep + udef_st + name + '(' + args + "))"+sep+"'";
14178 // raw.. - :raw modifier..
14179 return "'"+ sep + udef_st + name + ")"+sep+"'";
14183 // branched to use + in gecko and [].join() in others
14185 body = "tpl.compiled = function(values, parent){ with(values) { return '" +
14186 tpl.body.replace(/(\r\n|\n)/g, '\\n').replace(/'/g, "\\'").replace(this.re, fn) +
14189 body = ["tpl.compiled = function(values, parent){ with (values) { return ['"];
14190 body.push(tpl.body.replace(/(\r\n|\n)/g,
14191 '\\n').replace(/'/g, "\\'").replace(this.re, fn));
14192 body.push("'].join('');};};");
14193 body = body.join('');
14196 Roo.debug && Roo.log(body.replace(/\\n/,'\n'));
14198 /** eval:var:tpl eval:var:fm eval:var:useF eval:var:undef */
14205 * same as applyTemplate, except it's done to one of the subTemplates
14206 * when using named templates, you can do:
14208 * var str = pl.applySubTemplate('your-name', values);
14211 * @param {Number} id of the template
14212 * @param {Object} values to apply to template
14213 * @param {Object} parent (normaly the instance of this object)
14215 applySubTemplate : function(id, values, parent)
14219 var t = this.tpls[id];
14223 if(t.ifCall && !t.ifCall.call(this, values, parent)){
14224 Roo.debug && Roo.log('if call on ' + t.value + ' return false');
14228 Roo.log('Xtemplate.applySubTemplate('+ id+ '): Exception thrown on roo-if="' + t.value + '" - ' + e.toString());
14235 if(t.execCall && t.execCall.call(this, values, parent)){
14239 Roo.log('Xtemplate.applySubTemplate('+ id+ '): Exception thrown on roo-for="' + t.value + '" - ' + e.toString());
14245 var vs = t.forCall ? t.forCall.call(this, values, parent) : values;
14246 parent = t.target ? values : parent;
14247 if(t.forCall && vs instanceof Array){
14249 for(var i = 0, len = vs.length; i < len; i++){
14251 buf[buf.length] = t.compiled.call(this, vs[i], parent);
14253 Roo.log('Xtemplate.applySubTemplate('+ id+ '): Exception thrown on body="' + t.value + '" - ' + e.toString());
14255 //Roo.log(t.compiled);
14259 return buf.join('');
14262 Roo.log('Xtemplate.applySubTemplate('+ id+ '): Exception thrown on roo-for="' + t.value + '" - ' + e.toString());
14267 return t.compiled.call(this, vs, parent);
14269 Roo.log('Xtemplate.applySubTemplate('+ id+ '): Exception thrown on body="' + t.value + '" - ' + e.toString());
14271 //Roo.log(t.compiled);
14279 applyTemplate : function(values){
14280 return this.master.compiled.call(this, values, {});
14281 //var s = this.subs;
14284 apply : function(){
14285 return this.applyTemplate.apply(this, arguments);
14290 Roo.DomTemplate.from = function(el){
14291 el = Roo.getDom(el);
14292 return new Roo.Domtemplate(el.value || el.innerHTML);
14295 * Ext JS Library 1.1.1
14296 * Copyright(c) 2006-2007, Ext JS, LLC.
14298 * Originally Released Under LGPL - original licence link has changed is not relivant.
14301 * <script type="text/javascript">
14305 * @class Roo.util.DelayedTask
14306 * Provides a convenient method of performing setTimeout where a new
14307 * timeout cancels the old timeout. An example would be performing validation on a keypress.
14308 * You can use this class to buffer
14309 * the keypress events for a certain number of milliseconds, and perform only if they stop
14310 * for that amount of time.
14311 * @constructor The parameters to this constructor serve as defaults and are not required.
14312 * @param {Function} fn (optional) The default function to timeout
14313 * @param {Object} scope (optional) The default scope of that timeout
14314 * @param {Array} args (optional) The default Array of arguments
14316 Roo.util.DelayedTask = function(fn, scope, args){
14317 var id = null, d, t;
14319 var call = function(){
14320 var now = new Date().getTime();
14324 fn.apply(scope, args || []);
14328 * Cancels any pending timeout and queues a new one
14329 * @param {Number} delay The milliseconds to delay
14330 * @param {Function} newFn (optional) Overrides function passed to constructor
14331 * @param {Object} newScope (optional) Overrides scope passed to constructor
14332 * @param {Array} newArgs (optional) Overrides args passed to constructor
14334 this.delay = function(delay, newFn, newScope, newArgs){
14335 if(id && delay != d){
14339 t = new Date().getTime();
14341 scope = newScope || scope;
14342 args = newArgs || args;
14344 id = setInterval(call, d);
14349 * Cancel the last queued timeout
14351 this.cancel = function(){
14359 * Ext JS Library 1.1.1
14360 * Copyright(c) 2006-2007, Ext JS, LLC.
14362 * Originally Released Under LGPL - original licence link has changed is not relivant.
14365 * <script type="text/javascript">
14368 * @class Roo.util.TaskRunner
14369 * Manage background tasks - not sure why this is better that setInterval?
14374 Roo.util.TaskRunner = function(interval){
14375 interval = interval || 10;
14376 var tasks = [], removeQueue = [];
14378 var running = false;
14380 var stopThread = function(){
14386 var startThread = function(){
14389 id = setInterval(runTasks, interval);
14393 var removeTask = function(task){
14394 removeQueue.push(task);
14400 var runTasks = function(){
14401 if(removeQueue.length > 0){
14402 for(var i = 0, len = removeQueue.length; i < len; i++){
14403 tasks.remove(removeQueue[i]);
14406 if(tasks.length < 1){
14411 var now = new Date().getTime();
14412 for(var i = 0, len = tasks.length; i < len; ++i){
14414 var itime = now - t.taskRunTime;
14415 if(t.interval <= itime){
14416 var rt = t.run.apply(t.scope || t, t.args || [++t.taskRunCount]);
14417 t.taskRunTime = now;
14418 if(rt === false || t.taskRunCount === t.repeat){
14423 if(t.duration && t.duration <= (now - t.taskStartTime)){
14430 * Queues a new task.
14431 * @param {Object} task
14433 * Task property : interval = how frequent to run.
14434 * Task object should implement
14436 * Task object may implement
14437 * function onStop()
14439 this.start = function(task){
14441 task.taskStartTime = new Date().getTime();
14442 task.taskRunTime = 0;
14443 task.taskRunCount = 0;
14449 * @param {Object} task
14451 this.stop = function(task){
14458 this.stopAll = function(){
14460 for(var i = 0, len = tasks.length; i < len; i++){
14461 if(tasks[i].onStop){
14470 Roo.TaskMgr = new Roo.util.TaskRunner();/*
14472 * Ext JS Library 1.1.1
14473 * Copyright(c) 2006-2007, Ext JS, LLC.
14475 * Originally Released Under LGPL - original licence link has changed is not relivant.
14478 * <script type="text/javascript">
14483 * @class Roo.util.MixedCollection
14484 * @extends Roo.util.Observable
14485 * A Collection class that maintains both numeric indexes and keys and exposes events.
14487 * @param {Boolean} allowFunctions True if the addAll function should add function references to the
14488 * collection (defaults to false)
14489 * @param {Function} keyFn A function that can accept an item of the type(s) stored in this MixedCollection
14490 * and return the key value for that item. This is used when available to look up the key on items that
14491 * were passed without an explicit key parameter to a MixedCollection method. Passing this parameter is
14492 * equivalent to providing an implementation for the {@link #getKey} method.
14494 Roo.util.MixedCollection = function(allowFunctions, keyFn){
14502 * Fires when the collection is cleared.
14507 * Fires when an item is added to the collection.
14508 * @param {Number} index The index at which the item was added.
14509 * @param {Object} o The item added.
14510 * @param {String} key The key associated with the added item.
14515 * Fires when an item is replaced in the collection.
14516 * @param {String} key he key associated with the new added.
14517 * @param {Object} old The item being replaced.
14518 * @param {Object} new The new item.
14523 * Fires when an item is removed from the collection.
14524 * @param {Object} o The item being removed.
14525 * @param {String} key (optional) The key associated with the removed item.
14530 this.allowFunctions = allowFunctions === true;
14532 this.getKey = keyFn;
14534 Roo.util.MixedCollection.superclass.constructor.call(this);
14537 Roo.extend(Roo.util.MixedCollection, Roo.util.Observable, {
14538 allowFunctions : false,
14541 * Adds an item to the collection.
14542 * @param {String} key The key to associate with the item
14543 * @param {Object} o The item to add.
14544 * @return {Object} The item added.
14546 add : function(key, o){
14547 if(arguments.length == 1){
14549 key = this.getKey(o);
14551 if(typeof key == "undefined" || key === null){
14553 this.items.push(o);
14554 this.keys.push(null);
14556 var old = this.map[key];
14558 return this.replace(key, o);
14561 this.items.push(o);
14563 this.keys.push(key);
14565 this.fireEvent("add", this.length-1, o, key);
14570 * MixedCollection has a generic way to fetch keys if you implement getKey.
14573 var mc = new Roo.util.MixedCollection();
14574 mc.add(someEl.dom.id, someEl);
14575 mc.add(otherEl.dom.id, otherEl);
14579 var mc = new Roo.util.MixedCollection();
14580 mc.getKey = function(el){
14586 // or via the constructor
14587 var mc = new Roo.util.MixedCollection(false, function(el){
14593 * @param o {Object} The item for which to find the key.
14594 * @return {Object} The key for the passed item.
14596 getKey : function(o){
14601 * Replaces an item in the collection.
14602 * @param {String} key The key associated with the item to replace, or the item to replace.
14603 * @param o {Object} o (optional) If the first parameter passed was a key, the item to associate with that key.
14604 * @return {Object} The new item.
14606 replace : function(key, o){
14607 if(arguments.length == 1){
14609 key = this.getKey(o);
14611 var old = this.item(key);
14612 if(typeof key == "undefined" || key === null || typeof old == "undefined"){
14613 return this.add(key, o);
14615 var index = this.indexOfKey(key);
14616 this.items[index] = o;
14618 this.fireEvent("replace", key, old, o);
14623 * Adds all elements of an Array or an Object to the collection.
14624 * @param {Object/Array} objs An Object containing properties which will be added to the collection, or
14625 * an Array of values, each of which are added to the collection.
14627 addAll : function(objs){
14628 if(arguments.length > 1 || objs instanceof Array){
14629 var args = arguments.length > 1 ? arguments : objs;
14630 for(var i = 0, len = args.length; i < len; i++){
14634 for(var key in objs){
14635 if(this.allowFunctions || typeof objs[key] != "function"){
14636 this.add(key, objs[key]);
14643 * Executes the specified function once for every item in the collection, passing each
14644 * item as the first and only parameter. returning false from the function will stop the iteration.
14645 * @param {Function} fn The function to execute for each item.
14646 * @param {Object} scope (optional) The scope in which to execute the function.
14648 each : function(fn, scope){
14649 var items = [].concat(this.items); // each safe for removal
14650 for(var i = 0, len = items.length; i < len; i++){
14651 if(fn.call(scope || items[i], items[i], i, len) === false){
14658 * Executes the specified function once for every key in the collection, passing each
14659 * key, and its associated item as the first two parameters.
14660 * @param {Function} fn The function to execute for each item.
14661 * @param {Object} scope (optional) The scope in which to execute the function.
14663 eachKey : function(fn, scope){
14664 for(var i = 0, len = this.keys.length; i < len; i++){
14665 fn.call(scope || window, this.keys[i], this.items[i], i, len);
14670 * Returns the first item in the collection which elicits a true return value from the
14671 * passed selection function.
14672 * @param {Function} fn The selection function to execute for each item.
14673 * @param {Object} scope (optional) The scope in which to execute the function.
14674 * @return {Object} The first item in the collection which returned true from the selection function.
14676 find : function(fn, scope){
14677 for(var i = 0, len = this.items.length; i < len; i++){
14678 if(fn.call(scope || window, this.items[i], this.keys[i])){
14679 return this.items[i];
14686 * Inserts an item at the specified index in the collection.
14687 * @param {Number} index The index to insert the item at.
14688 * @param {String} key The key to associate with the new item, or the item itself.
14689 * @param {Object} o (optional) If the second parameter was a key, the new item.
14690 * @return {Object} The item inserted.
14692 insert : function(index, key, o){
14693 if(arguments.length == 2){
14695 key = this.getKey(o);
14697 if(index >= this.length){
14698 return this.add(key, o);
14701 this.items.splice(index, 0, o);
14702 if(typeof key != "undefined" && key != null){
14705 this.keys.splice(index, 0, key);
14706 this.fireEvent("add", index, o, key);
14711 * Removed an item from the collection.
14712 * @param {Object} o The item to remove.
14713 * @return {Object} The item removed.
14715 remove : function(o){
14716 return this.removeAt(this.indexOf(o));
14720 * Remove an item from a specified index in the collection.
14721 * @param {Number} index The index within the collection of the item to remove.
14723 removeAt : function(index){
14724 if(index < this.length && index >= 0){
14726 var o = this.items[index];
14727 this.items.splice(index, 1);
14728 var key = this.keys[index];
14729 if(typeof key != "undefined"){
14730 delete this.map[key];
14732 this.keys.splice(index, 1);
14733 this.fireEvent("remove", o, key);
14738 * Removed an item associated with the passed key fom the collection.
14739 * @param {String} key The key of the item to remove.
14741 removeKey : function(key){
14742 return this.removeAt(this.indexOfKey(key));
14746 * Returns the number of items in the collection.
14747 * @return {Number} the number of items in the collection.
14749 getCount : function(){
14750 return this.length;
14754 * Returns index within the collection of the passed Object.
14755 * @param {Object} o The item to find the index of.
14756 * @return {Number} index of the item.
14758 indexOf : function(o){
14759 if(!this.items.indexOf){
14760 for(var i = 0, len = this.items.length; i < len; i++){
14761 if(this.items[i] == o) {
14767 return this.items.indexOf(o);
14772 * Returns index within the collection of the passed key.
14773 * @param {String} key The key to find the index of.
14774 * @return {Number} index of the key.
14776 indexOfKey : function(key){
14777 if(!this.keys.indexOf){
14778 for(var i = 0, len = this.keys.length; i < len; i++){
14779 if(this.keys[i] == key) {
14785 return this.keys.indexOf(key);
14790 * Returns the item associated with the passed key OR index. Key has priority over index.
14791 * @param {String/Number} key The key or index of the item.
14792 * @return {Object} The item associated with the passed key.
14794 item : function(key){
14795 if (key === 'length') {
14798 var item = typeof this.map[key] != "undefined" ? this.map[key] : this.items[key];
14799 return typeof item != 'function' || this.allowFunctions ? item : null; // for prototype!
14803 * Returns the item at the specified index.
14804 * @param {Number} index The index of the item.
14807 itemAt : function(index){
14808 return this.items[index];
14812 * Returns the item associated with the passed key.
14813 * @param {String/Number} key The key of the item.
14814 * @return {Object} The item associated with the passed key.
14816 key : function(key){
14817 return this.map[key];
14821 * Returns true if the collection contains the passed Object as an item.
14822 * @param {Object} o The Object to look for in the collection.
14823 * @return {Boolean} True if the collection contains the Object as an item.
14825 contains : function(o){
14826 return this.indexOf(o) != -1;
14830 * Returns true if the collection contains the passed Object as a key.
14831 * @param {String} key The key to look for in the collection.
14832 * @return {Boolean} True if the collection contains the Object as a key.
14834 containsKey : function(key){
14835 return typeof this.map[key] != "undefined";
14839 * Removes all items from the collection.
14841 clear : function(){
14846 this.fireEvent("clear");
14850 * Returns the first item in the collection.
14851 * @return {Object} the first item in the collection..
14853 first : function(){
14854 return this.items[0];
14858 * Returns the last item in the collection.
14859 * @return {Object} the last item in the collection..
14862 return this.items[this.length-1];
14865 _sort : function(property, dir, fn){
14866 var dsc = String(dir).toUpperCase() == "DESC" ? -1 : 1;
14867 fn = fn || function(a, b){
14870 var c = [], k = this.keys, items = this.items;
14871 for(var i = 0, len = items.length; i < len; i++){
14872 c[c.length] = {key: k[i], value: items[i], index: i};
14874 c.sort(function(a, b){
14875 var v = fn(a[property], b[property]) * dsc;
14877 v = (a.index < b.index ? -1 : 1);
14881 for(var i = 0, len = c.length; i < len; i++){
14882 items[i] = c[i].value;
14885 this.fireEvent("sort", this);
14889 * Sorts this collection with the passed comparison function
14890 * @param {String} direction (optional) "ASC" or "DESC"
14891 * @param {Function} fn (optional) comparison function
14893 sort : function(dir, fn){
14894 this._sort("value", dir, fn);
14898 * Sorts this collection by keys
14899 * @param {String} direction (optional) "ASC" or "DESC"
14900 * @param {Function} fn (optional) a comparison function (defaults to case insensitive string)
14902 keySort : function(dir, fn){
14903 this._sort("key", dir, fn || function(a, b){
14904 return String(a).toUpperCase()-String(b).toUpperCase();
14909 * Returns a range of items in this collection
14910 * @param {Number} startIndex (optional) defaults to 0
14911 * @param {Number} endIndex (optional) default to the last item
14912 * @return {Array} An array of items
14914 getRange : function(start, end){
14915 var items = this.items;
14916 if(items.length < 1){
14919 start = start || 0;
14920 end = Math.min(typeof end == "undefined" ? this.length-1 : end, this.length-1);
14923 for(var i = start; i <= end; i++) {
14924 r[r.length] = items[i];
14927 for(var i = start; i >= end; i--) {
14928 r[r.length] = items[i];
14935 * Filter the <i>objects</i> in this collection by a specific property.
14936 * Returns a new collection that has been filtered.
14937 * @param {String} property A property on your objects
14938 * @param {String/RegExp} value Either string that the property values
14939 * should start with or a RegExp to test against the property
14940 * @return {MixedCollection} The new filtered collection
14942 filter : function(property, value){
14943 if(!value.exec){ // not a regex
14944 value = String(value);
14945 if(value.length == 0){
14946 return this.clone();
14948 value = new RegExp("^" + Roo.escapeRe(value), "i");
14950 return this.filterBy(function(o){
14951 return o && value.test(o[property]);
14956 * Filter by a function. * Returns a new collection that has been filtered.
14957 * The passed function will be called with each
14958 * object in the collection. If the function returns true, the value is included
14959 * otherwise it is filtered.
14960 * @param {Function} fn The function to be called, it will receive the args o (the object), k (the key)
14961 * @param {Object} scope (optional) The scope of the function (defaults to this)
14962 * @return {MixedCollection} The new filtered collection
14964 filterBy : function(fn, scope){
14965 var r = new Roo.util.MixedCollection();
14966 r.getKey = this.getKey;
14967 var k = this.keys, it = this.items;
14968 for(var i = 0, len = it.length; i < len; i++){
14969 if(fn.call(scope||this, it[i], k[i])){
14970 r.add(k[i], it[i]);
14977 * Creates a duplicate of this collection
14978 * @return {MixedCollection}
14980 clone : function(){
14981 var r = new Roo.util.MixedCollection();
14982 var k = this.keys, it = this.items;
14983 for(var i = 0, len = it.length; i < len; i++){
14984 r.add(k[i], it[i]);
14986 r.getKey = this.getKey;
14991 * Returns the item associated with the passed key or index.
14993 * @param {String/Number} key The key or index of the item.
14994 * @return {Object} The item associated with the passed key.
14996 Roo.util.MixedCollection.prototype.get = Roo.util.MixedCollection.prototype.item;/*
14998 * Ext JS Library 1.1.1
14999 * Copyright(c) 2006-2007, Ext JS, LLC.
15001 * Originally Released Under LGPL - original licence link has changed is not relivant.
15004 * <script type="text/javascript">
15007 * @class Roo.util.JSON
15008 * Modified version of Douglas Crockford"s json.js that doesn"t
15009 * mess with the Object prototype
15010 * http://www.json.org/js.html
15013 Roo.util.JSON = new (function(){
15014 var useHasOwn = {}.hasOwnProperty ? true : false;
15016 // crashes Safari in some instances
15017 //var validRE = /^("(\\.|[^"\\\n\r])*?"|[,:{}\[\]0-9.\-+Eaeflnr-u \n\r\t])+?$/;
15019 var pad = function(n) {
15020 return n < 10 ? "0" + n : n;
15033 var encodeString = function(s){
15034 if (/["\\\x00-\x1f]/.test(s)) {
15035 return '"' + s.replace(/([\x00-\x1f\\"])/g, function(a, b) {
15040 c = b.charCodeAt();
15042 Math.floor(c / 16).toString(16) +
15043 (c % 16).toString(16);
15046 return '"' + s + '"';
15049 var encodeArray = function(o){
15050 var a = ["["], b, i, l = o.length, v;
15051 for (i = 0; i < l; i += 1) {
15053 switch (typeof v) {
15062 a.push(v === null ? "null" : Roo.util.JSON.encode(v));
15070 var encodeDate = function(o){
15071 return '"' + o.getFullYear() + "-" +
15072 pad(o.getMonth() + 1) + "-" +
15073 pad(o.getDate()) + "T" +
15074 pad(o.getHours()) + ":" +
15075 pad(o.getMinutes()) + ":" +
15076 pad(o.getSeconds()) + '"';
15080 * Encodes an Object, Array or other value
15081 * @param {Mixed} o The variable to encode
15082 * @return {String} The JSON string
15084 this.encode = function(o)
15086 // should this be extended to fully wrap stringify..
15088 if(typeof o == "undefined" || o === null){
15090 }else if(o instanceof Array){
15091 return encodeArray(o);
15092 }else if(o instanceof Date){
15093 return encodeDate(o);
15094 }else if(typeof o == "string"){
15095 return encodeString(o);
15096 }else if(typeof o == "number"){
15097 return isFinite(o) ? String(o) : "null";
15098 }else if(typeof o == "boolean"){
15101 var a = ["{"], b, i, v;
15103 if(!useHasOwn || o.hasOwnProperty(i)) {
15105 switch (typeof v) {
15114 a.push(this.encode(i), ":",
15115 v === null ? "null" : this.encode(v));
15126 * Decodes (parses) a JSON string to an object. If the JSON is invalid, this function throws a SyntaxError.
15127 * @param {String} json The JSON string
15128 * @return {Object} The resulting object
15130 this.decode = function(json){
15132 return /** eval:var:json */ eval("(" + json + ')');
15136 * Shorthand for {@link Roo.util.JSON#encode}
15137 * @member Roo encode
15139 Roo.encode = typeof(JSON) != 'undefined' && JSON.stringify ? JSON.stringify : Roo.util.JSON.encode;
15141 * Shorthand for {@link Roo.util.JSON#decode}
15142 * @member Roo decode
15144 Roo.decode = typeof(JSON) != 'undefined' && JSON.parse ? JSON.parse : Roo.util.JSON.decode;
15147 * Ext JS Library 1.1.1
15148 * Copyright(c) 2006-2007, Ext JS, LLC.
15150 * Originally Released Under LGPL - original licence link has changed is not relivant.
15153 * <script type="text/javascript">
15157 * @class Roo.util.Format
15158 * Reusable data formatting functions
15161 Roo.util.Format = function(){
15162 var trimRe = /^\s+|\s+$/g;
15165 * Truncate a string and add an ellipsis ('...') to the end if it exceeds the specified length
15166 * @param {String} value The string to truncate
15167 * @param {Number} length The maximum length to allow before truncating
15168 * @return {String} The converted text
15170 ellipsis : function(value, len){
15171 if(value && value.length > len){
15172 return value.substr(0, len-3)+"...";
15178 * Checks a reference and converts it to empty string if it is undefined
15179 * @param {Mixed} value Reference to check
15180 * @return {Mixed} Empty string if converted, otherwise the original value
15182 undef : function(value){
15183 return typeof value != "undefined" ? value : "";
15187 * Convert certain characters (&, <, >, and ') to their HTML character equivalents for literal display in web pages.
15188 * @param {String} value The string to encode
15189 * @return {String} The encoded text
15191 htmlEncode : function(value){
15192 return !value ? value : String(value).replace(/&/g, "&").replace(/>/g, ">").replace(/</g, "<").replace(/"/g, """);
15196 * Convert certain characters (&, <, >, and ') from their HTML character equivalents.
15197 * @param {String} value The string to decode
15198 * @return {String} The decoded text
15200 htmlDecode : function(value){
15201 return !value ? value : String(value).replace(/&/g, "&").replace(/>/g, ">").replace(/</g, "<").replace(/"/g, '"');
15205 * Trims any whitespace from either side of a string
15206 * @param {String} value The text to trim
15207 * @return {String} The trimmed text
15209 trim : function(value){
15210 return String(value).replace(trimRe, "");
15214 * Returns a substring from within an original string
15215 * @param {String} value The original text
15216 * @param {Number} start The start index of the substring
15217 * @param {Number} length The length of the substring
15218 * @return {String} The substring
15220 substr : function(value, start, length){
15221 return String(value).substr(start, length);
15225 * Converts a string to all lower case letters
15226 * @param {String} value The text to convert
15227 * @return {String} The converted text
15229 lowercase : function(value){
15230 return String(value).toLowerCase();
15234 * Converts a string to all upper case letters
15235 * @param {String} value The text to convert
15236 * @return {String} The converted text
15238 uppercase : function(value){
15239 return String(value).toUpperCase();
15243 * Converts the first character only of a string to upper case
15244 * @param {String} value The text to convert
15245 * @return {String} The converted text
15247 capitalize : function(value){
15248 return !value ? value : value.charAt(0).toUpperCase() + value.substr(1).toLowerCase();
15252 call : function(value, fn){
15253 if(arguments.length > 2){
15254 var args = Array.prototype.slice.call(arguments, 2);
15255 args.unshift(value);
15257 return /** eval:var:value */ eval(fn).apply(window, args);
15259 /** eval:var:value */
15260 return /** eval:var:value */ eval(fn).call(window, value);
15266 * safer version of Math.toFixed..??/
15267 * @param {Number/String} value The numeric value to format
15268 * @param {Number/String} value Decimal places
15269 * @return {String} The formatted currency string
15271 toFixed : function(v, n)
15273 // why not use to fixed - precision is buggered???
15275 return Math.round(v-0);
15277 var fact = Math.pow(10,n+1);
15278 v = (Math.round((v-0)*fact))/fact;
15279 var z = (''+fact).substring(2);
15280 if (v == Math.floor(v)) {
15281 return Math.floor(v) + '.' + z;
15284 // now just padd decimals..
15285 var ps = String(v).split('.');
15286 var fd = (ps[1] + z);
15287 var r = fd.substring(0,n);
15288 var rm = fd.substring(n);
15290 return ps[0] + '.' + r;
15292 r*=1; // turn it into a number;
15294 if (String(r).length != n) {
15297 r = String(r).substring(1); // chop the end off.
15300 return ps[0] + '.' + r;
15305 * Format a number as US currency
15306 * @param {Number/String} value The numeric value to format
15307 * @return {String} The formatted currency string
15309 usMoney : function(v){
15310 return '$' + Roo.util.Format.number(v);
15315 * eventually this should probably emulate php's number_format
15316 * @param {Number/String} value The numeric value to format
15317 * @param {Number} decimals number of decimal places
15318 * @param {String} delimiter for thousands (default comma)
15319 * @return {String} The formatted currency string
15321 number : function(v, decimals, thousandsDelimiter)
15323 // multiply and round.
15324 decimals = typeof(decimals) == 'undefined' ? 2 : decimals;
15325 thousandsDelimiter = typeof(thousandsDelimiter) == 'undefined' ? ',' : thousandsDelimiter;
15327 var mul = Math.pow(10, decimals);
15328 var zero = String(mul).substring(1);
15329 v = (Math.round((v-0)*mul))/mul;
15331 // if it's '0' number.. then
15333 //v = (v == Math.floor(v)) ? v + "." + zero : ((v*10 == Math.floor(v*10)) ? v + "0" : v);
15335 var ps = v.split('.');
15338 var r = /(\d+)(\d{3})/;
15341 if(thousandsDelimiter.length != 0) {
15342 whole = whole.replace(/\B(?=(\d{3})+(?!\d))/g, thousandsDelimiter );
15347 (decimals ? ('.'+ ps[1] + zero.substring(ps[1].length)) : '') :
15348 // does not have decimals
15349 (decimals ? ('.' + zero) : '');
15352 return whole + sub ;
15356 * Parse a value into a formatted date using the specified format pattern.
15357 * @param {Mixed} value The value to format
15358 * @param {String} format (optional) Any valid date format string (defaults to 'm/d/Y')
15359 * @return {String} The formatted date string
15361 date : function(v, format){
15365 if(!(v instanceof Date)){
15366 v = new Date(Date.parse(v));
15368 return v.dateFormat(format || Roo.util.Format.defaults.date);
15372 * Returns a date rendering function that can be reused to apply a date format multiple times efficiently
15373 * @param {String} format Any valid date format string
15374 * @return {Function} The date formatting function
15376 dateRenderer : function(format){
15377 return function(v){
15378 return Roo.util.Format.date(v, format);
15383 stripTagsRE : /<\/?[^>]+>/gi,
15386 * Strips all HTML tags
15387 * @param {Mixed} value The text from which to strip tags
15388 * @return {String} The stripped text
15390 stripTags : function(v){
15391 return !v ? v : String(v).replace(this.stripTagsRE, "");
15395 * Size in Mb,Gb etc.
15396 * @param {Number} value The number to be formated
15397 * @param {number} decimals how many decimal places
15398 * @return {String} the formated string
15400 size : function(value, decimals)
15402 var sizes = ['b', 'k', 'M', 'G', 'T'];
15406 var i = parseInt(Math.floor(Math.log(value) / Math.log(1024)));
15407 return Roo.util.Format.number(value/ Math.pow(1024, i) ,decimals) + sizes[i];
15414 Roo.util.Format.defaults = {
15418 * Ext JS Library 1.1.1
15419 * Copyright(c) 2006-2007, Ext JS, LLC.
15421 * Originally Released Under LGPL - original licence link has changed is not relivant.
15424 * <script type="text/javascript">
15431 * @class Roo.MasterTemplate
15432 * @extends Roo.Template
15433 * Provides a template that can have child templates. The syntax is:
15435 var t = new Roo.MasterTemplate(
15436 '<select name="{name}">',
15437 '<tpl name="options"><option value="{value:trim}">{text:ellipsis(10)}</option></tpl>',
15440 t.add('options', {value: 'foo', text: 'bar'});
15441 // or you can add multiple child elements in one shot
15442 t.addAll('options', [
15443 {value: 'foo', text: 'bar'},
15444 {value: 'foo2', text: 'bar2'},
15445 {value: 'foo3', text: 'bar3'}
15447 // then append, applying the master template values
15448 t.append('my-form', {name: 'my-select'});
15450 * A name attribute for the child template is not required if you have only one child
15451 * template or you want to refer to them by index.
15453 Roo.MasterTemplate = function(){
15454 Roo.MasterTemplate.superclass.constructor.apply(this, arguments);
15455 this.originalHtml = this.html;
15457 var m, re = this.subTemplateRe;
15460 while(m = re.exec(this.html)){
15461 var name = m[1], content = m[2];
15466 tpl : new Roo.Template(content)
15469 st[name] = st[subIndex];
15471 st[subIndex].tpl.compile();
15472 st[subIndex].tpl.call = this.call.createDelegate(this);
15475 this.subCount = subIndex;
15478 Roo.extend(Roo.MasterTemplate, Roo.Template, {
15480 * The regular expression used to match sub templates
15484 subTemplateRe : /<tpl(?:\sname="([\w-]+)")?>((?:.|\n)*?)<\/tpl>/gi,
15487 * Applies the passed values to a child template.
15488 * @param {String/Number} name (optional) The name or index of the child template
15489 * @param {Array/Object} values The values to be applied to the template
15490 * @return {MasterTemplate} this
15492 add : function(name, values){
15493 if(arguments.length == 1){
15494 values = arguments[0];
15497 var s = this.subs[name];
15498 s.buffer[s.buffer.length] = s.tpl.apply(values);
15503 * Applies all the passed values to a child template.
15504 * @param {String/Number} name (optional) The name or index of the child template
15505 * @param {Array} values The values to be applied to the template, this should be an array of objects.
15506 * @param {Boolean} reset (optional) True to reset the template first
15507 * @return {MasterTemplate} this
15509 fill : function(name, values, reset){
15511 if(a.length == 1 || (a.length == 2 && typeof a[1] == "boolean")){
15519 for(var i = 0, len = values.length; i < len; i++){
15520 this.add(name, values[i]);
15526 * Resets the template for reuse
15527 * @return {MasterTemplate} this
15529 reset : function(){
15531 for(var i = 0; i < this.subCount; i++){
15537 applyTemplate : function(values){
15539 var replaceIndex = -1;
15540 this.html = this.originalHtml.replace(this.subTemplateRe, function(m, name){
15541 return s[++replaceIndex].buffer.join("");
15543 return Roo.MasterTemplate.superclass.applyTemplate.call(this, values);
15546 apply : function(){
15547 return this.applyTemplate.apply(this, arguments);
15550 compile : function(){return this;}
15554 * Alias for fill().
15557 Roo.MasterTemplate.prototype.addAll = Roo.MasterTemplate.prototype.fill;
15559 * Creates a template from the passed element's value (display:none textarea, preferred) or innerHTML. e.g.
15560 * var tpl = Roo.MasterTemplate.from('element-id');
15561 * @param {String/HTMLElement} el
15562 * @param {Object} config
15565 Roo.MasterTemplate.from = function(el, config){
15566 el = Roo.getDom(el);
15567 return new Roo.MasterTemplate(el.value || el.innerHTML, config || '');
15570 * Ext JS Library 1.1.1
15571 * Copyright(c) 2006-2007, Ext JS, LLC.
15573 * Originally Released Under LGPL - original licence link has changed is not relivant.
15576 * <script type="text/javascript">
15581 * @class Roo.util.CSS
15582 * Utility class for manipulating CSS rules
15586 Roo.util.CSS = function(){
15588 var doc = document;
15590 var camelRe = /(-[a-z])/gi;
15591 var camelFn = function(m, a){ return a.charAt(1).toUpperCase(); };
15595 * Very simple dynamic creation of stylesheets from a text blob of rules. The text will wrapped in a style
15596 * tag and appended to the HEAD of the document.
15597 * @param {String|Object} cssText The text containing the css rules
15598 * @param {String} id An id to add to the stylesheet for later removal
15599 * @return {StyleSheet}
15601 createStyleSheet : function(cssText, id){
15603 var head = doc.getElementsByTagName("head")[0];
15604 var nrules = doc.createElement("style");
15605 nrules.setAttribute("type", "text/css");
15607 nrules.setAttribute("id", id);
15609 if (typeof(cssText) != 'string') {
15610 // support object maps..
15611 // not sure if this a good idea..
15612 // perhaps it should be merged with the general css handling
15613 // and handle js style props.
15614 var cssTextNew = [];
15615 for(var n in cssText) {
15617 for(var k in cssText[n]) {
15618 citems.push( k + ' : ' +cssText[n][k] + ';' );
15620 cssTextNew.push( n + ' { ' + citems.join(' ') + '} ');
15623 cssText = cssTextNew.join("\n");
15629 head.appendChild(nrules);
15630 ss = nrules.styleSheet;
15631 ss.cssText = cssText;
15634 nrules.appendChild(doc.createTextNode(cssText));
15636 nrules.cssText = cssText;
15638 head.appendChild(nrules);
15639 ss = nrules.styleSheet ? nrules.styleSheet : (nrules.sheet || doc.styleSheets[doc.styleSheets.length-1]);
15641 this.cacheStyleSheet(ss);
15646 * Removes a style or link tag by id
15647 * @param {String} id The id of the tag
15649 removeStyleSheet : function(id){
15650 var existing = doc.getElementById(id);
15652 existing.parentNode.removeChild(existing);
15657 * Dynamically swaps an existing stylesheet reference for a new one
15658 * @param {String} id The id of an existing link tag to remove
15659 * @param {String} url The href of the new stylesheet to include
15661 swapStyleSheet : function(id, url){
15662 this.removeStyleSheet(id);
15663 var ss = doc.createElement("link");
15664 ss.setAttribute("rel", "stylesheet");
15665 ss.setAttribute("type", "text/css");
15666 ss.setAttribute("id", id);
15667 ss.setAttribute("href", url);
15668 doc.getElementsByTagName("head")[0].appendChild(ss);
15672 * Refresh the rule cache if you have dynamically added stylesheets
15673 * @return {Object} An object (hash) of rules indexed by selector
15675 refreshCache : function(){
15676 return this.getRules(true);
15680 cacheStyleSheet : function(stylesheet){
15684 try{// try catch for cross domain access issue
15685 var ssRules = stylesheet.cssRules || stylesheet.rules;
15686 for(var j = ssRules.length-1; j >= 0; --j){
15687 rules[ssRules[j].selectorText] = ssRules[j];
15693 * Gets all css rules for the document
15694 * @param {Boolean} refreshCache true to refresh the internal cache
15695 * @return {Object} An object (hash) of rules indexed by selector
15697 getRules : function(refreshCache){
15698 if(rules == null || refreshCache){
15700 var ds = doc.styleSheets;
15701 for(var i =0, len = ds.length; i < len; i++){
15703 this.cacheStyleSheet(ds[i]);
15711 * Gets an an individual CSS rule by selector(s)
15712 * @param {String/Array} selector The CSS selector or an array of selectors to try. The first selector that is found is returned.
15713 * @param {Boolean} refreshCache true to refresh the internal cache if you have recently updated any rules or added styles dynamically
15714 * @return {CSSRule} The CSS rule or null if one is not found
15716 getRule : function(selector, refreshCache){
15717 var rs = this.getRules(refreshCache);
15718 if(!(selector instanceof Array)){
15719 return rs[selector];
15721 for(var i = 0; i < selector.length; i++){
15722 if(rs[selector[i]]){
15723 return rs[selector[i]];
15731 * Updates a rule property
15732 * @param {String/Array} selector If it's an array it tries each selector until it finds one. Stops immediately once one is found.
15733 * @param {String} property The css property
15734 * @param {String} value The new value for the property
15735 * @return {Boolean} true If a rule was found and updated
15737 updateRule : function(selector, property, value){
15738 if(!(selector instanceof Array)){
15739 var rule = this.getRule(selector);
15741 rule.style[property.replace(camelRe, camelFn)] = value;
15745 for(var i = 0; i < selector.length; i++){
15746 if(this.updateRule(selector[i], property, value)){
15756 * Ext JS Library 1.1.1
15757 * Copyright(c) 2006-2007, Ext JS, LLC.
15759 * Originally Released Under LGPL - original licence link has changed is not relivant.
15762 * <script type="text/javascript">
15768 * @class Roo.util.ClickRepeater
15769 * @extends Roo.util.Observable
15771 * A wrapper class which can be applied to any element. Fires a "click" event while the
15772 * mouse is pressed. The interval between firings may be specified in the config but
15773 * defaults to 10 milliseconds.
15775 * Optionally, a CSS class may be applied to the element during the time it is pressed.
15777 * @cfg {String/HTMLElement/Element} el The element to act as a button.
15778 * @cfg {Number} delay The initial delay before the repeating event begins firing.
15779 * Similar to an autorepeat key delay.
15780 * @cfg {Number} interval The interval between firings of the "click" event. Default 10 ms.
15781 * @cfg {String} pressClass A CSS class name to be applied to the element while pressed.
15782 * @cfg {Boolean} accelerate True if autorepeating should start slowly and accelerate.
15783 * "interval" and "delay" are ignored. "immediate" is honored.
15784 * @cfg {Boolean} preventDefault True to prevent the default click event
15785 * @cfg {Boolean} stopDefault True to stop the default click event
15788 * 2007-02-02 jvs Original code contributed by Nige "Animal" White
15789 * 2007-02-02 jvs Renamed to ClickRepeater
15790 * 2007-02-03 jvs Modifications for FF Mac and Safari
15793 * @param {String/HTMLElement/Element} el The element to listen on
15794 * @param {Object} config
15796 Roo.util.ClickRepeater = function(el, config)
15798 this.el = Roo.get(el);
15799 this.el.unselectable();
15801 Roo.apply(this, config);
15806 * Fires when the mouse button is depressed.
15807 * @param {Roo.util.ClickRepeater} this
15809 "mousedown" : true,
15812 * Fires on a specified interval during the time the element is pressed.
15813 * @param {Roo.util.ClickRepeater} this
15818 * Fires when the mouse key is released.
15819 * @param {Roo.util.ClickRepeater} this
15824 this.el.on("mousedown", this.handleMouseDown, this);
15825 if(this.preventDefault || this.stopDefault){
15826 this.el.on("click", function(e){
15827 if(this.preventDefault){
15828 e.preventDefault();
15830 if(this.stopDefault){
15836 // allow inline handler
15838 this.on("click", this.handler, this.scope || this);
15841 Roo.util.ClickRepeater.superclass.constructor.call(this);
15844 Roo.extend(Roo.util.ClickRepeater, Roo.util.Observable, {
15847 preventDefault : true,
15848 stopDefault : false,
15852 handleMouseDown : function(){
15853 clearTimeout(this.timer);
15855 if(this.pressClass){
15856 this.el.addClass(this.pressClass);
15858 this.mousedownTime = new Date();
15860 Roo.get(document).on("mouseup", this.handleMouseUp, this);
15861 this.el.on("mouseout", this.handleMouseOut, this);
15863 this.fireEvent("mousedown", this);
15864 this.fireEvent("click", this);
15866 this.timer = this.click.defer(this.delay || this.interval, this);
15870 click : function(){
15871 this.fireEvent("click", this);
15872 this.timer = this.click.defer(this.getInterval(), this);
15876 getInterval: function(){
15877 if(!this.accelerate){
15878 return this.interval;
15880 var pressTime = this.mousedownTime.getElapsed();
15881 if(pressTime < 500){
15883 }else if(pressTime < 1700){
15885 }else if(pressTime < 2600){
15887 }else if(pressTime < 3500){
15889 }else if(pressTime < 4400){
15891 }else if(pressTime < 5300){
15893 }else if(pressTime < 6200){
15901 handleMouseOut : function(){
15902 clearTimeout(this.timer);
15903 if(this.pressClass){
15904 this.el.removeClass(this.pressClass);
15906 this.el.on("mouseover", this.handleMouseReturn, this);
15910 handleMouseReturn : function(){
15911 this.el.un("mouseover", this.handleMouseReturn);
15912 if(this.pressClass){
15913 this.el.addClass(this.pressClass);
15919 handleMouseUp : function(){
15920 clearTimeout(this.timer);
15921 this.el.un("mouseover", this.handleMouseReturn);
15922 this.el.un("mouseout", this.handleMouseOut);
15923 Roo.get(document).un("mouseup", this.handleMouseUp);
15924 this.el.removeClass(this.pressClass);
15925 this.fireEvent("mouseup", this);
15928 * @class Roo.util.Clipboard
15934 Roo.util.Clipboard = {
15936 * Writes a string to the clipboard - using the Clipboard API if https, otherwise using text area.
15937 * @param {String} text to copy to clipboard
15939 write : function(text) {
15940 // navigator clipboard api needs a secure context (https)
15941 if (navigator.clipboard && window.isSecureContext) {
15942 // navigator clipboard api method'
15943 navigator.clipboard.writeText(text);
15946 // text area method
15947 var ta = document.createElement("textarea");
15949 // make the textarea out of viewport
15950 ta.style.position = "fixed";
15951 ta.style.left = "-999999px";
15952 ta.style.top = "-999999px";
15953 document.body.appendChild(ta);
15956 document.execCommand('copy');
15966 * Ext JS Library 1.1.1
15967 * Copyright(c) 2006-2007, Ext JS, LLC.
15969 * Originally Released Under LGPL - original licence link has changed is not relivant.
15972 * <script type="text/javascript">
15977 * @class Roo.KeyNav
15978 * <p>Provides a convenient wrapper for normalized keyboard navigation. KeyNav allows you to bind
15979 * navigation keys to function calls that will get called when the keys are pressed, providing an easy
15980 * way to implement custom navigation schemes for any UI component.</p>
15981 * <p>The following are all of the possible keys that can be implemented: enter, left, right, up, down, tab, esc,
15982 * pageUp, pageDown, del, home, end. Usage:</p>
15984 var nav = new Roo.KeyNav("my-element", {
15985 "left" : function(e){
15986 this.moveLeft(e.ctrlKey);
15988 "right" : function(e){
15989 this.moveRight(e.ctrlKey);
15991 "enter" : function(e){
15998 * @param {String/HTMLElement/Roo.Element} el The element to bind to
15999 * @param {Object} config The config
16001 Roo.KeyNav = function(el, config){
16002 this.el = Roo.get(el);
16003 Roo.apply(this, config);
16004 if(!this.disabled){
16005 this.disabled = true;
16010 Roo.KeyNav.prototype = {
16012 * @cfg {Boolean} disabled
16013 * True to disable this KeyNav instance (defaults to false)
16017 * @cfg {String} defaultEventAction
16018 * The method to call on the {@link Roo.EventObject} after this KeyNav intercepts a key. Valid values are
16019 * {@link Roo.EventObject#stopEvent}, {@link Roo.EventObject#preventDefault} and
16020 * {@link Roo.EventObject#stopPropagation} (defaults to 'stopEvent')
16022 defaultEventAction: "stopEvent",
16024 * @cfg {Boolean} forceKeyDown
16025 * Handle the keydown event instead of keypress (defaults to false). KeyNav automatically does this for IE since
16026 * IE does not propagate special keys on keypress, but setting this to true will force other browsers to also
16027 * handle keydown instead of keypress.
16029 forceKeyDown : false,
16032 prepareEvent : function(e){
16033 var k = e.getKey();
16034 var h = this.keyToHandler[k];
16035 //if(h && this[h]){
16036 // e.stopPropagation();
16038 if(Roo.isSafari && h && k >= 37 && k <= 40){
16044 relay : function(e){
16045 var k = e.getKey();
16046 var h = this.keyToHandler[k];
16048 if(this.doRelay(e, this[h], h) !== true){
16049 e[this.defaultEventAction]();
16055 doRelay : function(e, h, hname){
16056 return h.call(this.scope || this, e);
16059 // possible handlers
16073 // quick lookup hash
16090 * Enable this KeyNav
16092 enable: function(){
16094 // ie won't do special keys on keypress, no one else will repeat keys with keydown
16095 // the EventObject will normalize Safari automatically
16096 if(this.forceKeyDown || Roo.isIE || Roo.isAir){
16097 this.el.on("keydown", this.relay, this);
16099 this.el.on("keydown", this.prepareEvent, this);
16100 this.el.on("keypress", this.relay, this);
16102 this.disabled = false;
16107 * Disable this KeyNav
16109 disable: function(){
16110 if(!this.disabled){
16111 if(this.forceKeyDown || Roo.isIE || Roo.isAir){
16112 this.el.un("keydown", this.relay);
16114 this.el.un("keydown", this.prepareEvent);
16115 this.el.un("keypress", this.relay);
16117 this.disabled = true;
16122 * Ext JS Library 1.1.1
16123 * Copyright(c) 2006-2007, Ext JS, LLC.
16125 * Originally Released Under LGPL - original licence link has changed is not relivant.
16128 * <script type="text/javascript">
16133 * @class Roo.KeyMap
16134 * Handles mapping keys to actions for an element. One key map can be used for multiple actions.
16135 * The constructor accepts the same config object as defined by {@link #addBinding}.
16136 * If you bind a callback function to a KeyMap, anytime the KeyMap handles an expected key
16137 * combination it will call the function with this signature (if the match is a multi-key
16138 * combination the callback will still be called only once): (String key, Roo.EventObject e)
16139 * A KeyMap can also handle a string representation of keys.<br />
16142 // map one key by key code
16143 var map = new Roo.KeyMap("my-element", {
16144 key: 13, // or Roo.EventObject.ENTER
16149 // map multiple keys to one action by string
16150 var map = new Roo.KeyMap("my-element", {
16156 // map multiple keys to multiple actions by strings and array of codes
16157 var map = new Roo.KeyMap("my-element", [
16160 fn: function(){ alert("Return was pressed"); }
16163 fn: function(){ alert('a, b or c was pressed'); }
16168 fn: function(){ alert('Control + shift + tab was pressed.'); }
16172 * <b>Note: A KeyMap starts enabled</b>
16174 * @param {String/HTMLElement/Roo.Element} el The element to bind to
16175 * @param {Object} config The config (see {@link #addBinding})
16176 * @param {String} eventName (optional) The event to bind to (defaults to "keydown")
16178 Roo.KeyMap = function(el, config, eventName){
16179 this.el = Roo.get(el);
16180 this.eventName = eventName || "keydown";
16181 this.bindings = [];
16183 this.addBinding(config);
16188 Roo.KeyMap.prototype = {
16190 * True to stop the event from bubbling and prevent the default browser action if the
16191 * key was handled by the KeyMap (defaults to false)
16197 * Add a new binding to this KeyMap. The following config object properties are supported:
16199 Property Type Description
16200 ---------- --------------- ----------------------------------------------------------------------
16201 key String/Array A single keycode or an array of keycodes to handle
16202 shift Boolean True to handle key only when shift is pressed (defaults to false)
16203 ctrl Boolean True to handle key only when ctrl is pressed (defaults to false)
16204 alt Boolean True to handle key only when alt is pressed (defaults to false)
16205 fn Function The function to call when KeyMap finds the expected key combination
16206 scope Object The scope of the callback function
16212 var map = new Roo.KeyMap(document, {
16213 key: Roo.EventObject.ENTER,
16218 //Add a new binding to the existing KeyMap later
16226 * @param {Object/Array} config A single KeyMap config or an array of configs
16228 addBinding : function(config){
16229 if(config instanceof Array){
16230 for(var i = 0, len = config.length; i < len; i++){
16231 this.addBinding(config[i]);
16235 var keyCode = config.key,
16236 shift = config.shift,
16237 ctrl = config.ctrl,
16240 scope = config.scope;
16241 if(typeof keyCode == "string"){
16243 var keyString = keyCode.toUpperCase();
16244 for(var j = 0, len = keyString.length; j < len; j++){
16245 ks.push(keyString.charCodeAt(j));
16249 var keyArray = keyCode instanceof Array;
16250 var handler = function(e){
16251 if((!shift || e.shiftKey) && (!ctrl || e.ctrlKey) && (!alt || e.altKey)){
16252 var k = e.getKey();
16254 for(var i = 0, len = keyCode.length; i < len; i++){
16255 if(keyCode[i] == k){
16256 if(this.stopEvent){
16259 fn.call(scope || window, k, e);
16265 if(this.stopEvent){
16268 fn.call(scope || window, k, e);
16273 this.bindings.push(handler);
16277 * Shorthand for adding a single key listener
16278 * @param {Number/Array/Object} key Either the numeric key code, array of key codes or an object with the
16279 * following options:
16280 * {key: (number or array), shift: (true/false), ctrl: (true/false), alt: (true/false)}
16281 * @param {Function} fn The function to call
16282 * @param {Object} scope (optional) The scope of the function
16284 on : function(key, fn, scope){
16285 var keyCode, shift, ctrl, alt;
16286 if(typeof key == "object" && !(key instanceof Array)){
16305 handleKeyDown : function(e){
16306 if(this.enabled){ //just in case
16307 var b = this.bindings;
16308 for(var i = 0, len = b.length; i < len; i++){
16309 b[i].call(this, e);
16315 * Returns true if this KeyMap is enabled
16316 * @return {Boolean}
16318 isEnabled : function(){
16319 return this.enabled;
16323 * Enables this KeyMap
16325 enable: function(){
16327 this.el.on(this.eventName, this.handleKeyDown, this);
16328 this.enabled = true;
16333 * Disable this KeyMap
16335 disable: function(){
16337 this.el.removeListener(this.eventName, this.handleKeyDown, this);
16338 this.enabled = false;
16343 * Ext JS Library 1.1.1
16344 * Copyright(c) 2006-2007, Ext JS, LLC.
16346 * Originally Released Under LGPL - original licence link has changed is not relivant.
16349 * <script type="text/javascript">
16354 * @class Roo.util.TextMetrics
16355 * Provides precise pixel measurements for blocks of text so that you can determine exactly how high and
16356 * wide, in pixels, a given block of text will be.
16359 Roo.util.TextMetrics = function(){
16363 * Measures the size of the specified text
16364 * @param {String/HTMLElement} el The element, dom node or id from which to copy existing CSS styles
16365 * that can affect the size of the rendered text
16366 * @param {String} text The text to measure
16367 * @param {Number} fixedWidth (optional) If the text will be multiline, you have to set a fixed width
16368 * in order to accurately measure the text height
16369 * @return {Object} An object containing the text's size {width: (width), height: (height)}
16371 measure : function(el, text, fixedWidth){
16373 shared = Roo.util.TextMetrics.Instance(el, fixedWidth);
16376 shared.setFixedWidth(fixedWidth || 'auto');
16377 return shared.getSize(text);
16381 * Return a unique TextMetrics instance that can be bound directly to an element and reused. This reduces
16382 * the overhead of multiple calls to initialize the style properties on each measurement.
16383 * @param {String/HTMLElement} el The element, dom node or id that the instance will be bound to
16384 * @param {Number} fixedWidth (optional) If the text will be multiline, you have to set a fixed width
16385 * in order to accurately measure the text height
16386 * @return {Roo.util.TextMetrics.Instance} instance The new instance
16388 createInstance : function(el, fixedWidth){
16389 return Roo.util.TextMetrics.Instance(el, fixedWidth);
16395 * @class Roo.util.TextMetrics.Instance
16396 * Instance of TextMetrics Calcuation
16398 * Create a new TextMetrics Instance
16399 * @param {Object} bindto
16400 * @param {Boolean} fixedWidth
16403 Roo.util.TextMetrics.Instance = function(bindTo, fixedWidth)
16405 var ml = new Roo.Element(document.createElement('div'));
16406 document.body.appendChild(ml.dom);
16407 ml.position('absolute');
16408 ml.setLeftTop(-1000, -1000);
16412 ml.setWidth(fixedWidth);
16417 * Returns the size of the specified text based on the internal element's style and width properties
16418 * @param {String} text The text to measure
16419 * @return {Object} An object containing the text's size {width: (width), height: (height)}
16421 getSize : function(text){
16423 var s = ml.getSize();
16429 * Binds this TextMetrics instance to an element from which to copy existing CSS styles
16430 * that can affect the size of the rendered text
16431 * @param {String/HTMLElement} el The element, dom node or id
16433 bind : function(el){
16435 Roo.fly(el).getStyles('font-size','font-style', 'font-weight', 'font-family','line-height')
16440 * Sets a fixed width on the internal measurement element. If the text will be multiline, you have
16441 * to set a fixed width in order to accurately measure the text height.
16442 * @param {Number} width The width to set on the element
16444 setFixedWidth : function(width){
16445 ml.setWidth(width);
16449 * Returns the measured width of the specified text
16450 * @param {String} text The text to measure
16451 * @return {Number} width The width in pixels
16453 getWidth : function(text){
16454 ml.dom.style.width = 'auto';
16455 return this.getSize(text).width;
16459 * Returns the measured height of the specified text. For multiline text, be sure to call
16460 * {@link #setFixedWidth} if necessary.
16461 * @param {String} text The text to measure
16462 * @return {Number} height The height in pixels
16464 getHeight : function(text){
16465 return this.getSize(text).height;
16469 instance.bind(bindTo);
16474 // backwards compat
16475 Roo.Element.measureText = Roo.util.TextMetrics.measure;/*
16477 * Ext JS Library 1.1.1
16478 * Copyright(c) 2006-2007, Ext JS, LLC.
16480 * Originally Released Under LGPL - original licence link has changed is not relivant.
16483 * <script type="text/javascript">
16487 * @class Roo.state.Provider
16488 * Abstract base class for state provider implementations. This class provides methods
16489 * for encoding and decoding <b>typed</b> variables including dates and defines the
16490 * Provider interface.
16492 Roo.state.Provider = function(){
16494 * @event statechange
16495 * Fires when a state change occurs.
16496 * @param {Provider} this This state provider
16497 * @param {String} key The state key which was changed
16498 * @param {String} value The encoded value for the state
16501 "statechange": true
16504 Roo.state.Provider.superclass.constructor.call(this);
16506 Roo.extend(Roo.state.Provider, Roo.util.Observable, {
16508 * Returns the current value for a key
16509 * @param {String} name The key name
16510 * @param {Mixed} defaultValue A default value to return if the key's value is not found
16511 * @return {Mixed} The state data
16513 get : function(name, defaultValue){
16514 return typeof this.state[name] == "undefined" ?
16515 defaultValue : this.state[name];
16519 * Clears a value from the state
16520 * @param {String} name The key name
16522 clear : function(name){
16523 delete this.state[name];
16524 this.fireEvent("statechange", this, name, null);
16528 * Sets the value for a key
16529 * @param {String} name The key name
16530 * @param {Mixed} value The value to set
16532 set : function(name, value){
16533 this.state[name] = value;
16534 this.fireEvent("statechange", this, name, value);
16538 * Decodes a string previously encoded with {@link #encodeValue}.
16539 * @param {String} value The value to decode
16540 * @return {Mixed} The decoded value
16542 decodeValue : function(cookie){
16543 var re = /^(a|n|d|b|s|o)\:(.*)$/;
16544 var matches = re.exec(unescape(cookie));
16545 if(!matches || !matches[1]) {
16546 return; // non state cookie
16548 var type = matches[1];
16549 var v = matches[2];
16552 return parseFloat(v);
16554 return new Date(Date.parse(v));
16559 var values = v.split("^");
16560 for(var i = 0, len = values.length; i < len; i++){
16561 all.push(this.decodeValue(values[i]));
16566 var values = v.split("^");
16567 for(var i = 0, len = values.length; i < len; i++){
16568 var kv = values[i].split("=");
16569 all[kv[0]] = this.decodeValue(kv[1]);
16578 * Encodes a value including type information. Decode with {@link #decodeValue}.
16579 * @param {Mixed} value The value to encode
16580 * @return {String} The encoded value
16582 encodeValue : function(v){
16584 if(typeof v == "number"){
16586 }else if(typeof v == "boolean"){
16587 enc = "b:" + (v ? "1" : "0");
16588 }else if(v instanceof Date){
16589 enc = "d:" + v.toGMTString();
16590 }else if(v instanceof Array){
16592 for(var i = 0, len = v.length; i < len; i++){
16593 flat += this.encodeValue(v[i]);
16599 }else if(typeof v == "object"){
16602 if(typeof v[key] != "function"){
16603 flat += key + "=" + this.encodeValue(v[key]) + "^";
16606 enc = "o:" + flat.substring(0, flat.length-1);
16610 return escape(enc);
16616 * Ext JS Library 1.1.1
16617 * Copyright(c) 2006-2007, Ext JS, LLC.
16619 * Originally Released Under LGPL - original licence link has changed is not relivant.
16622 * <script type="text/javascript">
16625 * @class Roo.state.Manager
16626 * This is the global state manager. By default all components that are "state aware" check this class
16627 * for state information if you don't pass them a custom state provider. In order for this class
16628 * to be useful, it must be initialized with a provider when your application initializes.
16630 // in your initialization function
16632 Roo.state.Manager.setProvider(new Roo.state.CookieProvider());
16634 // supposed you have a {@link Roo.BorderLayout}
16635 var layout = new Roo.BorderLayout(...);
16636 layout.restoreState();
16637 // or a {Roo.BasicDialog}
16638 var dialog = new Roo.BasicDialog(...);
16639 dialog.restoreState();
16643 Roo.state.Manager = function(){
16644 var provider = new Roo.state.Provider();
16648 * Configures the default state provider for your application
16649 * @param {Provider} stateProvider The state provider to set
16651 setProvider : function(stateProvider){
16652 provider = stateProvider;
16656 * Returns the current value for a key
16657 * @param {String} name The key name
16658 * @param {Mixed} defaultValue The default value to return if the key lookup does not match
16659 * @return {Mixed} The state data
16661 get : function(key, defaultValue){
16662 return provider.get(key, defaultValue);
16666 * Sets the value for a key
16667 * @param {String} name The key name
16668 * @param {Mixed} value The state data
16670 set : function(key, value){
16671 provider.set(key, value);
16675 * Clears a value from the state
16676 * @param {String} name The key name
16678 clear : function(key){
16679 provider.clear(key);
16683 * Gets the currently configured state provider
16684 * @return {Provider} The state provider
16686 getProvider : function(){
16693 * Ext JS Library 1.1.1
16694 * Copyright(c) 2006-2007, Ext JS, LLC.
16696 * Originally Released Under LGPL - original licence link has changed is not relivant.
16699 * <script type="text/javascript">
16702 * @class Roo.state.CookieProvider
16703 * @extends Roo.state.Provider
16704 * The default Provider implementation which saves state via cookies.
16707 var cp = new Roo.state.CookieProvider({
16709 expires: new Date(new Date().getTime()+(1000*60*60*24*30)); //30 days
16710 domain: "roojs.com"
16712 Roo.state.Manager.setProvider(cp);
16714 * @cfg {String} path The path for which the cookie is active (defaults to root '/' which makes it active for all pages in the site)
16715 * @cfg {Date} expires The cookie expiration date (defaults to 7 days from now)
16716 * @cfg {String} domain The domain to save the cookie for. Note that you cannot specify a different domain than
16717 * your page is on, but you can specify a sub-domain, or simply the domain itself like 'roojs.com' to include
16718 * all sub-domains if you need to access cookies across different sub-domains (defaults to null which uses the same
16719 * domain the page is running on including the 'www' like 'www.roojs.com')
16720 * @cfg {Boolean} secure True if the site is using SSL (defaults to false)
16722 * Create a new CookieProvider
16723 * @param {Object} config The configuration object
16725 Roo.state.CookieProvider = function(config){
16726 Roo.state.CookieProvider.superclass.constructor.call(this);
16728 this.expires = new Date(new Date().getTime()+(1000*60*60*24*7)); //7 days
16729 this.domain = null;
16730 this.secure = false;
16731 Roo.apply(this, config);
16732 this.state = this.readCookies();
16735 Roo.extend(Roo.state.CookieProvider, Roo.state.Provider, {
16737 set : function(name, value){
16738 if(typeof value == "undefined" || value === null){
16742 this.setCookie(name, value);
16743 Roo.state.CookieProvider.superclass.set.call(this, name, value);
16747 clear : function(name){
16748 this.clearCookie(name);
16749 Roo.state.CookieProvider.superclass.clear.call(this, name);
16753 readCookies : function(){
16755 var c = document.cookie + ";";
16756 var re = /\s?(.*?)=(.*?);/g;
16758 while((matches = re.exec(c)) != null){
16759 var name = matches[1];
16760 var value = matches[2];
16761 if(name && name.substring(0,3) == "ys-"){
16762 cookies[name.substr(3)] = this.decodeValue(value);
16769 setCookie : function(name, value){
16770 document.cookie = "ys-"+ name + "=" + this.encodeValue(value) +
16771 ((this.expires == null) ? "" : ("; expires=" + this.expires.toGMTString())) +
16772 ((this.path == null) ? "" : ("; path=" + this.path)) +
16773 ((this.domain == null) ? "" : ("; domain=" + this.domain)) +
16774 ((this.secure == true) ? "; secure" : "");
16778 clearCookie : function(name){
16779 document.cookie = "ys-" + name + "=null; expires=Thu, 01-Jan-70 00:00:01 GMT" +
16780 ((this.path == null) ? "" : ("; path=" + this.path)) +
16781 ((this.domain == null) ? "" : ("; domain=" + this.domain)) +
16782 ((this.secure == true) ? "; secure" : "");
16786 * Ext JS Library 1.1.1
16787 * Copyright(c) 2006-2007, Ext JS, LLC.
16789 * Originally Released Under LGPL - original licence link has changed is not relivant.
16792 * <script type="text/javascript">
16797 * @class Roo.ComponentMgr
16798 * Provides a common registry of all components on a page so that they can be easily accessed by component id (see {@link Roo.getCmp}).
16801 Roo.ComponentMgr = function(){
16802 var all = new Roo.util.MixedCollection();
16806 * Registers a component.
16807 * @param {Roo.Component} c The component
16809 register : function(c){
16814 * Unregisters a component.
16815 * @param {Roo.Component} c The component
16817 unregister : function(c){
16822 * Returns a component by id
16823 * @param {String} id The component id
16825 get : function(id){
16826 return all.get(id);
16830 * Registers a function that will be called when a specified component is added to ComponentMgr
16831 * @param {String} id The component id
16832 * @param {Funtction} fn The callback function
16833 * @param {Object} scope The scope of the callback
16835 onAvailable : function(id, fn, scope){
16836 all.on("add", function(index, o){
16838 fn.call(scope || o, o);
16839 all.un("add", fn, scope);
16846 * Ext JS Library 1.1.1
16847 * Copyright(c) 2006-2007, Ext JS, LLC.
16849 * Originally Released Under LGPL - original licence link has changed is not relivant.
16852 * <script type="text/javascript">
16856 * @class Roo.Component
16857 * @extends Roo.util.Observable
16858 * Base class for all major Roo components. All subclasses of Component can automatically participate in the standard
16859 * Roo component lifecycle of creation, rendering and destruction. They also have automatic support for basic hide/show
16860 * and enable/disable behavior. Component allows any subclass to be lazy-rendered into any {@link Roo.Container} and
16861 * to be automatically registered with the {@link Roo.ComponentMgr} so that it can be referenced at any time via {@link Roo.getCmp}.
16862 * All visual components (widgets) that require rendering into a layout should subclass Component.
16864 * @param {Roo.Element/String/Object} config The configuration options. If an element is passed, it is set as the internal
16865 * 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
16866 * and is used as the component id. Otherwise, it is assumed to be a standard config object and is applied to the component.
16868 Roo.Component = function(config){
16869 config = config || {};
16870 if(config.tagName || config.dom || typeof config == "string"){ // element object
16871 config = {el: config, id: config.id || config};
16873 this.initialConfig = config;
16875 Roo.apply(this, config);
16879 * Fires after the component is disabled.
16880 * @param {Roo.Component} this
16885 * Fires after the component is enabled.
16886 * @param {Roo.Component} this
16890 * @event beforeshow
16891 * Fires before the component is shown. Return false to stop the show.
16892 * @param {Roo.Component} this
16897 * Fires after the component is shown.
16898 * @param {Roo.Component} this
16902 * @event beforehide
16903 * Fires before the component is hidden. Return false to stop the hide.
16904 * @param {Roo.Component} this
16909 * Fires after the component is hidden.
16910 * @param {Roo.Component} this
16914 * @event beforerender
16915 * Fires before the component is rendered. Return false to stop the render.
16916 * @param {Roo.Component} this
16918 beforerender : true,
16921 * Fires after the component is rendered.
16922 * @param {Roo.Component} this
16926 * @event beforedestroy
16927 * Fires before the component is destroyed. Return false to stop the destroy.
16928 * @param {Roo.Component} this
16930 beforedestroy : true,
16933 * Fires after the component is destroyed.
16934 * @param {Roo.Component} this
16939 this.id = "roo-comp-" + (++Roo.Component.AUTO_ID);
16941 Roo.ComponentMgr.register(this);
16942 Roo.Component.superclass.constructor.call(this);
16943 this.initComponent();
16944 if(this.renderTo){ // not supported by all components yet. use at your own risk!
16945 this.render(this.renderTo);
16946 delete this.renderTo;
16951 Roo.Component.AUTO_ID = 1000;
16953 Roo.extend(Roo.Component, Roo.util.Observable, {
16955 * @scope Roo.Component.prototype
16957 * true if this component is hidden. Read-only.
16962 * true if this component is disabled. Read-only.
16967 * true if this component has been rendered. Read-only.
16971 /** @cfg {String} disableClass
16972 * CSS class added to the component when it is disabled (defaults to "x-item-disabled").
16974 disabledClass : "x-item-disabled",
16975 /** @cfg {Boolean} allowDomMove
16976 * Whether the component can move the Dom node when rendering (defaults to true).
16978 allowDomMove : true,
16979 /** @cfg {String} hideMode (display|visibility)
16980 * How this component should hidden. Supported values are
16981 * "visibility" (css visibility), "offsets" (negative offset position) and
16982 * "display" (css display) - defaults to "display".
16984 hideMode: 'display',
16987 ctype : "Roo.Component",
16990 * @cfg {String} actionMode
16991 * which property holds the element that used for hide() / show() / disable() / enable()
16992 * default is 'el' for forms you probably want to set this to fieldEl
16997 getActionEl : function(){
16998 return this[this.actionMode];
17001 initComponent : Roo.emptyFn,
17003 * If this is a lazy rendering component, render it to its container element.
17004 * @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.
17006 render : function(container, position){
17012 if(this.fireEvent("beforerender", this) === false){
17016 if(!container && this.el){
17017 this.el = Roo.get(this.el);
17018 container = this.el.dom.parentNode;
17019 this.allowDomMove = false;
17021 this.container = Roo.get(container);
17022 this.rendered = true;
17023 if(position !== undefined){
17024 if(typeof position == 'number'){
17025 position = this.container.dom.childNodes[position];
17027 position = Roo.getDom(position);
17030 this.onRender(this.container, position || null);
17032 this.el.addClass(this.cls);
17036 this.el.applyStyles(this.style);
17039 this.fireEvent("render", this);
17040 this.afterRender(this.container);
17053 // default function is not really useful
17054 onRender : function(ct, position){
17056 this.el = Roo.get(this.el);
17057 if(this.allowDomMove !== false){
17058 ct.dom.insertBefore(this.el.dom, position);
17064 getAutoCreate : function(){
17065 var cfg = typeof this.autoCreate == "object" ?
17066 this.autoCreate : Roo.apply({}, this.defaultAutoCreate);
17067 if(this.id && !cfg.id){
17074 afterRender : Roo.emptyFn,
17077 * Destroys this component by purging any event listeners, removing the component's element from the DOM,
17078 * removing the component from its {@link Roo.Container} (if applicable) and unregistering it from {@link Roo.ComponentMgr}.
17080 destroy : function(){
17081 if(this.fireEvent("beforedestroy", this) !== false){
17082 this.purgeListeners();
17083 this.beforeDestroy();
17085 this.el.removeAllListeners();
17087 if(this.actionMode == "container"){
17088 this.container.remove();
17092 Roo.ComponentMgr.unregister(this);
17093 this.fireEvent("destroy", this);
17098 beforeDestroy : function(){
17103 onDestroy : function(){
17108 * Returns the underlying {@link Roo.Element}.
17109 * @return {Roo.Element} The element
17111 getEl : function(){
17116 * Returns the id of this component.
17119 getId : function(){
17124 * Try to focus this component.
17125 * @param {Boolean} selectText True to also select the text in this component (if applicable)
17126 * @return {Roo.Component} this
17128 focus : function(selectText){
17131 if(selectText === true){
17132 this.el.dom.select();
17147 * Disable this component.
17148 * @return {Roo.Component} this
17150 disable : function(){
17154 this.disabled = true;
17155 this.fireEvent("disable", this);
17160 onDisable : function(){
17161 this.getActionEl().addClass(this.disabledClass);
17162 this.el.dom.disabled = true;
17166 * Enable this component.
17167 * @return {Roo.Component} this
17169 enable : function(){
17173 this.disabled = false;
17174 this.fireEvent("enable", this);
17179 onEnable : function(){
17180 this.getActionEl().removeClass(this.disabledClass);
17181 this.el.dom.disabled = false;
17185 * Convenience function for setting disabled/enabled by boolean.
17186 * @param {Boolean} disabled
17188 setDisabled : function(disabled){
17189 this[disabled ? "disable" : "enable"]();
17193 * Show this component.
17194 * @return {Roo.Component} this
17197 if(this.fireEvent("beforeshow", this) !== false){
17198 this.hidden = false;
17202 this.fireEvent("show", this);
17208 onShow : function(){
17209 var ae = this.getActionEl();
17210 if(this.hideMode == 'visibility'){
17211 ae.dom.style.visibility = "visible";
17212 }else if(this.hideMode == 'offsets'){
17213 ae.removeClass('x-hidden');
17215 ae.dom.style.display = "";
17220 * Hide this component.
17221 * @return {Roo.Component} this
17224 if(this.fireEvent("beforehide", this) !== false){
17225 this.hidden = true;
17229 this.fireEvent("hide", this);
17235 onHide : function(){
17236 var ae = this.getActionEl();
17237 if(this.hideMode == 'visibility'){
17238 ae.dom.style.visibility = "hidden";
17239 }else if(this.hideMode == 'offsets'){
17240 ae.addClass('x-hidden');
17242 ae.dom.style.display = "none";
17247 * Convenience function to hide or show this component by boolean.
17248 * @param {Boolean} visible True to show, false to hide
17249 * @return {Roo.Component} this
17251 setVisible: function(visible){
17261 * Returns true if this component is visible.
17263 isVisible : function(){
17264 return this.getActionEl().isVisible();
17267 cloneConfig : function(overrides){
17268 overrides = overrides || {};
17269 var id = overrides.id || Roo.id();
17270 var cfg = Roo.applyIf(overrides, this.initialConfig);
17271 cfg.id = id; // prevent dup id
17272 return new this.constructor(cfg);
17276 * Ext JS Library 1.1.1
17277 * Copyright(c) 2006-2007, Ext JS, LLC.
17279 * Originally Released Under LGPL - original licence link has changed is not relivant.
17282 * <script type="text/javascript">
17286 * @class Roo.BoxComponent
17287 * @extends Roo.Component
17288 * Base class for any visual {@link Roo.Component} that uses a box container. BoxComponent provides automatic box
17289 * model adjustments for sizing and positioning and will work correctly withnin the Component rendering model. All
17290 * container classes should subclass BoxComponent so that they will work consistently when nested within other Roo
17291 * layout containers.
17293 * @param {Roo.Element/String/Object} config The configuration options.
17295 Roo.BoxComponent = function(config){
17296 Roo.Component.call(this, config);
17300 * Fires after the component is resized.
17301 * @param {Roo.Component} this
17302 * @param {Number} adjWidth The box-adjusted width that was set
17303 * @param {Number} adjHeight The box-adjusted height that was set
17304 * @param {Number} rawWidth The width that was originally specified
17305 * @param {Number} rawHeight The height that was originally specified
17310 * Fires after the component is moved.
17311 * @param {Roo.Component} this
17312 * @param {Number} x The new x position
17313 * @param {Number} y The new y position
17319 Roo.extend(Roo.BoxComponent, Roo.Component, {
17320 // private, set in afterRender to signify that the component has been rendered
17322 // private, used to defer height settings to subclasses
17323 deferHeight: false,
17324 /** @cfg {Number} width
17325 * width (optional) size of component
17327 /** @cfg {Number} height
17328 * height (optional) size of component
17332 * Sets the width and height of the component. This method fires the resize event. This method can accept
17333 * either width and height as separate numeric arguments, or you can pass a size object like {width:10, height:20}.
17334 * @param {Number/Object} width The new width to set, or a size object in the format {width, height}
17335 * @param {Number} height The new height to set (not required if a size object is passed as the first arg)
17336 * @return {Roo.BoxComponent} this
17338 setSize : function(w, h){
17339 // support for standard size objects
17340 if(typeof w == 'object'){
17345 if(!this.boxReady){
17351 // prevent recalcs when not needed
17352 if(this.lastSize && this.lastSize.width == w && this.lastSize.height == h){
17355 this.lastSize = {width: w, height: h};
17357 var adj = this.adjustSize(w, h);
17358 var aw = adj.width, ah = adj.height;
17359 if(aw !== undefined || ah !== undefined){ // this code is nasty but performs better with floaters
17360 var rz = this.getResizeEl();
17361 if(!this.deferHeight && aw !== undefined && ah !== undefined){
17362 rz.setSize(aw, ah);
17363 }else if(!this.deferHeight && ah !== undefined){
17365 }else if(aw !== undefined){
17368 this.onResize(aw, ah, w, h);
17369 this.fireEvent('resize', this, aw, ah, w, h);
17375 * Gets the current size of the component's underlying element.
17376 * @return {Object} An object containing the element's size {width: (element width), height: (element height)}
17378 getSize : function(){
17379 return this.el.getSize();
17383 * Gets the current XY position of the component's underlying element.
17384 * @param {Boolean} local (optional) If true the element's left and top are returned instead of page XY (defaults to false)
17385 * @return {Array} The XY position of the element (e.g., [100, 200])
17387 getPosition : function(local){
17388 if(local === true){
17389 return [this.el.getLeft(true), this.el.getTop(true)];
17391 return this.xy || this.el.getXY();
17395 * Gets the current box measurements of the component's underlying element.
17396 * @param {Boolean} local (optional) If true the element's left and top are returned instead of page XY (defaults to false)
17397 * @returns {Object} box An object in the format {x, y, width, height}
17399 getBox : function(local){
17400 var s = this.el.getSize();
17402 s.x = this.el.getLeft(true);
17403 s.y = this.el.getTop(true);
17405 var xy = this.xy || this.el.getXY();
17413 * Sets the current box measurements of the component's underlying element.
17414 * @param {Object} box An object in the format {x, y, width, height}
17415 * @returns {Roo.BoxComponent} this
17417 updateBox : function(box){
17418 this.setSize(box.width, box.height);
17419 this.setPagePosition(box.x, box.y);
17424 getResizeEl : function(){
17425 return this.resizeEl || this.el;
17429 getPositionEl : function(){
17430 return this.positionEl || this.el;
17434 * Sets the left and top of the component. To set the page XY position instead, use {@link #setPagePosition}.
17435 * This method fires the move event.
17436 * @param {Number} left The new left
17437 * @param {Number} top The new top
17438 * @returns {Roo.BoxComponent} this
17440 setPosition : function(x, y){
17443 if(!this.boxReady){
17446 var adj = this.adjustPosition(x, y);
17447 var ax = adj.x, ay = adj.y;
17449 var el = this.getPositionEl();
17450 if(ax !== undefined || ay !== undefined){
17451 if(ax !== undefined && ay !== undefined){
17452 el.setLeftTop(ax, ay);
17453 }else if(ax !== undefined){
17455 }else if(ay !== undefined){
17458 this.onPosition(ax, ay);
17459 this.fireEvent('move', this, ax, ay);
17465 * Sets the page XY position of the component. To set the left and top instead, use {@link #setPosition}.
17466 * This method fires the move event.
17467 * @param {Number} x The new x position
17468 * @param {Number} y The new y position
17469 * @returns {Roo.BoxComponent} this
17471 setPagePosition : function(x, y){
17474 if(!this.boxReady){
17477 if(x === undefined || y === undefined){ // cannot translate undefined points
17480 var p = this.el.translatePoints(x, y);
17481 this.setPosition(p.left, p.top);
17486 onRender : function(ct, position){
17487 Roo.BoxComponent.superclass.onRender.call(this, ct, position);
17489 this.resizeEl = Roo.get(this.resizeEl);
17491 if(this.positionEl){
17492 this.positionEl = Roo.get(this.positionEl);
17497 afterRender : function(){
17498 Roo.BoxComponent.superclass.afterRender.call(this);
17499 this.boxReady = true;
17500 this.setSize(this.width, this.height);
17501 if(this.x || this.y){
17502 this.setPosition(this.x, this.y);
17504 if(this.pageX || this.pageY){
17505 this.setPagePosition(this.pageX, this.pageY);
17510 * Force the component's size to recalculate based on the underlying element's current height and width.
17511 * @returns {Roo.BoxComponent} this
17513 syncSize : function(){
17514 delete this.lastSize;
17515 this.setSize(this.el.getWidth(), this.el.getHeight());
17520 * Called after the component is resized, this method is empty by default but can be implemented by any
17521 * subclass that needs to perform custom logic after a resize occurs.
17522 * @param {Number} adjWidth The box-adjusted width that was set
17523 * @param {Number} adjHeight The box-adjusted height that was set
17524 * @param {Number} rawWidth The width that was originally specified
17525 * @param {Number} rawHeight The height that was originally specified
17527 onResize : function(adjWidth, adjHeight, rawWidth, rawHeight){
17532 * Called after the component is moved, this method is empty by default but can be implemented by any
17533 * subclass that needs to perform custom logic after a move occurs.
17534 * @param {Number} x The new x position
17535 * @param {Number} y The new y position
17537 onPosition : function(x, y){
17542 adjustSize : function(w, h){
17543 if(this.autoWidth){
17546 if(this.autoHeight){
17549 return {width : w, height: h};
17553 adjustPosition : function(x, y){
17554 return {x : x, y: y};
17558 * Ext JS Library 1.1.1
17559 * Copyright(c) 2006-2007, Ext JS, LLC.
17561 * Originally Released Under LGPL - original licence link has changed is not relivant.
17564 * <script type="text/javascript">
17569 * @extends Roo.Element
17570 * An extended {@link Roo.Element} object that supports a shadow and shim, constrain to viewport and
17571 * automatic maintaining of shadow/shim positions.
17572 * @cfg {Boolean} shim False to disable the iframe shim in browsers which need one (defaults to true)
17573 * @cfg {String/Boolean} shadow True to create a shadow element with default class "x-layer-shadow", or
17574 * you can pass a string with a CSS class name. False turns off the shadow.
17575 * @cfg {Object} dh DomHelper object config to create element with (defaults to {tag: "div", cls: "x-layer"}).
17576 * @cfg {Boolean} constrain False to disable constrain to viewport (defaults to true)
17577 * @cfg {String} cls CSS class to add to the element
17578 * @cfg {Number} zindex Starting z-index (defaults to 11000)
17579 * @cfg {Number} shadowOffset Number of pixels to offset the shadow (defaults to 3)
17581 * @param {Object} config An object with config options.
17582 * @param {String/HTMLElement} existingEl (optional) Uses an existing DOM element. If the element is not found it creates it.
17585 Roo.Layer = function(config, existingEl){
17586 config = config || {};
17587 var dh = Roo.DomHelper;
17588 var cp = config.parentEl, pel = cp ? Roo.getDom(cp) : document.body;
17590 this.dom = Roo.getDom(existingEl);
17593 var o = config.dh || {tag: "div", cls: "x-layer"};
17594 this.dom = dh.append(pel, o);
17597 this.addClass(config.cls);
17599 this.constrain = config.constrain !== false;
17600 this.visibilityMode = Roo.Element.VISIBILITY;
17602 this.id = this.dom.id = config.id;
17604 this.id = Roo.id(this.dom);
17606 this.zindex = config.zindex || this.getZIndex();
17607 this.position("absolute", this.zindex);
17609 this.shadowOffset = config.shadowOffset || 4;
17610 this.shadow = new Roo.Shadow({
17611 offset : this.shadowOffset,
17612 mode : config.shadow
17615 this.shadowOffset = 0;
17617 this.useShim = config.shim !== false && Roo.useShims;
17618 this.useDisplay = config.useDisplay;
17622 var supr = Roo.Element.prototype;
17624 // shims are shared among layer to keep from having 100 iframes
17627 Roo.extend(Roo.Layer, Roo.Element, {
17629 getZIndex : function(){
17630 return this.zindex || parseInt(this.getStyle("z-index"), 10) || 11000;
17633 getShim : function(){
17640 var shim = shims.shift();
17642 shim = this.createShim();
17643 shim.enableDisplayMode('block');
17644 shim.dom.style.display = 'none';
17645 shim.dom.style.visibility = 'visible';
17647 var pn = this.dom.parentNode;
17648 if(shim.dom.parentNode != pn){
17649 pn.insertBefore(shim.dom, this.dom);
17651 shim.setStyle('z-index', this.getZIndex()-2);
17656 hideShim : function(){
17658 this.shim.setDisplayed(false);
17659 shims.push(this.shim);
17664 disableShadow : function(){
17666 this.shadowDisabled = true;
17667 this.shadow.hide();
17668 this.lastShadowOffset = this.shadowOffset;
17669 this.shadowOffset = 0;
17673 enableShadow : function(show){
17675 this.shadowDisabled = false;
17676 this.shadowOffset = this.lastShadowOffset;
17677 delete this.lastShadowOffset;
17685 // this code can execute repeatedly in milliseconds (i.e. during a drag) so
17686 // code size was sacrificed for effeciency (e.g. no getBox/setBox, no XY calls)
17687 sync : function(doShow){
17688 var sw = this.shadow;
17689 if(!this.updating && this.isVisible() && (sw || this.useShim)){
17690 var sh = this.getShim();
17692 var w = this.getWidth(),
17693 h = this.getHeight();
17695 var l = this.getLeft(true),
17696 t = this.getTop(true);
17698 if(sw && !this.shadowDisabled){
17699 if(doShow && !sw.isVisible()){
17702 sw.realign(l, t, w, h);
17708 // fit the shim behind the shadow, so it is shimmed too
17709 var a = sw.adjusts, s = sh.dom.style;
17710 s.left = (Math.min(l, l+a.l))+"px";
17711 s.top = (Math.min(t, t+a.t))+"px";
17712 s.width = (w+a.w)+"px";
17713 s.height = (h+a.h)+"px";
17720 sh.setLeftTop(l, t);
17727 destroy : function(){
17730 this.shadow.hide();
17732 this.removeAllListeners();
17733 var pn = this.dom.parentNode;
17735 pn.removeChild(this.dom);
17737 Roo.Element.uncache(this.id);
17740 remove : function(){
17745 beginUpdate : function(){
17746 this.updating = true;
17750 endUpdate : function(){
17751 this.updating = false;
17756 hideUnders : function(negOffset){
17758 this.shadow.hide();
17764 constrainXY : function(){
17765 if(this.constrain){
17766 var vw = Roo.lib.Dom.getViewWidth(),
17767 vh = Roo.lib.Dom.getViewHeight();
17768 var s = Roo.get(document).getScroll();
17770 var xy = this.getXY();
17771 var x = xy[0], y = xy[1];
17772 var w = this.dom.offsetWidth+this.shadowOffset, h = this.dom.offsetHeight+this.shadowOffset;
17773 // only move it if it needs it
17775 // first validate right/bottom
17776 if((x + w) > vw+s.left){
17777 x = vw - w - this.shadowOffset;
17780 if((y + h) > vh+s.top){
17781 y = vh - h - this.shadowOffset;
17784 // then make sure top/left isn't negative
17795 var ay = this.avoidY;
17796 if(y <= ay && (y+h) >= ay){
17802 supr.setXY.call(this, xy);
17808 isVisible : function(){
17809 return this.visible;
17813 showAction : function(){
17814 this.visible = true; // track visibility to prevent getStyle calls
17815 if(this.useDisplay === true){
17816 this.setDisplayed("");
17817 }else if(this.lastXY){
17818 supr.setXY.call(this, this.lastXY);
17819 }else if(this.lastLT){
17820 supr.setLeftTop.call(this, this.lastLT[0], this.lastLT[1]);
17825 hideAction : function(){
17826 this.visible = false;
17827 if(this.useDisplay === true){
17828 this.setDisplayed(false);
17830 this.setLeftTop(-10000,-10000);
17834 // overridden Element method
17835 setVisible : function(v, a, d, c, e){
17840 var cb = function(){
17845 }.createDelegate(this);
17846 supr.setVisible.call(this, true, true, d, cb, e);
17849 this.hideUnders(true);
17858 }.createDelegate(this);
17860 supr.setVisible.call(this, v, a, d, cb, e);
17869 storeXY : function(xy){
17870 delete this.lastLT;
17874 storeLeftTop : function(left, top){
17875 delete this.lastXY;
17876 this.lastLT = [left, top];
17880 beforeFx : function(){
17881 this.beforeAction();
17882 return Roo.Layer.superclass.beforeFx.apply(this, arguments);
17886 afterFx : function(){
17887 Roo.Layer.superclass.afterFx.apply(this, arguments);
17888 this.sync(this.isVisible());
17892 beforeAction : function(){
17893 if(!this.updating && this.shadow){
17894 this.shadow.hide();
17898 // overridden Element method
17899 setLeft : function(left){
17900 this.storeLeftTop(left, this.getTop(true));
17901 supr.setLeft.apply(this, arguments);
17905 setTop : function(top){
17906 this.storeLeftTop(this.getLeft(true), top);
17907 supr.setTop.apply(this, arguments);
17911 setLeftTop : function(left, top){
17912 this.storeLeftTop(left, top);
17913 supr.setLeftTop.apply(this, arguments);
17917 setXY : function(xy, a, d, c, e){
17919 this.beforeAction();
17921 var cb = this.createCB(c);
17922 supr.setXY.call(this, xy, a, d, cb, e);
17929 createCB : function(c){
17940 // overridden Element method
17941 setX : function(x, a, d, c, e){
17942 this.setXY([x, this.getY()], a, d, c, e);
17945 // overridden Element method
17946 setY : function(y, a, d, c, e){
17947 this.setXY([this.getX(), y], a, d, c, e);
17950 // overridden Element method
17951 setSize : function(w, h, a, d, c, e){
17952 this.beforeAction();
17953 var cb = this.createCB(c);
17954 supr.setSize.call(this, w, h, a, d, cb, e);
17960 // overridden Element method
17961 setWidth : function(w, a, d, c, e){
17962 this.beforeAction();
17963 var cb = this.createCB(c);
17964 supr.setWidth.call(this, w, a, d, cb, e);
17970 // overridden Element method
17971 setHeight : function(h, a, d, c, e){
17972 this.beforeAction();
17973 var cb = this.createCB(c);
17974 supr.setHeight.call(this, h, a, d, cb, e);
17980 // overridden Element method
17981 setBounds : function(x, y, w, h, a, d, c, e){
17982 this.beforeAction();
17983 var cb = this.createCB(c);
17985 this.storeXY([x, y]);
17986 supr.setXY.call(this, [x, y]);
17987 supr.setSize.call(this, w, h, a, d, cb, e);
17990 supr.setBounds.call(this, x, y, w, h, a, d, cb, e);
17996 * Sets the z-index of this layer and adjusts any shadow and shim z-indexes. The layer z-index is automatically
17997 * incremented by two more than the value passed in so that it always shows above any shadow or shim (the shadow
17998 * element, if any, will be assigned z-index + 1, and the shim element, if any, will be assigned the unmodified z-index).
17999 * @param {Number} zindex The new z-index to set
18000 * @return {this} The Layer
18002 setZIndex : function(zindex){
18003 this.zindex = zindex;
18004 this.setStyle("z-index", zindex + 2);
18006 this.shadow.setZIndex(zindex + 1);
18009 this.shim.setStyle("z-index", zindex);
18014 * Original code for Roojs - LGPL
18015 * <script type="text/javascript">
18019 * @class Roo.XComponent
18020 * A delayed Element creator...
18021 * Or a way to group chunks of interface together.
18022 * technically this is a wrapper around a tree of Roo elements (which defines a 'module'),
18023 * used in conjunction with XComponent.build() it will create an instance of each element,
18024 * then call addxtype() to build the User interface.
18026 * Mypart.xyx = new Roo.XComponent({
18028 parent : 'Mypart.xyz', // empty == document.element.!!
18032 disabled : function() {}
18034 tree : function() { // return an tree of xtype declared components
18038 xtype : 'NestedLayoutPanel',
18045 * It can be used to build a big heiracy, with parent etc.
18046 * or you can just use this to render a single compoent to a dom element
18047 * MYPART.render(Roo.Element | String(id) | dom_element )
18054 * Roo is designed primarily as a single page application, so the UI build for a standard interface will
18055 * expect a single 'TOP' level module normally indicated by the 'parent' of the XComponent definition being defined as false.
18057 * Each sub module is expected to have a parent pointing to the class name of it's parent module.
18059 * When the top level is false, a 'Roo.BorderLayout' is created and the element is flagged as 'topModule'
18060 * - if mulitple topModules exist, the last one is defined as the top module.
18064 * When the top level or multiple modules are to embedded into a existing HTML page,
18065 * the parent element can container '#id' of the element where the module will be drawn.
18069 * Unlike classic Roo, the bootstrap tends not to be used as a single page.
18070 * it relies more on a include mechanism, where sub modules are included into an outer page.
18071 * This is normally managed by the builder tools using Roo.apply( options, Included.Sub.Module )
18073 * Bootstrap Roo Included elements
18075 * Our builder application needs the ability to preview these sub compoennts. They will normally have parent=false set,
18076 * hence confusing the component builder as it thinks there are multiple top level elements.
18078 * String Over-ride & Translations
18080 * Our builder application writes all the strings as _strings and _named_strings. This is to enable the translation of elements,
18081 * and also the 'overlaying of string values - needed when different versions of the same application with different text content
18082 * are needed. @see Roo.XComponent.overlayString
18086 * @extends Roo.util.Observable
18088 * @param cfg {Object} configuration of component
18091 Roo.XComponent = function(cfg) {
18092 Roo.apply(this, cfg);
18096 * Fires when this the componnt is built
18097 * @param {Roo.XComponent} c the component
18102 this.region = this.region || 'center'; // default..
18103 Roo.XComponent.register(this);
18104 this.modules = false;
18105 this.el = false; // where the layout goes..
18109 Roo.extend(Roo.XComponent, Roo.util.Observable, {
18112 * The created element (with Roo.factory())
18113 * @type {Roo.Layout}
18119 * for BC - use el in new code
18120 * @type {Roo.Layout}
18126 * for BC - use el in new code
18127 * @type {Roo.Layout}
18132 * @cfg {Function|boolean} disabled
18133 * If this module is disabled by some rule, return true from the funtion
18138 * @cfg {String} parent
18139 * Name of parent element which it get xtype added to..
18144 * @cfg {String} order
18145 * Used to set the order in which elements are created (usefull for multiple tabs)
18150 * @cfg {String} name
18151 * String to display while loading.
18155 * @cfg {String} region
18156 * Region to render component to (defaults to center)
18161 * @cfg {Array} items
18162 * A single item array - the first element is the root of the tree..
18163 * It's done this way to stay compatible with the Xtype system...
18169 * The method that retuns the tree of parts that make up this compoennt
18176 * render element to dom or tree
18177 * @param {Roo.Element|String|DomElement} optional render to if parent is not set.
18180 render : function(el)
18184 var hp = this.parent ? 1 : 0;
18185 Roo.debug && Roo.log(this);
18187 var tree = this._tree ? this._tree() : this.tree();
18190 if (!el && typeof(this.parent) == 'string' && this.parent.substring(0,1) == '#') {
18191 // if parent is a '#.....' string, then let's use that..
18192 var ename = this.parent.substr(1);
18193 this.parent = false;
18194 Roo.debug && Roo.log(ename);
18196 case 'bootstrap-body':
18197 if (typeof(tree.el) != 'undefined' && tree.el == document.body) {
18198 // this is the BorderLayout standard?
18199 this.parent = { el : true };
18202 if (["Nest", "Content", "Grid", "Tree"].indexOf(tree.xtype) > -1) {
18203 // need to insert stuff...
18205 el : new Roo.bootstrap.layout.Border({
18206 el : document.body,
18212 tabPosition: 'top',
18213 //resizeTabs: true,
18214 alwaysShowTabs: true,
18224 if (typeof(Roo.bootstrap.Body) != 'undefined' ) {
18225 this.parent = { el : new Roo.bootstrap.Body() };
18226 Roo.debug && Roo.log("setting el to doc body");
18229 throw "Container is bootstrap body, but Roo.bootstrap.Body is not defined";
18233 this.parent = { el : true};
18236 el = Roo.get(ename);
18237 if (typeof(Roo.bootstrap) != 'undefined' && tree['|xns'] == 'Roo.bootstrap') {
18238 this.parent = { el : true};
18245 if (!el && !this.parent) {
18246 Roo.debug && Roo.log("Warning - element can not be found :#" + ename );
18251 Roo.debug && Roo.log("EL:");
18252 Roo.debug && Roo.log(el);
18253 Roo.debug && Roo.log("this.parent.el:");
18254 Roo.debug && Roo.log(this.parent.el);
18257 // altertive root elements ??? - we need a better way to indicate these.
18258 var is_alt = Roo.XComponent.is_alt ||
18259 (typeof(tree.el) != 'undefined' && tree.el == document.body) ||
18260 (typeof(Roo.bootstrap) != 'undefined' && tree.xns == Roo.bootstrap) ||
18261 (typeof(Roo.mailer) != 'undefined' && tree.xns == Roo.mailer) ;
18265 if (!this.parent && is_alt) {
18266 //el = Roo.get(document.body);
18267 this.parent = { el : true };
18272 if (!this.parent) {
18274 Roo.debug && Roo.log("no parent - creating one");
18276 el = el ? Roo.get(el) : false;
18278 if (typeof(Roo.BorderLayout) == 'undefined' ) {
18281 el : new Roo.bootstrap.layout.Border({
18282 el: el || document.body,
18288 tabPosition: 'top',
18289 //resizeTabs: true,
18290 alwaysShowTabs: false,
18293 overflow: 'visible'
18299 // it's a top level one..
18301 el : new Roo.BorderLayout(el || document.body, {
18306 tabPosition: 'top',
18307 //resizeTabs: true,
18308 alwaysShowTabs: el && hp? false : true,
18309 hideTabs: el || !hp ? true : false,
18317 if (!this.parent.el) {
18318 // probably an old style ctor, which has been disabled.
18322 // The 'tree' method is '_tree now'
18324 tree.region = tree.region || this.region;
18325 var is_body = false;
18326 if (this.parent.el === true) {
18327 // bootstrap... - body..
18331 this.parent.el = Roo.factory(tree);
18335 this.el = this.parent.el.addxtype(tree, undefined, is_body);
18336 this.fireEvent('built', this);
18338 this.panel = this.el;
18339 this.layout = this.panel.layout;
18340 this.parentLayout = this.parent.layout || false;
18346 Roo.apply(Roo.XComponent, {
18348 * @property hideProgress
18349 * true to disable the building progress bar.. usefull on single page renders.
18352 hideProgress : false,
18354 * @property buildCompleted
18355 * True when the builder has completed building the interface.
18358 buildCompleted : false,
18361 * @property topModule
18362 * the upper most module - uses document.element as it's constructor.
18369 * @property modules
18370 * array of modules to be created by registration system.
18371 * @type {Array} of Roo.XComponent
18376 * @property elmodules
18377 * array of modules to be created by which use #ID
18378 * @type {Array} of Roo.XComponent
18385 * Is an alternative Root - normally used by bootstrap or other systems,
18386 * where the top element in the tree can wrap 'body'
18387 * @type {boolean} (default false)
18392 * @property build_from_html
18393 * Build elements from html - used by bootstrap HTML stuff
18394 * - this is cleared after build is completed
18395 * @type {boolean} (default false)
18398 build_from_html : false,
18400 * Register components to be built later.
18402 * This solves the following issues
18403 * - Building is not done on page load, but after an authentication process has occured.
18404 * - Interface elements are registered on page load
18405 * - Parent Interface elements may not be loaded before child, so this handles that..
18412 module : 'Pman.Tab.projectMgr',
18414 parent : 'Pman.layout',
18415 disabled : false, // or use a function..
18418 * * @param {Object} details about module
18420 register : function(obj) {
18422 Roo.XComponent.event.fireEvent('register', obj);
18423 switch(typeof(obj.disabled) ) {
18429 if ( obj.disabled() ) {
18435 if (obj.disabled || obj.region == '#disabled') {
18441 this.modules.push(obj);
18445 * convert a string to an object..
18446 * eg. 'AAA.BBB' -> finds AAA.BBB
18450 toObject : function(str)
18452 if (!str || typeof(str) == 'object') {
18455 if (str.substring(0,1) == '#') {
18459 var ar = str.split('.');
18464 eval('if (typeof ' + rt + ' == "undefined"){ o = false;} o = ' + rt + ';');
18466 throw "Module not found : " + str;
18470 throw "Module not found : " + str;
18472 Roo.each(ar, function(e) {
18473 if (typeof(o[e]) == 'undefined') {
18474 throw "Module not found : " + str;
18485 * move modules into their correct place in the tree..
18488 preBuild : function ()
18491 Roo.each(this.modules , function (obj)
18493 Roo.XComponent.event.fireEvent('beforebuild', obj);
18495 var opar = obj.parent;
18497 obj.parent = this.toObject(opar);
18499 Roo.debug && Roo.log("parent:toObject failed: " + e.toString());
18504 Roo.debug && Roo.log("GOT top level module");
18505 Roo.debug && Roo.log(obj);
18506 obj.modules = new Roo.util.MixedCollection(false,
18507 function(o) { return o.order + '' }
18509 this.topModule = obj;
18512 // parent is a string (usually a dom element name..)
18513 if (typeof(obj.parent) == 'string') {
18514 this.elmodules.push(obj);
18517 if (obj.parent.constructor != Roo.XComponent) {
18518 Roo.debug && Roo.log("Warning : Object Parent is not instance of XComponent:" + obj.name)
18520 if (!obj.parent.modules) {
18521 obj.parent.modules = new Roo.util.MixedCollection(false,
18522 function(o) { return o.order + '' }
18525 if (obj.parent.disabled) {
18526 obj.disabled = true;
18528 obj.parent.modules.add(obj);
18533 * make a list of modules to build.
18534 * @return {Array} list of modules.
18537 buildOrder : function()
18540 var cmp = function(a,b) {
18541 return String(a).toUpperCase() > String(b).toUpperCase() ? 1 : -1;
18543 if ((!this.topModule || !this.topModule.modules) && !this.elmodules.length) {
18544 throw "No top level modules to build";
18547 // make a flat list in order of modules to build.
18548 var mods = this.topModule ? [ this.topModule ] : [];
18551 // elmodules (is a list of DOM based modules )
18552 Roo.each(this.elmodules, function(e) {
18554 if (!this.topModule &&
18555 typeof(e.parent) == 'string' &&
18556 e.parent.substring(0,1) == '#' &&
18557 Roo.get(e.parent.substr(1))
18560 _this.topModule = e;
18566 // add modules to their parents..
18567 var addMod = function(m) {
18568 Roo.debug && Roo.log("build Order: add: " + m.name);
18571 if (m.modules && !m.disabled) {
18572 Roo.debug && Roo.log("build Order: " + m.modules.length + " child modules");
18573 m.modules.keySort('ASC', cmp );
18574 Roo.debug && Roo.log("build Order: " + m.modules.length + " child modules (after sort)");
18576 m.modules.each(addMod);
18578 Roo.debug && Roo.log("build Order: no child modules");
18580 // not sure if this is used any more..
18582 m.finalize.name = m.name + " (clean up) ";
18583 mods.push(m.finalize);
18587 if (this.topModule && this.topModule.modules) {
18588 this.topModule.modules.keySort('ASC', cmp );
18589 this.topModule.modules.each(addMod);
18595 * Build the registered modules.
18596 * @param {Object} parent element.
18597 * @param {Function} optional method to call after module has been added.
18601 build : function(opts)
18604 if (typeof(opts) != 'undefined') {
18605 Roo.apply(this,opts);
18609 var mods = this.buildOrder();
18611 //this.allmods = mods;
18612 //Roo.debug && Roo.log(mods);
18614 if (!mods.length) { // should not happen
18615 throw "NO modules!!!";
18619 var msg = "Building Interface...";
18620 // flash it up as modal - so we store the mask!?
18621 if (!this.hideProgress && Roo.MessageBox) {
18622 Roo.MessageBox.show({ title: 'loading' });
18623 Roo.MessageBox.show({
18624 title: "Please wait...",
18634 var total = mods.length;
18637 var progressRun = function() {
18638 if (!mods.length) {
18639 Roo.debug && Roo.log('hide?');
18640 if (!this.hideProgress && Roo.MessageBox) {
18641 Roo.MessageBox.hide();
18643 Roo.XComponent.build_from_html = false; // reset, so dialogs will be build from javascript
18645 Roo.XComponent.event.fireEvent('buildcomplete', _this.topModule);
18651 var m = mods.shift();
18654 Roo.debug && Roo.log(m);
18655 // not sure if this is supported any more.. - modules that are are just function
18656 if (typeof(m) == 'function') {
18658 return progressRun.defer(10, _this);
18662 msg = "Building Interface " + (total - mods.length) +
18664 (m.name ? (' - ' + m.name) : '');
18665 Roo.debug && Roo.log(msg);
18666 if (!_this.hideProgress && Roo.MessageBox) {
18667 Roo.MessageBox.updateProgress( (total - mods.length)/total, msg );
18671 // is the module disabled?
18672 var disabled = (typeof(m.disabled) == 'function') ?
18673 m.disabled.call(m.module.disabled) : m.disabled;
18677 return progressRun(); // we do not update the display!
18685 // it's 10 on top level, and 1 on others??? why...
18686 return progressRun.defer(10, _this);
18689 progressRun.defer(1, _this);
18695 * Overlay a set of modified strings onto a component
18696 * This is dependant on our builder exporting the strings and 'named strings' elements.
18698 * @param {Object} element to overlay on - eg. Pman.Dialog.Login
18699 * @param {Object} associative array of 'named' string and it's new value.
18702 overlayStrings : function( component, strings )
18704 if (typeof(component['_named_strings']) == 'undefined') {
18705 throw "ERROR: component does not have _named_strings";
18707 for ( var k in strings ) {
18708 var md = typeof(component['_named_strings'][k]) == 'undefined' ? false : component['_named_strings'][k];
18709 if (md !== false) {
18710 component['_strings'][md] = strings[k];
18712 Roo.log('could not find named string: ' + k + ' in');
18713 Roo.log(component);
18728 * wrapper for event.on - aliased later..
18729 * Typically use to register a event handler for register:
18731 * eg. Roo.XComponent.on('register', function(comp) { comp.disable = true } );
18740 Roo.XComponent.event = new Roo.util.Observable({
18744 * Fires when an Component is registered,
18745 * set the disable property on the Component to stop registration.
18746 * @param {Roo.XComponent} c the component being registerd.
18751 * @event beforebuild
18752 * Fires before each Component is built
18753 * can be used to apply permissions.
18754 * @param {Roo.XComponent} c the component being registerd.
18757 'beforebuild' : true,
18759 * @event buildcomplete
18760 * Fires on the top level element when all elements have been built
18761 * @param {Roo.XComponent} the top level component.
18763 'buildcomplete' : true
18768 Roo.XComponent.on = Roo.XComponent.event.on.createDelegate(Roo.XComponent.event);
18771 * marked - a markdown parser
18772 * Copyright (c) 2011-2014, Christopher Jeffrey. (MIT Licensed)
18773 * https://github.com/chjj/marked
18779 * Roo.Markdown - is a very crude wrapper around marked..
18783 * alert( Roo.Markdown.toHtml("Markdown *rocks*.") );
18785 * Note: move the sample code to the bottom of this
18786 * file before uncommenting it.
18791 Roo.Markdown.toHtml = function(text) {
18793 var c = new Roo.Markdown.marked.setOptions({
18794 renderer: new Roo.Markdown.marked.Renderer(),
18805 text = text.replace(/\\\n/g,' ');
18806 return Roo.Markdown.marked(text);
18811 // Wraps all "globals" so that the only thing
18812 // exposed is makeHtml().
18818 * eval:var:unescape
18826 var escape = function (html, encode) {
18828 .replace(!encode ? /&(?!#?\w+;)/g : /&/g, '&')
18829 .replace(/</g, '<')
18830 .replace(/>/g, '>')
18831 .replace(/"/g, '"')
18832 .replace(/'/g, ''');
18835 var unescape = function (html) {
18836 // explicitly match decimal, hex, and named HTML entities
18837 return html.replace(/&(#(?:\d+)|(?:#x[0-9A-Fa-f]+)|(?:\w+));?/g, function(_, n) {
18838 n = n.toLowerCase();
18839 if (n === 'colon') { return ':'; }
18840 if (n.charAt(0) === '#') {
18841 return n.charAt(1) === 'x'
18842 ? String.fromCharCode(parseInt(n.substring(2), 16))
18843 : String.fromCharCode(+n.substring(1));
18849 var replace = function (regex, opt) {
18850 regex = regex.source;
18852 return function self(name, val) {
18853 if (!name) { return new RegExp(regex, opt); }
18854 val = val.source || val;
18855 val = val.replace(/(^|[^\[])\^/g, '$1');
18856 regex = regex.replace(name, val);
18865 var noop = function () {}
18871 var merge = function (obj) {
18876 for (; i < arguments.length; i++) {
18877 target = arguments[i];
18878 for (key in target) {
18879 if (Object.prototype.hasOwnProperty.call(target, key)) {
18880 obj[key] = target[key];
18890 * Block-Level Grammar
18898 code: /^( {4}[^\n]+\n*)+/,
18900 hr: /^( *[-*_]){3,} *(?:\n+|$)/,
18901 heading: /^ *(#{1,6}) *([^\n]+?) *#* *(?:\n+|$)/,
18903 lheading: /^([^\n]+)\n *(=|-){2,} *(?:\n+|$)/,
18904 blockquote: /^( *>[^\n]+(\n(?!def)[^\n]+)*\n*)+/,
18905 list: /^( *)(bull) [\s\S]+?(?:hr|def|\n{2,}(?! )(?!\1bull )\n*|\s*$)/,
18906 html: /^ *(?:comment *(?:\n|\s*$)|closed *(?:\n{2,}|\s*$)|closing *(?:\n{2,}|\s*$))/,
18907 def: /^ *\[([^\]]+)\]: *<?([^\s>]+)>?(?: +["(]([^\n]+)[")])? *(?:\n+|$)/,
18909 paragraph: /^((?:[^\n]+\n?(?!hr|heading|lheading|blockquote|tag|def))+)\n*/,
18913 block.bullet = /(?:[*+-]|\d+\.)/;
18914 block.item = /^( *)(bull) [^\n]*(?:\n(?!\1bull )[^\n]*)*/;
18915 block.item = replace(block.item, 'gm')
18916 (/bull/g, block.bullet)
18919 block.list = replace(block.list)
18920 (/bull/g, block.bullet)
18921 ('hr', '\\n+(?=\\1?(?:[-*_] *){3,}(?:\\n+|$))')
18922 ('def', '\\n+(?=' + block.def.source + ')')
18925 block.blockquote = replace(block.blockquote)
18929 block._tag = '(?!(?:'
18930 + 'a|em|strong|small|s|cite|q|dfn|abbr|data|time|code'
18931 + '|var|samp|kbd|sub|sup|i|b|u|mark|ruby|rt|rp|bdi|bdo'
18932 + '|span|br|wbr|ins|del|img)\\b)\\w+(?!:/|[^\\w\\s@]*@)\\b';
18934 block.html = replace(block.html)
18935 ('comment', /<!--[\s\S]*?-->/)
18936 ('closed', /<(tag)[\s\S]+?<\/\1>/)
18937 ('closing', /<tag(?:"[^"]*"|'[^']*'|[^'">])*?>/)
18938 (/tag/g, block._tag)
18941 block.paragraph = replace(block.paragraph)
18943 ('heading', block.heading)
18944 ('lheading', block.lheading)
18945 ('blockquote', block.blockquote)
18946 ('tag', '<' + block._tag)
18951 * Normal Block Grammar
18954 block.normal = merge({}, block);
18957 * GFM Block Grammar
18960 block.gfm = merge({}, block.normal, {
18961 fences: /^ *(`{3,}|~{3,})[ \.]*(\S+)? *\n([\s\S]*?)\s*\1 *(?:\n+|$)/,
18963 heading: /^ *(#{1,6}) +([^\n]+?) *#* *(?:\n+|$)/
18966 block.gfm.paragraph = replace(block.paragraph)
18968 + block.gfm.fences.source.replace('\\1', '\\2') + '|'
18969 + block.list.source.replace('\\1', '\\3') + '|')
18973 * GFM + Tables Block Grammar
18976 block.tables = merge({}, block.gfm, {
18977 nptable: /^ *(\S.*\|.*)\n *([-:]+ *\|[-| :]*)\n((?:.*\|.*(?:\n|$))*)\n*/,
18978 table: /^ *\|(.+)\n *\|( *[-:]+[-| :]*)\n((?: *\|.*(?:\n|$))*)\n*/
18985 var Lexer = function (options) {
18987 this.tokens.links = {};
18988 this.options = options || marked.defaults;
18989 this.rules = block.normal;
18991 if (this.options.gfm) {
18992 if (this.options.tables) {
18993 this.rules = block.tables;
18995 this.rules = block.gfm;
19001 * Expose Block Rules
19004 Lexer.rules = block;
19007 * Static Lex Method
19010 Lexer.lex = function(src, options) {
19011 var lexer = new Lexer(options);
19012 return lexer.lex(src);
19019 Lexer.prototype.lex = function(src) {
19021 .replace(/\r\n|\r/g, '\n')
19022 .replace(/\t/g, ' ')
19023 .replace(/\u00a0/g, ' ')
19024 .replace(/\u2424/g, '\n');
19026 return this.token(src, true);
19033 Lexer.prototype.token = function(src, top, bq) {
19034 var src = src.replace(/^ +$/gm, '')
19047 if (cap = this.rules.newline.exec(src)) {
19048 src = src.substring(cap[0].length);
19049 if (cap[0].length > 1) {
19057 if (cap = this.rules.code.exec(src)) {
19058 src = src.substring(cap[0].length);
19059 cap = cap[0].replace(/^ {4}/gm, '');
19062 text: !this.options.pedantic
19063 ? cap.replace(/\n+$/, '')
19070 if (cap = this.rules.fences.exec(src)) {
19071 src = src.substring(cap[0].length);
19081 if (cap = this.rules.heading.exec(src)) {
19082 src = src.substring(cap[0].length);
19085 depth: cap[1].length,
19091 // table no leading pipe (gfm)
19092 if (top && (cap = this.rules.nptable.exec(src))) {
19093 src = src.substring(cap[0].length);
19097 header: cap[1].replace(/^ *| *\| *$/g, '').split(/ *\| */),
19098 align: cap[2].replace(/^ *|\| *$/g, '').split(/ *\| */),
19099 cells: cap[3].replace(/\n$/, '').split('\n')
19102 for (i = 0; i < item.align.length; i++) {
19103 if (/^ *-+: *$/.test(item.align[i])) {
19104 item.align[i] = 'right';
19105 } else if (/^ *:-+: *$/.test(item.align[i])) {
19106 item.align[i] = 'center';
19107 } else if (/^ *:-+ *$/.test(item.align[i])) {
19108 item.align[i] = 'left';
19110 item.align[i] = null;
19114 for (i = 0; i < item.cells.length; i++) {
19115 item.cells[i] = item.cells[i].split(/ *\| */);
19118 this.tokens.push(item);
19124 if (cap = this.rules.lheading.exec(src)) {
19125 src = src.substring(cap[0].length);
19128 depth: cap[2] === '=' ? 1 : 2,
19135 if (cap = this.rules.hr.exec(src)) {
19136 src = src.substring(cap[0].length);
19144 if (cap = this.rules.blockquote.exec(src)) {
19145 src = src.substring(cap[0].length);
19148 type: 'blockquote_start'
19151 cap = cap[0].replace(/^ *> ?/gm, '');
19153 // Pass `top` to keep the current
19154 // "toplevel" state. This is exactly
19155 // how markdown.pl works.
19156 this.token(cap, top, true);
19159 type: 'blockquote_end'
19166 if (cap = this.rules.list.exec(src)) {
19167 src = src.substring(cap[0].length);
19171 type: 'list_start',
19172 ordered: bull.length > 1
19175 // Get each top-level item.
19176 cap = cap[0].match(this.rules.item);
19182 for (; i < l; i++) {
19185 // Remove the list item's bullet
19186 // so it is seen as the next token.
19187 space = item.length;
19188 item = item.replace(/^ *([*+-]|\d+\.) +/, '');
19190 // Outdent whatever the
19191 // list item contains. Hacky.
19192 if (~item.indexOf('\n ')) {
19193 space -= item.length;
19194 item = !this.options.pedantic
19195 ? item.replace(new RegExp('^ {1,' + space + '}', 'gm'), '')
19196 : item.replace(/^ {1,4}/gm, '');
19199 // Determine whether the next list item belongs here.
19200 // Backpedal if it does not belong in this list.
19201 if (this.options.smartLists && i !== l - 1) {
19202 b = block.bullet.exec(cap[i + 1])[0];
19203 if (bull !== b && !(bull.length > 1 && b.length > 1)) {
19204 src = cap.slice(i + 1).join('\n') + src;
19209 // Determine whether item is loose or not.
19210 // Use: /(^|\n)(?! )[^\n]+\n\n(?!\s*$)/
19211 // for discount behavior.
19212 loose = next || /\n\n(?!\s*$)/.test(item);
19214 next = item.charAt(item.length - 1) === '\n';
19215 if (!loose) { loose = next; }
19220 ? 'loose_item_start'
19221 : 'list_item_start'
19225 this.token(item, false, bq);
19228 type: 'list_item_end'
19240 if (cap = this.rules.html.exec(src)) {
19241 src = src.substring(cap[0].length);
19243 type: this.options.sanitize
19246 pre: !this.options.sanitizer
19247 && (cap[1] === 'pre' || cap[1] === 'script' || cap[1] === 'style'),
19254 if ((!bq && top) && (cap = this.rules.def.exec(src))) {
19255 src = src.substring(cap[0].length);
19256 this.tokens.links[cap[1].toLowerCase()] = {
19264 if (top && (cap = this.rules.table.exec(src))) {
19265 src = src.substring(cap[0].length);
19269 header: cap[1].replace(/^ *| *\| *$/g, '').split(/ *\| */),
19270 align: cap[2].replace(/^ *|\| *$/g, '').split(/ *\| */),
19271 cells: cap[3].replace(/(?: *\| *)?\n$/, '').split('\n')
19274 for (i = 0; i < item.align.length; i++) {
19275 if (/^ *-+: *$/.test(item.align[i])) {
19276 item.align[i] = 'right';
19277 } else if (/^ *:-+: *$/.test(item.align[i])) {
19278 item.align[i] = 'center';
19279 } else if (/^ *:-+ *$/.test(item.align[i])) {
19280 item.align[i] = 'left';
19282 item.align[i] = null;
19286 for (i = 0; i < item.cells.length; i++) {
19287 item.cells[i] = item.cells[i]
19288 .replace(/^ *\| *| *\| *$/g, '')
19292 this.tokens.push(item);
19297 // top-level paragraph
19298 if (top && (cap = this.rules.paragraph.exec(src))) {
19299 src = src.substring(cap[0].length);
19302 text: cap[1].charAt(cap[1].length - 1) === '\n'
19303 ? cap[1].slice(0, -1)
19310 if (cap = this.rules.text.exec(src)) {
19311 // Top-level should never reach here.
19312 src = src.substring(cap[0].length);
19322 Error('Infinite loop on byte: ' + src.charCodeAt(0));
19326 return this.tokens;
19330 * Inline-Level Grammar
19334 escape: /^\\([\\`*{}\[\]()#+\-.!_>])/,
19335 autolink: /^<([^ >]+(@|:\/)[^ >]+)>/,
19337 tag: /^<!--[\s\S]*?-->|^<\/?\w+(?:"[^"]*"|'[^']*'|[^'">])*?>/,
19338 link: /^!?\[(inside)\]\(href\)/,
19339 reflink: /^!?\[(inside)\]\s*\[([^\]]*)\]/,
19340 nolink: /^!?\[((?:\[[^\]]*\]|[^\[\]])*)\]/,
19341 strong: /^__([\s\S]+?)__(?!_)|^\*\*([\s\S]+?)\*\*(?!\*)/,
19342 em: /^\b_((?:[^_]|__)+?)_\b|^\*((?:\*\*|[\s\S])+?)\*(?!\*)/,
19343 code: /^(`+)\s*([\s\S]*?[^`])\s*\1(?!`)/,
19344 br: /^ {2,}\n(?!\s*$)/,
19346 text: /^[\s\S]+?(?=[\\<!\[_*`]| {2,}\n|$)/
19349 inline._inside = /(?:\[[^\]]*\]|[^\[\]]|\](?=[^\[]*\]))*/;
19350 inline._href = /\s*<?([\s\S]*?)>?(?:\s+['"]([\s\S]*?)['"])?\s*/;
19352 inline.link = replace(inline.link)
19353 ('inside', inline._inside)
19354 ('href', inline._href)
19357 inline.reflink = replace(inline.reflink)
19358 ('inside', inline._inside)
19362 * Normal Inline Grammar
19365 inline.normal = merge({}, inline);
19368 * Pedantic Inline Grammar
19371 inline.pedantic = merge({}, inline.normal, {
19372 strong: /^__(?=\S)([\s\S]*?\S)__(?!_)|^\*\*(?=\S)([\s\S]*?\S)\*\*(?!\*)/,
19373 em: /^_(?=\S)([\s\S]*?\S)_(?!_)|^\*(?=\S)([\s\S]*?\S)\*(?!\*)/
19377 * GFM Inline Grammar
19380 inline.gfm = merge({}, inline.normal, {
19381 escape: replace(inline.escape)('])', '~|])')(),
19382 url: /^(https?:\/\/[^\s<]+[^<.,:;"')\]\s])/,
19383 del: /^~~(?=\S)([\s\S]*?\S)~~/,
19384 text: replace(inline.text)
19386 ('|', '|https?://|')
19391 * GFM + Line Breaks Inline Grammar
19394 inline.breaks = merge({}, inline.gfm, {
19395 br: replace(inline.br)('{2,}', '*')(),
19396 text: replace(inline.gfm.text)('{2,}', '*')()
19400 * Inline Lexer & Compiler
19403 var InlineLexer = function (links, options) {
19404 this.options = options || marked.defaults;
19405 this.links = links;
19406 this.rules = inline.normal;
19407 this.renderer = this.options.renderer || new Renderer;
19408 this.renderer.options = this.options;
19412 Error('Tokens array requires a `links` property.');
19415 if (this.options.gfm) {
19416 if (this.options.breaks) {
19417 this.rules = inline.breaks;
19419 this.rules = inline.gfm;
19421 } else if (this.options.pedantic) {
19422 this.rules = inline.pedantic;
19427 * Expose Inline Rules
19430 InlineLexer.rules = inline;
19433 * Static Lexing/Compiling Method
19436 InlineLexer.output = function(src, links, options) {
19437 var inline = new InlineLexer(links, options);
19438 return inline.output(src);
19445 InlineLexer.prototype.output = function(src) {
19454 if (cap = this.rules.escape.exec(src)) {
19455 src = src.substring(cap[0].length);
19461 if (cap = this.rules.autolink.exec(src)) {
19462 src = src.substring(cap[0].length);
19463 if (cap[2] === '@') {
19464 text = cap[1].charAt(6) === ':'
19465 ? this.mangle(cap[1].substring(7))
19466 : this.mangle(cap[1]);
19467 href = this.mangle('mailto:') + text;
19469 text = escape(cap[1]);
19472 out += this.renderer.link(href, null, text);
19477 if (!this.inLink && (cap = this.rules.url.exec(src))) {
19478 src = src.substring(cap[0].length);
19479 text = escape(cap[1]);
19481 out += this.renderer.link(href, null, text);
19486 if (cap = this.rules.tag.exec(src)) {
19487 if (!this.inLink && /^<a /i.test(cap[0])) {
19488 this.inLink = true;
19489 } else if (this.inLink && /^<\/a>/i.test(cap[0])) {
19490 this.inLink = false;
19492 src = src.substring(cap[0].length);
19493 out += this.options.sanitize
19494 ? this.options.sanitizer
19495 ? this.options.sanitizer(cap[0])
19502 if (cap = this.rules.link.exec(src)) {
19503 src = src.substring(cap[0].length);
19504 this.inLink = true;
19505 out += this.outputLink(cap, {
19509 this.inLink = false;
19514 if ((cap = this.rules.reflink.exec(src))
19515 || (cap = this.rules.nolink.exec(src))) {
19516 src = src.substring(cap[0].length);
19517 link = (cap[2] || cap[1]).replace(/\s+/g, ' ');
19518 link = this.links[link.toLowerCase()];
19519 if (!link || !link.href) {
19520 out += cap[0].charAt(0);
19521 src = cap[0].substring(1) + src;
19524 this.inLink = true;
19525 out += this.outputLink(cap, link);
19526 this.inLink = false;
19531 if (cap = this.rules.strong.exec(src)) {
19532 src = src.substring(cap[0].length);
19533 out += this.renderer.strong(this.output(cap[2] || cap[1]));
19538 if (cap = this.rules.em.exec(src)) {
19539 src = src.substring(cap[0].length);
19540 out += this.renderer.em(this.output(cap[2] || cap[1]));
19545 if (cap = this.rules.code.exec(src)) {
19546 src = src.substring(cap[0].length);
19547 out += this.renderer.codespan(escape(cap[2], true));
19552 if (cap = this.rules.br.exec(src)) {
19553 src = src.substring(cap[0].length);
19554 out += this.renderer.br();
19559 if (cap = this.rules.del.exec(src)) {
19560 src = src.substring(cap[0].length);
19561 out += this.renderer.del(this.output(cap[1]));
19566 if (cap = this.rules.text.exec(src)) {
19567 src = src.substring(cap[0].length);
19568 out += this.renderer.text(escape(this.smartypants(cap[0])));
19574 Error('Infinite loop on byte: ' + src.charCodeAt(0));
19585 InlineLexer.prototype.outputLink = function(cap, link) {
19586 var href = escape(link.href)
19587 , title = link.title ? escape(link.title) : null;
19589 return cap[0].charAt(0) !== '!'
19590 ? this.renderer.link(href, title, this.output(cap[1]))
19591 : this.renderer.image(href, title, escape(cap[1]));
19595 * Smartypants Transformations
19598 InlineLexer.prototype.smartypants = function(text) {
19599 if (!this.options.smartypants) { return text; }
19602 .replace(/---/g, '\u2014')
19604 .replace(/--/g, '\u2013')
19606 .replace(/(^|[-\u2014/(\[{"\s])'/g, '$1\u2018')
19607 // closing singles & apostrophes
19608 .replace(/'/g, '\u2019')
19610 .replace(/(^|[-\u2014/(\[{\u2018\s])"/g, '$1\u201c')
19612 .replace(/"/g, '\u201d')
19614 .replace(/\.{3}/g, '\u2026');
19621 InlineLexer.prototype.mangle = function(text) {
19622 if (!this.options.mangle) { return text; }
19628 for (; i < l; i++) {
19629 ch = text.charCodeAt(i);
19630 if (Math.random() > 0.5) {
19631 ch = 'x' + ch.toString(16);
19633 out += '&#' + ch + ';';
19644 * eval:var:Renderer
19647 var Renderer = function (options) {
19648 this.options = options || {};
19651 Renderer.prototype.code = function(code, lang, escaped) {
19652 if (this.options.highlight) {
19653 var out = this.options.highlight(code, lang);
19654 if (out != null && out !== code) {
19659 // hack!!! - it's already escapeD?
19664 return '<pre><code>'
19665 + (escaped ? code : escape(code, true))
19666 + '\n</code></pre>';
19669 return '<pre><code class="'
19670 + this.options.langPrefix
19671 + escape(lang, true)
19673 + (escaped ? code : escape(code, true))
19674 + '\n</code></pre>\n';
19677 Renderer.prototype.blockquote = function(quote) {
19678 return '<blockquote>\n' + quote + '</blockquote>\n';
19681 Renderer.prototype.html = function(html) {
19685 Renderer.prototype.heading = function(text, level, raw) {
19689 + this.options.headerPrefix
19690 + raw.toLowerCase().replace(/[^\w]+/g, '-')
19698 Renderer.prototype.hr = function() {
19699 return this.options.xhtml ? '<hr/>\n' : '<hr>\n';
19702 Renderer.prototype.list = function(body, ordered) {
19703 var type = ordered ? 'ol' : 'ul';
19704 return '<' + type + '>\n' + body + '</' + type + '>\n';
19707 Renderer.prototype.listitem = function(text) {
19708 return '<li>' + text + '</li>\n';
19711 Renderer.prototype.paragraph = function(text) {
19712 return '<p>' + text + '</p>\n';
19715 Renderer.prototype.table = function(header, body) {
19716 return '<table class="table table-striped">\n'
19726 Renderer.prototype.tablerow = function(content) {
19727 return '<tr>\n' + content + '</tr>\n';
19730 Renderer.prototype.tablecell = function(content, flags) {
19731 var type = flags.header ? 'th' : 'td';
19732 var tag = flags.align
19733 ? '<' + type + ' style="text-align:' + flags.align + '">'
19734 : '<' + type + '>';
19735 return tag + content + '</' + type + '>\n';
19738 // span level renderer
19739 Renderer.prototype.strong = function(text) {
19740 return '<strong>' + text + '</strong>';
19743 Renderer.prototype.em = function(text) {
19744 return '<em>' + text + '</em>';
19747 Renderer.prototype.codespan = function(text) {
19748 return '<code>' + text + '</code>';
19751 Renderer.prototype.br = function() {
19752 return this.options.xhtml ? '<br/>' : '<br>';
19755 Renderer.prototype.del = function(text) {
19756 return '<del>' + text + '</del>';
19759 Renderer.prototype.link = function(href, title, text) {
19760 if (this.options.sanitize) {
19762 var prot = decodeURIComponent(unescape(href))
19763 .replace(/[^\w:]/g, '')
19768 if (prot.indexOf('javascript:') === 0 || prot.indexOf('vbscript:') === 0) {
19772 var out = '<a href="' + href + '"';
19774 out += ' title="' + title + '"';
19776 out += '>' + text + '</a>';
19780 Renderer.prototype.image = function(href, title, text) {
19781 var out = '<img src="' + href + '" alt="' + text + '"';
19783 out += ' title="' + title + '"';
19785 out += this.options.xhtml ? '/>' : '>';
19789 Renderer.prototype.text = function(text) {
19794 * Parsing & Compiling
19800 var Parser= function (options) {
19803 this.options = options || marked.defaults;
19804 this.options.renderer = this.options.renderer || new Renderer;
19805 this.renderer = this.options.renderer;
19806 this.renderer.options = this.options;
19810 * Static Parse Method
19813 Parser.parse = function(src, options, renderer) {
19814 var parser = new Parser(options, renderer);
19815 return parser.parse(src);
19822 Parser.prototype.parse = function(src) {
19823 this.inline = new InlineLexer(src.links, this.options, this.renderer);
19824 this.tokens = src.reverse();
19827 while (this.next()) {
19838 Parser.prototype.next = function() {
19839 return this.token = this.tokens.pop();
19843 * Preview Next Token
19846 Parser.prototype.peek = function() {
19847 return this.tokens[this.tokens.length - 1] || 0;
19851 * Parse Text Tokens
19854 Parser.prototype.parseText = function() {
19855 var body = this.token.text;
19857 while (this.peek().type === 'text') {
19858 body += '\n' + this.next().text;
19861 return this.inline.output(body);
19865 * Parse Current Token
19868 Parser.prototype.tok = function() {
19869 switch (this.token.type) {
19874 return this.renderer.hr();
19877 return this.renderer.heading(
19878 this.inline.output(this.token.text),
19883 return this.renderer.code(this.token.text,
19885 this.token.escaped);
19898 for (i = 0; i < this.token.header.length; i++) {
19899 flags = { header: true, align: this.token.align[i] };
19900 cell += this.renderer.tablecell(
19901 this.inline.output(this.token.header[i]),
19902 { header: true, align: this.token.align[i] }
19905 header += this.renderer.tablerow(cell);
19907 for (i = 0; i < this.token.cells.length; i++) {
19908 row = this.token.cells[i];
19911 for (j = 0; j < row.length; j++) {
19912 cell += this.renderer.tablecell(
19913 this.inline.output(row[j]),
19914 { header: false, align: this.token.align[j] }
19918 body += this.renderer.tablerow(cell);
19920 return this.renderer.table(header, body);
19922 case 'blockquote_start': {
19925 while (this.next().type !== 'blockquote_end') {
19926 body += this.tok();
19929 return this.renderer.blockquote(body);
19931 case 'list_start': {
19933 , ordered = this.token.ordered;
19935 while (this.next().type !== 'list_end') {
19936 body += this.tok();
19939 return this.renderer.list(body, ordered);
19941 case 'list_item_start': {
19944 while (this.next().type !== 'list_item_end') {
19945 body += this.token.type === 'text'
19950 return this.renderer.listitem(body);
19952 case 'loose_item_start': {
19955 while (this.next().type !== 'list_item_end') {
19956 body += this.tok();
19959 return this.renderer.listitem(body);
19962 var html = !this.token.pre && !this.options.pedantic
19963 ? this.inline.output(this.token.text)
19965 return this.renderer.html(html);
19967 case 'paragraph': {
19968 return this.renderer.paragraph(this.inline.output(this.token.text));
19971 return this.renderer.paragraph(this.parseText());
19983 var marked = function (src, opt, callback) {
19984 if (callback || typeof opt === 'function') {
19990 opt = merge({}, marked.defaults, opt || {});
19992 var highlight = opt.highlight
19998 tokens = Lexer.lex(src, opt)
20000 return callback(e);
20003 pending = tokens.length;
20007 var done = function(err) {
20009 opt.highlight = highlight;
20010 return callback(err);
20016 out = Parser.parse(tokens, opt);
20021 opt.highlight = highlight;
20025 : callback(null, out);
20028 if (!highlight || highlight.length < 3) {
20032 delete opt.highlight;
20034 if (!pending) { return done(); }
20036 for (; i < tokens.length; i++) {
20038 if (token.type !== 'code') {
20039 return --pending || done();
20041 return highlight(token.text, token.lang, function(err, code) {
20042 if (err) { return done(err); }
20043 if (code == null || code === token.text) {
20044 return --pending || done();
20047 token.escaped = true;
20048 --pending || done();
20056 if (opt) { opt = merge({}, marked.defaults, opt); }
20057 return Parser.parse(Lexer.lex(src, opt), opt);
20059 e.message += '\nPlease report this to https://github.com/chjj/marked.';
20060 if ((opt || marked.defaults).silent) {
20061 return '<p>An error occured:</p><pre>'
20062 + escape(e.message + '', true)
20074 marked.setOptions = function(opt) {
20075 merge(marked.defaults, opt);
20079 marked.defaults = {
20090 langPrefix: 'lang-',
20091 smartypants: false,
20093 renderer: new Renderer,
20101 marked.Parser = Parser;
20102 marked.parser = Parser.parse;
20104 marked.Renderer = Renderer;
20106 marked.Lexer = Lexer;
20107 marked.lexer = Lexer.lex;
20109 marked.InlineLexer = InlineLexer;
20110 marked.inlineLexer = InlineLexer.output;
20112 marked.parse = marked;
20114 Roo.Markdown.marked = marked;
20118 * Ext JS Library 1.1.1
20119 * Copyright(c) 2006-2007, Ext JS, LLC.
20121 * Originally Released Under LGPL - original licence link has changed is not relivant.
20124 * <script type="text/javascript">
20130 * These classes are derivatives of the similarly named classes in the YUI Library.
20131 * The original license:
20132 * Copyright (c) 2006, Yahoo! Inc. All rights reserved.
20133 * Code licensed under the BSD License:
20134 * http://developer.yahoo.net/yui/license.txt
20139 var Event=Roo.EventManager;
20140 var Dom=Roo.lib.Dom;
20143 * @class Roo.dd.DragDrop
20144 * @extends Roo.util.Observable
20145 * Defines the interface and base operation of items that that can be
20146 * dragged or can be drop targets. It was designed to be extended, overriding
20147 * the event handlers for startDrag, onDrag, onDragOver and onDragOut.
20148 * Up to three html elements can be associated with a DragDrop instance:
20150 * <li>linked element: the element that is passed into the constructor.
20151 * This is the element which defines the boundaries for interaction with
20152 * other DragDrop objects.</li>
20153 * <li>handle element(s): The drag operation only occurs if the element that
20154 * was clicked matches a handle element. By default this is the linked
20155 * element, but there are times that you will want only a portion of the
20156 * linked element to initiate the drag operation, and the setHandleElId()
20157 * method provides a way to define this.</li>
20158 * <li>drag element: this represents the element that would be moved along
20159 * with the cursor during a drag operation. By default, this is the linked
20160 * element itself as in {@link Roo.dd.DD}. setDragElId() lets you define
20161 * a separate element that would be moved, as in {@link Roo.dd.DDProxy}.
20164 * This class should not be instantiated until the onload event to ensure that
20165 * the associated elements are available.
20166 * The following would define a DragDrop obj that would interact with any
20167 * other DragDrop obj in the "group1" group:
20169 * dd = new Roo.dd.DragDrop("div1", "group1");
20171 * Since none of the event handlers have been implemented, nothing would
20172 * actually happen if you were to run the code above. Normally you would
20173 * override this class or one of the default implementations, but you can
20174 * also override the methods you want on an instance of the class...
20176 * dd.onDragDrop = function(e, id) {
20177 * alert("dd was dropped on " + id);
20181 * @param {String} id of the element that is linked to this instance
20182 * @param {String} sGroup the group of related DragDrop objects
20183 * @param {object} config an object containing configurable attributes
20184 * Valid properties for DragDrop:
20185 * padding, isTarget, maintainOffset, primaryButtonOnly
20187 Roo.dd.DragDrop = function(id, sGroup, config) {
20189 this.init(id, sGroup, config);
20194 Roo.extend(Roo.dd.DragDrop, Roo.util.Observable , {
20197 * The id of the element associated with this object. This is what we
20198 * refer to as the "linked element" because the size and position of
20199 * this element is used to determine when the drag and drop objects have
20207 * Configuration attributes passed into the constructor
20214 * The id of the element that will be dragged. By default this is same
20215 * as the linked element , but could be changed to another element. Ex:
20217 * @property dragElId
20224 * the id of the element that initiates the drag operation. By default
20225 * this is the linked element, but could be changed to be a child of this
20226 * element. This lets us do things like only starting the drag when the
20227 * header element within the linked html element is clicked.
20228 * @property handleElId
20235 * An associative array of HTML tags that will be ignored if clicked.
20236 * @property invalidHandleTypes
20237 * @type {string: string}
20239 invalidHandleTypes: null,
20242 * An associative array of ids for elements that will be ignored if clicked
20243 * @property invalidHandleIds
20244 * @type {string: string}
20246 invalidHandleIds: null,
20249 * An indexted array of css class names for elements that will be ignored
20251 * @property invalidHandleClasses
20254 invalidHandleClasses: null,
20257 * The linked element's absolute X position at the time the drag was
20259 * @property startPageX
20266 * The linked element's absolute X position at the time the drag was
20268 * @property startPageY
20275 * The group defines a logical collection of DragDrop objects that are
20276 * related. Instances only get events when interacting with other
20277 * DragDrop object in the same group. This lets us define multiple
20278 * groups using a single DragDrop subclass if we want.
20280 * @type {string: string}
20285 * Individual drag/drop instances can be locked. This will prevent
20286 * onmousedown start drag.
20294 * Lock this instance
20297 lock: function() { this.locked = true; },
20300 * Unlock this instace
20303 unlock: function() { this.locked = false; },
20306 * By default, all insances can be a drop target. This can be disabled by
20307 * setting isTarget to false.
20314 * The padding configured for this drag and drop object for calculating
20315 * the drop zone intersection with this object.
20322 * Cached reference to the linked element
20323 * @property _domRef
20329 * Internal typeof flag
20330 * @property __ygDragDrop
20333 __ygDragDrop: true,
20336 * Set to true when horizontal contraints are applied
20337 * @property constrainX
20344 * Set to true when vertical contraints are applied
20345 * @property constrainY
20352 * The left constraint
20360 * The right constraint
20368 * The up constraint
20377 * The down constraint
20385 * Maintain offsets when we resetconstraints. Set to true when you want
20386 * the position of the element relative to its parent to stay the same
20387 * when the page changes
20389 * @property maintainOffset
20392 maintainOffset: false,
20395 * Array of pixel locations the element will snap to if we specified a
20396 * horizontal graduation/interval. This array is generated automatically
20397 * when you define a tick interval.
20404 * Array of pixel locations the element will snap to if we specified a
20405 * vertical graduation/interval. This array is generated automatically
20406 * when you define a tick interval.
20413 * By default the drag and drop instance will only respond to the primary
20414 * button click (left button for a right-handed mouse). Set to true to
20415 * allow drag and drop to start with any mouse click that is propogated
20417 * @property primaryButtonOnly
20420 primaryButtonOnly: true,
20423 * The availabe property is false until the linked dom element is accessible.
20424 * @property available
20430 * By default, drags can only be initiated if the mousedown occurs in the
20431 * region the linked element is. This is done in part to work around a
20432 * bug in some browsers that mis-report the mousedown if the previous
20433 * mouseup happened outside of the window. This property is set to true
20434 * if outer handles are defined.
20436 * @property hasOuterHandles
20440 hasOuterHandles: false,
20443 * Code that executes immediately before the startDrag event
20444 * @method b4StartDrag
20447 b4StartDrag: function(x, y) { },
20450 * Abstract method called after a drag/drop object is clicked
20451 * and the drag or mousedown time thresholds have beeen met.
20452 * @method startDrag
20453 * @param {int} X click location
20454 * @param {int} Y click location
20456 startDrag: function(x, y) { /* override this */ },
20459 * Code that executes immediately before the onDrag event
20463 b4Drag: function(e) { },
20466 * Abstract method called during the onMouseMove event while dragging an
20469 * @param {Event} e the mousemove event
20471 onDrag: function(e) { /* override this */ },
20474 * Abstract method called when this element fist begins hovering over
20475 * another DragDrop obj
20476 * @method onDragEnter
20477 * @param {Event} e the mousemove event
20478 * @param {String|DragDrop[]} id In POINT mode, the element
20479 * id this is hovering over. In INTERSECT mode, an array of one or more
20480 * dragdrop items being hovered over.
20482 onDragEnter: function(e, id) { /* override this */ },
20485 * Code that executes immediately before the onDragOver event
20486 * @method b4DragOver
20489 b4DragOver: function(e) { },
20492 * Abstract method called when this element is hovering over another
20494 * @method onDragOver
20495 * @param {Event} e the mousemove event
20496 * @param {String|DragDrop[]} id In POINT mode, the element
20497 * id this is hovering over. In INTERSECT mode, an array of dd items
20498 * being hovered over.
20500 onDragOver: function(e, id) { /* override this */ },
20503 * Code that executes immediately before the onDragOut event
20504 * @method b4DragOut
20507 b4DragOut: function(e) { },
20510 * Abstract method called when we are no longer hovering over an element
20511 * @method onDragOut
20512 * @param {Event} e the mousemove event
20513 * @param {String|DragDrop[]} id In POINT mode, the element
20514 * id this was hovering over. In INTERSECT mode, an array of dd items
20515 * that the mouse is no longer over.
20517 onDragOut: function(e, id) { /* override this */ },
20520 * Code that executes immediately before the onDragDrop event
20521 * @method b4DragDrop
20524 b4DragDrop: function(e) { },
20527 * Abstract method called when this item is dropped on another DragDrop
20529 * @method onDragDrop
20530 * @param {Event} e the mouseup event
20531 * @param {String|DragDrop[]} id In POINT mode, the element
20532 * id this was dropped on. In INTERSECT mode, an array of dd items this
20535 onDragDrop: function(e, id) { /* override this */ },
20538 * Abstract method called when this item is dropped on an area with no
20540 * @method onInvalidDrop
20541 * @param {Event} e the mouseup event
20543 onInvalidDrop: function(e) { /* override this */ },
20546 * Code that executes immediately before the endDrag event
20547 * @method b4EndDrag
20550 b4EndDrag: function(e) { },
20553 * Fired when we are done dragging the object
20555 * @param {Event} e the mouseup event
20557 endDrag: function(e) { /* override this */ },
20560 * Code executed immediately before the onMouseDown event
20561 * @method b4MouseDown
20562 * @param {Event} e the mousedown event
20565 b4MouseDown: function(e) { },
20568 * Event handler that fires when a drag/drop obj gets a mousedown
20569 * @method onMouseDown
20570 * @param {Event} e the mousedown event
20572 onMouseDown: function(e) { /* override this */ },
20575 * Event handler that fires when a drag/drop obj gets a mouseup
20576 * @method onMouseUp
20577 * @param {Event} e the mouseup event
20579 onMouseUp: function(e) { /* override this */ },
20582 * Override the onAvailable method to do what is needed after the initial
20583 * position was determined.
20584 * @method onAvailable
20586 onAvailable: function () {
20590 * Provides default constraint padding to "constrainTo" elements (defaults to {left: 0, right:0, top:0, bottom:0}).
20593 defaultPadding : {left:0, right:0, top:0, bottom:0},
20596 * Initializes the drag drop object's constraints to restrict movement to a certain element.
20600 var dd = new Roo.dd.DDProxy("dragDiv1", "proxytest",
20601 { dragElId: "existingProxyDiv" });
20602 dd.startDrag = function(){
20603 this.constrainTo("parent-id");
20606 * Or you can initalize it using the {@link Roo.Element} object:
20608 Roo.get("dragDiv1").initDDProxy("proxytest", {dragElId: "existingProxyDiv"}, {
20609 startDrag : function(){
20610 this.constrainTo("parent-id");
20614 * @param {String/HTMLElement/Element} constrainTo The element to constrain to.
20615 * @param {Object/Number} pad (optional) Pad provides a way to specify "padding" of the constraints,
20616 * and can be either a number for symmetrical padding (4 would be equal to {left:4, right:4, top:4, bottom:4}) or
20617 * an object containing the sides to pad. For example: {right:10, bottom:10}
20618 * @param {Boolean} inContent (optional) Constrain the draggable in the content box of the element (inside padding and borders)
20620 constrainTo : function(constrainTo, pad, inContent){
20621 if(typeof pad == "number"){
20622 pad = {left: pad, right:pad, top:pad, bottom:pad};
20624 pad = pad || this.defaultPadding;
20625 var b = Roo.get(this.getEl()).getBox();
20626 var ce = Roo.get(constrainTo);
20627 var s = ce.getScroll();
20628 var c, cd = ce.dom;
20629 if(cd == document.body){
20630 c = { x: s.left, y: s.top, width: Roo.lib.Dom.getViewWidth(), height: Roo.lib.Dom.getViewHeight()};
20633 c = {x : xy[0]+s.left, y: xy[1]+s.top, width: cd.clientWidth, height: cd.clientHeight};
20637 var topSpace = b.y - c.y;
20638 var leftSpace = b.x - c.x;
20640 this.resetConstraints();
20641 this.setXConstraint(leftSpace - (pad.left||0), // left
20642 c.width - leftSpace - b.width - (pad.right||0) //right
20644 this.setYConstraint(topSpace - (pad.top||0), //top
20645 c.height - topSpace - b.height - (pad.bottom||0) //bottom
20650 * Returns a reference to the linked element
20652 * @return {HTMLElement} the html element
20654 getEl: function() {
20655 if (!this._domRef) {
20656 this._domRef = Roo.getDom(this.id);
20659 return this._domRef;
20663 * Returns a reference to the actual element to drag. By default this is
20664 * the same as the html element, but it can be assigned to another
20665 * element. An example of this can be found in Roo.dd.DDProxy
20666 * @method getDragEl
20667 * @return {HTMLElement} the html element
20669 getDragEl: function() {
20670 return Roo.getDom(this.dragElId);
20674 * Sets up the DragDrop object. Must be called in the constructor of any
20675 * Roo.dd.DragDrop subclass
20677 * @param id the id of the linked element
20678 * @param {String} sGroup the group of related items
20679 * @param {object} config configuration attributes
20681 init: function(id, sGroup, config) {
20682 this.initTarget(id, sGroup, config);
20683 if (!Roo.isTouch) {
20684 Event.on(this.id, "mousedown", this.handleMouseDown, this);
20686 Event.on(this.id, "touchstart", this.handleMouseDown, this);
20687 // Event.on(this.id, "selectstart", Event.preventDefault);
20691 * Initializes Targeting functionality only... the object does not
20692 * get a mousedown handler.
20693 * @method initTarget
20694 * @param id the id of the linked element
20695 * @param {String} sGroup the group of related items
20696 * @param {object} config configuration attributes
20698 initTarget: function(id, sGroup, config) {
20700 // configuration attributes
20701 this.config = config || {};
20703 // create a local reference to the drag and drop manager
20704 this.DDM = Roo.dd.DDM;
20705 // initialize the groups array
20708 // assume that we have an element reference instead of an id if the
20709 // parameter is not a string
20710 if (typeof id !== "string") {
20717 // add to an interaction group
20718 this.addToGroup((sGroup) ? sGroup : "default");
20720 // We don't want to register this as the handle with the manager
20721 // so we just set the id rather than calling the setter.
20722 this.handleElId = id;
20724 // the linked element is the element that gets dragged by default
20725 this.setDragElId(id);
20727 // by default, clicked anchors will not start drag operations.
20728 this.invalidHandleTypes = { A: "A" };
20729 this.invalidHandleIds = {};
20730 this.invalidHandleClasses = [];
20732 this.applyConfig();
20734 this.handleOnAvailable();
20738 * Applies the configuration parameters that were passed into the constructor.
20739 * This is supposed to happen at each level through the inheritance chain. So
20740 * a DDProxy implentation will execute apply config on DDProxy, DD, and
20741 * DragDrop in order to get all of the parameters that are available in
20743 * @method applyConfig
20745 applyConfig: function() {
20747 // configurable properties:
20748 // padding, isTarget, maintainOffset, primaryButtonOnly
20749 this.padding = this.config.padding || [0, 0, 0, 0];
20750 this.isTarget = (this.config.isTarget !== false);
20751 this.maintainOffset = (this.config.maintainOffset);
20752 this.primaryButtonOnly = (this.config.primaryButtonOnly !== false);
20757 * Executed when the linked element is available
20758 * @method handleOnAvailable
20761 handleOnAvailable: function() {
20762 this.available = true;
20763 this.resetConstraints();
20764 this.onAvailable();
20768 * Configures the padding for the target zone in px. Effectively expands
20769 * (or reduces) the virtual object size for targeting calculations.
20770 * Supports css-style shorthand; if only one parameter is passed, all sides
20771 * will have that padding, and if only two are passed, the top and bottom
20772 * will have the first param, the left and right the second.
20773 * @method setPadding
20774 * @param {int} iTop Top pad
20775 * @param {int} iRight Right pad
20776 * @param {int} iBot Bot pad
20777 * @param {int} iLeft Left pad
20779 setPadding: function(iTop, iRight, iBot, iLeft) {
20780 // this.padding = [iLeft, iRight, iTop, iBot];
20781 if (!iRight && 0 !== iRight) {
20782 this.padding = [iTop, iTop, iTop, iTop];
20783 } else if (!iBot && 0 !== iBot) {
20784 this.padding = [iTop, iRight, iTop, iRight];
20786 this.padding = [iTop, iRight, iBot, iLeft];
20791 * Stores the initial placement of the linked element.
20792 * @method setInitialPosition
20793 * @param {int} diffX the X offset, default 0
20794 * @param {int} diffY the Y offset, default 0
20796 setInitPosition: function(diffX, diffY) {
20797 var el = this.getEl();
20799 if (!this.DDM.verifyEl(el)) {
20803 var dx = diffX || 0;
20804 var dy = diffY || 0;
20806 var p = Dom.getXY( el );
20808 this.initPageX = p[0] - dx;
20809 this.initPageY = p[1] - dy;
20811 this.lastPageX = p[0];
20812 this.lastPageY = p[1];
20815 this.setStartPosition(p);
20819 * Sets the start position of the element. This is set when the obj
20820 * is initialized, the reset when a drag is started.
20821 * @method setStartPosition
20822 * @param pos current position (from previous lookup)
20825 setStartPosition: function(pos) {
20826 var p = pos || Dom.getXY( this.getEl() );
20827 this.deltaSetXY = null;
20829 this.startPageX = p[0];
20830 this.startPageY = p[1];
20834 * Add this instance to a group of related drag/drop objects. All
20835 * instances belong to at least one group, and can belong to as many
20836 * groups as needed.
20837 * @method addToGroup
20838 * @param sGroup {string} the name of the group
20840 addToGroup: function(sGroup) {
20841 this.groups[sGroup] = true;
20842 this.DDM.regDragDrop(this, sGroup);
20846 * Remove's this instance from the supplied interaction group
20847 * @method removeFromGroup
20848 * @param {string} sGroup The group to drop
20850 removeFromGroup: function(sGroup) {
20851 if (this.groups[sGroup]) {
20852 delete this.groups[sGroup];
20855 this.DDM.removeDDFromGroup(this, sGroup);
20859 * Allows you to specify that an element other than the linked element
20860 * will be moved with the cursor during a drag
20861 * @method setDragElId
20862 * @param id {string} the id of the element that will be used to initiate the drag
20864 setDragElId: function(id) {
20865 this.dragElId = id;
20869 * Allows you to specify a child of the linked element that should be
20870 * used to initiate the drag operation. An example of this would be if
20871 * you have a content div with text and links. Clicking anywhere in the
20872 * content area would normally start the drag operation. Use this method
20873 * to specify that an element inside of the content div is the element
20874 * that starts the drag operation.
20875 * @method setHandleElId
20876 * @param id {string} the id of the element that will be used to
20877 * initiate the drag.
20879 setHandleElId: function(id) {
20880 if (typeof id !== "string") {
20883 this.handleElId = id;
20884 this.DDM.regHandle(this.id, id);
20888 * Allows you to set an element outside of the linked element as a drag
20890 * @method setOuterHandleElId
20891 * @param id the id of the element that will be used to initiate the drag
20893 setOuterHandleElId: function(id) {
20894 if (typeof id !== "string") {
20897 Event.on(id, "mousedown",
20898 this.handleMouseDown, this);
20899 this.setHandleElId(id);
20901 this.hasOuterHandles = true;
20905 * Remove all drag and drop hooks for this element
20908 unreg: function() {
20909 Event.un(this.id, "mousedown",
20910 this.handleMouseDown);
20911 Event.un(this.id, "touchstart",
20912 this.handleMouseDown);
20913 this._domRef = null;
20914 this.DDM._remove(this);
20917 destroy : function(){
20922 * Returns true if this instance is locked, or the drag drop mgr is locked
20923 * (meaning that all drag/drop is disabled on the page.)
20925 * @return {boolean} true if this obj or all drag/drop is locked, else
20928 isLocked: function() {
20929 return (this.DDM.isLocked() || this.locked);
20933 * Fired when this object is clicked
20934 * @method handleMouseDown
20936 * @param {Roo.dd.DragDrop} oDD the clicked dd object (this dd obj)
20939 handleMouseDown: function(e, oDD){
20941 if (!Roo.isTouch && this.primaryButtonOnly && e.button != 0) {
20942 //Roo.log('not touch/ button !=0');
20945 if (e.browserEvent.touches && e.browserEvent.touches.length != 1) {
20946 return; // double touch..
20950 if (this.isLocked()) {
20951 //Roo.log('locked');
20955 this.DDM.refreshCache(this.groups);
20956 // Roo.log([Roo.lib.Event.getPageX(e), Roo.lib.Event.getPageY(e)]);
20957 var pt = new Roo.lib.Point(Roo.lib.Event.getPageX(e), Roo.lib.Event.getPageY(e));
20958 if (!this.hasOuterHandles && !this.DDM.isOverTarget(pt, this) ) {
20959 //Roo.log('no outer handes or not over target');
20962 // Roo.log('check validator');
20963 if (this.clickValidator(e)) {
20964 // Roo.log('validate success');
20965 // set the initial element position
20966 this.setStartPosition();
20969 this.b4MouseDown(e);
20970 this.onMouseDown(e);
20972 this.DDM.handleMouseDown(e, this);
20974 this.DDM.stopEvent(e);
20982 clickValidator: function(e) {
20983 var target = e.getTarget();
20984 return ( this.isValidHandleChild(target) &&
20985 (this.id == this.handleElId ||
20986 this.DDM.handleWasClicked(target, this.id)) );
20990 * Allows you to specify a tag name that should not start a drag operation
20991 * when clicked. This is designed to facilitate embedding links within a
20992 * drag handle that do something other than start the drag.
20993 * @method addInvalidHandleType
20994 * @param {string} tagName the type of element to exclude
20996 addInvalidHandleType: function(tagName) {
20997 var type = tagName.toUpperCase();
20998 this.invalidHandleTypes[type] = type;
21002 * Lets you to specify an element id for a child of a drag handle
21003 * that should not initiate a drag
21004 * @method addInvalidHandleId
21005 * @param {string} id the element id of the element you wish to ignore
21007 addInvalidHandleId: function(id) {
21008 if (typeof id !== "string") {
21011 this.invalidHandleIds[id] = id;
21015 * Lets you specify a css class of elements that will not initiate a drag
21016 * @method addInvalidHandleClass
21017 * @param {string} cssClass the class of the elements you wish to ignore
21019 addInvalidHandleClass: function(cssClass) {
21020 this.invalidHandleClasses.push(cssClass);
21024 * Unsets an excluded tag name set by addInvalidHandleType
21025 * @method removeInvalidHandleType
21026 * @param {string} tagName the type of element to unexclude
21028 removeInvalidHandleType: function(tagName) {
21029 var type = tagName.toUpperCase();
21030 // this.invalidHandleTypes[type] = null;
21031 delete this.invalidHandleTypes[type];
21035 * Unsets an invalid handle id
21036 * @method removeInvalidHandleId
21037 * @param {string} id the id of the element to re-enable
21039 removeInvalidHandleId: function(id) {
21040 if (typeof id !== "string") {
21043 delete this.invalidHandleIds[id];
21047 * Unsets an invalid css class
21048 * @method removeInvalidHandleClass
21049 * @param {string} cssClass the class of the element(s) you wish to
21052 removeInvalidHandleClass: function(cssClass) {
21053 for (var i=0, len=this.invalidHandleClasses.length; i<len; ++i) {
21054 if (this.invalidHandleClasses[i] == cssClass) {
21055 delete this.invalidHandleClasses[i];
21061 * Checks the tag exclusion list to see if this click should be ignored
21062 * @method isValidHandleChild
21063 * @param {HTMLElement} node the HTMLElement to evaluate
21064 * @return {boolean} true if this is a valid tag type, false if not
21066 isValidHandleChild: function(node) {
21069 // var n = (node.nodeName == "#text") ? node.parentNode : node;
21072 nodeName = node.nodeName.toUpperCase();
21074 nodeName = node.nodeName;
21076 valid = valid && !this.invalidHandleTypes[nodeName];
21077 valid = valid && !this.invalidHandleIds[node.id];
21079 for (var i=0, len=this.invalidHandleClasses.length; valid && i<len; ++i) {
21080 valid = !Dom.hasClass(node, this.invalidHandleClasses[i]);
21089 * Create the array of horizontal tick marks if an interval was specified
21090 * in setXConstraint().
21091 * @method setXTicks
21094 setXTicks: function(iStartX, iTickSize) {
21096 this.xTickSize = iTickSize;
21100 for (var i = this.initPageX; i >= this.minX; i = i - iTickSize) {
21102 this.xTicks[this.xTicks.length] = i;
21107 for (i = this.initPageX; i <= this.maxX; i = i + iTickSize) {
21109 this.xTicks[this.xTicks.length] = i;
21114 this.xTicks.sort(this.DDM.numericSort) ;
21118 * Create the array of vertical tick marks if an interval was specified in
21119 * setYConstraint().
21120 * @method setYTicks
21123 setYTicks: function(iStartY, iTickSize) {
21125 this.yTickSize = iTickSize;
21129 for (var i = this.initPageY; i >= this.minY; i = i - iTickSize) {
21131 this.yTicks[this.yTicks.length] = i;
21136 for (i = this.initPageY; i <= this.maxY; i = i + iTickSize) {
21138 this.yTicks[this.yTicks.length] = i;
21143 this.yTicks.sort(this.DDM.numericSort) ;
21147 * By default, the element can be dragged any place on the screen. Use
21148 * this method to limit the horizontal travel of the element. Pass in
21149 * 0,0 for the parameters if you want to lock the drag to the y axis.
21150 * @method setXConstraint
21151 * @param {int} iLeft the number of pixels the element can move to the left
21152 * @param {int} iRight the number of pixels the element can move to the
21154 * @param {int} iTickSize optional parameter for specifying that the
21156 * should move iTickSize pixels at a time.
21158 setXConstraint: function(iLeft, iRight, iTickSize) {
21159 this.leftConstraint = iLeft;
21160 this.rightConstraint = iRight;
21162 this.minX = this.initPageX - iLeft;
21163 this.maxX = this.initPageX + iRight;
21164 if (iTickSize) { this.setXTicks(this.initPageX, iTickSize); }
21166 this.constrainX = true;
21170 * Clears any constraints applied to this instance. Also clears ticks
21171 * since they can't exist independent of a constraint at this time.
21172 * @method clearConstraints
21174 clearConstraints: function() {
21175 this.constrainX = false;
21176 this.constrainY = false;
21181 * Clears any tick interval defined for this instance
21182 * @method clearTicks
21184 clearTicks: function() {
21185 this.xTicks = null;
21186 this.yTicks = null;
21187 this.xTickSize = 0;
21188 this.yTickSize = 0;
21192 * By default, the element can be dragged any place on the screen. Set
21193 * this to limit the vertical travel of the element. Pass in 0,0 for the
21194 * parameters if you want to lock the drag to the x axis.
21195 * @method setYConstraint
21196 * @param {int} iUp the number of pixels the element can move up
21197 * @param {int} iDown the number of pixels the element can move down
21198 * @param {int} iTickSize optional parameter for specifying that the
21199 * element should move iTickSize pixels at a time.
21201 setYConstraint: function(iUp, iDown, iTickSize) {
21202 this.topConstraint = iUp;
21203 this.bottomConstraint = iDown;
21205 this.minY = this.initPageY - iUp;
21206 this.maxY = this.initPageY + iDown;
21207 if (iTickSize) { this.setYTicks(this.initPageY, iTickSize); }
21209 this.constrainY = true;
21214 * resetConstraints must be called if you manually reposition a dd element.
21215 * @method resetConstraints
21216 * @param {boolean} maintainOffset
21218 resetConstraints: function() {
21221 // Maintain offsets if necessary
21222 if (this.initPageX || this.initPageX === 0) {
21223 // figure out how much this thing has moved
21224 var dx = (this.maintainOffset) ? this.lastPageX - this.initPageX : 0;
21225 var dy = (this.maintainOffset) ? this.lastPageY - this.initPageY : 0;
21227 this.setInitPosition(dx, dy);
21229 // This is the first time we have detected the element's position
21231 this.setInitPosition();
21234 if (this.constrainX) {
21235 this.setXConstraint( this.leftConstraint,
21236 this.rightConstraint,
21240 if (this.constrainY) {
21241 this.setYConstraint( this.topConstraint,
21242 this.bottomConstraint,
21248 * Normally the drag element is moved pixel by pixel, but we can specify
21249 * that it move a number of pixels at a time. This method resolves the
21250 * location when we have it set up like this.
21252 * @param {int} val where we want to place the object
21253 * @param {int[]} tickArray sorted array of valid points
21254 * @return {int} the closest tick
21257 getTick: function(val, tickArray) {
21260 // If tick interval is not defined, it is effectively 1 pixel,
21261 // so we return the value passed to us.
21263 } else if (tickArray[0] >= val) {
21264 // The value is lower than the first tick, so we return the first
21266 return tickArray[0];
21268 for (var i=0, len=tickArray.length; i<len; ++i) {
21270 if (tickArray[next] && tickArray[next] >= val) {
21271 var diff1 = val - tickArray[i];
21272 var diff2 = tickArray[next] - val;
21273 return (diff2 > diff1) ? tickArray[i] : tickArray[next];
21277 // The value is larger than the last tick, so we return the last
21279 return tickArray[tickArray.length - 1];
21286 * @return {string} string representation of the dd obj
21288 toString: function() {
21289 return ("DragDrop " + this.id);
21297 * Ext JS Library 1.1.1
21298 * Copyright(c) 2006-2007, Ext JS, LLC.
21300 * Originally Released Under LGPL - original licence link has changed is not relivant.
21303 * <script type="text/javascript">
21308 * The drag and drop utility provides a framework for building drag and drop
21309 * applications. In addition to enabling drag and drop for specific elements,
21310 * the drag and drop elements are tracked by the manager class, and the
21311 * interactions between the various elements are tracked during the drag and
21312 * the implementing code is notified about these important moments.
21315 // Only load the library once. Rewriting the manager class would orphan
21316 // existing drag and drop instances.
21317 if (!Roo.dd.DragDropMgr) {
21320 * @class Roo.dd.DragDropMgr
21321 * DragDropMgr is a singleton that tracks the element interaction for
21322 * all DragDrop items in the window. Generally, you will not call
21323 * this class directly, but it does have helper methods that could
21324 * be useful in your DragDrop implementations.
21327 Roo.dd.DragDropMgr = function() {
21329 var Event = Roo.EventManager;
21334 * Two dimensional Array of registered DragDrop objects. The first
21335 * dimension is the DragDrop item group, the second the DragDrop
21338 * @type {string: string}
21345 * Array of element ids defined as drag handles. Used to determine
21346 * if the element that generated the mousedown event is actually the
21347 * handle and not the html element itself.
21348 * @property handleIds
21349 * @type {string: string}
21356 * the DragDrop object that is currently being dragged
21357 * @property dragCurrent
21365 * the DragDrop object(s) that are being hovered over
21366 * @property dragOvers
21374 * the X distance between the cursor and the object being dragged
21383 * the Y distance between the cursor and the object being dragged
21392 * Flag to determine if we should prevent the default behavior of the
21393 * events we define. By default this is true, but this can be set to
21394 * false if you need the default behavior (not recommended)
21395 * @property preventDefault
21399 preventDefault: true,
21402 * Flag to determine if we should stop the propagation of the events
21403 * we generate. This is true by default but you may want to set it to
21404 * false if the html element contains other features that require the
21406 * @property stopPropagation
21410 stopPropagation: true,
21413 * Internal flag that is set to true when drag and drop has been
21415 * @property initialized
21422 * All drag and drop can be disabled.
21430 * Called the first time an element is registered.
21436 this.initialized = true;
21440 * In point mode, drag and drop interaction is defined by the
21441 * location of the cursor during the drag/drop
21449 * In intersect mode, drag and drop interactio nis defined by the
21450 * overlap of two or more drag and drop objects.
21451 * @property INTERSECT
21458 * The current drag and drop mode. Default: POINT
21466 * Runs method on all drag and drop objects
21467 * @method _execOnAll
21471 _execOnAll: function(sMethod, args) {
21472 for (var i in this.ids) {
21473 for (var j in this.ids[i]) {
21474 var oDD = this.ids[i][j];
21475 if (! this.isTypeOfDD(oDD)) {
21478 oDD[sMethod].apply(oDD, args);
21484 * Drag and drop initialization. Sets up the global event handlers
21489 _onLoad: function() {
21493 if (!Roo.isTouch) {
21494 Event.on(document, "mouseup", this.handleMouseUp, this, true);
21495 Event.on(document, "mousemove", this.handleMouseMove, this, true);
21497 Event.on(document, "touchend", this.handleMouseUp, this, true);
21498 Event.on(document, "touchmove", this.handleMouseMove, this, true);
21500 Event.on(window, "unload", this._onUnload, this, true);
21501 Event.on(window, "resize", this._onResize, this, true);
21502 // Event.on(window, "mouseout", this._test);
21507 * Reset constraints on all drag and drop objs
21508 * @method _onResize
21512 _onResize: function(e) {
21513 this._execOnAll("resetConstraints", []);
21517 * Lock all drag and drop functionality
21521 lock: function() { this.locked = true; },
21524 * Unlock all drag and drop functionality
21528 unlock: function() { this.locked = false; },
21531 * Is drag and drop locked?
21533 * @return {boolean} True if drag and drop is locked, false otherwise.
21536 isLocked: function() { return this.locked; },
21539 * Location cache that is set for all drag drop objects when a drag is
21540 * initiated, cleared when the drag is finished.
21541 * @property locationCache
21548 * Set useCache to false if you want to force object the lookup of each
21549 * drag and drop linked element constantly during a drag.
21550 * @property useCache
21557 * The number of pixels that the mouse needs to move after the
21558 * mousedown before the drag is initiated. Default=3;
21559 * @property clickPixelThresh
21563 clickPixelThresh: 3,
21566 * The number of milliseconds after the mousedown event to initiate the
21567 * drag if we don't get a mouseup event. Default=1000
21568 * @property clickTimeThresh
21572 clickTimeThresh: 350,
21575 * Flag that indicates that either the drag pixel threshold or the
21576 * mousdown time threshold has been met
21577 * @property dragThreshMet
21582 dragThreshMet: false,
21585 * Timeout used for the click time threshold
21586 * @property clickTimeout
21591 clickTimeout: null,
21594 * The X position of the mousedown event stored for later use when a
21595 * drag threshold is met.
21604 * The Y position of the mousedown event stored for later use when a
21605 * drag threshold is met.
21614 * Each DragDrop instance must be registered with the DragDropMgr.
21615 * This is executed in DragDrop.init()
21616 * @method regDragDrop
21617 * @param {DragDrop} oDD the DragDrop object to register
21618 * @param {String} sGroup the name of the group this element belongs to
21621 regDragDrop: function(oDD, sGroup) {
21622 if (!this.initialized) { this.init(); }
21624 if (!this.ids[sGroup]) {
21625 this.ids[sGroup] = {};
21627 this.ids[sGroup][oDD.id] = oDD;
21631 * Removes the supplied dd instance from the supplied group. Executed
21632 * by DragDrop.removeFromGroup, so don't call this function directly.
21633 * @method removeDDFromGroup
21637 removeDDFromGroup: function(oDD, sGroup) {
21638 if (!this.ids[sGroup]) {
21639 this.ids[sGroup] = {};
21642 var obj = this.ids[sGroup];
21643 if (obj && obj[oDD.id]) {
21644 delete obj[oDD.id];
21649 * Unregisters a drag and drop item. This is executed in
21650 * DragDrop.unreg, use that method instead of calling this directly.
21655 _remove: function(oDD) {
21656 for (var g in oDD.groups) {
21657 if (g && this.ids[g][oDD.id]) {
21658 delete this.ids[g][oDD.id];
21661 delete this.handleIds[oDD.id];
21665 * Each DragDrop handle element must be registered. This is done
21666 * automatically when executing DragDrop.setHandleElId()
21667 * @method regHandle
21668 * @param {String} sDDId the DragDrop id this element is a handle for
21669 * @param {String} sHandleId the id of the element that is the drag
21673 regHandle: function(sDDId, sHandleId) {
21674 if (!this.handleIds[sDDId]) {
21675 this.handleIds[sDDId] = {};
21677 this.handleIds[sDDId][sHandleId] = sHandleId;
21681 * Utility function to determine if a given element has been
21682 * registered as a drag drop item.
21683 * @method isDragDrop
21684 * @param {String} id the element id to check
21685 * @return {boolean} true if this element is a DragDrop item,
21689 isDragDrop: function(id) {
21690 return ( this.getDDById(id) ) ? true : false;
21694 * Returns the drag and drop instances that are in all groups the
21695 * passed in instance belongs to.
21696 * @method getRelated
21697 * @param {DragDrop} p_oDD the obj to get related data for
21698 * @param {boolean} bTargetsOnly if true, only return targetable objs
21699 * @return {DragDrop[]} the related instances
21702 getRelated: function(p_oDD, bTargetsOnly) {
21704 for (var i in p_oDD.groups) {
21705 for (j in this.ids[i]) {
21706 var dd = this.ids[i][j];
21707 if (! this.isTypeOfDD(dd)) {
21710 if (!bTargetsOnly || dd.isTarget) {
21711 oDDs[oDDs.length] = dd;
21720 * Returns true if the specified dd target is a legal target for
21721 * the specifice drag obj
21722 * @method isLegalTarget
21723 * @param {DragDrop} the drag obj
21724 * @param {DragDrop} the target
21725 * @return {boolean} true if the target is a legal target for the
21729 isLegalTarget: function (oDD, oTargetDD) {
21730 var targets = this.getRelated(oDD, true);
21731 for (var i=0, len=targets.length;i<len;++i) {
21732 if (targets[i].id == oTargetDD.id) {
21741 * My goal is to be able to transparently determine if an object is
21742 * typeof DragDrop, and the exact subclass of DragDrop. typeof
21743 * returns "object", oDD.constructor.toString() always returns
21744 * "DragDrop" and not the name of the subclass. So for now it just
21745 * evaluates a well-known variable in DragDrop.
21746 * @method isTypeOfDD
21747 * @param {Object} the object to evaluate
21748 * @return {boolean} true if typeof oDD = DragDrop
21751 isTypeOfDD: function (oDD) {
21752 return (oDD && oDD.__ygDragDrop);
21756 * Utility function to determine if a given element has been
21757 * registered as a drag drop handle for the given Drag Drop object.
21759 * @param {String} id the element id to check
21760 * @return {boolean} true if this element is a DragDrop handle, false
21764 isHandle: function(sDDId, sHandleId) {
21765 return ( this.handleIds[sDDId] &&
21766 this.handleIds[sDDId][sHandleId] );
21770 * Returns the DragDrop instance for a given id
21771 * @method getDDById
21772 * @param {String} id the id of the DragDrop object
21773 * @return {DragDrop} the drag drop object, null if it is not found
21776 getDDById: function(id) {
21777 for (var i in this.ids) {
21778 if (this.ids[i][id]) {
21779 return this.ids[i][id];
21786 * Fired after a registered DragDrop object gets the mousedown event.
21787 * Sets up the events required to track the object being dragged
21788 * @method handleMouseDown
21789 * @param {Event} e the event
21790 * @param oDD the DragDrop object being dragged
21794 handleMouseDown: function(e, oDD) {
21796 Roo.QuickTips.disable();
21798 this.currentTarget = e.getTarget();
21800 this.dragCurrent = oDD;
21802 var el = oDD.getEl();
21804 // track start position
21805 this.startX = e.getPageX();
21806 this.startY = e.getPageY();
21808 this.deltaX = this.startX - el.offsetLeft;
21809 this.deltaY = this.startY - el.offsetTop;
21811 this.dragThreshMet = false;
21813 this.clickTimeout = setTimeout(
21815 var DDM = Roo.dd.DDM;
21816 DDM.startDrag(DDM.startX, DDM.startY);
21818 this.clickTimeThresh );
21822 * Fired when either the drag pixel threshol or the mousedown hold
21823 * time threshold has been met.
21824 * @method startDrag
21825 * @param x {int} the X position of the original mousedown
21826 * @param y {int} the Y position of the original mousedown
21829 startDrag: function(x, y) {
21830 clearTimeout(this.clickTimeout);
21831 if (this.dragCurrent) {
21832 this.dragCurrent.b4StartDrag(x, y);
21833 this.dragCurrent.startDrag(x, y);
21835 this.dragThreshMet = true;
21839 * Internal function to handle the mouseup event. Will be invoked
21840 * from the context of the document.
21841 * @method handleMouseUp
21842 * @param {Event} e the event
21846 handleMouseUp: function(e) {
21849 Roo.QuickTips.enable();
21851 if (! this.dragCurrent) {
21855 clearTimeout(this.clickTimeout);
21857 if (this.dragThreshMet) {
21858 this.fireEvents(e, true);
21868 * Utility to stop event propagation and event default, if these
21869 * features are turned on.
21870 * @method stopEvent
21871 * @param {Event} e the event as returned by this.getEvent()
21874 stopEvent: function(e){
21875 if(this.stopPropagation) {
21876 e.stopPropagation();
21879 if (this.preventDefault) {
21880 e.preventDefault();
21885 * Internal function to clean up event handlers after the drag
21886 * operation is complete
21888 * @param {Event} e the event
21892 stopDrag: function(e) {
21893 // Fire the drag end event for the item that was dragged
21894 if (this.dragCurrent) {
21895 if (this.dragThreshMet) {
21896 this.dragCurrent.b4EndDrag(e);
21897 this.dragCurrent.endDrag(e);
21900 this.dragCurrent.onMouseUp(e);
21903 this.dragCurrent = null;
21904 this.dragOvers = {};
21908 * Internal function to handle the mousemove event. Will be invoked
21909 * from the context of the html element.
21911 * @TODO figure out what we can do about mouse events lost when the
21912 * user drags objects beyond the window boundary. Currently we can
21913 * detect this in internet explorer by verifying that the mouse is
21914 * down during the mousemove event. Firefox doesn't give us the
21915 * button state on the mousemove event.
21916 * @method handleMouseMove
21917 * @param {Event} e the event
21921 handleMouseMove: function(e) {
21922 if (! this.dragCurrent) {
21926 // var button = e.which || e.button;
21928 // check for IE mouseup outside of page boundary
21929 if (Roo.isIE && (e.button !== 0 && e.button !== 1 && e.button !== 2)) {
21931 return this.handleMouseUp(e);
21934 if (!this.dragThreshMet) {
21935 var diffX = Math.abs(this.startX - e.getPageX());
21936 var diffY = Math.abs(this.startY - e.getPageY());
21937 if (diffX > this.clickPixelThresh ||
21938 diffY > this.clickPixelThresh) {
21939 this.startDrag(this.startX, this.startY);
21943 if (this.dragThreshMet) {
21944 this.dragCurrent.b4Drag(e);
21945 this.dragCurrent.onDrag(e);
21946 if(!this.dragCurrent.moveOnly){
21947 this.fireEvents(e, false);
21957 * Iterates over all of the DragDrop elements to find ones we are
21958 * hovering over or dropping on
21959 * @method fireEvents
21960 * @param {Event} e the event
21961 * @param {boolean} isDrop is this a drop op or a mouseover op?
21965 fireEvents: function(e, isDrop) {
21966 var dc = this.dragCurrent;
21968 // If the user did the mouse up outside of the window, we could
21969 // get here even though we have ended the drag.
21970 if (!dc || dc.isLocked()) {
21974 var pt = e.getPoint();
21976 // cache the previous dragOver array
21982 var enterEvts = [];
21984 // Check to see if the object(s) we were hovering over is no longer
21985 // being hovered over so we can fire the onDragOut event
21986 for (var i in this.dragOvers) {
21988 var ddo = this.dragOvers[i];
21990 if (! this.isTypeOfDD(ddo)) {
21994 if (! this.isOverTarget(pt, ddo, this.mode)) {
21995 outEvts.push( ddo );
21998 oldOvers[i] = true;
21999 delete this.dragOvers[i];
22002 for (var sGroup in dc.groups) {
22004 if ("string" != typeof sGroup) {
22008 for (i in this.ids[sGroup]) {
22009 var oDD = this.ids[sGroup][i];
22010 if (! this.isTypeOfDD(oDD)) {
22014 if (oDD.isTarget && !oDD.isLocked() && oDD != dc) {
22015 if (this.isOverTarget(pt, oDD, this.mode)) {
22016 // look for drop interactions
22018 dropEvts.push( oDD );
22019 // look for drag enter and drag over interactions
22022 // initial drag over: dragEnter fires
22023 if (!oldOvers[oDD.id]) {
22024 enterEvts.push( oDD );
22025 // subsequent drag overs: dragOver fires
22027 overEvts.push( oDD );
22030 this.dragOvers[oDD.id] = oDD;
22038 if (outEvts.length) {
22039 dc.b4DragOut(e, outEvts);
22040 dc.onDragOut(e, outEvts);
22043 if (enterEvts.length) {
22044 dc.onDragEnter(e, enterEvts);
22047 if (overEvts.length) {
22048 dc.b4DragOver(e, overEvts);
22049 dc.onDragOver(e, overEvts);
22052 if (dropEvts.length) {
22053 dc.b4DragDrop(e, dropEvts);
22054 dc.onDragDrop(e, dropEvts);
22058 // fire dragout events
22060 for (i=0, len=outEvts.length; i<len; ++i) {
22061 dc.b4DragOut(e, outEvts[i].id);
22062 dc.onDragOut(e, outEvts[i].id);
22065 // fire enter events
22066 for (i=0,len=enterEvts.length; i<len; ++i) {
22067 // dc.b4DragEnter(e, oDD.id);
22068 dc.onDragEnter(e, enterEvts[i].id);
22071 // fire over events
22072 for (i=0,len=overEvts.length; i<len; ++i) {
22073 dc.b4DragOver(e, overEvts[i].id);
22074 dc.onDragOver(e, overEvts[i].id);
22077 // fire drop events
22078 for (i=0, len=dropEvts.length; i<len; ++i) {
22079 dc.b4DragDrop(e, dropEvts[i].id);
22080 dc.onDragDrop(e, dropEvts[i].id);
22085 // notify about a drop that did not find a target
22086 if (isDrop && !dropEvts.length) {
22087 dc.onInvalidDrop(e);
22093 * Helper function for getting the best match from the list of drag
22094 * and drop objects returned by the drag and drop events when we are
22095 * in INTERSECT mode. It returns either the first object that the
22096 * cursor is over, or the object that has the greatest overlap with
22097 * the dragged element.
22098 * @method getBestMatch
22099 * @param {DragDrop[]} dds The array of drag and drop objects
22101 * @return {DragDrop} The best single match
22104 getBestMatch: function(dds) {
22106 // Return null if the input is not what we expect
22107 //if (!dds || !dds.length || dds.length == 0) {
22109 // If there is only one item, it wins
22110 //} else if (dds.length == 1) {
22112 var len = dds.length;
22117 // Loop through the targeted items
22118 for (var i=0; i<len; ++i) {
22120 // If the cursor is over the object, it wins. If the
22121 // cursor is over multiple matches, the first one we come
22123 if (dd.cursorIsOver) {
22126 // Otherwise the object with the most overlap wins
22129 winner.overlap.getArea() < dd.overlap.getArea()) {
22140 * Refreshes the cache of the top-left and bottom-right points of the
22141 * drag and drop objects in the specified group(s). This is in the
22142 * format that is stored in the drag and drop instance, so typical
22145 * Roo.dd.DragDropMgr.refreshCache(ddinstance.groups);
22149 * Roo.dd.DragDropMgr.refreshCache({group1:true, group2:true});
22151 * @TODO this really should be an indexed array. Alternatively this
22152 * method could accept both.
22153 * @method refreshCache
22154 * @param {Object} groups an associative array of groups to refresh
22157 refreshCache: function(groups) {
22158 for (var sGroup in groups) {
22159 if ("string" != typeof sGroup) {
22162 for (var i in this.ids[sGroup]) {
22163 var oDD = this.ids[sGroup][i];
22165 if (this.isTypeOfDD(oDD)) {
22166 // if (this.isTypeOfDD(oDD) && oDD.isTarget) {
22167 var loc = this.getLocation(oDD);
22169 this.locationCache[oDD.id] = loc;
22171 delete this.locationCache[oDD.id];
22172 // this will unregister the drag and drop object if
22173 // the element is not in a usable state
22182 * This checks to make sure an element exists and is in the DOM. The
22183 * main purpose is to handle cases where innerHTML is used to remove
22184 * drag and drop objects from the DOM. IE provides an 'unspecified
22185 * error' when trying to access the offsetParent of such an element
22187 * @param {HTMLElement} el the element to check
22188 * @return {boolean} true if the element looks usable
22191 verifyEl: function(el) {
22196 parent = el.offsetParent;
22199 parent = el.offsetParent;
22210 * Returns a Region object containing the drag and drop element's position
22211 * and size, including the padding configured for it
22212 * @method getLocation
22213 * @param {DragDrop} oDD the drag and drop object to get the
22215 * @return {Roo.lib.Region} a Region object representing the total area
22216 * the element occupies, including any padding
22217 * the instance is configured for.
22220 getLocation: function(oDD) {
22221 if (! this.isTypeOfDD(oDD)) {
22225 var el = oDD.getEl(), pos, x1, x2, y1, y2, t, r, b, l;
22228 pos= Roo.lib.Dom.getXY(el);
22236 x2 = x1 + el.offsetWidth;
22238 y2 = y1 + el.offsetHeight;
22240 t = y1 - oDD.padding[0];
22241 r = x2 + oDD.padding[1];
22242 b = y2 + oDD.padding[2];
22243 l = x1 - oDD.padding[3];
22245 return new Roo.lib.Region( t, r, b, l );
22249 * Checks the cursor location to see if it over the target
22250 * @method isOverTarget
22251 * @param {Roo.lib.Point} pt The point to evaluate
22252 * @param {DragDrop} oTarget the DragDrop object we are inspecting
22253 * @return {boolean} true if the mouse is over the target
22257 isOverTarget: function(pt, oTarget, intersect) {
22258 // use cache if available
22259 var loc = this.locationCache[oTarget.id];
22260 if (!loc || !this.useCache) {
22261 loc = this.getLocation(oTarget);
22262 this.locationCache[oTarget.id] = loc;
22270 oTarget.cursorIsOver = loc.contains( pt );
22272 // DragDrop is using this as a sanity check for the initial mousedown
22273 // in this case we are done. In POINT mode, if the drag obj has no
22274 // contraints, we are also done. Otherwise we need to evaluate the
22275 // location of the target as related to the actual location of the
22276 // dragged element.
22277 var dc = this.dragCurrent;
22278 if (!dc || !dc.getTargetCoord ||
22279 (!intersect && !dc.constrainX && !dc.constrainY)) {
22280 return oTarget.cursorIsOver;
22283 oTarget.overlap = null;
22285 // Get the current location of the drag element, this is the
22286 // location of the mouse event less the delta that represents
22287 // where the original mousedown happened on the element. We
22288 // need to consider constraints and ticks as well.
22289 var pos = dc.getTargetCoord(pt.x, pt.y);
22291 var el = dc.getDragEl();
22292 var curRegion = new Roo.lib.Region( pos.y,
22293 pos.x + el.offsetWidth,
22294 pos.y + el.offsetHeight,
22297 var overlap = curRegion.intersect(loc);
22300 oTarget.overlap = overlap;
22301 return (intersect) ? true : oTarget.cursorIsOver;
22308 * unload event handler
22309 * @method _onUnload
22313 _onUnload: function(e, me) {
22314 Roo.dd.DragDropMgr.unregAll();
22318 * Cleans up the drag and drop events and objects.
22323 unregAll: function() {
22325 if (this.dragCurrent) {
22327 this.dragCurrent = null;
22330 this._execOnAll("unreg", []);
22332 for (i in this.elementCache) {
22333 delete this.elementCache[i];
22336 this.elementCache = {};
22341 * A cache of DOM elements
22342 * @property elementCache
22349 * Get the wrapper for the DOM element specified
22350 * @method getElWrapper
22351 * @param {String} id the id of the element to get
22352 * @return {Roo.dd.DDM.ElementWrapper} the wrapped element
22354 * @deprecated This wrapper isn't that useful
22357 getElWrapper: function(id) {
22358 var oWrapper = this.elementCache[id];
22359 if (!oWrapper || !oWrapper.el) {
22360 oWrapper = this.elementCache[id] =
22361 new this.ElementWrapper(Roo.getDom(id));
22367 * Returns the actual DOM element
22368 * @method getElement
22369 * @param {String} id the id of the elment to get
22370 * @return {Object} The element
22371 * @deprecated use Roo.getDom instead
22374 getElement: function(id) {
22375 return Roo.getDom(id);
22379 * Returns the style property for the DOM element (i.e.,
22380 * document.getElById(id).style)
22382 * @param {String} id the id of the elment to get
22383 * @return {Object} The style property of the element
22384 * @deprecated use Roo.getDom instead
22387 getCss: function(id) {
22388 var el = Roo.getDom(id);
22389 return (el) ? el.style : null;
22393 * Inner class for cached elements
22394 * @class DragDropMgr.ElementWrapper
22399 ElementWrapper: function(el) {
22404 this.el = el || null;
22409 this.id = this.el && el.id;
22411 * A reference to the style property
22414 this.css = this.el && el.style;
22418 * Returns the X position of an html element
22420 * @param el the element for which to get the position
22421 * @return {int} the X coordinate
22423 * @deprecated use Roo.lib.Dom.getX instead
22426 getPosX: function(el) {
22427 return Roo.lib.Dom.getX(el);
22431 * Returns the Y position of an html element
22433 * @param el the element for which to get the position
22434 * @return {int} the Y coordinate
22435 * @deprecated use Roo.lib.Dom.getY instead
22438 getPosY: function(el) {
22439 return Roo.lib.Dom.getY(el);
22443 * Swap two nodes. In IE, we use the native method, for others we
22444 * emulate the IE behavior
22446 * @param n1 the first node to swap
22447 * @param n2 the other node to swap
22450 swapNode: function(n1, n2) {
22454 var p = n2.parentNode;
22455 var s = n2.nextSibling;
22458 p.insertBefore(n1, n2);
22459 } else if (n2 == n1.nextSibling) {
22460 p.insertBefore(n2, n1);
22462 n1.parentNode.replaceChild(n2, n1);
22463 p.insertBefore(n1, s);
22469 * Returns the current scroll position
22470 * @method getScroll
22474 getScroll: function () {
22475 var t, l, dde=document.documentElement, db=document.body;
22476 if (dde && (dde.scrollTop || dde.scrollLeft)) {
22478 l = dde.scrollLeft;
22485 return { top: t, left: l };
22489 * Returns the specified element style property
22491 * @param {HTMLElement} el the element
22492 * @param {string} styleProp the style property
22493 * @return {string} The value of the style property
22494 * @deprecated use Roo.lib.Dom.getStyle
22497 getStyle: function(el, styleProp) {
22498 return Roo.fly(el).getStyle(styleProp);
22502 * Gets the scrollTop
22503 * @method getScrollTop
22504 * @return {int} the document's scrollTop
22507 getScrollTop: function () { return this.getScroll().top; },
22510 * Gets the scrollLeft
22511 * @method getScrollLeft
22512 * @return {int} the document's scrollTop
22515 getScrollLeft: function () { return this.getScroll().left; },
22518 * Sets the x/y position of an element to the location of the
22521 * @param {HTMLElement} moveEl The element to move
22522 * @param {HTMLElement} targetEl The position reference element
22525 moveToEl: function (moveEl, targetEl) {
22526 var aCoord = Roo.lib.Dom.getXY(targetEl);
22527 Roo.lib.Dom.setXY(moveEl, aCoord);
22531 * Numeric array sort function
22532 * @method numericSort
22535 numericSort: function(a, b) { return (a - b); },
22539 * @property _timeoutCount
22546 * Trying to make the load order less important. Without this we get
22547 * an error if this file is loaded before the Event Utility.
22548 * @method _addListeners
22552 _addListeners: function() {
22553 var DDM = Roo.dd.DDM;
22554 if ( Roo.lib.Event && document ) {
22557 if (DDM._timeoutCount > 2000) {
22559 setTimeout(DDM._addListeners, 10);
22560 if (document && document.body) {
22561 DDM._timeoutCount += 1;
22568 * Recursively searches the immediate parent and all child nodes for
22569 * the handle element in order to determine wheter or not it was
22571 * @method handleWasClicked
22572 * @param node the html element to inspect
22575 handleWasClicked: function(node, id) {
22576 if (this.isHandle(id, node.id)) {
22579 // check to see if this is a text node child of the one we want
22580 var p = node.parentNode;
22583 if (this.isHandle(id, p.id)) {
22598 // shorter alias, save a few bytes
22599 Roo.dd.DDM = Roo.dd.DragDropMgr;
22600 Roo.dd.DDM._addListeners();
22604 * Ext JS Library 1.1.1
22605 * Copyright(c) 2006-2007, Ext JS, LLC.
22607 * Originally Released Under LGPL - original licence link has changed is not relivant.
22610 * <script type="text/javascript">
22615 * A DragDrop implementation where the linked element follows the
22616 * mouse cursor during a drag.
22617 * @extends Roo.dd.DragDrop
22619 * @param {String} id the id of the linked element
22620 * @param {String} sGroup the group of related DragDrop items
22621 * @param {object} config an object containing configurable attributes
22622 * Valid properties for DD:
22625 Roo.dd.DD = function(id, sGroup, config) {
22627 this.init(id, sGroup, config);
22631 Roo.extend(Roo.dd.DD, Roo.dd.DragDrop, {
22634 * When set to true, the utility automatically tries to scroll the browser
22635 * window wehn a drag and drop element is dragged near the viewport boundary.
22636 * Defaults to true.
22643 * Sets the pointer offset to the distance between the linked element's top
22644 * left corner and the location the element was clicked
22645 * @method autoOffset
22646 * @param {int} iPageX the X coordinate of the click
22647 * @param {int} iPageY the Y coordinate of the click
22649 autoOffset: function(iPageX, iPageY) {
22650 var x = iPageX - this.startPageX;
22651 var y = iPageY - this.startPageY;
22652 this.setDelta(x, y);
22656 * Sets the pointer offset. You can call this directly to force the
22657 * offset to be in a particular location (e.g., pass in 0,0 to set it
22658 * to the center of the object)
22660 * @param {int} iDeltaX the distance from the left
22661 * @param {int} iDeltaY the distance from the top
22663 setDelta: function(iDeltaX, iDeltaY) {
22664 this.deltaX = iDeltaX;
22665 this.deltaY = iDeltaY;
22669 * Sets the drag element to the location of the mousedown or click event,
22670 * maintaining the cursor location relative to the location on the element
22671 * that was clicked. Override this if you want to place the element in a
22672 * location other than where the cursor is.
22673 * @method setDragElPos
22674 * @param {int} iPageX the X coordinate of the mousedown or drag event
22675 * @param {int} iPageY the Y coordinate of the mousedown or drag event
22677 setDragElPos: function(iPageX, iPageY) {
22678 // the first time we do this, we are going to check to make sure
22679 // the element has css positioning
22681 var el = this.getDragEl();
22682 this.alignElWithMouse(el, iPageX, iPageY);
22686 * Sets the element to the location of the mousedown or click event,
22687 * maintaining the cursor location relative to the location on the element
22688 * that was clicked. Override this if you want to place the element in a
22689 * location other than where the cursor is.
22690 * @method alignElWithMouse
22691 * @param {HTMLElement} el the element to move
22692 * @param {int} iPageX the X coordinate of the mousedown or drag event
22693 * @param {int} iPageY the Y coordinate of the mousedown or drag event
22695 alignElWithMouse: function(el, iPageX, iPageY) {
22696 var oCoord = this.getTargetCoord(iPageX, iPageY);
22697 var fly = el.dom ? el : Roo.fly(el);
22698 if (!this.deltaSetXY) {
22699 var aCoord = [oCoord.x, oCoord.y];
22701 var newLeft = fly.getLeft(true);
22702 var newTop = fly.getTop(true);
22703 this.deltaSetXY = [ newLeft - oCoord.x, newTop - oCoord.y ];
22705 fly.setLeftTop(oCoord.x + this.deltaSetXY[0], oCoord.y + this.deltaSetXY[1]);
22708 this.cachePosition(oCoord.x, oCoord.y);
22709 this.autoScroll(oCoord.x, oCoord.y, el.offsetHeight, el.offsetWidth);
22714 * Saves the most recent position so that we can reset the constraints and
22715 * tick marks on-demand. We need to know this so that we can calculate the
22716 * number of pixels the element is offset from its original position.
22717 * @method cachePosition
22718 * @param iPageX the current x position (optional, this just makes it so we
22719 * don't have to look it up again)
22720 * @param iPageY the current y position (optional, this just makes it so we
22721 * don't have to look it up again)
22723 cachePosition: function(iPageX, iPageY) {
22725 this.lastPageX = iPageX;
22726 this.lastPageY = iPageY;
22728 var aCoord = Roo.lib.Dom.getXY(this.getEl());
22729 this.lastPageX = aCoord[0];
22730 this.lastPageY = aCoord[1];
22735 * Auto-scroll the window if the dragged object has been moved beyond the
22736 * visible window boundary.
22737 * @method autoScroll
22738 * @param {int} x the drag element's x position
22739 * @param {int} y the drag element's y position
22740 * @param {int} h the height of the drag element
22741 * @param {int} w the width of the drag element
22744 autoScroll: function(x, y, h, w) {
22747 // The client height
22748 var clientH = Roo.lib.Dom.getViewWidth();
22750 // The client width
22751 var clientW = Roo.lib.Dom.getViewHeight();
22753 // The amt scrolled down
22754 var st = this.DDM.getScrollTop();
22756 // The amt scrolled right
22757 var sl = this.DDM.getScrollLeft();
22759 // Location of the bottom of the element
22762 // Location of the right of the element
22765 // The distance from the cursor to the bottom of the visible area,
22766 // adjusted so that we don't scroll if the cursor is beyond the
22767 // element drag constraints
22768 var toBot = (clientH + st - y - this.deltaY);
22770 // The distance from the cursor to the right of the visible area
22771 var toRight = (clientW + sl - x - this.deltaX);
22774 // How close to the edge the cursor must be before we scroll
22775 // var thresh = (document.all) ? 100 : 40;
22778 // How many pixels to scroll per autoscroll op. This helps to reduce
22779 // clunky scrolling. IE is more sensitive about this ... it needs this
22780 // value to be higher.
22781 var scrAmt = (document.all) ? 80 : 30;
22783 // Scroll down if we are near the bottom of the visible page and the
22784 // obj extends below the crease
22785 if ( bot > clientH && toBot < thresh ) {
22786 window.scrollTo(sl, st + scrAmt);
22789 // Scroll up if the window is scrolled down and the top of the object
22790 // goes above the top border
22791 if ( y < st && st > 0 && y - st < thresh ) {
22792 window.scrollTo(sl, st - scrAmt);
22795 // Scroll right if the obj is beyond the right border and the cursor is
22796 // near the border.
22797 if ( right > clientW && toRight < thresh ) {
22798 window.scrollTo(sl + scrAmt, st);
22801 // Scroll left if the window has been scrolled to the right and the obj
22802 // extends past the left border
22803 if ( x < sl && sl > 0 && x - sl < thresh ) {
22804 window.scrollTo(sl - scrAmt, st);
22810 * Finds the location the element should be placed if we want to move
22811 * it to where the mouse location less the click offset would place us.
22812 * @method getTargetCoord
22813 * @param {int} iPageX the X coordinate of the click
22814 * @param {int} iPageY the Y coordinate of the click
22815 * @return an object that contains the coordinates (Object.x and Object.y)
22818 getTargetCoord: function(iPageX, iPageY) {
22821 var x = iPageX - this.deltaX;
22822 var y = iPageY - this.deltaY;
22824 if (this.constrainX) {
22825 if (x < this.minX) { x = this.minX; }
22826 if (x > this.maxX) { x = this.maxX; }
22829 if (this.constrainY) {
22830 if (y < this.minY) { y = this.minY; }
22831 if (y > this.maxY) { y = this.maxY; }
22834 x = this.getTick(x, this.xTicks);
22835 y = this.getTick(y, this.yTicks);
22842 * Sets up config options specific to this class. Overrides
22843 * Roo.dd.DragDrop, but all versions of this method through the
22844 * inheritance chain are called
22846 applyConfig: function() {
22847 Roo.dd.DD.superclass.applyConfig.call(this);
22848 this.scroll = (this.config.scroll !== false);
22852 * Event that fires prior to the onMouseDown event. Overrides
22855 b4MouseDown: function(e) {
22856 // this.resetConstraints();
22857 this.autoOffset(e.getPageX(),
22862 * Event that fires prior to the onDrag event. Overrides
22865 b4Drag: function(e) {
22866 this.setDragElPos(e.getPageX(),
22870 toString: function() {
22871 return ("DD " + this.id);
22874 //////////////////////////////////////////////////////////////////////////
22875 // Debugging ygDragDrop events that can be overridden
22876 //////////////////////////////////////////////////////////////////////////
22878 startDrag: function(x, y) {
22881 onDrag: function(e) {
22884 onDragEnter: function(e, id) {
22887 onDragOver: function(e, id) {
22890 onDragOut: function(e, id) {
22893 onDragDrop: function(e, id) {
22896 endDrag: function(e) {
22903 * Ext JS Library 1.1.1
22904 * Copyright(c) 2006-2007, Ext JS, LLC.
22906 * Originally Released Under LGPL - original licence link has changed is not relivant.
22909 * <script type="text/javascript">
22913 * @class Roo.dd.DDProxy
22914 * A DragDrop implementation that inserts an empty, bordered div into
22915 * the document that follows the cursor during drag operations. At the time of
22916 * the click, the frame div is resized to the dimensions of the linked html
22917 * element, and moved to the exact location of the linked element.
22919 * References to the "frame" element refer to the single proxy element that
22920 * was created to be dragged in place of all DDProxy elements on the
22923 * @extends Roo.dd.DD
22925 * @param {String} id the id of the linked html element
22926 * @param {String} sGroup the group of related DragDrop objects
22927 * @param {object} config an object containing configurable attributes
22928 * Valid properties for DDProxy in addition to those in DragDrop:
22929 * resizeFrame, centerFrame, dragElId
22931 Roo.dd.DDProxy = function(id, sGroup, config) {
22933 this.init(id, sGroup, config);
22939 * The default drag frame div id
22940 * @property Roo.dd.DDProxy.dragElId
22944 Roo.dd.DDProxy.dragElId = "ygddfdiv";
22946 Roo.extend(Roo.dd.DDProxy, Roo.dd.DD, {
22949 * By default we resize the drag frame to be the same size as the element
22950 * we want to drag (this is to get the frame effect). We can turn it off
22951 * if we want a different behavior.
22952 * @property resizeFrame
22958 * By default the frame is positioned exactly where the drag element is, so
22959 * we use the cursor offset provided by Roo.dd.DD. Another option that works only if
22960 * you do not have constraints on the obj is to have the drag frame centered
22961 * around the cursor. Set centerFrame to true for this effect.
22962 * @property centerFrame
22965 centerFrame: false,
22968 * Creates the proxy element if it does not yet exist
22969 * @method createFrame
22971 createFrame: function() {
22973 var body = document.body;
22975 if (!body || !body.firstChild) {
22976 setTimeout( function() { self.createFrame(); }, 50 );
22980 var div = this.getDragEl();
22983 div = document.createElement("div");
22984 div.id = this.dragElId;
22987 s.position = "absolute";
22988 s.visibility = "hidden";
22990 s.border = "2px solid #aaa";
22993 // appendChild can blow up IE if invoked prior to the window load event
22994 // while rendering a table. It is possible there are other scenarios
22995 // that would cause this to happen as well.
22996 body.insertBefore(div, body.firstChild);
23001 * Initialization for the drag frame element. Must be called in the
23002 * constructor of all subclasses
23003 * @method initFrame
23005 initFrame: function() {
23006 this.createFrame();
23009 applyConfig: function() {
23010 Roo.dd.DDProxy.superclass.applyConfig.call(this);
23012 this.resizeFrame = (this.config.resizeFrame !== false);
23013 this.centerFrame = (this.config.centerFrame);
23014 this.setDragElId(this.config.dragElId || Roo.dd.DDProxy.dragElId);
23018 * Resizes the drag frame to the dimensions of the clicked object, positions
23019 * it over the object, and finally displays it
23020 * @method showFrame
23021 * @param {int} iPageX X click position
23022 * @param {int} iPageY Y click position
23025 showFrame: function(iPageX, iPageY) {
23026 var el = this.getEl();
23027 var dragEl = this.getDragEl();
23028 var s = dragEl.style;
23030 this._resizeProxy();
23032 if (this.centerFrame) {
23033 this.setDelta( Math.round(parseInt(s.width, 10)/2),
23034 Math.round(parseInt(s.height, 10)/2) );
23037 this.setDragElPos(iPageX, iPageY);
23039 Roo.fly(dragEl).show();
23043 * The proxy is automatically resized to the dimensions of the linked
23044 * element when a drag is initiated, unless resizeFrame is set to false
23045 * @method _resizeProxy
23048 _resizeProxy: function() {
23049 if (this.resizeFrame) {
23050 var el = this.getEl();
23051 Roo.fly(this.getDragEl()).setSize(el.offsetWidth, el.offsetHeight);
23055 // overrides Roo.dd.DragDrop
23056 b4MouseDown: function(e) {
23057 var x = e.getPageX();
23058 var y = e.getPageY();
23059 this.autoOffset(x, y);
23060 this.setDragElPos(x, y);
23063 // overrides Roo.dd.DragDrop
23064 b4StartDrag: function(x, y) {
23065 // show the drag frame
23066 this.showFrame(x, y);
23069 // overrides Roo.dd.DragDrop
23070 b4EndDrag: function(e) {
23071 Roo.fly(this.getDragEl()).hide();
23074 // overrides Roo.dd.DragDrop
23075 // By default we try to move the element to the last location of the frame.
23076 // This is so that the default behavior mirrors that of Roo.dd.DD.
23077 endDrag: function(e) {
23079 var lel = this.getEl();
23080 var del = this.getDragEl();
23082 // Show the drag frame briefly so we can get its position
23083 del.style.visibility = "";
23086 // Hide the linked element before the move to get around a Safari
23088 lel.style.visibility = "hidden";
23089 Roo.dd.DDM.moveToEl(lel, del);
23090 del.style.visibility = "hidden";
23091 lel.style.visibility = "";
23096 beforeMove : function(){
23100 afterDrag : function(){
23104 toString: function() {
23105 return ("DDProxy " + this.id);
23111 * Ext JS Library 1.1.1
23112 * Copyright(c) 2006-2007, Ext JS, LLC.
23114 * Originally Released Under LGPL - original licence link has changed is not relivant.
23117 * <script type="text/javascript">
23121 * @class Roo.dd.DDTarget
23122 * A DragDrop implementation that does not move, but can be a drop
23123 * target. You would get the same result by simply omitting implementation
23124 * for the event callbacks, but this way we reduce the processing cost of the
23125 * event listener and the callbacks.
23126 * @extends Roo.dd.DragDrop
23128 * @param {String} id the id of the element that is a drop target
23129 * @param {String} sGroup the group of related DragDrop objects
23130 * @param {object} config an object containing configurable attributes
23131 * Valid properties for DDTarget in addition to those in
23135 Roo.dd.DDTarget = function(id, sGroup, config) {
23137 this.initTarget(id, sGroup, config);
23139 if (config && (config.listeners || config.events)) {
23140 Roo.dd.DragDrop.superclass.constructor.call(this, {
23141 listeners : config.listeners || {},
23142 events : config.events || {}
23147 // Roo.dd.DDTarget.prototype = new Roo.dd.DragDrop();
23148 Roo.extend(Roo.dd.DDTarget, Roo.dd.DragDrop, {
23149 toString: function() {
23150 return ("DDTarget " + this.id);
23155 * Ext JS Library 1.1.1
23156 * Copyright(c) 2006-2007, Ext JS, LLC.
23158 * Originally Released Under LGPL - original licence link has changed is not relivant.
23161 * <script type="text/javascript">
23166 * @class Roo.dd.ScrollManager
23167 * Provides automatic scrolling of overflow regions in the page during drag operations.<br><br>
23168 * <b>Note: This class uses "Point Mode" and is untested in "Intersect Mode".</b>
23171 Roo.dd.ScrollManager = function(){
23172 var ddm = Roo.dd.DragDropMgr;
23179 var onStop = function(e){
23184 var triggerRefresh = function(){
23185 if(ddm.dragCurrent){
23186 ddm.refreshCache(ddm.dragCurrent.groups);
23190 var doScroll = function(){
23191 if(ddm.dragCurrent){
23192 var dds = Roo.dd.ScrollManager;
23194 if(proc.el.scroll(proc.dir, dds.increment)){
23198 proc.el.scroll(proc.dir, dds.increment, true, dds.animDuration, triggerRefresh);
23203 var clearProc = function(){
23205 clearInterval(proc.id);
23212 var startProc = function(el, dir){
23213 Roo.log('scroll startproc');
23217 proc.id = setInterval(doScroll, Roo.dd.ScrollManager.frequency);
23220 var onFire = function(e, isDrop){
23222 if(isDrop || !ddm.dragCurrent){ return; }
23223 var dds = Roo.dd.ScrollManager;
23224 if(!dragEl || dragEl != ddm.dragCurrent){
23225 dragEl = ddm.dragCurrent;
23226 // refresh regions on drag start
23227 dds.refreshCache();
23230 var xy = Roo.lib.Event.getXY(e);
23231 var pt = new Roo.lib.Point(xy[0], xy[1]);
23232 for(var id in els){
23233 var el = els[id], r = el._region;
23234 if(r && r.contains(pt) && el.isScrollable()){
23235 if(r.bottom - pt.y <= dds.thresh){
23237 startProc(el, "down");
23240 }else if(r.right - pt.x <= dds.thresh){
23242 startProc(el, "left");
23245 }else if(pt.y - r.top <= dds.thresh){
23247 startProc(el, "up");
23250 }else if(pt.x - r.left <= dds.thresh){
23252 startProc(el, "right");
23261 ddm.fireEvents = ddm.fireEvents.createSequence(onFire, ddm);
23262 ddm.stopDrag = ddm.stopDrag.createSequence(onStop, ddm);
23266 * Registers new overflow element(s) to auto scroll
23267 * @param {String/HTMLElement/Element/Array} el The id of or the element to be scrolled or an array of either
23269 register : function(el){
23270 if(el instanceof Array){
23271 for(var i = 0, len = el.length; i < len; i++) {
23272 this.register(el[i]);
23278 Roo.dd.ScrollManager.els = els;
23282 * Unregisters overflow element(s) so they are no longer scrolled
23283 * @param {String/HTMLElement/Element/Array} el The id of or the element to be removed or an array of either
23285 unregister : function(el){
23286 if(el instanceof Array){
23287 for(var i = 0, len = el.length; i < len; i++) {
23288 this.unregister(el[i]);
23297 * The number of pixels from the edge of a container the pointer needs to be to
23298 * trigger scrolling (defaults to 25)
23304 * The number of pixels to scroll in each scroll increment (defaults to 50)
23310 * The frequency of scrolls in milliseconds (defaults to 500)
23316 * True to animate the scroll (defaults to true)
23322 * The animation duration in seconds -
23323 * MUST BE less than Roo.dd.ScrollManager.frequency! (defaults to .4)
23329 * Manually trigger a cache refresh.
23331 refreshCache : function(){
23332 for(var id in els){
23333 if(typeof els[id] == 'object'){ // for people extending the object prototype
23334 els[id]._region = els[id].getRegion();
23341 * Ext JS Library 1.1.1
23342 * Copyright(c) 2006-2007, Ext JS, LLC.
23344 * Originally Released Under LGPL - original licence link has changed is not relivant.
23347 * <script type="text/javascript">
23352 * @class Roo.dd.Registry
23353 * Provides easy access to all drag drop components that are registered on a page. Items can be retrieved either
23354 * directly by DOM node id, or by passing in the drag drop event that occurred and looking up the event target.
23357 Roo.dd.Registry = function(){
23360 var autoIdSeed = 0;
23362 var getId = function(el, autogen){
23363 if(typeof el == "string"){
23367 if(!id && autogen !== false){
23368 id = "roodd-" + (++autoIdSeed);
23376 * Register a drag drop element
23377 * @param {String|HTMLElement} element The id or DOM node to register
23378 * @param {Object} data (optional) A custom data object that will be passed between the elements that are involved
23379 * in drag drop operations. You can populate this object with any arbitrary properties that your own code
23380 * knows how to interpret, plus there are some specific properties known to the Registry that should be
23381 * populated in the data object (if applicable):
23383 Value Description<br />
23384 --------- ------------------------------------------<br />
23385 handles Array of DOM nodes that trigger dragging<br />
23386 for the element being registered<br />
23387 isHandle True if the element passed in triggers<br />
23388 dragging itself, else false
23391 register : function(el, data){
23393 if(typeof el == "string"){
23394 el = document.getElementById(el);
23397 elements[getId(el)] = data;
23398 if(data.isHandle !== false){
23399 handles[data.ddel.id] = data;
23402 var hs = data.handles;
23403 for(var i = 0, len = hs.length; i < len; i++){
23404 handles[getId(hs[i])] = data;
23410 * Unregister a drag drop element
23411 * @param {String|HTMLElement} element The id or DOM node to unregister
23413 unregister : function(el){
23414 var id = getId(el, false);
23415 var data = elements[id];
23417 delete elements[id];
23419 var hs = data.handles;
23420 for(var i = 0, len = hs.length; i < len; i++){
23421 delete handles[getId(hs[i], false)];
23428 * Returns the handle registered for a DOM Node by id
23429 * @param {String|HTMLElement} id The DOM node or id to look up
23430 * @return {Object} handle The custom handle data
23432 getHandle : function(id){
23433 if(typeof id != "string"){ // must be element?
23436 return handles[id];
23440 * Returns the handle that is registered for the DOM node that is the target of the event
23441 * @param {Event} e The event
23442 * @return {Object} handle The custom handle data
23444 getHandleFromEvent : function(e){
23445 var t = Roo.lib.Event.getTarget(e);
23446 return t ? handles[t.id] : null;
23450 * Returns a custom data object that is registered for a DOM node by id
23451 * @param {String|HTMLElement} id The DOM node or id to look up
23452 * @return {Object} data The custom data
23454 getTarget : function(id){
23455 if(typeof id != "string"){ // must be element?
23458 return elements[id];
23462 * Returns a custom data object that is registered for the DOM node that is the target of the event
23463 * @param {Event} e The event
23464 * @return {Object} data The custom data
23466 getTargetFromEvent : function(e){
23467 var t = Roo.lib.Event.getTarget(e);
23468 return t ? elements[t.id] || handles[t.id] : null;
23473 * Ext JS Library 1.1.1
23474 * Copyright(c) 2006-2007, Ext JS, LLC.
23476 * Originally Released Under LGPL - original licence link has changed is not relivant.
23479 * <script type="text/javascript">
23484 * @class Roo.dd.StatusProxy
23485 * A specialized drag proxy that supports a drop status icon, {@link Roo.Layer} styles and auto-repair. This is the
23486 * default drag proxy used by all Roo.dd components.
23488 * @param {Object} config
23490 Roo.dd.StatusProxy = function(config){
23491 Roo.apply(this, config);
23492 this.id = this.id || Roo.id();
23493 this.el = new Roo.Layer({
23495 id: this.id, tag: "div", cls: "x-dd-drag-proxy "+this.dropNotAllowed, children: [
23496 {tag: "div", cls: "x-dd-drop-icon"},
23497 {tag: "div", cls: "x-dd-drag-ghost"}
23500 shadow: !config || config.shadow !== false
23502 this.ghost = Roo.get(this.el.dom.childNodes[1]);
23503 this.dropStatus = this.dropNotAllowed;
23506 Roo.dd.StatusProxy.prototype = {
23508 * @cfg {String} dropAllowed
23509 * The CSS class to apply to the status element when drop is allowed (defaults to "x-dd-drop-ok").
23511 dropAllowed : "x-dd-drop-ok",
23513 * @cfg {String} dropNotAllowed
23514 * The CSS class to apply to the status element when drop is not allowed (defaults to "x-dd-drop-nodrop").
23516 dropNotAllowed : "x-dd-drop-nodrop",
23519 * Updates the proxy's visual element to indicate the status of whether or not drop is allowed
23520 * over the current target element.
23521 * @param {String} cssClass The css class for the new drop status indicator image
23523 setStatus : function(cssClass){
23524 cssClass = cssClass || this.dropNotAllowed;
23525 if(this.dropStatus != cssClass){
23526 this.el.replaceClass(this.dropStatus, cssClass);
23527 this.dropStatus = cssClass;
23532 * Resets the status indicator to the default dropNotAllowed value
23533 * @param {Boolean} clearGhost True to also remove all content from the ghost, false to preserve it
23535 reset : function(clearGhost){
23536 this.el.dom.className = "x-dd-drag-proxy " + this.dropNotAllowed;
23537 this.dropStatus = this.dropNotAllowed;
23539 this.ghost.update("");
23544 * Updates the contents of the ghost element
23545 * @param {String} html The html that will replace the current innerHTML of the ghost element
23547 update : function(html){
23548 if(typeof html == "string"){
23549 this.ghost.update(html);
23551 this.ghost.update("");
23552 html.style.margin = "0";
23553 this.ghost.dom.appendChild(html);
23555 // ensure float = none set?? cant remember why though.
23556 var el = this.ghost.dom.firstChild;
23558 Roo.fly(el).setStyle('float', 'none');
23563 * Returns the underlying proxy {@link Roo.Layer}
23564 * @return {Roo.Layer} el
23566 getEl : function(){
23571 * Returns the ghost element
23572 * @return {Roo.Element} el
23574 getGhost : function(){
23580 * @param {Boolean} clear True to reset the status and clear the ghost contents, false to preserve them
23582 hide : function(clear){
23590 * Stops the repair animation if it's currently running
23593 if(this.anim && this.anim.isAnimated && this.anim.isAnimated()){
23599 * Displays this proxy
23606 * Force the Layer to sync its shadow and shim positions to the element
23613 * Causes the proxy to return to its position of origin via an animation. Should be called after an
23614 * invalid drop operation by the item being dragged.
23615 * @param {Array} xy The XY position of the element ([x, y])
23616 * @param {Function} callback The function to call after the repair is complete
23617 * @param {Object} scope The scope in which to execute the callback
23619 repair : function(xy, callback, scope){
23620 this.callback = callback;
23621 this.scope = scope;
23622 if(xy && this.animRepair !== false){
23623 this.el.addClass("x-dd-drag-repair");
23624 this.el.hideUnders(true);
23625 this.anim = this.el.shift({
23626 duration: this.repairDuration || .5,
23630 callback: this.afterRepair,
23634 this.afterRepair();
23639 afterRepair : function(){
23641 if(typeof this.callback == "function"){
23642 this.callback.call(this.scope || this);
23644 this.callback = null;
23649 * Ext JS Library 1.1.1
23650 * Copyright(c) 2006-2007, Ext JS, LLC.
23652 * Originally Released Under LGPL - original licence link has changed is not relivant.
23655 * <script type="text/javascript">
23659 * @class Roo.dd.DragSource
23660 * @extends Roo.dd.DDProxy
23661 * A simple class that provides the basic implementation needed to make any element draggable.
23663 * @param {String/HTMLElement/Element} el The container element
23664 * @param {Object} config
23666 Roo.dd.DragSource = function(el, config){
23667 this.el = Roo.get(el);
23668 this.dragData = {};
23670 Roo.apply(this, config);
23673 this.proxy = new Roo.dd.StatusProxy();
23676 Roo.dd.DragSource.superclass.constructor.call(this, this.el.dom, this.ddGroup || this.group,
23677 {dragElId : this.proxy.id, resizeFrame: false, isTarget: false, scroll: this.scroll === true});
23679 this.dragging = false;
23682 Roo.extend(Roo.dd.DragSource, Roo.dd.DDProxy, {
23684 * @cfg {String} dropAllowed
23685 * The CSS class returned to the drag source when drop is allowed (defaults to "x-dd-drop-ok").
23687 dropAllowed : "x-dd-drop-ok",
23689 * @cfg {String} dropNotAllowed
23690 * The CSS class returned to the drag source when drop is not allowed (defaults to "x-dd-drop-nodrop").
23692 dropNotAllowed : "x-dd-drop-nodrop",
23695 * Returns the data object associated with this drag source
23696 * @return {Object} data An object containing arbitrary data
23698 getDragData : function(e){
23699 return this.dragData;
23703 onDragEnter : function(e, id){
23704 var target = Roo.dd.DragDropMgr.getDDById(id);
23705 this.cachedTarget = target;
23706 if(this.beforeDragEnter(target, e, id) !== false){
23707 if(target.isNotifyTarget){
23708 var status = target.notifyEnter(this, e, this.dragData);
23709 this.proxy.setStatus(status);
23711 this.proxy.setStatus(this.dropAllowed);
23714 if(this.afterDragEnter){
23716 * An empty function by default, but provided so that you can perform a custom action
23717 * when the dragged item enters the drop target by providing an implementation.
23718 * @param {Roo.dd.DragDrop} target The drop target
23719 * @param {Event} e The event object
23720 * @param {String} id The id of the dragged element
23721 * @method afterDragEnter
23723 this.afterDragEnter(target, e, id);
23729 * An empty function by default, but provided so that you can perform a custom action
23730 * before the dragged item enters the drop target and optionally cancel the onDragEnter.
23731 * @param {Roo.dd.DragDrop} target The drop target
23732 * @param {Event} e The event object
23733 * @param {String} id The id of the dragged element
23734 * @return {Boolean} isValid True if the drag event is valid, else false to cancel
23736 beforeDragEnter : function(target, e, id){
23741 alignElWithMouse: function() {
23742 Roo.dd.DragSource.superclass.alignElWithMouse.apply(this, arguments);
23747 onDragOver : function(e, id){
23748 var target = this.cachedTarget || Roo.dd.DragDropMgr.getDDById(id);
23749 if(this.beforeDragOver(target, e, id) !== false){
23750 if(target.isNotifyTarget){
23751 var status = target.notifyOver(this, e, this.dragData);
23752 this.proxy.setStatus(status);
23755 if(this.afterDragOver){
23757 * An empty function by default, but provided so that you can perform a custom action
23758 * while the dragged item is over the drop target by providing an implementation.
23759 * @param {Roo.dd.DragDrop} target The drop target
23760 * @param {Event} e The event object
23761 * @param {String} id The id of the dragged element
23762 * @method afterDragOver
23764 this.afterDragOver(target, e, id);
23770 * An empty function by default, but provided so that you can perform a custom action
23771 * while the dragged item is over the drop target and optionally cancel the onDragOver.
23772 * @param {Roo.dd.DragDrop} target The drop target
23773 * @param {Event} e The event object
23774 * @param {String} id The id of the dragged element
23775 * @return {Boolean} isValid True if the drag event is valid, else false to cancel
23777 beforeDragOver : function(target, e, id){
23782 onDragOut : function(e, id){
23783 var target = this.cachedTarget || Roo.dd.DragDropMgr.getDDById(id);
23784 if(this.beforeDragOut(target, e, id) !== false){
23785 if(target.isNotifyTarget){
23786 target.notifyOut(this, e, this.dragData);
23788 this.proxy.reset();
23789 if(this.afterDragOut){
23791 * An empty function by default, but provided so that you can perform a custom action
23792 * after the dragged item is dragged out of the target without dropping.
23793 * @param {Roo.dd.DragDrop} target The drop target
23794 * @param {Event} e The event object
23795 * @param {String} id The id of the dragged element
23796 * @method afterDragOut
23798 this.afterDragOut(target, e, id);
23801 this.cachedTarget = null;
23805 * An empty function by default, but provided so that you can perform a custom action before the dragged
23806 * item is dragged out of the target without dropping, and optionally cancel the onDragOut.
23807 * @param {Roo.dd.DragDrop} target The drop target
23808 * @param {Event} e The event object
23809 * @param {String} id The id of the dragged element
23810 * @return {Boolean} isValid True if the drag event is valid, else false to cancel
23812 beforeDragOut : function(target, e, id){
23817 onDragDrop : function(e, id){
23818 var target = this.cachedTarget || Roo.dd.DragDropMgr.getDDById(id);
23819 if(this.beforeDragDrop(target, e, id) !== false){
23820 if(target.isNotifyTarget){
23821 if(target.notifyDrop(this, e, this.dragData)){ // valid drop?
23822 this.onValidDrop(target, e, id);
23824 this.onInvalidDrop(target, e, id);
23827 this.onValidDrop(target, e, id);
23830 if(this.afterDragDrop){
23832 * An empty function by default, but provided so that you can perform a custom action
23833 * after a valid drag drop has occurred by providing an implementation.
23834 * @param {Roo.dd.DragDrop} target The drop target
23835 * @param {Event} e The event object
23836 * @param {String} id The id of the dropped element
23837 * @method afterDragDrop
23839 this.afterDragDrop(target, e, id);
23842 delete this.cachedTarget;
23846 * An empty function by default, but provided so that you can perform a custom action before the dragged
23847 * item is dropped onto the target and optionally cancel the onDragDrop.
23848 * @param {Roo.dd.DragDrop} target The drop target
23849 * @param {Event} e The event object
23850 * @param {String} id The id of the dragged element
23851 * @return {Boolean} isValid True if the drag drop event is valid, else false to cancel
23853 beforeDragDrop : function(target, e, id){
23858 onValidDrop : function(target, e, id){
23860 if(this.afterValidDrop){
23862 * An empty function by default, but provided so that you can perform a custom action
23863 * after a valid drop has occurred by providing an implementation.
23864 * @param {Object} target The target DD
23865 * @param {Event} e The event object
23866 * @param {String} id The id of the dropped element
23867 * @method afterInvalidDrop
23869 this.afterValidDrop(target, e, id);
23874 getRepairXY : function(e, data){
23875 return this.el.getXY();
23879 onInvalidDrop : function(target, e, id){
23880 this.beforeInvalidDrop(target, e, id);
23881 if(this.cachedTarget){
23882 if(this.cachedTarget.isNotifyTarget){
23883 this.cachedTarget.notifyOut(this, e, this.dragData);
23885 this.cacheTarget = null;
23887 this.proxy.repair(this.getRepairXY(e, this.dragData), this.afterRepair, this);
23889 if(this.afterInvalidDrop){
23891 * An empty function by default, but provided so that you can perform a custom action
23892 * after an invalid drop has occurred by providing an implementation.
23893 * @param {Event} e The event object
23894 * @param {String} id The id of the dropped element
23895 * @method afterInvalidDrop
23897 this.afterInvalidDrop(e, id);
23902 afterRepair : function(){
23904 this.el.highlight(this.hlColor || "c3daf9");
23906 this.dragging = false;
23910 * An empty function by default, but provided so that you can perform a custom action after an invalid
23911 * drop has occurred.
23912 * @param {Roo.dd.DragDrop} target The drop target
23913 * @param {Event} e The event object
23914 * @param {String} id The id of the dragged element
23915 * @return {Boolean} isValid True if the invalid drop should proceed, else false to cancel
23917 beforeInvalidDrop : function(target, e, id){
23922 handleMouseDown : function(e){
23923 if(this.dragging) {
23926 var data = this.getDragData(e);
23927 if(data && this.onBeforeDrag(data, e) !== false){
23928 this.dragData = data;
23930 Roo.dd.DragSource.superclass.handleMouseDown.apply(this, arguments);
23935 * An empty function by default, but provided so that you can perform a custom action before the initial
23936 * drag event begins and optionally cancel it.
23937 * @param {Object} data An object containing arbitrary data to be shared with drop targets
23938 * @param {Event} e The event object
23939 * @return {Boolean} isValid True if the drag event is valid, else false to cancel
23941 onBeforeDrag : function(data, e){
23946 * An empty function by default, but provided so that you can perform a custom action once the initial
23947 * drag event has begun. The drag cannot be canceled from this function.
23948 * @param {Number} x The x position of the click on the dragged object
23949 * @param {Number} y The y position of the click on the dragged object
23951 onStartDrag : Roo.emptyFn,
23953 // private - YUI override
23954 startDrag : function(x, y){
23955 this.proxy.reset();
23956 this.dragging = true;
23957 this.proxy.update("");
23958 this.onInitDrag(x, y);
23963 onInitDrag : function(x, y){
23964 var clone = this.el.dom.cloneNode(true);
23965 clone.id = Roo.id(); // prevent duplicate ids
23966 this.proxy.update(clone);
23967 this.onStartDrag(x, y);
23972 * Returns the drag source's underlying {@link Roo.dd.StatusProxy}
23973 * @return {Roo.dd.StatusProxy} proxy The StatusProxy
23975 getProxy : function(){
23980 * Hides the drag source's {@link Roo.dd.StatusProxy}
23982 hideProxy : function(){
23984 this.proxy.reset(true);
23985 this.dragging = false;
23989 triggerCacheRefresh : function(){
23990 Roo.dd.DDM.refreshCache(this.groups);
23993 // private - override to prevent hiding
23994 b4EndDrag: function(e) {
23997 // private - override to prevent moving
23998 endDrag : function(e){
23999 this.onEndDrag(this.dragData, e);
24003 onEndDrag : function(data, e){
24006 // private - pin to cursor
24007 autoOffset : function(x, y) {
24008 this.setDelta(-12, -20);
24012 * Ext JS Library 1.1.1
24013 * Copyright(c) 2006-2007, Ext JS, LLC.
24015 * Originally Released Under LGPL - original licence link has changed is not relivant.
24018 * <script type="text/javascript">
24023 * @class Roo.dd.DropTarget
24024 * @extends Roo.dd.DDTarget
24025 * A simple class that provides the basic implementation needed to make any element a drop target that can have
24026 * draggable items dropped onto it. The drop has no effect until an implementation of notifyDrop is provided.
24028 * @param {String/HTMLElement/Element} el The container element
24029 * @param {Object} config
24031 Roo.dd.DropTarget = function(el, config){
24032 this.el = Roo.get(el);
24034 var listeners = false; ;
24035 if (config && config.listeners) {
24036 listeners= config.listeners;
24037 delete config.listeners;
24039 Roo.apply(this, config);
24041 if(this.containerScroll){
24042 Roo.dd.ScrollManager.register(this.el);
24046 * @scope Roo.dd.DropTarget
24051 * The function a {@link Roo.dd.DragSource} calls once to notify this drop target that the source is now over the
24052 * target. This default implementation adds the CSS class specified by overClass (if any) to the drop element
24053 * and returns the dropAllowed config value. This method should be overridden if drop validation is required.
24055 * IMPORTANT : it should set this.valid to true|false
24057 * @param {Roo.dd.DragSource} source The drag source that was dragged over this drop target
24058 * @param {Event} e The event
24059 * @param {Object} data An object containing arbitrary data supplied by the drag source
24065 * The function a {@link Roo.dd.DragSource} calls continuously while it is being dragged over the target.
24066 * This method will be called on every mouse movement while the drag source is over the drop target.
24067 * This default implementation simply returns the dropAllowed config value.
24069 * IMPORTANT : it should set this.valid to true|false
24071 * @param {Roo.dd.DragSource} source The drag source that was dragged over this drop target
24072 * @param {Event} e The event
24073 * @param {Object} data An object containing arbitrary data supplied by the drag source
24079 * The function a {@link Roo.dd.DragSource} calls once to notify this drop target that the source has been dragged
24080 * out of the target without dropping. This default implementation simply removes the CSS class specified by
24081 * overClass (if any) from the drop element.
24084 * @param {Roo.dd.DragSource} source The drag source that was dragged over this drop target
24085 * @param {Event} e The event
24086 * @param {Object} data An object containing arbitrary data supplied by the drag source
24092 * The function a {@link Roo.dd.DragSource} calls once to notify this drop target that the dragged item has
24093 * been dropped on it. This method has no default implementation and returns false, so you must provide an
24094 * implementation that does something to process the drop event and returns true so that the drag source's
24095 * repair action does not run.
24097 * IMPORTANT : it should set this.success
24099 * @param {Roo.dd.DragSource} source The drag source that was dragged over this drop target
24100 * @param {Event} e The event
24101 * @param {Object} data An object containing arbitrary data supplied by the drag source
24107 Roo.dd.DropTarget.superclass.constructor.call( this,
24109 this.ddGroup || this.group,
24112 listeners : listeners || {}
24120 Roo.extend(Roo.dd.DropTarget, Roo.dd.DDTarget, {
24122 * @cfg {String} overClass
24123 * The CSS class applied to the drop target element while the drag source is over it (defaults to "").
24126 * @cfg {String} ddGroup
24127 * The drag drop group to handle drop events for
24131 * @cfg {String} dropAllowed
24132 * The CSS class returned to the drag source when drop is allowed (defaults to "x-dd-drop-ok").
24134 dropAllowed : "x-dd-drop-ok",
24136 * @cfg {String} dropNotAllowed
24137 * The CSS class returned to the drag source when drop is not allowed (defaults to "x-dd-drop-nodrop").
24139 dropNotAllowed : "x-dd-drop-nodrop",
24141 * @cfg {boolean} success
24142 * set this after drop listener..
24146 * @cfg {boolean|String} valid true/false or string (ok-add/ok-sub/ok/nodrop)
24147 * if the drop point is valid for over/enter..
24154 isNotifyTarget : true,
24159 notifyEnter : function(dd, e, data)
24162 this.fireEvent('enter', dd, e, data);
24163 if(this.overClass){
24164 this.el.addClass(this.overClass);
24166 return typeof(this.valid) == 'string' ? 'x-dd-drop-' + this.valid : (
24167 this.valid ? this.dropAllowed : this.dropNotAllowed
24174 notifyOver : function(dd, e, data)
24177 this.fireEvent('over', dd, e, data);
24178 return typeof(this.valid) == 'string' ? 'x-dd-drop-' + this.valid : (
24179 this.valid ? this.dropAllowed : this.dropNotAllowed
24186 notifyOut : function(dd, e, data)
24188 this.fireEvent('out', dd, e, data);
24189 if(this.overClass){
24190 this.el.removeClass(this.overClass);
24197 notifyDrop : function(dd, e, data)
24199 this.success = false;
24200 this.fireEvent('drop', dd, e, data);
24201 return this.success;
24205 * Ext JS Library 1.1.1
24206 * Copyright(c) 2006-2007, Ext JS, LLC.
24208 * Originally Released Under LGPL - original licence link has changed is not relivant.
24211 * <script type="text/javascript">
24216 * @class Roo.dd.DragZone
24217 * @extends Roo.dd.DragSource
24218 * This class provides a container DD instance that proxies for multiple child node sources.<br />
24219 * By default, this class requires that draggable child nodes are registered with {@link Roo.dd.Registry}.
24221 * @param {String/HTMLElement/Element} el The container element
24222 * @param {Object} config
24224 Roo.dd.DragZone = function(el, config){
24225 Roo.dd.DragZone.superclass.constructor.call(this, el, config);
24226 if(this.containerScroll){
24227 Roo.dd.ScrollManager.register(this.el);
24231 Roo.extend(Roo.dd.DragZone, Roo.dd.DragSource, {
24233 * @cfg {Boolean} containerScroll True to register this container with the Scrollmanager
24234 * for auto scrolling during drag operations.
24237 * @cfg {String} hlColor The color to use when visually highlighting the drag source in the afterRepair
24238 * method after a failed drop (defaults to "c3daf9" - light blue)
24242 * Called when a mousedown occurs in this container. Looks in {@link Roo.dd.Registry}
24243 * for a valid target to drag based on the mouse down. Override this method
24244 * to provide your own lookup logic (e.g. finding a child by class name). Make sure your returned
24245 * object has a "ddel" attribute (with an HTML Element) for other functions to work.
24246 * @param {EventObject} e The mouse down event
24247 * @return {Object} The dragData
24249 getDragData : function(e){
24250 return Roo.dd.Registry.getHandleFromEvent(e);
24254 * Called once drag threshold has been reached to initialize the proxy element. By default, it clones the
24255 * this.dragData.ddel
24256 * @param {Number} x The x position of the click on the dragged object
24257 * @param {Number} y The y position of the click on the dragged object
24258 * @return {Boolean} true to continue the drag, false to cancel
24260 onInitDrag : function(x, y){
24261 this.proxy.update(this.dragData.ddel.cloneNode(true));
24262 this.onStartDrag(x, y);
24267 * Called after a repair of an invalid drop. By default, highlights this.dragData.ddel
24269 afterRepair : function(){
24271 Roo.Element.fly(this.dragData.ddel).highlight(this.hlColor || "c3daf9");
24273 this.dragging = false;
24277 * Called before a repair of an invalid drop to get the XY to animate to. By default returns
24278 * the XY of this.dragData.ddel
24279 * @param {EventObject} e The mouse up event
24280 * @return {Array} The xy location (e.g. [100, 200])
24282 getRepairXY : function(e){
24283 return Roo.Element.fly(this.dragData.ddel).getXY();
24287 * Ext JS Library 1.1.1
24288 * Copyright(c) 2006-2007, Ext JS, LLC.
24290 * Originally Released Under LGPL - original licence link has changed is not relivant.
24293 * <script type="text/javascript">
24296 * @class Roo.dd.DropZone
24297 * @extends Roo.dd.DropTarget
24298 * This class provides a container DD instance that proxies for multiple child node targets.<br />
24299 * By default, this class requires that child nodes accepting drop are registered with {@link Roo.dd.Registry}.
24301 * @param {String/HTMLElement/Element} el The container element
24302 * @param {Object} config
24304 Roo.dd.DropZone = function(el, config){
24305 Roo.dd.DropZone.superclass.constructor.call(this, el, config);
24308 Roo.extend(Roo.dd.DropZone, Roo.dd.DropTarget, {
24310 * Returns a custom data object associated with the DOM node that is the target of the event. By default
24311 * this looks up the event target in the {@link Roo.dd.Registry}, although you can override this method to
24312 * provide your own custom lookup.
24313 * @param {Event} e The event
24314 * @return {Object} data The custom data
24316 getTargetFromEvent : function(e){
24317 return Roo.dd.Registry.getTargetFromEvent(e);
24321 * Called internally when the DropZone determines that a {@link Roo.dd.DragSource} has entered a drop node
24322 * that it has registered. This method has no default implementation and should be overridden to provide
24323 * node-specific processing if necessary.
24324 * @param {Object} nodeData The custom data associated with the drop node (this is the same value returned from
24325 * {@link #getTargetFromEvent} for this node)
24326 * @param {Roo.dd.DragSource} source The drag source that was dragged over this drop zone
24327 * @param {Event} e The event
24328 * @param {Object} data An object containing arbitrary data supplied by the drag source
24330 onNodeEnter : function(n, dd, e, data){
24335 * Called internally while the DropZone determines that a {@link Roo.dd.DragSource} is over a drop node
24336 * that it has registered. The default implementation returns this.dropNotAllowed, so it should be
24337 * overridden to provide the proper feedback.
24338 * @param {Object} nodeData The custom data associated with the drop node (this is the same value returned from
24339 * {@link #getTargetFromEvent} for this node)
24340 * @param {Roo.dd.DragSource} source The drag source that was dragged over this drop zone
24341 * @param {Event} e The event
24342 * @param {Object} data An object containing arbitrary data supplied by the drag source
24343 * @return {String} status The CSS class that communicates the drop status back to the source so that the
24344 * underlying {@link Roo.dd.StatusProxy} can be updated
24346 onNodeOver : function(n, dd, e, data){
24347 return this.dropAllowed;
24351 * Called internally when the DropZone determines that a {@link Roo.dd.DragSource} has been dragged out of
24352 * the drop node without dropping. This method has no default implementation and should be overridden to provide
24353 * node-specific processing if necessary.
24354 * @param {Object} nodeData The custom data associated with the drop node (this is the same value returned from
24355 * {@link #getTargetFromEvent} for this node)
24356 * @param {Roo.dd.DragSource} source The drag source that was dragged over this drop zone
24357 * @param {Event} e The event
24358 * @param {Object} data An object containing arbitrary data supplied by the drag source
24360 onNodeOut : function(n, dd, e, data){
24365 * Called internally when the DropZone determines that a {@link Roo.dd.DragSource} has been dropped onto
24366 * the drop node. The default implementation returns false, so it should be overridden to provide the
24367 * appropriate processing of the drop event and return true so that the drag source's repair action does not run.
24368 * @param {Object} nodeData The custom data associated with the drop node (this is the same value returned from
24369 * {@link #getTargetFromEvent} for this node)
24370 * @param {Roo.dd.DragSource} source The drag source that was dragged over this drop zone
24371 * @param {Event} e The event
24372 * @param {Object} data An object containing arbitrary data supplied by the drag source
24373 * @return {Boolean} True if the drop was valid, else false
24375 onNodeDrop : function(n, dd, e, data){
24380 * Called internally while the DropZone determines that a {@link Roo.dd.DragSource} is being dragged over it,
24381 * but not over any of its registered drop nodes. The default implementation returns this.dropNotAllowed, so
24382 * it should be overridden to provide the proper feedback if necessary.
24383 * @param {Roo.dd.DragSource} source The drag source that was dragged over this drop zone
24384 * @param {Event} e The event
24385 * @param {Object} data An object containing arbitrary data supplied by the drag source
24386 * @return {String} status The CSS class that communicates the drop status back to the source so that the
24387 * underlying {@link Roo.dd.StatusProxy} can be updated
24389 onContainerOver : function(dd, e, data){
24390 return this.dropNotAllowed;
24394 * Called internally when the DropZone determines that a {@link Roo.dd.DragSource} has been dropped on it,
24395 * but not on any of its registered drop nodes. The default implementation returns false, so it should be
24396 * overridden to provide the appropriate processing of the drop event if you need the drop zone itself to
24397 * be able to accept drops. It should return true when valid so that the drag source's repair action does not run.
24398 * @param {Roo.dd.DragSource} source The drag source that was dragged over this drop zone
24399 * @param {Event} e The event
24400 * @param {Object} data An object containing arbitrary data supplied by the drag source
24401 * @return {Boolean} True if the drop was valid, else false
24403 onContainerDrop : function(dd, e, data){
24408 * The function a {@link Roo.dd.DragSource} calls once to notify this drop zone that the source is now over
24409 * the zone. The default implementation returns this.dropNotAllowed and expects that only registered drop
24410 * nodes can process drag drop operations, so if you need the drop zone itself to be able to process drops
24411 * you should override this method and provide a custom implementation.
24412 * @param {Roo.dd.DragSource} source The drag source that was dragged over this drop zone
24413 * @param {Event} e The event
24414 * @param {Object} data An object containing arbitrary data supplied by the drag source
24415 * @return {String} status The CSS class that communicates the drop status back to the source so that the
24416 * underlying {@link Roo.dd.StatusProxy} can be updated
24418 notifyEnter : function(dd, e, data){
24419 return this.dropNotAllowed;
24423 * The function a {@link Roo.dd.DragSource} calls continuously while it is being dragged over the drop zone.
24424 * This method will be called on every mouse movement while the drag source is over the drop zone.
24425 * It will call {@link #onNodeOver} while the drag source is over a registered node, and will also automatically
24426 * delegate to the appropriate node-specific methods as necessary when the drag source enters and exits
24427 * registered nodes ({@link #onNodeEnter}, {@link #onNodeOut}). If the drag source is not currently over a
24428 * registered node, it will call {@link #onContainerOver}.
24429 * @param {Roo.dd.DragSource} source The drag source that was dragged over this drop zone
24430 * @param {Event} e The event
24431 * @param {Object} data An object containing arbitrary data supplied by the drag source
24432 * @return {String} status The CSS class that communicates the drop status back to the source so that the
24433 * underlying {@link Roo.dd.StatusProxy} can be updated
24435 notifyOver : function(dd, e, data){
24436 var n = this.getTargetFromEvent(e);
24437 if(!n){ // not over valid drop target
24438 if(this.lastOverNode){
24439 this.onNodeOut(this.lastOverNode, dd, e, data);
24440 this.lastOverNode = null;
24442 return this.onContainerOver(dd, e, data);
24444 if(this.lastOverNode != n){
24445 if(this.lastOverNode){
24446 this.onNodeOut(this.lastOverNode, dd, e, data);
24448 this.onNodeEnter(n, dd, e, data);
24449 this.lastOverNode = n;
24451 return this.onNodeOver(n, dd, e, data);
24455 * The function a {@link Roo.dd.DragSource} calls once to notify this drop zone that the source has been dragged
24456 * out of the zone without dropping. If the drag source is currently over a registered node, the notification
24457 * will be delegated to {@link #onNodeOut} for node-specific handling, otherwise it will be ignored.
24458 * @param {Roo.dd.DragSource} source The drag source that was dragged over this drop target
24459 * @param {Event} e The event
24460 * @param {Object} data An object containing arbitrary data supplied by the drag zone
24462 notifyOut : function(dd, e, data){
24463 if(this.lastOverNode){
24464 this.onNodeOut(this.lastOverNode, dd, e, data);
24465 this.lastOverNode = null;
24470 * The function a {@link Roo.dd.DragSource} calls once to notify this drop zone that the dragged item has
24471 * been dropped on it. The drag zone will look up the target node based on the event passed in, and if there
24472 * is a node registered for that event, it will delegate to {@link #onNodeDrop} for node-specific handling,
24473 * otherwise it will call {@link #onContainerDrop}.
24474 * @param {Roo.dd.DragSource} source The drag source that was dragged over this drop zone
24475 * @param {Event} e The event
24476 * @param {Object} data An object containing arbitrary data supplied by the drag source
24477 * @return {Boolean} True if the drop was valid, else false
24479 notifyDrop : function(dd, e, data){
24480 if(this.lastOverNode){
24481 this.onNodeOut(this.lastOverNode, dd, e, data);
24482 this.lastOverNode = null;
24484 var n = this.getTargetFromEvent(e);
24486 this.onNodeDrop(n, dd, e, data) :
24487 this.onContainerDrop(dd, e, data);
24491 triggerCacheRefresh : function(){
24492 Roo.dd.DDM.refreshCache(this.groups);