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 {String} interval (optional) Default Date.MILLI, A valid date interval enum value (eg. Date.DAY)
1209 @return {Number} The diff in milliseconds or units of interval
1210 @member Date getElapsed
1212 Date.prototype.getElapsed = function(date, interval)
1214 date = date || new Date();
1215 var ret = Math.abs(date.getTime()-this.getTime());
1219 return Math.floor(ret / (1000));
1221 return Math.floor(ret / (1000*60));
1223 return Math.floor(ret / (1000*60*60));
1225 return Math.floor(ret / (1000*60*60*24));
1226 case Date.MONTH: // this does not give exact number...??
1227 return ((date.format("Y") - this.format("Y")) * 12) + (date.format("m") - this.format("m"));
1228 case Date.YEAR: // this does not give exact number...??
1229 return (date.format("Y") - this.format("Y"));
1237 // was in date file..
1241 Date.parseFunctions = {count:0};
1243 Date.parseRegexes = [];
1245 Date.formatFunctions = {count:0};
1248 Date.prototype.dateFormat = function(format) {
1249 if (Date.formatFunctions[format] == null) {
1250 Date.createNewFormat(format);
1252 var func = Date.formatFunctions[format];
1253 return this[func]();
1258 * Formats a date given the supplied format string
1259 * @param {String} format The format string
1260 * @return {String} The formatted date
1263 Date.prototype.format = Date.prototype.dateFormat;
1266 Date.createNewFormat = function(format) {
1267 var funcName = "format" + Date.formatFunctions.count++;
1268 Date.formatFunctions[format] = funcName;
1269 var code = "Date.prototype." + funcName + " = function(){return ";
1270 var special = false;
1272 for (var i = 0; i < format.length; ++i) {
1273 ch = format.charAt(i);
1274 if (!special && ch == "\\") {
1279 code += "'" + String.escape(ch) + "' + ";
1282 code += Date.getFormatCode(ch);
1285 /** eval:var:zzzzzzzzzzzzz */
1286 eval(code.substring(0, code.length - 3) + ";}");
1290 Date.getFormatCode = function(character) {
1291 switch (character) {
1293 return "String.leftPad(this.getDate(), 2, '0') + ";
1295 return "Date.dayNames[this.getDay()].substring(0, 3) + ";
1297 return "this.getDate() + ";
1299 return "Date.dayNames[this.getDay()] + ";
1301 return "this.getSuffix() + ";
1303 return "this.getDay() + ";
1305 return "this.getDayOfYear() + ";
1307 return "this.getWeekOfYear() + ";
1309 return "Date.monthNames[this.getMonth()] + ";
1311 return "String.leftPad(this.getMonth() + 1, 2, '0') + ";
1313 return "Date.monthNames[this.getMonth()].substring(0, 3) + ";
1315 return "(this.getMonth() + 1) + ";
1317 return "this.getDaysInMonth() + ";
1319 return "(this.isLeapYear() ? 1 : 0) + ";
1321 return "this.getFullYear() + ";
1323 return "('' + this.getFullYear()).substring(2, 4) + ";
1325 return "(this.getHours() < 12 ? 'am' : 'pm') + ";
1327 return "(this.getHours() < 12 ? 'AM' : 'PM') + ";
1329 return "((this.getHours() % 12) ? this.getHours() % 12 : 12) + ";
1331 return "this.getHours() + ";
1333 return "String.leftPad((this.getHours() % 12) ? this.getHours() % 12 : 12, 2, '0') + ";
1335 return "String.leftPad(this.getHours(), 2, '0') + ";
1337 return "String.leftPad(this.getMinutes(), 2, '0') + ";
1339 return "String.leftPad(this.getSeconds(), 2, '0') + ";
1341 return "this.getGMTOffset() + ";
1343 return "this.getGMTColonOffset() + ";
1345 return "this.getTimezone() + ";
1347 return "(this.getTimezoneOffset() * -60) + ";
1349 return "'" + String.escape(character) + "' + ";
1354 * Parses the passed string using the specified format. Note that this function expects dates in normal calendar
1355 * format, meaning that months are 1-based (1 = January) and not zero-based like in JavaScript dates. Any part of
1356 * the date format that is not specified will default to the current date value for that part. Time parts can also
1357 * be specified, but default to 0. Keep in mind that the input date string must precisely match the specified format
1358 * string or the parse operation will fail.
1361 //dt = Fri May 25 2007 (current date)
1362 var dt = new Date();
1364 //dt = Thu May 25 2006 (today's month/day in 2006)
1365 dt = Date.parseDate("2006", "Y");
1367 //dt = Sun Jan 15 2006 (all date parts specified)
1368 dt = Date.parseDate("2006-1-15", "Y-m-d");
1370 //dt = Sun Jan 15 2006 15:20:01 GMT-0600 (CST)
1371 dt = Date.parseDate("2006-1-15 3:20:01 PM", "Y-m-d h:i:s A" );
1373 * @param {String} input The unparsed date as a string
1374 * @param {String} format The format the date is in
1375 * @return {Date} The parsed date
1378 Date.parseDate = function(input, format) {
1379 if (Date.parseFunctions[format] == null) {
1380 Date.createParser(format);
1382 var func = Date.parseFunctions[format];
1383 return Date[func](input);
1389 Date.createParser = function(format) {
1390 var funcName = "parse" + Date.parseFunctions.count++;
1391 var regexNum = Date.parseRegexes.length;
1392 var currentGroup = 1;
1393 Date.parseFunctions[format] = funcName;
1395 var code = "Date." + funcName + " = function(input){\n"
1396 + "var y = -1, m = -1, d = -1, h = -1, i = -1, s = -1, o, z, v;\n"
1397 + "var d = new Date();\n"
1398 + "y = d.getFullYear();\n"
1399 + "m = d.getMonth();\n"
1400 + "d = d.getDate();\n"
1401 + "if (typeof(input) !== 'string') { input = input.toString(); }\n"
1402 + "var results = input.match(Date.parseRegexes[" + regexNum + "]);\n"
1403 + "if (results && results.length > 0) {";
1406 var special = false;
1408 for (var i = 0; i < format.length; ++i) {
1409 ch = format.charAt(i);
1410 if (!special && ch == "\\") {
1415 regex += String.escape(ch);
1418 var obj = Date.formatCodeToRegex(ch, currentGroup);
1419 currentGroup += obj.g;
1421 if (obj.g && obj.c) {
1427 code += "if (y >= 0 && m >= 0 && d > 0 && h >= 0 && i >= 0 && s >= 0)\n"
1428 + "{v = new Date(y, m, d, h, i, s); v.setFullYear(y);}\n"
1429 + "else if (y >= 0 && m >= 0 && d > 0 && h >= 0 && i >= 0)\n"
1430 + "{v = new Date(y, m, d, h, i); v.setFullYear(y);}\n"
1431 + "else if (y >= 0 && m >= 0 && d > 0 && h >= 0)\n"
1432 + "{v = new Date(y, m, d, h); v.setFullYear(y);}\n"
1433 + "else if (y >= 0 && m >= 0 && d > 0)\n"
1434 + "{v = new Date(y, m, d); v.setFullYear(y);}\n"
1435 + "else if (y >= 0 && m >= 0)\n"
1436 + "{v = new Date(y, m); v.setFullYear(y);}\n"
1437 + "else if (y >= 0)\n"
1438 + "{v = new Date(y); v.setFullYear(y);}\n"
1439 + "}return (v && (z || o))?\n" // favour UTC offset over GMT offset
1440 + " ((z)? v.add(Date.SECOND, (v.getTimezoneOffset() * 60) + (z*1)) :\n" // reset to UTC, then add offset
1441 + " v.add(Date.HOUR, (v.getGMTOffset() / 100) + (o / -100))) : v\n" // reset to GMT, then add offset
1444 Date.parseRegexes[regexNum] = new RegExp("^" + regex + "$");
1445 /** eval:var:zzzzzzzzzzzzz */
1450 Date.formatCodeToRegex = function(character, currentGroup) {
1451 switch (character) {
1455 s:"(?:Sun|Mon|Tue|Wed|Thu|Fri|Sat)"};
1458 c:"d = parseInt(results[" + currentGroup + "], 10);\n",
1459 s:"(\\d{1,2})"}; // day of month without leading zeroes
1462 c:"d = parseInt(results[" + currentGroup + "], 10);\n",
1463 s:"(\\d{2})"}; // day of month with leading zeroes
1467 s:"(?:" + Date.dayNames.join("|") + ")"};
1471 s:"(?:st|nd|rd|th)"};
1486 c:"m = parseInt(Date.monthNumbers[results[" + currentGroup + "].substring(0, 3)], 10);\n",
1487 s:"(" + Date.monthNames.join("|") + ")"};
1490 c:"m = parseInt(Date.monthNumbers[results[" + currentGroup + "]], 10);\n",
1491 s:"(Jan|Feb|Mar|Apr|May|Jun|Jul|Aug|Sep|Oct|Nov|Dec)"};
1494 c:"m = parseInt(results[" + currentGroup + "], 10) - 1;\n",
1495 s:"(\\d{1,2})"}; // Numeric representation of a month, without leading zeros
1498 c:"m = Math.max(0,parseInt(results[" + currentGroup + "], 10) - 1);\n",
1499 s:"(\\d{2})"}; // Numeric representation of a month, with leading zeros
1510 c:"y = parseInt(results[" + currentGroup + "], 10);\n",
1514 c:"var ty = parseInt(results[" + currentGroup + "], 10);\n"
1515 + "y = ty > Date.y2kYear ? 1900 + ty : 2000 + ty;\n",
1519 c:"if (results[" + currentGroup + "] == 'am') {\n"
1520 + "if (h == 12) { h = 0; }\n"
1521 + "} else { if (h < 12) { h += 12; }}",
1525 c:"if (results[" + currentGroup + "] == 'AM') {\n"
1526 + "if (h == 12) { h = 0; }\n"
1527 + "} else { if (h < 12) { h += 12; }}",
1532 c:"h = parseInt(results[" + currentGroup + "], 10);\n",
1533 s:"(\\d{1,2})"}; // 12/24-hr format format of an hour without leading zeroes
1537 c:"h = parseInt(results[" + currentGroup + "], 10);\n",
1538 s:"(\\d{2})"}; // 12/24-hr format format of an hour with leading zeroes
1541 c:"i = parseInt(results[" + currentGroup + "], 10);\n",
1545 c:"s = parseInt(results[" + currentGroup + "], 10);\n",
1550 "o = results[", currentGroup, "];\n",
1551 "var sn = o.substring(0,1);\n", // get + / - sign
1552 "var hr = o.substring(1,3)*1 + Math.floor(o.substring(3,5) / 60);\n", // get hours (performs minutes-to-hour conversion also)
1553 "var mn = o.substring(3,5) % 60;\n", // get minutes
1554 "o = ((-12 <= (hr*60 + mn)/60) && ((hr*60 + mn)/60 <= 14))?\n", // -12hrs <= GMT offset <= 14hrs
1555 " (sn + String.leftPad(hr, 2, 0) + String.leftPad(mn, 2, 0)) : null;\n"
1557 s:"([+\-]\\d{2,4})"};
1563 "o = results[", currentGroup, "];\n",
1564 "var sn = o.substring(0,1);\n",
1565 "var hr = o.substring(1,3)*1 + Math.floor(o.substring(4,6) / 60);\n",
1566 "var mn = o.substring(4,6) % 60;\n",
1567 "o = ((-12 <= (hr*60 + mn)/60) && ((hr*60 + mn)/60 <= 14))?\n",
1568 " (sn + String.leftPad(hr, 2, 0) + String.leftPad(mn, 2, 0)) : null;\n"
1574 s:"[A-Z]{1,4}"}; // timezone abbrev. may be between 1 - 4 chars
1577 c:"z = results[" + currentGroup + "];\n" // -43200 <= UTC offset <= 50400
1578 + "z = (-43200 <= z*1 && z*1 <= 50400)? z : null;\n",
1579 s:"([+\-]?\\d{1,5})"}; // leading '+' sign is optional for UTC offset
1583 s:String.escape(character)};
1588 * Get the timezone abbreviation of the current date (equivalent to the format specifier 'T').
1589 * @return {String} The abbreviated timezone name (e.g. 'CST')
1591 Date.prototype.getTimezone = function() {
1592 return this.toString().replace(/^.*? ([A-Z]{1,4})[\-+][0-9]{4} .*$/, "$1");
1596 * Get the offset from GMT of the current date (equivalent to the format specifier 'O').
1597 * @return {String} The 4-character offset string prefixed with + or - (e.g. '-0600')
1599 Date.prototype.getGMTOffset = function() {
1600 return (this.getTimezoneOffset() > 0 ? "-" : "+")
1601 + String.leftPad(Math.abs(Math.floor(this.getTimezoneOffset() / 60)), 2, "0")
1602 + String.leftPad(this.getTimezoneOffset() % 60, 2, "0");
1606 * Get the offset from GMT of the current date (equivalent to the format specifier 'P').
1607 * @return {String} 2-characters representing hours and 2-characters representing minutes
1608 * seperated by a colon and prefixed with + or - (e.g. '-06:00')
1610 Date.prototype.getGMTColonOffset = function() {
1611 return (this.getTimezoneOffset() > 0 ? "-" : "+")
1612 + String.leftPad(Math.abs(Math.floor(this.getTimezoneOffset() / 60)), 2, "0")
1614 + String.leftPad(this.getTimezoneOffset() %60, 2, "0");
1618 * Get the numeric day number of the year, adjusted for leap year.
1619 * @return {Number} 0 through 364 (365 in leap years)
1621 Date.prototype.getDayOfYear = function() {
1623 Date.daysInMonth[1] = this.isLeapYear() ? 29 : 28;
1624 for (var i = 0; i < this.getMonth(); ++i) {
1625 num += Date.daysInMonth[i];
1627 return num + this.getDate() - 1;
1631 * Get the string representation of the numeric week number of the year
1632 * (equivalent to the format specifier 'W').
1633 * @return {String} '00' through '52'
1635 Date.prototype.getWeekOfYear = function() {
1636 // Skip to Thursday of this week
1637 var now = this.getDayOfYear() + (4 - this.getDay());
1638 // Find the first Thursday of the year
1639 var jan1 = new Date(this.getFullYear(), 0, 1);
1640 var then = (7 - jan1.getDay() + 4);
1641 return String.leftPad(((now - then) / 7) + 1, 2, "0");
1645 * Whether or not the current date is in a leap year.
1646 * @return {Boolean} True if the current date is in a leap year, else false
1648 Date.prototype.isLeapYear = function() {
1649 var year = this.getFullYear();
1650 return ((year & 3) == 0 && (year % 100 || (year % 400 == 0 && year)));
1654 * Get the first day of the current month, adjusted for leap year. The returned value
1655 * is the numeric day index within the week (0-6) which can be used in conjunction with
1656 * the {@link #monthNames} array to retrieve the textual day name.
1659 var dt = new Date('1/10/2007');
1660 document.write(Date.dayNames[dt.getFirstDayOfMonth()]); //output: 'Monday'
1662 * @return {Number} The day number (0-6)
1664 Date.prototype.getFirstDayOfMonth = function() {
1665 var day = (this.getDay() - (this.getDate() - 1)) % 7;
1666 return (day < 0) ? (day + 7) : day;
1670 * Get the last day of the current month, adjusted for leap year. The returned value
1671 * is the numeric day index within the week (0-6) which can be used in conjunction with
1672 * the {@link #monthNames} array to retrieve the textual day name.
1675 var dt = new Date('1/10/2007');
1676 document.write(Date.dayNames[dt.getLastDayOfMonth()]); //output: 'Wednesday'
1678 * @return {Number} The day number (0-6)
1680 Date.prototype.getLastDayOfMonth = function() {
1681 var day = (this.getDay() + (Date.daysInMonth[this.getMonth()] - this.getDate())) % 7;
1682 return (day < 0) ? (day + 7) : day;
1687 * Get the first date of this date's month
1690 Date.prototype.getFirstDateOfMonth = function() {
1691 return new Date(this.getFullYear(), this.getMonth(), 1);
1695 * Get the last date of this date's month
1698 Date.prototype.getLastDateOfMonth = function() {
1699 return new Date(this.getFullYear(), this.getMonth(), this.getDaysInMonth());
1702 * Get the number of days in the current month, adjusted for leap year.
1703 * @return {Number} The number of days in the month
1705 Date.prototype.getDaysInMonth = function() {
1706 Date.daysInMonth[1] = this.isLeapYear() ? 29 : 28;
1707 return Date.daysInMonth[this.getMonth()];
1711 * Get the English ordinal suffix of the current day (equivalent to the format specifier 'S').
1712 * @return {String} 'st, 'nd', 'rd' or 'th'
1714 Date.prototype.getSuffix = function() {
1715 switch (this.getDate()) {
1732 Date.daysInMonth = [31,28,31,30,31,30,31,31,30,31,30,31];
1735 * An array of textual month names.
1736 * Override these values for international dates, for example...
1737 * Date.monthNames = ['JanInYourLang', 'FebInYourLang', ...];
1756 * An array of textual day names.
1757 * Override these values for international dates, for example...
1758 * Date.dayNames = ['SundayInYourLang', 'MondayInYourLang', ...];
1774 Date.monthNumbers = {
1789 * Creates and returns a new Date instance with the exact same date value as the called instance.
1790 * Dates are copied and passed by reference, so if a copied date variable is modified later, the original
1791 * variable will also be changed. When the intention is to create a new variable that will not
1792 * modify the original instance, you should create a clone.
1794 * Example of correctly cloning a date:
1797 var orig = new Date('10/1/2006');
1800 document.write(orig); //returns 'Thu Oct 05 2006'!
1803 var orig = new Date('10/1/2006');
1804 var copy = orig.clone();
1806 document.write(orig); //returns 'Thu Oct 01 2006'
1808 * @return {Date} The new Date instance
1810 Date.prototype.clone = function() {
1811 return new Date(this.getTime());
1815 * Clears any time information from this date
1816 @param {Boolean} clone true to create a clone of this date, clear the time and return it
1817 @return {Date} this or the clone
1819 Date.prototype.clearTime = function(clone){
1821 return this.clone().clearTime();
1826 this.setMilliseconds(0);
1831 // safari setMonth is broken -- check that this is only donw once...
1832 if(Roo.isSafari && typeof(Date.brokenSetMonth) == 'undefined'){
1833 Date.brokenSetMonth = Date.prototype.setMonth;
1834 Date.prototype.setMonth = function(num){
1836 var n = Math.ceil(-num);
1837 var back_year = Math.ceil(n/12);
1838 var month = (n % 12) ? 12 - n % 12 : 0 ;
1839 this.setFullYear(this.getFullYear() - back_year);
1840 return Date.brokenSetMonth.call(this, month);
1842 return Date.brokenSetMonth.apply(this, arguments);
1847 /** Date interval constant
1851 /** Date interval constant
1855 /** Date interval constant
1859 /** Date interval constant
1863 /** Date interval constant
1867 /** Date interval constant
1871 /** Date interval constant
1877 * Provides a convenient method of performing basic date arithmetic. This method
1878 * does not modify the Date instance being called - it creates and returns
1879 * a new Date instance containing the resulting date value.
1884 var dt = new Date('10/29/2006').add(Date.DAY, 5);
1885 document.write(dt); //returns 'Fri Oct 06 2006 00:00:00'
1887 //Negative values will subtract correctly:
1888 var dt2 = new Date('10/1/2006').add(Date.DAY, -5);
1889 document.write(dt2); //returns 'Tue Sep 26 2006 00:00:00'
1891 //You can even chain several calls together in one line!
1892 var dt3 = new Date('10/1/2006').add(Date.DAY, 5).add(Date.HOUR, 8).add(Date.MINUTE, -30);
1893 document.write(dt3); //returns 'Fri Oct 06 2006 07:30:00'
1896 * @param {String} interval A valid date interval enum value
1897 * @param {Number} value The amount to add to the current date
1898 * @return {Date} The new Date instance
1900 Date.prototype.add = function(interval, value){
1901 var d = this.clone();
1902 if (!interval || value === 0) { return d; }
1903 switch(interval.toLowerCase()){
1905 d.setMilliseconds(this.getMilliseconds() + value);
1908 d.setSeconds(this.getSeconds() + value);
1911 d.setMinutes(this.getMinutes() + value);
1914 d.setHours(this.getHours() + value);
1917 d.setDate(this.getDate() + value);
1920 var day = this.getDate();
1922 day = Math.min(day, this.getFirstDateOfMonth().add('mo', value).getLastDateOfMonth().getDate());
1925 d.setMonth(this.getMonth() + value);
1928 d.setFullYear(this.getFullYear() + value);
1934 * @class Roo.lib.Dom
1938 * Dom utils (from YIU afaik)
1944 * Get the view width
1945 * @param {Boolean} full True will get the full document, otherwise it's the view width
1946 * @return {Number} The width
1949 getViewWidth : function(full) {
1950 return full ? this.getDocumentWidth() : this.getViewportWidth();
1953 * Get the view height
1954 * @param {Boolean} full True will get the full document, otherwise it's the view height
1955 * @return {Number} The height
1957 getViewHeight : function(full) {
1958 return full ? this.getDocumentHeight() : this.getViewportHeight();
1961 * Get the Full Document height
1962 * @return {Number} The height
1964 getDocumentHeight: function() {
1965 var scrollHeight = (document.compatMode != "CSS1Compat") ? document.body.scrollHeight : document.documentElement.scrollHeight;
1966 return Math.max(scrollHeight, this.getViewportHeight());
1969 * Get the Full Document width
1970 * @return {Number} The width
1972 getDocumentWidth: function() {
1973 var scrollWidth = (document.compatMode != "CSS1Compat") ? document.body.scrollWidth : document.documentElement.scrollWidth;
1974 return Math.max(scrollWidth, this.getViewportWidth());
1977 * Get the Window Viewport height
1978 * @return {Number} The height
1980 getViewportHeight: function() {
1981 var height = self.innerHeight;
1982 var mode = document.compatMode;
1984 if ((mode || Roo.isIE) && !Roo.isOpera) {
1985 height = (mode == "CSS1Compat") ?
1986 document.documentElement.clientHeight :
1987 document.body.clientHeight;
1993 * Get the Window Viewport width
1994 * @return {Number} The width
1996 getViewportWidth: function() {
1997 var width = self.innerWidth;
1998 var mode = document.compatMode;
2000 if (mode || Roo.isIE) {
2001 width = (mode == "CSS1Compat") ?
2002 document.documentElement.clientWidth :
2003 document.body.clientWidth;
2008 isAncestor : function(p, c) {
2015 if (p.contains && !Roo.isSafari) {
2016 return p.contains(c);
2017 } else if (p.compareDocumentPosition) {
2018 return !!(p.compareDocumentPosition(c) & 16);
2020 var parent = c.parentNode;
2025 else if (!parent.tagName || parent.tagName.toUpperCase() == "HTML") {
2028 parent = parent.parentNode;
2034 getRegion : function(el) {
2035 return Roo.lib.Region.getRegion(el);
2038 getY : function(el) {
2039 return this.getXY(el)[1];
2042 getX : function(el) {
2043 return this.getXY(el)[0];
2046 getXY : function(el) {
2047 var p, pe, b, scroll, bd = document.body;
2048 el = Roo.getDom(el);
2049 var fly = Roo.lib.AnimBase.fly;
2050 if (el.getBoundingClientRect) {
2051 b = el.getBoundingClientRect();
2052 scroll = fly(document).getScroll();
2053 return [b.left + scroll.left, b.top + scroll.top];
2059 var hasAbsolute = fly(el).getStyle("position") == "absolute";
2066 if (!hasAbsolute && fly(p).getStyle("position") == "absolute") {
2073 var bt = parseInt(pe.getStyle("borderTopWidth"), 10) || 0;
2074 var bl = parseInt(pe.getStyle("borderLeftWidth"), 10) || 0;
2081 if (p != el && pe.getStyle('overflow') != 'visible') {
2089 if (Roo.isSafari && hasAbsolute) {
2094 if (Roo.isGecko && !hasAbsolute) {
2096 x += parseInt(dbd.getStyle("borderLeftWidth"), 10) || 0;
2097 y += parseInt(dbd.getStyle("borderTopWidth"), 10) || 0;
2101 while (p && p != bd) {
2102 if (!Roo.isOpera || (p.tagName != 'TR' && fly(p).getStyle("display") != "inline")) {
2114 setXY : function(el, xy) {
2115 el = Roo.fly(el, '_setXY');
2117 var pts = el.translatePoints(xy);
2118 if (xy[0] !== false) {
2119 el.dom.style.left = pts.left + "px";
2121 if (xy[1] !== false) {
2122 el.dom.style.top = pts.top + "px";
2126 setX : function(el, x) {
2127 this.setXY(el, [x, false]);
2130 setY : function(el, y) {
2131 this.setXY(el, [false, y]);
2135 * Portions of this file are based on pieces of Yahoo User Interface Library
2136 * Copyright (c) 2007, Yahoo! Inc. All rights reserved.
2137 * YUI licensed under the BSD License:
2138 * http://developer.yahoo.net/yui/license.txt
2139 * <script type="text/javascript">
2143 Roo.lib.Event = function() {
2144 var loadComplete = false;
2146 var unloadListeners = [];
2148 var onAvailStack = [];
2150 var lastError = null;
2163 startInterval: function() {
2164 if (!this._interval) {
2166 var callback = function() {
2167 self._tryPreloadAttach();
2169 this._interval = setInterval(callback, this.POLL_INTERVAL);
2174 onAvailable: function(p_id, p_fn, p_obj, p_override) {
2175 onAvailStack.push({ id: p_id,
2178 override: p_override,
2179 checkReady: false });
2181 retryCount = this.POLL_RETRYS;
2182 this.startInterval();
2186 addListener: function(el, eventName, fn) {
2187 el = Roo.getDom(el);
2192 if ("unload" == eventName) {
2193 unloadListeners[unloadListeners.length] =
2194 [el, eventName, fn];
2198 var wrappedFn = function(e) {
2199 return fn(Roo.lib.Event.getEvent(e));
2202 var li = [el, eventName, fn, wrappedFn];
2204 var index = listeners.length;
2205 listeners[index] = li;
2207 this.doAdd(el, eventName, wrappedFn, false);
2213 removeListener: function(el, eventName, fn) {
2216 el = Roo.getDom(el);
2219 return this.purgeElement(el, false, eventName);
2223 if ("unload" == eventName) {
2225 for (i = 0,len = unloadListeners.length; i < len; i++) {
2226 var li = unloadListeners[i];
2229 li[1] == eventName &&
2231 unloadListeners.splice(i, 1);
2239 var cacheItem = null;
2242 var index = arguments[3];
2244 if ("undefined" == typeof index) {
2245 index = this._getCacheIndex(el, eventName, fn);
2249 cacheItem = listeners[index];
2252 if (!el || !cacheItem) {
2256 this.doRemove(el, eventName, cacheItem[this.WFN], false);
2258 delete listeners[index][this.WFN];
2259 delete listeners[index][this.FN];
2260 listeners.splice(index, 1);
2267 getTarget: function(ev, resolveTextNode) {
2268 ev = ev.browserEvent || ev;
2269 ev = ev.touches ? (ev.touches[0] || ev.changedTouches[0] || ev ) : ev;
2270 var t = ev.target || ev.srcElement;
2271 return this.resolveTextNode(t);
2275 resolveTextNode: function(node) {
2276 if (Roo.isSafari && node && 3 == node.nodeType) {
2277 return node.parentNode;
2284 getPageX: function(ev) {
2285 ev = ev.browserEvent || ev;
2286 ev = ev.touches ? (ev.touches[0] || ev.changedTouches[0] || ev ) : ev;
2288 if (!x && 0 !== x) {
2289 x = ev.clientX || 0;
2292 x += this.getScroll()[1];
2300 getPageY: function(ev) {
2301 ev = ev.browserEvent || ev;
2302 ev = ev.touches ? (ev.touches[0] || ev.changedTouches[0] || ev ) : ev;
2304 if (!y && 0 !== y) {
2305 y = ev.clientY || 0;
2308 y += this.getScroll()[0];
2317 getXY: function(ev) {
2318 ev = ev.browserEvent || ev;
2319 ev = ev.touches ? (ev.touches[0] || ev.changedTouches[0] || ev ) : ev;
2320 return [this.getPageX(ev), this.getPageY(ev)];
2324 getRelatedTarget: function(ev) {
2325 ev = ev.browserEvent || ev;
2326 ev = ev.touches ? (ev.touches[0] || ev.changedTouches[0] || ev ) : ev;
2327 var t = ev.relatedTarget;
2329 if (ev.type == "mouseout") {
2331 } else if (ev.type == "mouseover") {
2336 return this.resolveTextNode(t);
2340 getTime: function(ev) {
2341 ev = ev.browserEvent || ev;
2342 ev = ev.touches ? (ev.touches[0] || ev.changedTouches[0] || ev ) : ev;
2344 var t = new Date().getTime();
2348 this.lastError = ex;
2357 stopEvent: function(ev) {
2358 this.stopPropagation(ev);
2359 this.preventDefault(ev);
2363 stopPropagation: function(ev) {
2364 ev = ev.browserEvent || ev;
2365 if (ev.stopPropagation) {
2366 ev.stopPropagation();
2368 ev.cancelBubble = true;
2373 preventDefault: function(ev) {
2374 ev = ev.browserEvent || ev;
2375 if(ev.preventDefault) {
2376 ev.preventDefault();
2378 ev.returnValue = false;
2383 getEvent: function(e) {
2384 var ev = e || window.event;
2386 var c = this.getEvent.caller;
2388 ev = c.arguments[0];
2389 if (ev && Event == ev.constructor) {
2399 getCharCode: function(ev) {
2400 ev = ev.browserEvent || ev;
2401 return ev.charCode || ev.keyCode || 0;
2405 _getCacheIndex: function(el, eventName, fn) {
2406 for (var i = 0,len = listeners.length; i < len; ++i) {
2407 var li = listeners[i];
2409 li[this.FN] == fn &&
2410 li[this.EL] == el &&
2411 li[this.TYPE] == eventName) {
2423 getEl: function(id) {
2424 return document.getElementById(id);
2428 clearCache: function() {
2432 _load: function(e) {
2433 loadComplete = true;
2434 var EU = Roo.lib.Event;
2438 EU.doRemove(window, "load", EU._load);
2443 _tryPreloadAttach: function() {
2452 var tryAgain = !loadComplete;
2454 tryAgain = (retryCount > 0);
2459 for (var i = 0,len = onAvailStack.length; i < len; ++i) {
2460 var item = onAvailStack[i];
2462 var el = this.getEl(item.id);
2465 if (!item.checkReady ||
2468 (document && document.body)) {
2471 if (item.override) {
2472 if (item.override === true) {
2475 scope = item.override;
2478 item.fn.call(scope, item.obj);
2479 onAvailStack[i] = null;
2482 notAvail.push(item);
2487 retryCount = (notAvail.length === 0) ? 0 : retryCount - 1;
2491 this.startInterval();
2493 clearInterval(this._interval);
2494 this._interval = null;
2497 this.locked = false;
2504 purgeElement: function(el, recurse, eventName) {
2505 var elListeners = this.getListeners(el, eventName);
2507 for (var i = 0,len = elListeners.length; i < len; ++i) {
2508 var l = elListeners[i];
2509 this.removeListener(el, l.type, l.fn);
2513 if (recurse && el && el.childNodes) {
2514 for (i = 0,len = el.childNodes.length; i < len; ++i) {
2515 this.purgeElement(el.childNodes[i], recurse, eventName);
2521 getListeners: function(el, eventName) {
2522 var results = [], searchLists;
2524 searchLists = [listeners, unloadListeners];
2525 } else if (eventName == "unload") {
2526 searchLists = [unloadListeners];
2528 searchLists = [listeners];
2531 for (var j = 0; j < searchLists.length; ++j) {
2532 var searchList = searchLists[j];
2533 if (searchList && searchList.length > 0) {
2534 for (var i = 0,len = searchList.length; i < len; ++i) {
2535 var l = searchList[i];
2536 if (l && l[this.EL] === el &&
2537 (!eventName || eventName === l[this.TYPE])) {
2542 adjust: l[this.ADJ_SCOPE],
2550 return (results.length) ? results : null;
2554 _unload: function(e) {
2556 var EU = Roo.lib.Event, i, j, l, len, index;
2558 for (i = 0,len = unloadListeners.length; i < len; ++i) {
2559 l = unloadListeners[i];
2562 if (l[EU.ADJ_SCOPE]) {
2563 if (l[EU.ADJ_SCOPE] === true) {
2566 scope = l[EU.ADJ_SCOPE];
2569 l[EU.FN].call(scope, EU.getEvent(e), l[EU.OBJ]);
2570 unloadListeners[i] = null;
2576 unloadListeners = null;
2578 if (listeners && listeners.length > 0) {
2579 j = listeners.length;
2582 l = listeners[index];
2584 EU.removeListener(l[EU.EL], l[EU.TYPE],
2594 EU.doRemove(window, "unload", EU._unload);
2599 getScroll: function() {
2600 var dd = document.documentElement, db = document.body;
2601 if (dd && (dd.scrollTop || dd.scrollLeft)) {
2602 return [dd.scrollTop, dd.scrollLeft];
2604 return [db.scrollTop, db.scrollLeft];
2611 doAdd: function () {
2612 if (window.addEventListener) {
2613 return function(el, eventName, fn, capture) {
2614 el.addEventListener(eventName, fn, (capture));
2616 } else if (window.attachEvent) {
2617 return function(el, eventName, fn, capture) {
2618 el.attachEvent("on" + eventName, fn);
2627 doRemove: function() {
2628 if (window.removeEventListener) {
2629 return function (el, eventName, fn, capture) {
2630 el.removeEventListener(eventName, fn, (capture));
2632 } else if (window.detachEvent) {
2633 return function (el, eventName, fn) {
2634 el.detachEvent("on" + eventName, fn);
2646 var E = Roo.lib.Event;
2647 E.on = E.addListener;
2648 E.un = E.removeListener;
2650 if (document && document.body) {
2653 E.doAdd(window, "load", E._load);
2655 E.doAdd(window, "unload", E._unload);
2656 E._tryPreloadAttach();
2663 * @class Roo.lib.Ajax
2665 * provide a simple Ajax request utility functions
2667 * Portions of this file are based on pieces of Yahoo User Interface Library
2668 * Copyright (c) 2007, Yahoo! Inc. All rights reserved.
2669 * YUI licensed under the BSD License:
2670 * http://developer.yahoo.net/yui/license.txt
2671 * <script type="text/javascript">
2679 request : function(method, uri, cb, data, options) {
2681 var hs = options.headers;
2684 if(hs.hasOwnProperty(h)){
2685 this.initHeader(h, hs[h], false);
2689 if(options.xmlData){
2690 this.initHeader('Content-Type', 'text/xml', false);
2692 data = options.xmlData;
2696 return this.asyncRequest(method, uri, cb, data);
2702 * @param {DomForm} form element
2703 * @return {String} urlencode form output.
2705 serializeForm : function(form) {
2706 if(typeof form == 'string') {
2707 form = (document.getElementById(form) || document.forms[form]);
2710 var el, name, val, disabled, data = '', hasSubmit = false;
2711 for (var i = 0; i < form.elements.length; i++) {
2712 el = form.elements[i];
2713 disabled = form.elements[i].disabled;
2714 name = form.elements[i].name;
2715 val = form.elements[i].value;
2717 if (!disabled && name){
2721 case 'select-multiple':
2722 for (var j = 0; j < el.options.length; j++) {
2723 if (el.options[j].selected) {
2725 data += Roo.encodeURIComponent(name) + '=' + Roo.encodeURIComponent(el.options[j].attributes['value'].specified ? el.options[j].value : el.options[j].text) + '&';
2728 data += Roo.encodeURIComponent(name) + '=' + Roo.encodeURIComponent(el.options[j].hasAttribute('value') ? el.options[j].value : el.options[j].text) + '&';
2736 data += Roo.encodeURIComponent(name) + '=' + Roo.encodeURIComponent(val) + '&';
2749 if(hasSubmit == false) {
2750 data += Roo.encodeURIComponent(name) + '=' + Roo.encodeURIComponent(val) + '&';
2755 data += Roo.encodeURIComponent(name) + '=' + Roo.encodeURIComponent(val) + '&';
2760 data = data.substr(0, data.length - 1);
2768 useDefaultHeader:true,
2770 defaultPostHeader:'application/x-www-form-urlencoded',
2772 useDefaultXhrHeader:true,
2774 defaultXhrHeader:'XMLHttpRequest',
2776 hasDefaultHeaders:true,
2788 setProgId:function(id)
2790 this.activeX.unshift(id);
2793 setDefaultPostHeader:function(b)
2795 this.useDefaultHeader = b;
2798 setDefaultXhrHeader:function(b)
2800 this.useDefaultXhrHeader = b;
2803 setPollingInterval:function(i)
2805 if (typeof i == 'number' && isFinite(i)) {
2806 this.pollInterval = i;
2810 createXhrObject:function(transactionId)
2816 http = new XMLHttpRequest();
2818 obj = { conn:http, tId:transactionId };
2822 for (var i = 0; i < this.activeX.length; ++i) {
2826 http = new ActiveXObject(this.activeX[i]);
2828 obj = { conn:http, tId:transactionId };
2841 getConnectionObject:function()
2844 var tId = this.transactionId;
2848 o = this.createXhrObject(tId);
2850 this.transactionId++;
2861 asyncRequest:function(method, uri, callback, postData)
2863 var o = this.getConnectionObject();
2869 o.conn.open(method, uri, true);
2871 if (this.useDefaultXhrHeader) {
2872 if (!this.defaultHeaders['X-Requested-With']) {
2873 this.initHeader('X-Requested-With', this.defaultXhrHeader, true);
2877 if(postData && this.useDefaultHeader){
2878 this.initHeader('Content-Type', this.defaultPostHeader);
2881 if (this.hasDefaultHeaders || this.hasHeaders) {
2885 this.handleReadyState(o, callback);
2886 o.conn.send(postData || null);
2892 handleReadyState:function(o, callback)
2896 if (callback && callback.timeout) {
2898 this.timeout[o.tId] = window.setTimeout(function() {
2899 oConn.abort(o, callback, true);
2900 }, callback.timeout);
2903 this.poll[o.tId] = window.setInterval(
2905 if (o.conn && o.conn.readyState == 4) {
2906 window.clearInterval(oConn.poll[o.tId]);
2907 delete oConn.poll[o.tId];
2909 if(callback && callback.timeout) {
2910 window.clearTimeout(oConn.timeout[o.tId]);
2911 delete oConn.timeout[o.tId];
2914 oConn.handleTransactionResponse(o, callback);
2917 , this.pollInterval);
2920 handleTransactionResponse:function(o, callback, isAbort)
2924 this.releaseObject(o);
2928 var httpStatus, responseObject;
2932 if (o.conn.status !== undefined && o.conn.status != 0) {
2933 httpStatus = o.conn.status;
2945 if (httpStatus >= 200 && httpStatus < 300) {
2946 responseObject = this.createResponseObject(o, callback.argument);
2947 if (callback.success) {
2948 if (!callback.scope) {
2949 callback.success(responseObject);
2954 callback.success.apply(callback.scope, [responseObject]);
2959 switch (httpStatus) {
2967 responseObject = this.createExceptionObject(o.tId, callback.argument, (isAbort ? isAbort : false));
2968 if (callback.failure) {
2969 if (!callback.scope) {
2970 callback.failure(responseObject);
2973 callback.failure.apply(callback.scope, [responseObject]);
2978 responseObject = this.createResponseObject(o, callback.argument);
2979 if (callback.failure) {
2980 if (!callback.scope) {
2981 callback.failure(responseObject);
2984 callback.failure.apply(callback.scope, [responseObject]);
2990 this.releaseObject(o);
2991 responseObject = null;
2994 createResponseObject:function(o, callbackArg)
3001 var headerStr = o.conn.getAllResponseHeaders();
3002 var header = headerStr.split('\n');
3003 for (var i = 0; i < header.length; i++) {
3004 var delimitPos = header[i].indexOf(':');
3005 if (delimitPos != -1) {
3006 headerObj[header[i].substring(0, delimitPos)] = header[i].substring(delimitPos + 2);
3014 obj.status = o.conn.status;
3015 obj.statusText = o.conn.statusText;
3016 obj.getResponseHeader = headerObj;
3017 obj.getAllResponseHeaders = headerStr;
3018 obj.responseText = o.conn.responseText;
3019 obj.responseXML = o.conn.responseXML;
3021 if (typeof callbackArg !== undefined) {
3022 obj.argument = callbackArg;
3028 createExceptionObject:function(tId, callbackArg, isAbort)
3031 var COMM_ERROR = 'communication failure';
3032 var ABORT_CODE = -1;
3033 var ABORT_ERROR = 'transaction aborted';
3039 obj.status = ABORT_CODE;
3040 obj.statusText = ABORT_ERROR;
3043 obj.status = COMM_CODE;
3044 obj.statusText = COMM_ERROR;
3048 obj.argument = callbackArg;
3054 initHeader:function(label, value, isDefault)
3056 var headerObj = (isDefault) ? this.defaultHeaders : this.headers;
3058 if (headerObj[label] === undefined) {
3059 headerObj[label] = value;
3064 headerObj[label] = value + "," + headerObj[label];
3068 this.hasDefaultHeaders = true;
3071 this.hasHeaders = true;
3076 setHeader:function(o)
3078 if (this.hasDefaultHeaders) {
3079 for (var prop in this.defaultHeaders) {
3080 if (this.defaultHeaders.hasOwnProperty(prop)) {
3081 o.conn.setRequestHeader(prop, this.defaultHeaders[prop]);
3086 if (this.hasHeaders) {
3087 for (var prop in this.headers) {
3088 if (this.headers.hasOwnProperty(prop)) {
3089 o.conn.setRequestHeader(prop, this.headers[prop]);
3093 this.hasHeaders = false;
3097 resetDefaultHeaders:function() {
3098 delete this.defaultHeaders;
3099 this.defaultHeaders = {};
3100 this.hasDefaultHeaders = false;
3103 abort:function(o, callback, isTimeout)
3105 if(this.isCallInProgress(o)) {
3107 window.clearInterval(this.poll[o.tId]);
3108 delete this.poll[o.tId];
3110 delete this.timeout[o.tId];
3113 this.handleTransactionResponse(o, callback, true);
3123 isCallInProgress:function(o)
3126 return o.conn.readyState != 4 && o.conn.readyState != 0;
3135 releaseObject:function(o)
3144 'MSXML2.XMLHTTP.3.0',
3152 * Portions of this file are based on pieces of Yahoo User Interface Library
3153 * Copyright (c) 2007, Yahoo! Inc. All rights reserved.
3154 * YUI licensed under the BSD License:
3155 * http://developer.yahoo.net/yui/license.txt
3156 * <script type="text/javascript">
3160 Roo.lib.Region = function(t, r, b, l) {
3170 Roo.lib.Region.prototype = {
3171 contains : function(region) {
3172 return ( region.left >= this.left &&
3173 region.right <= this.right &&
3174 region.top >= this.top &&
3175 region.bottom <= this.bottom );
3179 getArea : function() {
3180 return ( (this.bottom - this.top) * (this.right - this.left) );
3183 intersect : function(region) {
3184 var t = Math.max(this.top, region.top);
3185 var r = Math.min(this.right, region.right);
3186 var b = Math.min(this.bottom, region.bottom);
3187 var l = Math.max(this.left, region.left);
3189 if (b >= t && r >= l) {
3190 return new Roo.lib.Region(t, r, b, l);
3195 union : function(region) {
3196 var t = Math.min(this.top, region.top);
3197 var r = Math.max(this.right, region.right);
3198 var b = Math.max(this.bottom, region.bottom);
3199 var l = Math.min(this.left, region.left);
3201 return new Roo.lib.Region(t, r, b, l);
3204 adjust : function(t, l, b, r) {
3213 Roo.lib.Region.getRegion = function(el) {
3214 var p = Roo.lib.Dom.getXY(el);
3217 var r = p[0] + el.offsetWidth;
3218 var b = p[1] + el.offsetHeight;
3221 return new Roo.lib.Region(t, r, b, l);
3224 * Portions of this file are based on pieces of Yahoo User Interface Library
3225 * Copyright (c) 2007, Yahoo! Inc. All rights reserved.
3226 * YUI licensed under the BSD License:
3227 * http://developer.yahoo.net/yui/license.txt
3228 * <script type="text/javascript">
3231 //@@dep Roo.lib.Region
3234 Roo.lib.Point = function(x, y) {
3235 if (x instanceof Array) {
3239 this.x = this.right = this.left = this[0] = x;
3240 this.y = this.top = this.bottom = this[1] = y;
3243 Roo.lib.Point.prototype = new Roo.lib.Region();
3245 * Portions of this file are based on pieces of Yahoo User Interface Library
3246 * Copyright (c) 2007, Yahoo! Inc. All rights reserved.
3247 * YUI licensed under the BSD License:
3248 * http://developer.yahoo.net/yui/license.txt
3249 * <script type="text/javascript">
3256 scroll : function(el, args, duration, easing, cb, scope) {
3257 this.run(el, args, duration, easing, cb, scope, Roo.lib.Scroll);
3260 motion : function(el, args, duration, easing, cb, scope) {
3261 this.run(el, args, duration, easing, cb, scope, Roo.lib.Motion);
3264 color : function(el, args, duration, easing, cb, scope) {
3265 this.run(el, args, duration, easing, cb, scope, Roo.lib.ColorAnim);
3268 run : function(el, args, duration, easing, cb, scope, type) {
3269 type = type || Roo.lib.AnimBase;
3270 if (typeof easing == "string") {
3271 easing = Roo.lib.Easing[easing];
3273 var anim = new type(el, args, duration, easing);
3274 anim.animateX(function() {
3275 Roo.callback(cb, scope);
3281 * Portions of this file are based on pieces of Yahoo User Interface Library
3282 * Copyright (c) 2007, Yahoo! Inc. All rights reserved.
3283 * YUI licensed under the BSD License:
3284 * http://developer.yahoo.net/yui/license.txt
3285 * <script type="text/javascript">
3293 if (!libFlyweight) {
3294 libFlyweight = new Roo.Element.Flyweight();
3296 libFlyweight.dom = el;
3297 return libFlyweight;
3300 // since this uses fly! - it cant be in DOM (which does not have fly yet..)
3304 Roo.lib.AnimBase = function(el, attributes, duration, method) {
3306 this.init(el, attributes, duration, method);
3310 Roo.lib.AnimBase.fly = fly;
3314 Roo.lib.AnimBase.prototype = {
3316 toString: function() {
3317 var el = this.getEl();
3318 var id = el.id || el.tagName;
3319 return ("Anim " + id);
3323 noNegatives: /width|height|opacity|padding/i,
3324 offsetAttribute: /^((width|height)|(top|left))$/,
3325 defaultUnit: /width|height|top$|bottom$|left$|right$/i,
3326 offsetUnit: /\d+(em|%|en|ex|pt|in|cm|mm|pc)$/i
3330 doMethod: function(attr, start, end) {
3331 return this.method(this.currentFrame, start, end - start, this.totalFrames);
3335 setAttribute: function(attr, val, unit) {
3336 if (this.patterns.noNegatives.test(attr)) {
3337 val = (val > 0) ? val : 0;
3340 Roo.fly(this.getEl(), '_anim').setStyle(attr, val + unit);
3344 getAttribute: function(attr) {
3345 var el = this.getEl();
3346 var val = fly(el).getStyle(attr);
3348 if (val !== 'auto' && !this.patterns.offsetUnit.test(val)) {
3349 return parseFloat(val);
3352 var a = this.patterns.offsetAttribute.exec(attr) || [];
3353 var pos = !!( a[3] );
3354 var box = !!( a[2] );
3357 if (box || (fly(el).getStyle('position') == 'absolute' && pos)) {
3358 val = el['offset' + a[0].charAt(0).toUpperCase() + a[0].substr(1)];
3367 getDefaultUnit: function(attr) {
3368 if (this.patterns.defaultUnit.test(attr)) {
3375 animateX : function(callback, scope) {
3376 var f = function() {
3377 this.onComplete.removeListener(f);
3378 if (typeof callback == "function") {
3379 callback.call(scope || this, this);
3382 this.onComplete.addListener(f, this);
3387 setRuntimeAttribute: function(attr) {
3390 var attributes = this.attributes;
3392 this.runtimeAttributes[attr] = {};
3394 var isset = function(prop) {
3395 return (typeof prop !== 'undefined');
3398 if (!isset(attributes[attr]['to']) && !isset(attributes[attr]['by'])) {
3402 start = ( isset(attributes[attr]['from']) ) ? attributes[attr]['from'] : this.getAttribute(attr);
3405 if (isset(attributes[attr]['to'])) {
3406 end = attributes[attr]['to'];
3407 } else if (isset(attributes[attr]['by'])) {
3408 if (start.constructor == Array) {
3410 for (var i = 0, len = start.length; i < len; ++i) {
3411 end[i] = start[i] + attributes[attr]['by'][i];
3414 end = start + attributes[attr]['by'];
3418 this.runtimeAttributes[attr].start = start;
3419 this.runtimeAttributes[attr].end = end;
3422 this.runtimeAttributes[attr].unit = ( isset(attributes[attr].unit) ) ? attributes[attr]['unit'] : this.getDefaultUnit(attr);
3426 init: function(el, attributes, duration, method) {
3428 var isAnimated = false;
3431 var startTime = null;
3434 var actualFrames = 0;
3437 el = Roo.getDom(el);
3440 this.attributes = attributes || {};
3443 this.duration = duration || 1;
3446 this.method = method || Roo.lib.Easing.easeNone;
3449 this.useSeconds = true;
3452 this.currentFrame = 0;
3455 this.totalFrames = Roo.lib.AnimMgr.fps;
3458 this.getEl = function() {
3463 this.isAnimated = function() {
3468 this.getStartTime = function() {
3472 this.runtimeAttributes = {};
3475 this.animate = function() {
3476 if (this.isAnimated()) {
3480 this.currentFrame = 0;
3482 this.totalFrames = ( this.useSeconds ) ? Math.ceil(Roo.lib.AnimMgr.fps * this.duration) : this.duration;
3484 Roo.lib.AnimMgr.registerElement(this);
3488 this.stop = function(finish) {
3490 this.currentFrame = this.totalFrames;
3491 this._onTween.fire();
3493 Roo.lib.AnimMgr.stop(this);
3496 var onStart = function() {
3497 this.onStart.fire();
3499 this.runtimeAttributes = {};
3500 for (var attr in this.attributes) {
3501 this.setRuntimeAttribute(attr);
3506 startTime = new Date();
3510 var onTween = function() {
3512 duration: new Date() - this.getStartTime(),
3513 currentFrame: this.currentFrame
3516 data.toString = function() {
3518 'duration: ' + data.duration +
3519 ', currentFrame: ' + data.currentFrame
3523 this.onTween.fire(data);
3525 var runtimeAttributes = this.runtimeAttributes;
3527 for (var attr in runtimeAttributes) {
3528 this.setAttribute(attr, this.doMethod(attr, runtimeAttributes[attr].start, runtimeAttributes[attr].end), runtimeAttributes[attr].unit);
3534 var onComplete = function() {
3535 var actual_duration = (new Date() - startTime) / 1000 ;
3538 duration: actual_duration,
3539 frames: actualFrames,
3540 fps: actualFrames / actual_duration
3543 data.toString = function() {
3545 'duration: ' + data.duration +
3546 ', frames: ' + data.frames +
3547 ', fps: ' + data.fps
3553 this.onComplete.fire(data);
3557 this._onStart = new Roo.util.Event(this);
3558 this.onStart = new Roo.util.Event(this);
3559 this.onTween = new Roo.util.Event(this);
3560 this._onTween = new Roo.util.Event(this);
3561 this.onComplete = new Roo.util.Event(this);
3562 this._onComplete = new Roo.util.Event(this);
3563 this._onStart.addListener(onStart);
3564 this._onTween.addListener(onTween);
3565 this._onComplete.addListener(onComplete);
3570 * Portions of this file are based on pieces of Yahoo User Interface Library
3571 * Copyright (c) 2007, Yahoo! Inc. All rights reserved.
3572 * YUI licensed under the BSD License:
3573 * http://developer.yahoo.net/yui/license.txt
3574 * <script type="text/javascript">
3578 Roo.lib.AnimMgr = new function() {
3595 this.registerElement = function(tween) {
3596 queue[queue.length] = tween;
3598 tween._onStart.fire();
3603 this.unRegister = function(tween, index) {
3604 tween._onComplete.fire();
3605 index = index || getIndex(tween);
3607 queue.splice(index, 1);
3611 if (tweenCount <= 0) {
3617 this.start = function() {
3618 if (thread === null) {
3619 thread = setInterval(this.run, this.delay);
3624 this.stop = function(tween) {
3626 clearInterval(thread);
3628 for (var i = 0, len = queue.length; i < len; ++i) {
3629 if (queue[0].isAnimated()) {
3630 this.unRegister(queue[0], 0);
3639 this.unRegister(tween);
3644 this.run = function() {
3645 for (var i = 0, len = queue.length; i < len; ++i) {
3646 var tween = queue[i];
3647 if (!tween || !tween.isAnimated()) {
3651 if (tween.currentFrame < tween.totalFrames || tween.totalFrames === null)
3653 tween.currentFrame += 1;
3655 if (tween.useSeconds) {
3656 correctFrame(tween);
3658 tween._onTween.fire();
3661 Roo.lib.AnimMgr.stop(tween, i);
3666 var getIndex = function(anim) {
3667 for (var i = 0, len = queue.length; i < len; ++i) {
3668 if (queue[i] == anim) {
3676 var correctFrame = function(tween) {
3677 var frames = tween.totalFrames;
3678 var frame = tween.currentFrame;
3679 var expected = (tween.currentFrame * tween.duration * 1000 / tween.totalFrames);
3680 var elapsed = (new Date() - tween.getStartTime());
3683 if (elapsed < tween.duration * 1000) {
3684 tweak = Math.round((elapsed / expected - 1) * tween.currentFrame);
3686 tweak = frames - (frame + 1);
3688 if (tweak > 0 && isFinite(tweak)) {
3689 if (tween.currentFrame + tweak >= frames) {
3690 tweak = frames - (frame + 1);
3693 tween.currentFrame += tweak;
3699 * Portions of this file are based on pieces of Yahoo User Interface Library
3700 * Copyright (c) 2007, Yahoo! Inc. All rights reserved.
3701 * YUI licensed under the BSD License:
3702 * http://developer.yahoo.net/yui/license.txt
3703 * <script type="text/javascript">
3706 Roo.lib.Bezier = new function() {
3708 this.getPosition = function(points, t) {
3709 var n = points.length;
3712 for (var i = 0; i < n; ++i) {
3713 tmp[i] = [points[i][0], points[i][1]];
3716 for (var j = 1; j < n; ++j) {
3717 for (i = 0; i < n - j; ++i) {
3718 tmp[i][0] = (1 - t) * tmp[i][0] + t * tmp[parseInt(i + 1, 10)][0];
3719 tmp[i][1] = (1 - t) * tmp[i][1] + t * tmp[parseInt(i + 1, 10)][1];
3723 return [ tmp[0][0], tmp[0][1] ];
3729 * @class Roo.lib.Color
3731 * An abstract Color implementation. Concrete Color implementations should use
3732 * an instance of this function as their prototype, and implement the getRGB and
3733 * getHSL functions. getRGB should return an object representing the RGB
3734 * components of this Color, with the red, green, and blue components in the
3735 * range [0,255] and the alpha component in the range [0,100]. getHSL should
3736 * return an object representing the HSL components of this Color, with the hue
3737 * component in the range [0,360), the saturation and lightness components in
3738 * the range [0,100], and the alpha component in the range [0,1].
3743 * Functions for Color handling and processing.
3745 * http://www.safalra.com/web-design/javascript/Color-handling-and-processing/
3747 * The author of this program, Safalra (Stephen Morley), irrevocably releases all
3748 * rights to this program, with the intention of it becoming part of the public
3749 * domain. Because this program is released into the public domain, it comes with
3750 * no warranty either expressed or implied, to the extent permitted by law.
3752 * For more free and public domain JavaScript code by the same author, visit:
3753 * http://www.safalra.com/web-design/javascript/
3756 Roo.lib.Color = function() { }
3759 Roo.apply(Roo.lib.Color.prototype, {
3767 * @return {Object} an object representing the RGBA components of this Color. The red,
3768 * green, and blue components are converted to integers in the range [0,255].
3769 * The alpha is a value in the range [0,1].
3771 getIntegerRGB : function(){
3773 // get the RGB components of this Color
3774 var rgb = this.getRGB();
3776 // return the integer components
3778 'r' : Math.round(rgb.r),
3779 'g' : Math.round(rgb.g),
3780 'b' : Math.round(rgb.b),
3788 * @return {Object} an object representing the RGBA components of this Color. The red,
3789 * green, and blue components are converted to numbers in the range [0,100].
3790 * The alpha is a value in the range [0,1].
3792 getPercentageRGB : function(){
3794 // get the RGB components of this Color
3795 var rgb = this.getRGB();
3797 // return the percentage components
3799 'r' : 100 * rgb.r / 255,
3800 'g' : 100 * rgb.g / 255,
3801 'b' : 100 * rgb.b / 255,
3808 * getCSSHexadecimalRGB
3809 * @return {String} a string representing this Color as a CSS hexadecimal RGB Color
3810 * value - that is, a string of the form #RRGGBB where each of RR, GG, and BB
3811 * are two-digit hexadecimal numbers.
3813 getCSSHexadecimalRGB : function()
3816 // get the integer RGB components
3817 var rgb = this.getIntegerRGB();
3819 // determine the hexadecimal equivalents
3820 var r16 = rgb.r.toString(16);
3821 var g16 = rgb.g.toString(16);
3822 var b16 = rgb.b.toString(16);
3824 // return the CSS RGB Color value
3826 + (r16.length == 2 ? r16 : '0' + r16)
3827 + (g16.length == 2 ? g16 : '0' + g16)
3828 + (b16.length == 2 ? b16 : '0' + b16);
3834 * @return {String} a string representing this Color as a CSS integer RGB Color
3835 * value - that is, a string of the form rgb(r,g,b) where each of r, g, and b
3836 * are integers in the range [0,255].
3838 getCSSIntegerRGB : function(){
3840 // get the integer RGB components
3841 var rgb = this.getIntegerRGB();
3843 // return the CSS RGB Color value
3844 return 'rgb(' + rgb.r + ',' + rgb.g + ',' + rgb.b + ')';
3850 * @return {String} Returns a string representing this Color as a CSS integer RGBA Color
3851 * value - that is, a string of the form rgba(r,g,b,a) where each of r, g, and
3852 * b are integers in the range [0,255] and a is in the range [0,1].
3854 getCSSIntegerRGBA : function(){
3856 // get the integer RGB components
3857 var rgb = this.getIntegerRGB();
3859 // return the CSS integer RGBA Color value
3860 return 'rgb(' + rgb.r + ',' + rgb.g + ',' + rgb.b + ',' + rgb.a + ')';
3865 * getCSSPercentageRGB
3866 * @return {String} a string representing this Color as a CSS percentage RGB Color
3867 * value - that is, a string of the form rgb(r%,g%,b%) where each of r, g, and
3868 * b are in the range [0,100].
3870 getCSSPercentageRGB : function(){
3872 // get the percentage RGB components
3873 var rgb = this.getPercentageRGB();
3875 // return the CSS RGB Color value
3876 return 'rgb(' + rgb.r + '%,' + rgb.g + '%,' + rgb.b + '%)';
3881 * getCSSPercentageRGBA
3882 * @return {String} a string representing this Color as a CSS percentage RGBA Color
3883 * value - that is, a string of the form rgba(r%,g%,b%,a) where each of r, g,
3884 * and b are in the range [0,100] and a is in the range [0,1].
3886 getCSSPercentageRGBA : function(){
3888 // get the percentage RGB components
3889 var rgb = this.getPercentageRGB();
3891 // return the CSS percentage RGBA Color value
3892 return 'rgb(' + rgb.r + '%,' + rgb.g + '%,' + rgb.b + '%,' + rgb.a + ')';
3898 * @return {String} a string representing this Color as a CSS HSL Color value - that
3899 * is, a string of the form hsl(h,s%,l%) where h is in the range [0,100] and
3900 * s and l are in the range [0,100].
3902 getCSSHSL : function(){
3904 // get the HSL components
3905 var hsl = this.getHSL();
3907 // return the CSS HSL Color value
3908 return 'hsl(' + hsl.h + ',' + hsl.s + '%,' + hsl.l + '%)';
3914 * @return {String} a string representing this Color as a CSS HSLA Color value - that
3915 * is, a string of the form hsla(h,s%,l%,a) where h is in the range [0,100],
3916 * s and l are in the range [0,100], and a is in the range [0,1].
3918 getCSSHSLA : function(){
3920 // get the HSL components
3921 var hsl = this.getHSL();
3923 // return the CSS HSL Color value
3924 return 'hsl(' + hsl.h + ',' + hsl.s + '%,' + hsl.l + '%,' + hsl.a + ')';
3929 * Sets the Color of the specified node to this Color. This functions sets
3930 * the CSS 'color' property for the node. The parameter is:
3932 * @param {DomElement} node - the node whose Color should be set
3934 setNodeColor : function(node){
3936 // set the Color of the node
3937 node.style.color = this.getCSSHexadecimalRGB();
3942 * Sets the background Color of the specified node to this Color. This
3943 * functions sets the CSS 'background-color' property for the node. The
3946 * @param {DomElement} node - the node whose background Color should be set
3948 setNodeBackgroundColor : function(node){
3950 // set the background Color of the node
3951 node.style.backgroundColor = this.getCSSHexadecimalRGB();
3954 // convert between formats..
3957 var r = this.getIntegerRGB();
3958 return new Roo.lib.RGBColor(r.r,r.g,r.b,r.a);
3963 var hsl = this.getHSL();
3964 // return the CSS HSL Color value
3965 return new Roo.lib.HSLColor(hsl.h, hsl.s, hsl.l , hsl.a );
3971 var rgb = this.toRGB();
3972 var hsv = rgb.getHSV();
3973 // return the CSS HSL Color value
3974 return new Roo.lib.HSVColor(hsv.h, hsv.s, hsv.v , hsv.a );
3978 // modify v = 0 ... 1 (eg. 0.5)
3979 saturate : function(v)
3981 var rgb = this.toRGB();
3982 var hsv = rgb.getHSV();
3983 return new Roo.lib.HSVColor(hsv.h, hsv.s * v, hsv.v , hsv.a );
3991 * @return {Object} the RGB and alpha components of this Color as an object with r,
3992 * g, b, and a properties. r, g, and b are in the range [0,255] and a is in
3997 // return the RGB components
4009 * @return {Object} the HSV and alpha components of this Color as an object with h,
4010 * s, v, and a properties. h is in the range [0,360), s and v are in the range
4011 * [0,100], and a is in the range [0,1].
4016 // calculate the HSV components if necessary
4017 if (this.hsv == null) {
4018 this.calculateHSV();
4021 // return the HSV components
4033 * @return {Object} the HSL and alpha components of this Color as an object with h,
4034 * s, l, and a properties. h is in the range [0,360), s and l are in the range
4035 * [0,100], and a is in the range [0,1].
4037 getHSL : function(){
4040 // calculate the HSV components if necessary
4041 if (this.hsl == null) { this.calculateHSL(); }
4043 // return the HSL components
4058 * @class Roo.lib.RGBColor
4059 * @extends Roo.lib.Color
4060 * Creates a Color specified in the RGB Color space, with an optional alpha
4061 * component. The parameters are:
4065 * @param {Number} r - the red component, clipped to the range [0,255]
4066 * @param {Number} g - the green component, clipped to the range [0,255]
4067 * @param {Number} b - the blue component, clipped to the range [0,255]
4068 * @param {Number} a - the alpha component, clipped to the range [0,1] - this parameter is
4069 * optional and defaults to 1
4071 Roo.lib.RGBColor = function (r, g, b, a){
4073 // store the alpha component after clipping it if necessary
4074 this.alpha = (a === undefined ? 1 : Math.max(0, Math.min(1, a)));
4076 // store the RGB components after clipping them if necessary
4079 'r' : Math.max(0, Math.min(255, r)),
4080 'g' : Math.max(0, Math.min(255, g)),
4081 'b' : Math.max(0, Math.min(255, b))
4084 // initialise the HSV and HSL components to null
4088 * //private returns the HSV or HSL hue component of this RGBColor. The hue is in the
4089 * range [0,360). The parameters are:
4091 * maximum - the maximum of the RGB component values
4092 * range - the range of the RGB component values
4097 // this does an 'exteds'
4098 Roo.extend(Roo.lib.RGBColor, Roo.lib.Color, {
4101 getHue : function(maximum, range)
4105 // check whether the range is zero
4108 // set the hue to zero (any hue is acceptable as the Color is grey)
4113 // determine which of the components has the highest value and set the hue
4116 // red has the highest value
4118 var hue = (rgb.g - rgb.b) / range * 60;
4119 if (hue < 0) { hue += 360; }
4122 // green has the highest value
4124 var hue = (rgb.b - rgb.r) / range * 60 + 120;
4127 // blue has the highest value
4129 var hue = (rgb.r - rgb.g) / range * 60 + 240;
4141 /* //private Calculates and stores the HSV components of this RGBColor so that they can
4142 * be returned be the getHSV function.
4144 calculateHSV : function(){
4146 // get the maximum and range of the RGB component values
4147 var maximum = Math.max(rgb.r, rgb.g, rgb.b);
4148 var range = maximum - Math.min(rgb.r, rgb.g, rgb.b);
4150 // store the HSV components
4153 'h' : this.getHue(maximum, range),
4154 's' : (maximum == 0 ? 0 : 100 * range / maximum),
4155 'v' : maximum / 2.55
4160 /* //private Calculates and stores the HSL components of this RGBColor so that they can
4161 * be returned be the getHSL function.
4163 calculateHSL : function(){
4165 // get the maximum and range of the RGB component values
4166 var maximum = Math.max(rgb.r, rgb.g, rgb.b);
4167 var range = maximum - Math.min(rgb.r, rgb.g, rgb.b);
4169 // determine the lightness in the range [0,1]
4170 var l = maximum / 255 - range / 510;
4172 // store the HSL components
4175 'h' : this.getHue(maximum, range),
4176 's' : (range == 0 ? 0 : range / 2.55 / (l < 0.5 ? l * 2 : 2 - l * 2)),
4185 * @class Roo.lib.HSVColor
4186 * @extends Roo.lib.Color
4187 * Creates a Color specified in the HSV Color space, with an optional alpha
4188 * component. The parameters are:
4191 * @param {Number} h - the hue component, wrapped to the range [0,360)
4192 * @param {Number} s - the saturation component, clipped to the range [0,100]
4193 * @param {Number} v - the value component, clipped to the range [0,100]
4194 * @param {Number} a - the alpha component, clipped to the range [0,1] - this parameter is
4195 * optional and defaults to 1
4197 Roo.lib.HSVColor = function (h, s, v, a){
4199 // store the alpha component after clipping it if necessary
4200 this.alpha = (a === undefined ? 1 : Math.max(0, Math.min(1, a)));
4202 // store the HSV components after clipping or wrapping them if necessary
4205 'h' : (h % 360 + 360) % 360,
4206 's' : Math.max(0, Math.min(100, s)),
4207 'v' : Math.max(0, Math.min(100, v))
4210 // initialise the RGB and HSL components to null
4215 Roo.extend(Roo.lib.HSVColor, Roo.lib.Color, {
4216 /* Calculates and stores the RGB components of this HSVColor so that they can
4217 * be returned be the getRGB function.
4219 calculateRGB: function ()
4222 // check whether the saturation is zero
4225 // set the Color to the appropriate shade of grey
4232 // set some temporary values
4233 var f = hsv.h / 60 - Math.floor(hsv.h / 60);
4234 var p = hsv.v * (1 - hsv.s / 100);
4235 var q = hsv.v * (1 - hsv.s / 100 * f);
4236 var t = hsv.v * (1 - hsv.s / 100 * (1 - f));
4238 // set the RGB Color components to their temporary values
4239 switch (Math.floor(hsv.h / 60)){
4240 case 0: var r = hsv.v; var g = t; var b = p; break;
4241 case 1: var r = q; var g = hsv.v; var b = p; break;
4242 case 2: var r = p; var g = hsv.v; var b = t; break;
4243 case 3: var r = p; var g = q; var b = hsv.v; break;
4244 case 4: var r = t; var g = p; var b = hsv.v; break;
4245 case 5: var r = hsv.v; var g = p; var b = q; break;
4250 // store the RGB components
4260 /* Calculates and stores the HSL components of this HSVColor so that they can
4261 * be returned be the getHSL function.
4263 calculateHSL : function (){
4266 // determine the lightness in the range [0,100]
4267 var l = (2 - hsv.s / 100) * hsv.v / 2;
4269 // store the HSL components
4273 's' : hsv.s * hsv.v / (l < 50 ? l * 2 : 200 - l * 2),
4277 // correct a division-by-zero error
4278 if (isNaN(hsl.s)) { hsl.s = 0; }
4287 * @class Roo.lib.HSLColor
4288 * @extends Roo.lib.Color
4291 * Creates a Color specified in the HSL Color space, with an optional alpha
4292 * component. The parameters are:
4294 * @param {Number} h - the hue component, wrapped to the range [0,360)
4295 * @param {Number} s - the saturation component, clipped to the range [0,100]
4296 * @param {Number} l - the lightness component, clipped to the range [0,100]
4297 * @param {Number} a - the alpha component, clipped to the range [0,1] - this parameter is
4298 * optional and defaults to 1
4301 Roo.lib.HSLColor = function(h, s, l, a){
4303 // store the alpha component after clipping it if necessary
4304 this.alpha = (a === undefined ? 1 : Math.max(0, Math.min(1, a)));
4306 // store the HSL components after clipping or wrapping them if necessary
4309 'h' : (h % 360 + 360) % 360,
4310 's' : Math.max(0, Math.min(100, s)),
4311 'l' : Math.max(0, Math.min(100, l))
4314 // initialise the RGB and HSV components to null
4317 Roo.extend(Roo.lib.HSLColor, Roo.lib.Color, {
4319 /* Calculates and stores the RGB components of this HSLColor so that they can
4320 * be returned be the getRGB function.
4322 calculateRGB: function (){
4324 // check whether the saturation is zero
4325 if (this.hsl.s == 0){
4327 // store the RGB components representing the appropriate shade of grey
4330 'r' : this.hsl.l * 2.55,
4331 'g' : this.hsl.l * 2.55,
4332 'b' : this.hsl.l * 2.55
4337 // set some temporary values
4338 var p = this.hsl.l < 50
4339 ? this.hsl.l * (1 + hsl.s / 100)
4340 : this.hsl.l + hsl.s - hsl.l * hsl.s / 100;
4341 var q = 2 * hsl.l - p;
4343 // initialise the RGB components
4346 'r' : (h + 120) / 60 % 6,
4348 'b' : (h + 240) / 60 % 6
4351 // loop over the RGB components
4352 for (var key in this.rgb){
4354 // ensure that the property is not inherited from the root object
4355 if (this.rgb.hasOwnProperty(key)){
4357 // set the component to its value in the range [0,100]
4358 if (this.rgb[key] < 1){
4359 this.rgb[key] = q + (p - q) * this.rgb[key];
4360 }else if (this.rgb[key] < 3){
4362 }else if (this.rgb[key] < 4){
4363 this.rgb[key] = q + (p - q) * (4 - this.rgb[key]);
4368 // set the component to its value in the range [0,255]
4369 this.rgb[key] *= 2.55;
4379 /* Calculates and stores the HSV components of this HSLColor so that they can
4380 * be returned be the getHSL function.
4382 calculateHSV : function(){
4384 // set a temporary value
4385 var t = this.hsl.s * (this.hsl.l < 50 ? this.hsl.l : 100 - this.hsl.l) / 100;
4387 // store the HSV components
4391 's' : 200 * t / (this.hsl.l + t),
4392 'v' : t + this.hsl.l
4395 // correct a division-by-zero error
4396 if (isNaN(this.hsv.s)) { this.hsv.s = 0; }
4403 * Portions of this file are based on pieces of Yahoo User Interface Library
4404 * Copyright (c) 2007, Yahoo! Inc. All rights reserved.
4405 * YUI licensed under the BSD License:
4406 * http://developer.yahoo.net/yui/license.txt
4407 * <script type="text/javascript">
4412 Roo.lib.ColorAnim = function(el, attributes, duration, method) {
4413 Roo.lib.ColorAnim.superclass.constructor.call(this, el, attributes, duration, method);
4416 Roo.extend(Roo.lib.ColorAnim, Roo.lib.AnimBase);
4418 var fly = Roo.lib.AnimBase.fly;
4420 var superclass = Y.ColorAnim.superclass;
4421 var proto = Y.ColorAnim.prototype;
4423 proto.toString = function() {
4424 var el = this.getEl();
4425 var id = el.id || el.tagName;
4426 return ("ColorAnim " + id);
4429 proto.patterns.color = /color$/i;
4430 proto.patterns.rgb = /^rgb\(([0-9]+)\s*,\s*([0-9]+)\s*,\s*([0-9]+)\)$/i;
4431 proto.patterns.hex = /^#?([0-9A-F]{2})([0-9A-F]{2})([0-9A-F]{2})$/i;
4432 proto.patterns.hex3 = /^#?([0-9A-F]{1})([0-9A-F]{1})([0-9A-F]{1})$/i;
4433 proto.patterns.transparent = /^transparent|rgba\(0, 0, 0, 0\)$/;
4436 proto.parseColor = function(s) {
4437 if (s.length == 3) {
4441 var c = this.patterns.hex.exec(s);
4442 if (c && c.length == 4) {
4443 return [ parseInt(c[1], 16), parseInt(c[2], 16), parseInt(c[3], 16) ];
4446 c = this.patterns.rgb.exec(s);
4447 if (c && c.length == 4) {
4448 return [ parseInt(c[1], 10), parseInt(c[2], 10), parseInt(c[3], 10) ];
4451 c = this.patterns.hex3.exec(s);
4452 if (c && c.length == 4) {
4453 return [ parseInt(c[1] + c[1], 16), parseInt(c[2] + c[2], 16), parseInt(c[3] + c[3], 16) ];
4458 // since this uses fly! - it cant be in ColorAnim (which does not have fly yet..)
4459 proto.getAttribute = function(attr) {
4460 var el = this.getEl();
4461 if (this.patterns.color.test(attr)) {
4462 var val = fly(el).getStyle(attr);
4464 if (this.patterns.transparent.test(val)) {
4465 var parent = el.parentNode;
4466 val = fly(parent).getStyle(attr);
4468 while (parent && this.patterns.transparent.test(val)) {
4469 parent = parent.parentNode;
4470 val = fly(parent).getStyle(attr);
4471 if (parent.tagName.toUpperCase() == 'HTML') {
4477 val = superclass.getAttribute.call(this, attr);
4482 proto.getAttribute = function(attr) {
4483 var el = this.getEl();
4484 if (this.patterns.color.test(attr)) {
4485 var val = fly(el).getStyle(attr);
4487 if (this.patterns.transparent.test(val)) {
4488 var parent = el.parentNode;
4489 val = fly(parent).getStyle(attr);
4491 while (parent && this.patterns.transparent.test(val)) {
4492 parent = parent.parentNode;
4493 val = fly(parent).getStyle(attr);
4494 if (parent.tagName.toUpperCase() == 'HTML') {
4500 val = superclass.getAttribute.call(this, attr);
4506 proto.doMethod = function(attr, start, end) {
4509 if (this.patterns.color.test(attr)) {
4511 for (var i = 0, len = start.length; i < len; ++i) {
4512 val[i] = superclass.doMethod.call(this, attr, start[i], end[i]);
4515 val = 'rgb(' + Math.floor(val[0]) + ',' + Math.floor(val[1]) + ',' + Math.floor(val[2]) + ')';
4518 val = superclass.doMethod.call(this, attr, start, end);
4524 proto.setRuntimeAttribute = function(attr) {
4525 superclass.setRuntimeAttribute.call(this, attr);
4527 if (this.patterns.color.test(attr)) {
4528 var attributes = this.attributes;
4529 var start = this.parseColor(this.runtimeAttributes[attr].start);
4530 var end = this.parseColor(this.runtimeAttributes[attr].end);
4532 if (typeof attributes[attr]['to'] === 'undefined' && typeof attributes[attr]['by'] !== 'undefined') {
4533 end = this.parseColor(attributes[attr].by);
4535 for (var i = 0, len = start.length; i < len; ++i) {
4536 end[i] = start[i] + end[i];
4540 this.runtimeAttributes[attr].start = start;
4541 this.runtimeAttributes[attr].end = end;
4547 * Portions of this file are based on pieces of Yahoo User Interface Library
4548 * Copyright (c) 2007, Yahoo! Inc. All rights reserved.
4549 * YUI licensed under the BSD License:
4550 * http://developer.yahoo.net/yui/license.txt
4551 * <script type="text/javascript">
4557 easeNone: function (t, b, c, d) {
4558 return c * t / d + b;
4562 easeIn: function (t, b, c, d) {
4563 return c * (t /= d) * t + b;
4567 easeOut: function (t, b, c, d) {
4568 return -c * (t /= d) * (t - 2) + b;
4572 easeBoth: function (t, b, c, d) {
4573 if ((t /= d / 2) < 1) {
4574 return c / 2 * t * t + b;
4577 return -c / 2 * ((--t) * (t - 2) - 1) + b;
4581 easeInStrong: function (t, b, c, d) {
4582 return c * (t /= d) * t * t * t + b;
4586 easeOutStrong: function (t, b, c, d) {
4587 return -c * ((t = t / d - 1) * t * t * t - 1) + b;
4591 easeBothStrong: function (t, b, c, d) {
4592 if ((t /= d / 2) < 1) {
4593 return c / 2 * t * t * t * t + b;
4596 return -c / 2 * ((t -= 2) * t * t * t - 2) + b;
4601 elasticIn: function (t, b, c, d, a, p) {
4605 if ((t /= d) == 1) {
4612 if (!a || a < Math.abs(c)) {
4617 var s = p / (2 * Math.PI) * Math.asin(c / a);
4620 return -(a * Math.pow(2, 10 * (t -= 1)) * Math.sin((t * d - s) * (2 * Math.PI) / p)) + b;
4624 elasticOut: function (t, b, c, d, a, p) {
4628 if ((t /= d) == 1) {
4635 if (!a || a < Math.abs(c)) {
4640 var s = p / (2 * Math.PI) * Math.asin(c / a);
4643 return a * Math.pow(2, -10 * t) * Math.sin((t * d - s) * (2 * Math.PI) / p) + c + b;
4647 elasticBoth: function (t, b, c, d, a, p) {
4652 if ((t /= d / 2) == 2) {
4660 if (!a || a < Math.abs(c)) {
4665 var s = p / (2 * Math.PI) * Math.asin(c / a);
4669 return -.5 * (a * Math.pow(2, 10 * (t -= 1)) *
4670 Math.sin((t * d - s) * (2 * Math.PI) / p)) + b;
4672 return a * Math.pow(2, -10 * (t -= 1)) *
4673 Math.sin((t * d - s) * (2 * Math.PI) / p) * .5 + c + b;
4678 backIn: function (t, b, c, d, s) {
4679 if (typeof s == 'undefined') {
4682 return c * (t /= d) * t * ((s + 1) * t - s) + b;
4686 backOut: function (t, b, c, d, s) {
4687 if (typeof s == 'undefined') {
4690 return c * ((t = t / d - 1) * t * ((s + 1) * t + s) + 1) + b;
4694 backBoth: function (t, b, c, d, s) {
4695 if (typeof s == 'undefined') {
4699 if ((t /= d / 2 ) < 1) {
4700 return c / 2 * (t * t * (((s *= (1.525)) + 1) * t - s)) + b;
4702 return c / 2 * ((t -= 2) * t * (((s *= (1.525)) + 1) * t + s) + 2) + b;
4706 bounceIn: function (t, b, c, d) {
4707 return c - Roo.lib.Easing.bounceOut(d - t, 0, c, d) + b;
4711 bounceOut: function (t, b, c, d) {
4712 if ((t /= d) < (1 / 2.75)) {
4713 return c * (7.5625 * t * t) + b;
4714 } else if (t < (2 / 2.75)) {
4715 return c * (7.5625 * (t -= (1.5 / 2.75)) * t + .75) + b;
4716 } else if (t < (2.5 / 2.75)) {
4717 return c * (7.5625 * (t -= (2.25 / 2.75)) * t + .9375) + b;
4719 return c * (7.5625 * (t -= (2.625 / 2.75)) * t + .984375) + b;
4723 bounceBoth: function (t, b, c, d) {
4725 return Roo.lib.Easing.bounceIn(t * 2, 0, c, d) * .5 + b;
4727 return Roo.lib.Easing.bounceOut(t * 2 - d, 0, c, d) * .5 + c * .5 + b;
4730 * Portions of this file are based on pieces of Yahoo User Interface Library
4731 * Copyright (c) 2007, Yahoo! Inc. All rights reserved.
4732 * YUI licensed under the BSD License:
4733 * http://developer.yahoo.net/yui/license.txt
4734 * <script type="text/javascript">
4738 Roo.lib.Motion = function(el, attributes, duration, method) {
4740 Roo.lib.Motion.superclass.constructor.call(this, el, attributes, duration, method);
4744 Roo.extend(Roo.lib.Motion, Roo.lib.ColorAnim);
4748 var superclass = Y.Motion.superclass;
4749 var proto = Y.Motion.prototype;
4751 proto.toString = function() {
4752 var el = this.getEl();
4753 var id = el.id || el.tagName;
4754 return ("Motion " + id);
4757 proto.patterns.points = /^points$/i;
4759 proto.setAttribute = function(attr, val, unit) {
4760 if (this.patterns.points.test(attr)) {
4761 unit = unit || 'px';
4762 superclass.setAttribute.call(this, 'left', val[0], unit);
4763 superclass.setAttribute.call(this, 'top', val[1], unit);
4765 superclass.setAttribute.call(this, attr, val, unit);
4769 proto.getAttribute = function(attr) {
4770 if (this.patterns.points.test(attr)) {
4772 superclass.getAttribute.call(this, 'left'),
4773 superclass.getAttribute.call(this, 'top')
4776 val = superclass.getAttribute.call(this, attr);
4782 proto.doMethod = function(attr, start, end) {
4785 if (this.patterns.points.test(attr)) {
4786 var t = this.method(this.currentFrame, 0, 100, this.totalFrames) / 100;
4787 val = Y.Bezier.getPosition(this.runtimeAttributes[attr], t);
4789 val = superclass.doMethod.call(this, attr, start, end);
4794 proto.setRuntimeAttribute = function(attr) {
4795 if (this.patterns.points.test(attr)) {
4796 var el = this.getEl();
4797 var attributes = this.attributes;
4799 var control = attributes['points']['control'] || [];
4803 if (control.length > 0 && !(control[0] instanceof Array)) {
4804 control = [control];
4807 for (i = 0,len = control.length; i < len; ++i) {
4808 tmp[i] = control[i];
4813 Roo.fly(el).position();
4815 if (isset(attributes['points']['from'])) {
4816 Roo.lib.Dom.setXY(el, attributes['points']['from']);
4819 Roo.lib.Dom.setXY(el, Roo.lib.Dom.getXY(el));
4822 start = this.getAttribute('points');
4825 if (isset(attributes['points']['to'])) {
4826 end = translateValues.call(this, attributes['points']['to'], start);
4828 var pageXY = Roo.lib.Dom.getXY(this.getEl());
4829 for (i = 0,len = control.length; i < len; ++i) {
4830 control[i] = translateValues.call(this, control[i], start);
4834 } else if (isset(attributes['points']['by'])) {
4835 end = [ start[0] + attributes['points']['by'][0], start[1] + attributes['points']['by'][1] ];
4837 for (i = 0,len = control.length; i < len; ++i) {
4838 control[i] = [ start[0] + control[i][0], start[1] + control[i][1] ];
4842 this.runtimeAttributes[attr] = [start];
4844 if (control.length > 0) {
4845 this.runtimeAttributes[attr] = this.runtimeAttributes[attr].concat(control);
4848 this.runtimeAttributes[attr][this.runtimeAttributes[attr].length] = end;
4851 superclass.setRuntimeAttribute.call(this, attr);
4855 var translateValues = function(val, start) {
4856 var pageXY = Roo.lib.Dom.getXY(this.getEl());
4857 val = [ val[0] - pageXY[0] + start[0], val[1] - pageXY[1] + start[1] ];
4862 var isset = function(prop) {
4863 return (typeof prop !== 'undefined');
4867 * Portions of this file are based on pieces of Yahoo User Interface Library
4868 * Copyright (c) 2007, Yahoo! Inc. All rights reserved.
4869 * YUI licensed under the BSD License:
4870 * http://developer.yahoo.net/yui/license.txt
4871 * <script type="text/javascript">
4875 Roo.lib.Scroll = function(el, attributes, duration, method) {
4877 Roo.lib.Scroll.superclass.constructor.call(this, el, attributes, duration, method);
4881 Roo.extend(Roo.lib.Scroll, Roo.lib.ColorAnim);
4885 var superclass = Y.Scroll.superclass;
4886 var proto = Y.Scroll.prototype;
4888 proto.toString = function() {
4889 var el = this.getEl();
4890 var id = el.id || el.tagName;
4891 return ("Scroll " + id);
4894 proto.doMethod = function(attr, start, end) {
4897 if (attr == 'scroll') {
4899 this.method(this.currentFrame, start[0], end[0] - start[0], this.totalFrames),
4900 this.method(this.currentFrame, start[1], end[1] - start[1], this.totalFrames)
4904 val = superclass.doMethod.call(this, attr, start, end);
4909 proto.getAttribute = function(attr) {
4911 var el = this.getEl();
4913 if (attr == 'scroll') {
4914 val = [ el.scrollLeft, el.scrollTop ];
4916 val = superclass.getAttribute.call(this, attr);
4922 proto.setAttribute = function(attr, val, unit) {
4923 var el = this.getEl();
4925 if (attr == 'scroll') {
4926 el.scrollLeft = val[0];
4927 el.scrollTop = val[1];
4929 superclass.setAttribute.call(this, attr, val, unit);
4934 * Originally based of this code... - refactored for Roo...
4935 * https://github.com/aaalsaleh/undo-manager
4938 * @author Abdulrahman Alsaleh
4939 * @copyright 2015 Abdulrahman Alsaleh
4940 * @license MIT License (c)
4942 * Hackily modifyed by alan@roojs.com
4947 * TOTALLY UNTESTED...
4949 * Documentation to be done....
4954 * @class Roo.lib.UndoManager
4955 * An undo manager implementation in JavaScript. It follows the W3C UndoManager and DOM Transaction
4956 * Draft and the undocumented and disabled Mozilla Firefox's UndoManager implementation.
4962 editor.undoManager = new Roo.lib.UndoManager(1000, editor);
4966 * For more information see this blog post with examples:
4967 * <a href="http://www.cnitblog.com/seeyeah/archive/2011/12/30/38728.html/">DomHelper
4968 - Create Elements using DOM, HTML fragments and Templates</a>.
4970 * @param {Number} limit how far back to go ... use 1000?
4971 * @param {Object} scope usually use document..
4974 Roo.lib.UndoManager = function (limit, undoScopeHost)
4978 this.scope = undoScopeHost;
4979 this.fireEvent = typeof CustomEvent != 'undefined' && undoScopeHost && undoScopeHost.dispatchEvent;
4980 if (this.fireEvent) {
4987 Roo.lib.UndoManager.prototype = {
4998 * To push and execute a transaction, the method undoManager.transact
4999 * must be called by passing a transaction object as the first argument, and a merge
5000 * flag as the second argument. A transaction object has the following properties:
5004 undoManager.transact({
5006 execute: function() { ... },
5007 undo: function() { ... },
5008 // redo same as execute
5009 redo: function() { this.execute(); }
5012 // merge transaction
5013 undoManager.transact({
5015 execute: function() { ... }, // this will be run...
5016 undo: function() { ... }, // what to do when undo is run.
5017 // redo same as execute
5018 redo: function() { this.execute(); }
5023 * @param {Object} transaction The transaction to add to the stack.
5024 * @return {String} The HTML fragment
5028 transact : function (transaction, merge)
5030 if (arguments.length < 2) {
5031 throw new TypeError('Not enough arguments to UndoManager.transact.');
5034 transaction.execute();
5036 this.stack.splice(0, this.position);
5037 if (merge && this.length) {
5038 this.stack[0].push(transaction);
5040 this.stack.unshift([transaction]);
5045 if (this.limit && this.stack.length > this.limit) {
5046 this.length = this.stack.length = this.limit;
5048 this.length = this.stack.length;
5051 if (this.fireEvent) {
5052 this.scope.dispatchEvent(
5053 new CustomEvent('DOMTransaction', {
5055 transactions: this.stack[0].slice()
5063 //Roo.log("transaction: pos:" + this.position + " len: " + this.length + " slen:" + this.stack.length);
5070 //Roo.log("undo: pos:" + this.position + " len: " + this.length + " slen:" + this.stack.length);
5072 if (this.position < this.length) {
5073 for (var i = this.stack[this.position].length - 1; i >= 0; i--) {
5074 this.stack[this.position][i].undo();
5078 if (this.fireEvent) {
5079 this.scope.dispatchEvent(
5080 new CustomEvent('undo', {
5082 transactions: this.stack[this.position - 1].slice()
5094 if (this.position > 0) {
5095 for (var i = 0, n = this.stack[this.position - 1].length; i < n; i++) {
5096 this.stack[this.position - 1][i].redo();
5100 if (this.fireEvent) {
5101 this.scope.dispatchEvent(
5102 new CustomEvent('redo', {
5104 transactions: this.stack[this.position].slice()
5114 item : function (index)
5116 if (index >= 0 && index < this.length) {
5117 return this.stack[index].slice();
5122 clearUndo : function () {
5123 this.stack.length = this.length = this.position;
5126 clearRedo : function () {
5127 this.stack.splice(0, this.position);
5129 this.length = this.stack.length;
5132 * Reset the undo - probaly done on load to clear all history.
5139 this.current_html = this.scope.innerHTML;
5140 if (this.timer !== false) {
5141 clearTimeout(this.timer);
5153 // this will handle the undo/redo on the element.?
5154 bindEvents : function()
5156 var el = this.scope;
5157 el.undoManager = this;
5160 this.scope.addEventListener('keydown', function(e) {
5161 if ((e.ctrlKey || e.metaKey) && e.keyCode === 90) {
5163 el.undoManager.redo(); // Ctrl/Command + Shift + Z
5165 el.undoManager.undo(); // Ctrl/Command + Z
5172 this.scope.addEventListener('keyup', function(e) {
5173 if ((e.ctrlKey || e.metaKey) && e.keyCode === 90) {
5182 el.addEventListener('input', function(e) {
5183 if(el.innerHTML == t.current_html) {
5186 // only record events every second.
5187 if (t.timer !== false) {
5188 clearTimeout(t.timer);
5191 t.timer = setTimeout(function() { t.merge = false; }, 1000);
5193 t.addEvent(t.merge);
5194 t.merge = true; // ignore changes happening every second..
5198 * Manually add an event.
5199 * Normall called without arguements - and it will just get added to the stack.
5203 addEvent : function(merge)
5205 //Roo.log("undomanager +" + (merge ? 'Y':'n'));
5206 // not sure if this should clear the timer
5207 merge = typeof(merge) == 'undefined' ? false : merge;
5209 this.scope.undoManager.transact({
5211 oldHTML: this.current_html,
5212 newHTML: this.scope.innerHTML,
5213 // nothing to execute (content already changed when input is fired)
5214 execute: function() { },
5216 this.scope.innerHTML = this.current_html = this.oldHTML;
5219 this.scope.innerHTML = this.current_html = this.newHTML;
5221 }, false); //merge);
5225 this.current_html = this.scope.innerHTML;
5235 * @class Roo.lib.Range
5237 * This is a toolkit, normally used to copy features into a Dom Range element
5238 * Roo.lib.Range.wrap(x);
5243 Roo.lib.Range = function() { };
5246 * Wrap a Dom Range object, to give it new features...
5248 * @param {Range} the range to wrap
5250 Roo.lib.Range.wrap = function(r) {
5251 return Roo.apply(r, Roo.lib.Range.prototype);
5254 * find a parent node eg. LI / OL
5255 * @param {string|Array} node name or array of nodenames
5256 * @return {DomElement|false}
5258 Roo.apply(Roo.lib.Range.prototype,
5261 closest : function(str)
5263 if (typeof(str) != 'string') {
5264 // assume it's a array.
5265 for(var i = 0;i < str.length;i++) {
5266 var r = this.closest(str[i]);
5274 str = str.toLowerCase();
5275 var n = this.commonAncestorContainer; // might not be a node
5276 while (n.nodeType != 1) {
5280 if (n.nodeName.toLowerCase() == str ) {
5283 if (n.nodeName.toLowerCase() == 'body') {
5287 return n.closest(str) || false;
5290 cloneRange : function()
5292 return Roo.lib.Range.wrap(Range.prototype.cloneRange.call(this));
5295 * @class Roo.lib.Selection
5297 * This is a toolkit, normally used to copy features into a Dom Selection element
5298 * Roo.lib.Selection.wrap(x);
5303 Roo.lib.Selection = function() { };
5306 * Wrap a Dom Range object, to give it new features...
5308 * @param {Range} the range to wrap
5310 Roo.lib.Selection.wrap = function(r, doc) {
5311 Roo.apply(r, Roo.lib.Selection.prototype);
5312 r.ownerDocument = doc; // usefull so we dont have to keep referening to it.
5316 * find a parent node eg. LI / OL
5317 * @param {string|Array} node name or array of nodenames
5318 * @return {DomElement|false}
5320 Roo.apply(Roo.lib.Selection.prototype,
5323 * the owner document
5325 ownerDocument : false,
5327 getRangeAt : function(n)
5329 return Roo.lib.Range.wrap(Selection.prototype.getRangeAt.call(this,n));
5333 * insert node at selection
5334 * @param {DomElement|string} node
5335 * @param {string} cursor (after|in|none) where to place the cursor after inserting.
5337 insertNode: function(node, cursor)
5339 if (typeof(node) == 'string') {
5340 node = this.ownerDocument.createElement(node);
5341 if (cursor == 'in') {
5342 node.innerHTML = ' ';
5346 var range = this.getRangeAt(0);
5348 if (this.type != 'Caret') {
5349 range.deleteContents();
5351 var sn = node.childNodes[0]; // select the contents.
5355 range.insertNode(node);
5356 if (cursor == 'after') {
5357 node.insertAdjacentHTML('afterend', ' ');
5358 sn = node.nextSibling;
5361 if (cursor == 'none') {
5365 this.cursorText(sn);
5368 cursorText : function(n)
5371 //var range = this.getRangeAt(0);
5372 range = Roo.lib.Range.wrap(new Range());
5373 //range.selectNode(n);
5375 var ix = Array.from(n.parentNode.childNodes).indexOf(n);
5376 range.setStart(n.parentNode,ix);
5377 range.setEnd(n.parentNode,ix+1);
5378 //range.collapse(false);
5380 this.removeAllRanges();
5381 this.addRange(range);
5383 Roo.log([n, range, this,this.baseOffset,this.extentOffset, this.type]);
5385 cursorAfter : function(n)
5387 if (!n.nextSibling || n.nextSibling.nodeValue != ' ') {
5388 n.insertAdjacentHTML('afterend', ' ');
5390 this.cursorText (n.nextSibling);
5396 * Ext JS Library 1.1.1
5397 * Copyright(c) 2006-2007, Ext JS, LLC.
5399 * Originally Released Under LGPL - original licence link has changed is not relivant.
5402 * <script type="text/javascript">
5406 // nasty IE9 hack - what a pile of crap that is..
5408 if (typeof Range != "undefined" && typeof Range.prototype.createContextualFragment == "undefined") {
5409 Range.prototype.createContextualFragment = function (html) {
5410 var doc = window.document;
5411 var container = doc.createElement("div");
5412 container.innerHTML = html;
5413 var frag = doc.createDocumentFragment(), n;
5414 while ((n = container.firstChild)) {
5415 frag.appendChild(n);
5422 * @class Roo.DomHelper
5423 * Utility class for working with DOM and/or Templates. It transparently supports using HTML fragments or DOM.
5424 * 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>.
5427 Roo.DomHelper = function(){
5428 var tempTableEl = null;
5429 var emptyTags = /^(?:br|frame|hr|img|input|link|meta|range|spacer|wbr|area|param|col)$/i;
5430 var tableRe = /^table|tbody|tr|td$/i;
5432 // build as innerHTML where available
5434 var createHtml = function(o){
5435 if(typeof o == 'string'){
5444 if(attr == "tag" || attr == "children" || attr == "cn" || attr == "html" || typeof o[attr] == "function") { continue; }
5445 if(attr == "style"){
5447 if(typeof s == "function"){
5450 if(typeof s == "string"){
5451 b += ' style="' + s + '"';
5452 }else if(typeof s == "object"){
5455 if(typeof s[key] != "function"){
5456 b += key + ":" + s[key] + ";";
5463 b += ' class="' + o["cls"] + '"';
5464 }else if(attr == "htmlFor"){
5465 b += ' for="' + o["htmlFor"] + '"';
5467 b += " " + attr + '="' + o[attr] + '"';
5471 if(emptyTags.test(o.tag)){
5475 var cn = o.children || o.cn;
5477 //http://bugs.kde.org/show_bug.cgi?id=71506
5478 if((cn instanceof Array) || (Roo.isSafari && typeof(cn.join) == "function")){
5479 for(var i = 0, len = cn.length; i < len; i++) {
5480 b += createHtml(cn[i], b);
5483 b += createHtml(cn, b);
5489 b += "</" + o.tag + ">";
5496 var createDom = function(o, parentNode){
5498 // defininition craeted..
5500 if (o.ns && o.ns != 'html') {
5502 if (o.xmlns && typeof(xmlns[o.ns]) == 'undefined') {
5503 xmlns[o.ns] = o.xmlns;
5506 if (typeof(xmlns[o.ns]) == 'undefined') {
5507 console.log("Trying to create namespace element " + o.ns + ", however no xmlns was sent to builder previously");
5513 if (typeof(o) == 'string') {
5514 return parentNode.appendChild(document.createTextNode(o));
5516 o.tag = o.tag || div;
5517 if (o.ns && Roo.isIE) {
5519 o.tag = o.ns + ':' + o.tag;
5522 var el = ns ? document.createElementNS( ns, o.tag||'div') : document.createElement(o.tag||'div');
5523 var useSet = el.setAttribute ? true : false; // In IE some elements don't have setAttribute
5526 if(attr == "tag" || attr == "ns" ||attr == "xmlns" ||attr == "children" || attr == "cn" || attr == "html" ||
5527 attr == "style" || typeof o[attr] == "function") { continue; }
5529 if(attr=="cls" && Roo.isIE){
5530 el.className = o["cls"];
5532 if(useSet) { el.setAttribute(attr=="cls" ? 'class' : attr, o[attr]);}
5538 Roo.DomHelper.applyStyles(el, o.style);
5539 var cn = o.children || o.cn;
5541 //http://bugs.kde.org/show_bug.cgi?id=71506
5542 if((cn instanceof Array) || (Roo.isSafari && typeof(cn.join) == "function")){
5543 for(var i = 0, len = cn.length; i < len; i++) {
5544 createDom(cn[i], el);
5551 el.innerHTML = o.html;
5554 parentNode.appendChild(el);
5559 var ieTable = function(depth, s, h, e){
5560 tempTableEl.innerHTML = [s, h, e].join('');
5561 var i = -1, el = tempTableEl;
5562 while(++i < depth && el.firstChild){
5568 // kill repeat to save bytes
5572 tbe = '</tbody>'+te,
5578 * Nasty code for IE's broken table implementation
5580 var insertIntoTable = function(tag, where, el, html){
5582 tempTableEl = document.createElement('div');
5587 if(where == 'afterbegin' || where == 'beforeend'){ // INTO a TD
5590 if(where == 'beforebegin'){
5594 before = el.nextSibling;
5597 node = ieTable(4, trs, html, tre);
5599 else if(tag == 'tr'){
5600 if(where == 'beforebegin'){
5603 node = ieTable(3, tbs, html, tbe);
5604 } else if(where == 'afterend'){
5605 before = el.nextSibling;
5607 node = ieTable(3, tbs, html, tbe);
5608 } else{ // INTO a TR
5609 if(where == 'afterbegin'){
5610 before = el.firstChild;
5612 node = ieTable(4, trs, html, tre);
5614 } else if(tag == 'tbody'){
5615 if(where == 'beforebegin'){
5618 node = ieTable(2, ts, html, te);
5619 } else if(where == 'afterend'){
5620 before = el.nextSibling;
5622 node = ieTable(2, ts, html, te);
5624 if(where == 'afterbegin'){
5625 before = el.firstChild;
5627 node = ieTable(3, tbs, html, tbe);
5630 if(where == 'beforebegin' || where == 'afterend'){ // OUTSIDE the table
5633 if(where == 'afterbegin'){
5634 before = el.firstChild;
5636 node = ieTable(2, ts, html, te);
5638 el.insertBefore(node, before);
5642 // this is a bit like the react update code...
5645 var updateNode = function(from, to)
5647 // should we handle non-standard elements?
5648 Roo.log(["UpdateNode" , from, to]);
5649 if (from.nodeType != to.nodeType) {
5650 Roo.log(["ReplaceChild - mismatch notType" , to, from ]);
5651 from.parentNode.replaceChild(to, from);
5654 if (from.nodeType == 3) {
5655 // assume it's text?!
5656 if (from.data == to.data) {
5659 from.data = to.data;
5662 if (!from.parentNode) {
5663 // not sure why this is happening?
5666 // assume 'to' doesnt have '1/3 nodetypes!
5667 // not sure why, by from, parent node might not exist?
5668 if (from.nodeType !=1 || from.tagName != to.tagName) {
5669 Roo.log(["ReplaceChild" , from, to ]);
5671 from.parentNode.replaceChild(to, from);
5674 // compare attributes
5675 var ar = Array.from(from.attributes);
5676 for(var i = 0; i< ar.length;i++) {
5677 if (to.hasAttribute(ar[i].name)) {
5680 if (ar[i].name == 'id') { // always keep ids?
5683 //if (ar[i].name == 'style') {
5684 // throw "style removed?";
5686 Roo.log("removeAttribute" + ar[i].name);
5687 from.removeAttribute(ar[i].name);
5690 for(var i = 0; i< ar.length;i++) {
5691 if (from.getAttribute(ar[i].name) == to.getAttribute(ar[i].name)) {
5692 Roo.log("skipAttribute " + ar[i].name + '=' + to.getAttribute(ar[i].name));
5695 Roo.log("updateAttribute " + ar[i].name + '=>' + to.getAttribute(ar[i].name));
5696 from.setAttribute(ar[i].name, to.getAttribute(ar[i].name));
5699 var far = Array.from(from.childNodes);
5700 var tar = Array.from(to.childNodes);
5701 // if the lengths are different.. then it's probably a editable content change, rather than
5702 // a change of the block definition..
5704 // this did notwork , as our rebuilt nodes did not include ID's so did not match at all.
5705 /*if (from.innerHTML == to.innerHTML) {
5708 if (far.length != tar.length) {
5709 from.innerHTML = to.innerHTML;
5714 for(var i = 0; i < Math.max(tar.length, far.length); i++) {
5715 if (i >= far.length) {
5716 from.appendChild(tar[i]);
5717 Roo.log(["add", tar[i]]);
5719 } else if ( i >= tar.length) {
5720 from.removeChild(far[i]);
5721 Roo.log(["remove", far[i]]);
5724 updateNode(far[i], tar[i]);
5736 /** True to force the use of DOM instead of html fragments @type Boolean */
5740 * Returns the markup for the passed Element(s) config
5741 * @param {Object} o The Dom object spec (and children)
5744 markup : function(o){
5745 return createHtml(o);
5749 * Applies a style specification to an element
5750 * @param {String/HTMLElement} el The element to apply styles to
5751 * @param {String/Object/Function} styles A style specification string eg "width:100px", or object in the form {width:"100px"}, or
5752 * a function which returns such a specification.
5754 applyStyles : function(el, styles){
5757 if(typeof styles == "string"){
5758 var re = /\s?([a-z\-]*)\:\s?([^;]*);?/gi;
5760 while ((matches = re.exec(styles)) != null){
5761 el.setStyle(matches[1], matches[2]);
5763 }else if (typeof styles == "object"){
5764 for (var style in styles){
5765 el.setStyle(style, styles[style]);
5767 }else if (typeof styles == "function"){
5768 Roo.DomHelper.applyStyles(el, styles.call());
5774 * Inserts an HTML fragment into the Dom
5775 * @param {String} where Where to insert the html in relation to el - beforeBegin, afterBegin, beforeEnd, afterEnd.
5776 * @param {HTMLElement} el The context element
5777 * @param {String} html The HTML fragmenet
5778 * @return {HTMLElement} The new node
5780 insertHtml : function(where, el, html){
5781 where = where.toLowerCase();
5782 if(el.insertAdjacentHTML){
5783 if(tableRe.test(el.tagName)){
5785 if(rs = insertIntoTable(el.tagName.toLowerCase(), where, el, html)){
5791 el.insertAdjacentHTML('BeforeBegin', html);
5792 return el.previousSibling;
5794 el.insertAdjacentHTML('AfterBegin', html);
5795 return el.firstChild;
5797 el.insertAdjacentHTML('BeforeEnd', html);
5798 return el.lastChild;
5800 el.insertAdjacentHTML('AfterEnd', html);
5801 return el.nextSibling;
5803 throw 'Illegal insertion point -> "' + where + '"';
5805 var range = el.ownerDocument.createRange();
5809 range.setStartBefore(el);
5810 frag = range.createContextualFragment(html);
5811 el.parentNode.insertBefore(frag, el);
5812 return el.previousSibling;
5815 range.setStartBefore(el.firstChild);
5816 frag = range.createContextualFragment(html);
5817 el.insertBefore(frag, el.firstChild);
5818 return el.firstChild;
5820 el.innerHTML = html;
5821 return el.firstChild;
5825 range.setStartAfter(el.lastChild);
5826 frag = range.createContextualFragment(html);
5827 el.appendChild(frag);
5828 return el.lastChild;
5830 el.innerHTML = html;
5831 return el.lastChild;
5834 range.setStartAfter(el);
5835 frag = range.createContextualFragment(html);
5836 el.parentNode.insertBefore(frag, el.nextSibling);
5837 return el.nextSibling;
5839 throw 'Illegal insertion point -> "' + where + '"';
5843 * Creates new Dom element(s) and inserts them before el
5844 * @param {String/HTMLElement/Element} el The context element
5845 * @param {Object/String} o The Dom object spec (and children) or raw HTML blob
5846 * @param {Boolean} returnElement (optional) true to return a Roo.Element
5847 * @return {HTMLElement/Roo.Element} The new node
5849 insertBefore : function(el, o, returnElement){
5850 return this.doInsert(el, o, returnElement, "beforeBegin");
5854 * Creates new Dom element(s) and inserts them after el
5855 * @param {String/HTMLElement/Element} el The context element
5856 * @param {Object} o The Dom object spec (and children)
5857 * @param {Boolean} returnElement (optional) true to return a Roo.Element
5858 * @return {HTMLElement/Roo.Element} The new node
5860 insertAfter : function(el, o, returnElement){
5861 return this.doInsert(el, o, returnElement, "afterEnd", "nextSibling");
5865 * Creates new Dom element(s) and inserts them as the first child of el
5866 * @param {String/HTMLElement/Element} el The context element
5867 * @param {Object/String} o The Dom object spec (and children) or raw HTML blob
5868 * @param {Boolean} returnElement (optional) true to return a Roo.Element
5869 * @return {HTMLElement/Roo.Element} The new node
5871 insertFirst : function(el, o, returnElement){
5872 return this.doInsert(el, o, returnElement, "afterBegin");
5876 doInsert : function(el, o, returnElement, pos, sibling){
5877 el = Roo.getDom(el);
5879 if(this.useDom || o.ns){
5880 newNode = createDom(o, null);
5881 el.parentNode.insertBefore(newNode, sibling ? el[sibling] : el);
5883 var html = createHtml(o);
5884 newNode = this.insertHtml(pos, el, html);
5886 return returnElement ? Roo.get(newNode, true) : newNode;
5890 * Creates new Dom element(s) and appends them to el
5891 * @param {String/HTMLElement/Element} el The context element
5892 * @param {Object/String} o The Dom object spec (and children) or raw HTML blob
5893 * @param {Boolean} returnElement (optional) true to return a Roo.Element
5894 * @return {HTMLElement/Roo.Element} The new node
5896 append : function(el, o, returnElement){
5897 el = Roo.getDom(el);
5899 if(this.useDom || o.ns){
5900 newNode = createDom(o, null);
5901 el.appendChild(newNode);
5903 var html = createHtml(o);
5904 newNode = this.insertHtml("beforeEnd", el, html);
5906 return returnElement ? Roo.get(newNode, true) : newNode;
5910 * Creates new Dom element(s) and overwrites the contents of el with them
5911 * @param {String/HTMLElement/Element} el The context element
5912 * @param {Object/String} o The Dom object spec (and children) or raw HTML blob
5913 * @param {Boolean} returnElement (optional) true to return a Roo.Element
5914 * @return {HTMLElement/Roo.Element} The new node
5916 overwrite : function(el, o, returnElement)
5918 el = Roo.getDom(el);
5921 while (el.childNodes.length) {
5922 el.removeChild(el.firstChild);
5926 el.innerHTML = createHtml(o);
5929 return returnElement ? Roo.get(el.firstChild, true) : el.firstChild;
5933 * Creates a new Roo.DomHelper.Template from the Dom object spec
5934 * @param {Object} o The Dom object spec (and children)
5935 * @return {Roo.DomHelper.Template} The new template
5937 createTemplate : function(o){
5938 var html = createHtml(o);
5939 return new Roo.Template(html);
5942 * Updates the first element with the spec from the o (replacing if necessary)
5943 * This iterates through the children, and updates attributes / children etc..
5944 * @param {String/HTMLElement/Element} el The context element
5945 * @param {Object/String} o The Dom object spec (and children) or raw HTML blob
5948 update : function(el, o)
5950 updateNode(Roo.getDom(el), createDom(o));
5959 * Ext JS Library 1.1.1
5960 * Copyright(c) 2006-2007, Ext JS, LLC.
5962 * Originally Released Under LGPL - original licence link has changed is not relivant.
5965 * <script type="text/javascript">
5969 * @class Roo.Template
5970 * Represents an HTML fragment template. Templates can be precompiled for greater performance.
5971 * For a list of available format functions, see {@link Roo.util.Format}.<br />
5974 var t = new Roo.Template({
5975 html : '<div name="{id}">' +
5976 '<span class="{cls}">{name:trim} {someval:this.myformat}{value:ellipsis(10)}</span>' +
5978 myformat: function (value, allValues) {
5979 return 'XX' + value;
5982 t.append('some-element', {id: 'myid', cls: 'myclass', name: 'foo', value: 'bar'});
5984 * For more information see this blog post with examples:
5985 * <a href="http://www.cnitblog.com/seeyeah/archive/2011/12/30/38728.html/">DomHelper
5986 - Create Elements using DOM, HTML fragments and Templates</a>.
5988 * @param {Object} cfg - Configuration object.
5990 Roo.Template = function(cfg){
5992 if(cfg instanceof Array){
5994 }else if(arguments.length > 1){
5995 cfg = Array.prototype.join.call(arguments, "");
5999 if (typeof(cfg) == 'object') {
6010 Roo.Template.prototype = {
6013 * @cfg {Function} onLoad Called after the template has been loaded and complied (usually from a remove source)
6019 * @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..
6020 * it should be fixed so that template is observable...
6024 * @cfg {String} html The HTML fragment or an array of fragments to join("") or multiple arguments to join("")
6032 * Returns an HTML fragment of this template with the specified values applied.
6033 * @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'})
6034 * @return {String} The HTML fragment
6039 applyTemplate : function(values){
6040 //Roo.log(["applyTemplate", values]);
6044 return this.compiled(values);
6046 var useF = this.disableFormats !== true;
6047 var fm = Roo.util.Format, tpl = this;
6048 var fn = function(m, name, format, args){
6050 if(format.substr(0, 5) == "this."){
6051 return tpl.call(format.substr(5), values[name], values);
6054 // quoted values are required for strings in compiled templates,
6055 // but for non compiled we need to strip them
6056 // quoted reversed for jsmin
6057 var re = /^\s*['"](.*)["']\s*$/;
6058 args = args.split(',');
6059 for(var i = 0, len = args.length; i < len; i++){
6060 args[i] = args[i].replace(re, "$1");
6062 args = [values[name]].concat(args);
6064 args = [values[name]];
6066 return fm[format].apply(fm, args);
6069 return values[name] !== undefined ? values[name] : "";
6072 return this.html.replace(this.re, fn);
6090 this.loading = true;
6091 this.compiled = false;
6093 var cx = new Roo.data.Connection();
6097 success : function (response) {
6101 _t.set(response.responseText,true);
6107 failure : function(response) {
6108 Roo.log("Template failed to load from " + _t.url);
6115 * Sets the HTML used as the template and optionally compiles it.
6116 * @param {String} html
6117 * @param {Boolean} compile (optional) True to compile the template (defaults to undefined)
6118 * @return {Roo.Template} this
6120 set : function(html, compile){
6122 this.compiled = false;
6130 * True to disable format functions (defaults to false)
6133 disableFormats : false,
6136 * The regular expression used to match template variables
6140 re : /\{([\w-]+)(?:\:([\w\.]*)(?:\((.*?)?\))?)?\}/g,
6143 * Compiles the template into an internal function, eliminating the RegEx overhead.
6144 * @return {Roo.Template} this
6146 compile : function(){
6147 var fm = Roo.util.Format;
6148 var useF = this.disableFormats !== true;
6149 var sep = Roo.isGecko ? "+" : ",";
6150 var fn = function(m, name, format, args){
6152 args = args ? ',' + args : "";
6153 if(format.substr(0, 5) != "this."){
6154 format = "fm." + format + '(';
6156 format = 'this.call("'+ format.substr(5) + '", ';
6160 args= ''; format = "(values['" + name + "'] == undefined ? '' : ";
6162 return "'"+ sep + format + "values['" + name + "']" + args + ")"+sep+"'";
6165 // branched to use + in gecko and [].join() in others
6167 body = "this.compiled = function(values){ return '" +
6168 this.html.replace(/\\/g, '\\\\').replace(/(\r\n|\n)/g, '\\n').replace(/'/g, "\\'").replace(this.re, fn) +
6171 body = ["this.compiled = function(values){ return ['"];
6172 body.push(this.html.replace(/\\/g, '\\\\').replace(/(\r\n|\n)/g, '\\n').replace(/'/g, "\\'").replace(this.re, fn));
6173 body.push("'].join('');};");
6174 body = body.join('');
6184 // private function used to call members
6185 call : function(fnName, value, allValues){
6186 return this[fnName](value, allValues);
6190 * Applies the supplied values to the template and inserts the new node(s) as the first child of el.
6191 * @param {String/HTMLElement/Roo.Element} el The context element
6192 * @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'})
6193 * @param {Boolean} returnElement (optional) true to return a Roo.Element (defaults to undefined)
6194 * @return {HTMLElement/Roo.Element} The new node or Element
6196 insertFirst: function(el, values, returnElement){
6197 return this.doInsert('afterBegin', el, values, returnElement);
6201 * Applies the supplied values to the template and inserts the new node(s) before el.
6202 * @param {String/HTMLElement/Roo.Element} el The context element
6203 * @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'})
6204 * @param {Boolean} returnElement (optional) true to return a Roo.Element (defaults to undefined)
6205 * @return {HTMLElement/Roo.Element} The new node or Element
6207 insertBefore: function(el, values, returnElement){
6208 return this.doInsert('beforeBegin', el, values, returnElement);
6212 * Applies the supplied values to the template and inserts the new node(s) after el.
6213 * @param {String/HTMLElement/Roo.Element} el The context element
6214 * @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'})
6215 * @param {Boolean} returnElement (optional) true to return a Roo.Element (defaults to undefined)
6216 * @return {HTMLElement/Roo.Element} The new node or Element
6218 insertAfter : function(el, values, returnElement){
6219 return this.doInsert('afterEnd', el, values, returnElement);
6223 * Applies the supplied values to the template and appends the new node(s) to el.
6224 * @param {String/HTMLElement/Roo.Element} el The context element
6225 * @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'})
6226 * @param {Boolean} returnElement (optional) true to return a Roo.Element (defaults to undefined)
6227 * @return {HTMLElement/Roo.Element} The new node or Element
6229 append : function(el, values, returnElement){
6230 return this.doInsert('beforeEnd', el, values, returnElement);
6233 doInsert : function(where, el, values, returnEl){
6234 el = Roo.getDom(el);
6235 var newNode = Roo.DomHelper.insertHtml(where, el, this.applyTemplate(values));
6236 return returnEl ? Roo.get(newNode, true) : newNode;
6240 * Applies the supplied values to the template and overwrites the content of el with the new node(s).
6241 * @param {String/HTMLElement/Roo.Element} el The context element
6242 * @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'})
6243 * @param {Boolean} returnElement (optional) true to return a Roo.Element (defaults to undefined)
6244 * @return {HTMLElement/Roo.Element} The new node or Element
6246 overwrite : function(el, values, returnElement){
6247 el = Roo.getDom(el);
6248 el.innerHTML = this.applyTemplate(values);
6249 return returnElement ? Roo.get(el.firstChild, true) : el.firstChild;
6253 * Alias for {@link #applyTemplate}
6256 Roo.Template.prototype.apply = Roo.Template.prototype.applyTemplate;
6259 Roo.DomHelper.Template = Roo.Template;
6262 * Creates a template from the passed element's value (<i>display:none</i> textarea, preferred) or innerHTML.
6263 * @param {String/HTMLElement} el A DOM element or its id
6264 * @returns {Roo.Template} The created template
6267 Roo.Template.from = function(el){
6268 el = Roo.getDom(el);
6269 return new Roo.Template(el.value || el.innerHTML);
6272 * Ext JS Library 1.1.1
6273 * Copyright(c) 2006-2007, Ext JS, LLC.
6275 * Originally Released Under LGPL - original licence link has changed is not relivant.
6278 * <script type="text/javascript">
6283 * This is code is also distributed under MIT license for use
6284 * with jQuery and prototype JavaScript libraries.
6287 * @class Roo.DomQuery
6288 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).
6290 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>
6293 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.
6295 <h4>Element Selectors:</h4>
6297 <li> <b>*</b> any element</li>
6298 <li> <b>E</b> an element with the tag E</li>
6299 <li> <b>E F</b> All descendent elements of E that have the tag F</li>
6300 <li> <b>E > F</b> or <b>E/F</b> all direct children elements of E that have the tag F</li>
6301 <li> <b>E + F</b> all elements with the tag F that are immediately preceded by an element with the tag E</li>
6302 <li> <b>E ~ F</b> all elements with the tag F that are preceded by a sibling element with the tag E</li>
6304 <h4>Attribute Selectors:</h4>
6305 <p>The use of @ and quotes are optional. For example, div[@foo='bar'] is also a valid attribute selector.</p>
6307 <li> <b>E[foo]</b> has an attribute "foo"</li>
6308 <li> <b>E[foo=bar]</b> has an attribute "foo" that equals "bar"</li>
6309 <li> <b>E[foo^=bar]</b> has an attribute "foo" that starts with "bar"</li>
6310 <li> <b>E[foo$=bar]</b> has an attribute "foo" that ends with "bar"</li>
6311 <li> <b>E[foo*=bar]</b> has an attribute "foo" that contains the substring "bar"</li>
6312 <li> <b>E[foo%=2]</b> has an attribute "foo" that is evenly divisible by 2</li>
6313 <li> <b>E[foo!=bar]</b> has an attribute "foo" that does not equal "bar"</li>
6315 <h4>Pseudo Classes:</h4>
6317 <li> <b>E:first-child</b> E is the first child of its parent</li>
6318 <li> <b>E:last-child</b> E is the last child of its parent</li>
6319 <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>
6320 <li> <b>E:nth-child(odd)</b> E is an odd child of its parent</li>
6321 <li> <b>E:nth-child(even)</b> E is an even child of its parent</li>
6322 <li> <b>E:only-child</b> E is the only child of its parent</li>
6323 <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>
6324 <li> <b>E:first</b> the first E in the resultset</li>
6325 <li> <b>E:last</b> the last E in the resultset</li>
6326 <li> <b>E:nth(<i>n</i>)</b> the <i>n</i>th E in the resultset (1 based)</li>
6327 <li> <b>E:odd</b> shortcut for :nth-child(odd)</li>
6328 <li> <b>E:even</b> shortcut for :nth-child(even)</li>
6329 <li> <b>E:contains(foo)</b> E's innerHTML contains the substring "foo"</li>
6330 <li> <b>E:nodeValue(foo)</b> E contains a textNode with a nodeValue that equals "foo"</li>
6331 <li> <b>E:not(S)</b> an E element that does not match simple selector S</li>
6332 <li> <b>E:has(S)</b> an E element that has a descendent that matches simple selector S</li>
6333 <li> <b>E:next(S)</b> an E element whose next sibling matches simple selector S</li>
6334 <li> <b>E:prev(S)</b> an E element whose previous sibling matches simple selector S</li>
6336 <h4>CSS Value Selectors:</h4>
6338 <li> <b>E{display=none}</b> css value "display" that equals "none"</li>
6339 <li> <b>E{display^=none}</b> css value "display" that starts with "none"</li>
6340 <li> <b>E{display$=none}</b> css value "display" that ends with "none"</li>
6341 <li> <b>E{display*=none}</b> css value "display" that contains the substring "none"</li>
6342 <li> <b>E{display%=2}</b> css value "display" that is evenly divisible by 2</li>
6343 <li> <b>E{display!=none}</b> css value "display" that does not equal "none"</li>
6347 Roo.DomQuery = function(){
6348 var cache = {}, simpleCache = {}, valueCache = {};
6349 var nonSpace = /\S/;
6350 var trimRe = /^\s+|\s+$/g;
6351 var tplRe = /\{(\d+)\}/g;
6352 var modeRe = /^(\s?[\/>+~]\s?|\s|$)/;
6353 var tagTokenRe = /^(#)?([\w-\*]+)/;
6354 var nthRe = /(\d*)n\+?(\d*)/, nthRe2 = /\D/;
6356 function child(p, index){
6358 var n = p.firstChild;
6360 if(n.nodeType == 1){
6371 while((n = n.nextSibling) && n.nodeType != 1);
6376 while((n = n.previousSibling) && n.nodeType != 1);
6380 function children(d){
6381 var n = d.firstChild, ni = -1;
6383 var nx = n.nextSibling;
6384 if(n.nodeType == 3 && !nonSpace.test(n.nodeValue)){
6394 function byClassName(c, a, v){
6398 var r = [], ri = -1, cn;
6399 for(var i = 0, ci; ci = c[i]; i++){
6403 ( (ci instanceof SVGElement) ? ci.className.baseVal : ci.className)
6404 +' ').indexOf(v) != -1){
6411 function attrValue(n, attr){
6412 if(!n.tagName && typeof n.length != "undefined"){
6421 if(attr == "class" || attr == "className"){
6422 return (n instanceof SVGElement) ? n.className.baseVal : n.className;
6424 return n.getAttribute(attr) || n[attr];
6428 function getNodes(ns, mode, tagName){
6429 var result = [], ri = -1, cs;
6433 tagName = tagName || "*";
6434 if(typeof ns.getElementsByTagName != "undefined"){
6438 for(var i = 0, ni; ni = ns[i]; i++){
6439 cs = ni.getElementsByTagName(tagName);
6440 for(var j = 0, ci; ci = cs[j]; j++){
6444 }else if(mode == "/" || mode == ">"){
6445 var utag = tagName.toUpperCase();
6446 for(var i = 0, ni, cn; ni = ns[i]; i++){
6447 cn = ni.children || ni.childNodes;
6448 for(var j = 0, cj; cj = cn[j]; j++){
6449 if(cj.nodeName == utag || cj.nodeName == tagName || tagName == '*'){
6454 }else if(mode == "+"){
6455 var utag = tagName.toUpperCase();
6456 for(var i = 0, n; n = ns[i]; i++){
6457 while((n = n.nextSibling) && n.nodeType != 1);
6458 if(n && (n.nodeName == utag || n.nodeName == tagName || tagName == '*')){
6462 }else if(mode == "~"){
6463 for(var i = 0, n; n = ns[i]; i++){
6464 while((n = n.nextSibling) && (n.nodeType != 1 || (tagName == '*' || n.tagName.toLowerCase()!=tagName)));
6473 function concat(a, b){
6477 for(var i = 0, l = b.length; i < l; i++){
6483 function byTag(cs, tagName){
6484 if(cs.tagName || cs == document){
6490 var r = [], ri = -1;
6491 tagName = tagName.toLowerCase();
6492 for(var i = 0, ci; ci = cs[i]; i++){
6493 if(ci.nodeType == 1 && ci.tagName.toLowerCase()==tagName){
6500 function byId(cs, attr, id){
6501 if(cs.tagName || cs == document){
6507 var r = [], ri = -1;
6508 for(var i = 0,ci; ci = cs[i]; i++){
6509 if(ci && ci.id == id){
6517 function byAttribute(cs, attr, value, op, custom){
6518 var r = [], ri = -1, st = custom=="{";
6519 var f = Roo.DomQuery.operators[op];
6520 for(var i = 0, ci; ci = cs[i]; i++){
6523 a = Roo.DomQuery.getStyle(ci, attr);
6525 else if(attr == "class" || attr == "className"){
6526 a = (ci instanceof SVGElement) ? ci.className.baseVal : ci.className;
6527 }else if(attr == "for"){
6529 }else if(attr == "href"){
6530 a = ci.getAttribute("href", 2);
6532 a = ci.getAttribute(attr);
6534 if((f && f(a, value)) || (!f && a)){
6541 function byPseudo(cs, name, value){
6542 return Roo.DomQuery.pseudos[name](cs, value);
6545 // This is for IE MSXML which does not support expandos.
6546 // IE runs the same speed using setAttribute, however FF slows way down
6547 // and Safari completely fails so they need to continue to use expandos.
6548 var isIE = window.ActiveXObject ? true : false;
6550 // this eval is stop the compressor from
6551 // renaming the variable to something shorter
6553 /** eval:var:batch */
6558 function nodupIEXml(cs){
6560 cs[0].setAttribute("_nodup", d);
6562 for(var i = 1, len = cs.length; i < len; i++){
6564 if(!c.getAttribute("_nodup") != d){
6565 c.setAttribute("_nodup", d);
6569 for(var i = 0, len = cs.length; i < len; i++){
6570 cs[i].removeAttribute("_nodup");
6579 var len = cs.length, c, i, r = cs, cj, ri = -1;
6580 if(!len || typeof cs.nodeType != "undefined" || len == 1){
6583 if(isIE && typeof cs[0].selectSingleNode != "undefined"){
6584 return nodupIEXml(cs);
6588 for(i = 1; c = cs[i]; i++){
6593 for(var j = 0; j < i; j++){
6596 for(j = i+1; cj = cs[j]; j++){
6608 function quickDiffIEXml(c1, c2){
6610 for(var i = 0, len = c1.length; i < len; i++){
6611 c1[i].setAttribute("_qdiff", d);
6614 for(var i = 0, len = c2.length; i < len; i++){
6615 if(c2[i].getAttribute("_qdiff") != d){
6616 r[r.length] = c2[i];
6619 for(var i = 0, len = c1.length; i < len; i++){
6620 c1[i].removeAttribute("_qdiff");
6625 function quickDiff(c1, c2){
6626 var len1 = c1.length;
6630 if(isIE && c1[0].selectSingleNode){
6631 return quickDiffIEXml(c1, c2);
6634 for(var i = 0; i < len1; i++){
6638 for(var i = 0, len = c2.length; i < len; i++){
6639 if(c2[i]._qdiff != d){
6640 r[r.length] = c2[i];
6646 function quickId(ns, mode, root, id){
6648 var d = root.ownerDocument || root;
6649 return d.getElementById(id);
6651 ns = getNodes(ns, mode, "*");
6652 return byId(ns, null, id);
6656 getStyle : function(el, name){
6657 return Roo.fly(el).getStyle(name);
6660 * Compiles a selector/xpath query into a reusable function. The returned function
6661 * takes one parameter "root" (optional), which is the context node from where the query should start.
6662 * @param {String} selector The selector/xpath query
6663 * @param {String} type (optional) Either "select" (the default) or "simple" for a simple selector match
6664 * @return {Function}
6666 compile : function(path, type){
6667 type = type || "select";
6669 var fn = ["var f = function(root){\n var mode; ++batch; var n = root || document;\n"];
6670 var q = path, mode, lq;
6671 var tk = Roo.DomQuery.matchers;
6672 var tklen = tk.length;
6675 // accept leading mode switch
6676 var lmode = q.match(modeRe);
6677 if(lmode && lmode[1]){
6678 fn[fn.length] = 'mode="'+lmode[1].replace(trimRe, "")+'";';
6679 q = q.replace(lmode[1], "");
6681 // strip leading slashes
6682 while(path.substr(0, 1)=="/"){
6683 path = path.substr(1);
6686 while(q && lq != q){
6688 var tm = q.match(tagTokenRe);
6689 if(type == "select"){
6692 fn[fn.length] = 'n = quickId(n, mode, root, "'+tm[2]+'");';
6694 fn[fn.length] = 'n = getNodes(n, mode, "'+tm[2]+'");';
6696 q = q.replace(tm[0], "");
6697 }else if(q.substr(0, 1) != '@'){
6698 fn[fn.length] = 'n = getNodes(n, mode, "*");';
6703 fn[fn.length] = 'n = byId(n, null, "'+tm[2]+'");';
6705 fn[fn.length] = 'n = byTag(n, "'+tm[2]+'");';
6707 q = q.replace(tm[0], "");
6710 while(!(mm = q.match(modeRe))){
6711 var matched = false;
6712 for(var j = 0; j < tklen; j++){
6714 var m = q.match(t.re);
6716 fn[fn.length] = t.select.replace(tplRe, function(x, i){
6719 q = q.replace(m[0], "");
6724 // prevent infinite loop on bad selector
6726 throw 'Error parsing selector, parsing failed at "' + q + '"';
6730 fn[fn.length] = 'mode="'+mm[1].replace(trimRe, "")+'";';
6731 q = q.replace(mm[1], "");
6734 fn[fn.length] = "return nodup(n);\n}";
6737 * list of variables that need from compression as they are used by eval.
6747 * eval:var:byClassName
6749 * eval:var:byAttribute
6750 * eval:var:attrValue
6758 * Selects a group of elements.
6759 * @param {String} selector The selector/xpath query (can be a comma separated list of selectors)
6760 * @param {Node} root (optional) The start of the query (defaults to document).
6763 select : function(path, root, type){
6764 if(!root || root == document){
6767 if(typeof root == "string"){
6768 root = document.getElementById(root);
6770 var paths = path.split(",");
6772 for(var i = 0, len = paths.length; i < len; i++){
6773 var p = paths[i].replace(trimRe, "");
6775 cache[p] = Roo.DomQuery.compile(p);
6777 throw p + " is not a valid selector";
6780 var result = cache[p](root);
6781 if(result && result != document){
6782 results = results.concat(result);
6785 if(paths.length > 1){
6786 return nodup(results);
6792 * Selects a single element.
6793 * @param {String} selector The selector/xpath query
6794 * @param {Node} root (optional) The start of the query (defaults to document).
6797 selectNode : function(path, root){
6798 return Roo.DomQuery.select(path, root)[0];
6802 * Selects the value of a node, optionally replacing null with the defaultValue.
6803 * @param {String} selector The selector/xpath query
6804 * @param {Node} root (optional) The start of the query (defaults to document).
6805 * @param {String} defaultValue
6807 selectValue : function(path, root, defaultValue){
6808 path = path.replace(trimRe, "");
6809 if(!valueCache[path]){
6810 valueCache[path] = Roo.DomQuery.compile(path, "select");
6812 var n = valueCache[path](root);
6813 n = n[0] ? n[0] : n;
6814 var v = (n && n.firstChild ? n.firstChild.nodeValue : null);
6815 return ((v === null||v === undefined||v==='') ? defaultValue : v);
6819 * Selects the value of a node, parsing integers and floats.
6820 * @param {String} selector The selector/xpath query
6821 * @param {Node} root (optional) The start of the query (defaults to document).
6822 * @param {Number} defaultValue
6825 selectNumber : function(path, root, defaultValue){
6826 var v = Roo.DomQuery.selectValue(path, root, defaultValue || 0);
6827 return parseFloat(v);
6831 * Returns true if the passed element(s) match the passed simple selector (e.g. div.some-class or span:first-child)
6832 * @param {String/HTMLElement/Array} el An element id, element or array of elements
6833 * @param {String} selector The simple selector to test
6836 is : function(el, ss){
6837 if(typeof el == "string"){
6838 el = document.getElementById(el);
6840 var isArray = (el instanceof Array);
6841 var result = Roo.DomQuery.filter(isArray ? el : [el], ss);
6842 return isArray ? (result.length == el.length) : (result.length > 0);
6846 * Filters an array of elements to only include matches of a simple selector (e.g. div.some-class or span:first-child)
6847 * @param {Array} el An array of elements to filter
6848 * @param {String} selector The simple selector to test
6849 * @param {Boolean} nonMatches If true, it returns the elements that DON'T match
6850 * the selector instead of the ones that match
6853 filter : function(els, ss, nonMatches){
6854 ss = ss.replace(trimRe, "");
6855 if(!simpleCache[ss]){
6856 simpleCache[ss] = Roo.DomQuery.compile(ss, "simple");
6858 var result = simpleCache[ss](els);
6859 return nonMatches ? quickDiff(result, els) : result;
6863 * Collection of matching regular expressions and code snippets.
6867 select: 'n = byClassName(n, null, " {1} ");'
6869 re: /^\:([\w-]+)(?:\(((?:[^\s>\/]*|.*?))\))?/,
6870 select: 'n = byPseudo(n, "{1}", "{2}");'
6872 re: /^(?:([\[\{])(?:@)?([\w-]+)\s?(?:(=|.=)\s?['"]?(.*?)["']?)?[\]\}])/,
6873 select: 'n = byAttribute(n, "{2}", "{4}", "{3}", "{1}");'
6876 select: 'n = byId(n, null, "{1}");'
6879 select: 'return {firstChild:{nodeValue:attrValue(n, "{1}")}};'
6884 * Collection of operator comparison functions. The default operators are =, !=, ^=, $=, *=, %=, |= and ~=.
6885 * 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, > <.
6888 "=" : function(a, v){
6891 "!=" : function(a, v){
6894 "^=" : function(a, v){
6895 return a && a.substr(0, v.length) == v;
6897 "$=" : function(a, v){
6898 return a && a.substr(a.length-v.length) == v;
6900 "*=" : function(a, v){
6901 return a && a.indexOf(v) !== -1;
6903 "%=" : function(a, v){
6904 return (a % v) == 0;
6906 "|=" : function(a, v){
6907 return a && (a == v || a.substr(0, v.length+1) == v+'-');
6909 "~=" : function(a, v){
6910 return a && (' '+a+' ').indexOf(' '+v+' ') != -1;
6915 * Collection of "pseudo class" processors. Each processor is passed the current nodeset (array)
6916 * and the argument (if any) supplied in the selector.
6919 "first-child" : function(c){
6920 var r = [], ri = -1, n;
6921 for(var i = 0, ci; ci = n = c[i]; i++){
6922 while((n = n.previousSibling) && n.nodeType != 1);
6930 "last-child" : function(c){
6931 var r = [], ri = -1, n;
6932 for(var i = 0, ci; ci = n = c[i]; i++){
6933 while((n = n.nextSibling) && n.nodeType != 1);
6941 "nth-child" : function(c, a) {
6942 var r = [], ri = -1;
6943 var m = nthRe.exec(a == "even" && "2n" || a == "odd" && "2n+1" || !nthRe2.test(a) && "n+" + a || a);
6944 var f = (m[1] || 1) - 0, l = m[2] - 0;
6945 for(var i = 0, n; n = c[i]; i++){
6946 var pn = n.parentNode;
6947 if (batch != pn._batch) {
6949 for(var cn = pn.firstChild; cn; cn = cn.nextSibling){
6950 if(cn.nodeType == 1){
6957 if (l == 0 || n.nodeIndex == l){
6960 } else if ((n.nodeIndex + l) % f == 0){
6968 "only-child" : function(c){
6969 var r = [], ri = -1;;
6970 for(var i = 0, ci; ci = c[i]; i++){
6971 if(!prev(ci) && !next(ci)){
6978 "empty" : function(c){
6979 var r = [], ri = -1;
6980 for(var i = 0, ci; ci = c[i]; i++){
6981 var cns = ci.childNodes, j = 0, cn, empty = true;
6984 if(cn.nodeType == 1 || cn.nodeType == 3){
6996 "contains" : function(c, v){
6997 var r = [], ri = -1;
6998 for(var i = 0, ci; ci = c[i]; i++){
6999 if((ci.textContent||ci.innerText||'').indexOf(v) != -1){
7006 "nodeValue" : function(c, v){
7007 var r = [], ri = -1;
7008 for(var i = 0, ci; ci = c[i]; i++){
7009 if(ci.firstChild && ci.firstChild.nodeValue == v){
7016 "checked" : function(c){
7017 var r = [], ri = -1;
7018 for(var i = 0, ci; ci = c[i]; i++){
7019 if(ci.checked == true){
7026 "not" : function(c, ss){
7027 return Roo.DomQuery.filter(c, ss, true);
7030 "odd" : function(c){
7031 return this["nth-child"](c, "odd");
7034 "even" : function(c){
7035 return this["nth-child"](c, "even");
7038 "nth" : function(c, a){
7039 return c[a-1] || [];
7042 "first" : function(c){
7046 "last" : function(c){
7047 return c[c.length-1] || [];
7050 "has" : function(c, ss){
7051 var s = Roo.DomQuery.select;
7052 var r = [], ri = -1;
7053 for(var i = 0, ci; ci = c[i]; i++){
7054 if(s(ss, ci).length > 0){
7061 "next" : function(c, ss){
7062 var is = Roo.DomQuery.is;
7063 var r = [], ri = -1;
7064 for(var i = 0, ci; ci = c[i]; i++){
7073 "prev" : function(c, ss){
7074 var is = Roo.DomQuery.is;
7075 var r = [], ri = -1;
7076 for(var i = 0, ci; ci = c[i]; i++){
7089 * Selects an array of DOM nodes by CSS/XPath selector. Shorthand of {@link Roo.DomQuery#select}
7090 * @param {String} path The selector/xpath query
7091 * @param {Node} root (optional) The start of the query (defaults to document).
7096 Roo.query = Roo.DomQuery.select;
7099 * Ext JS Library 1.1.1
7100 * Copyright(c) 2006-2007, Ext JS, LLC.
7102 * Originally Released Under LGPL - original licence link has changed is not relivant.
7105 * <script type="text/javascript">
7109 * @class Roo.util.Observable
7110 * Base class that provides a common interface for publishing events. Subclasses are expected to
7111 * to have a property "events" with all the events defined.<br>
7114 Employee = function(name){
7121 Roo.extend(Employee, Roo.util.Observable);
7123 * @param {Object} config properties to use (incuding events / listeners)
7126 Roo.util.Observable = function(cfg){
7127 console.log("UTIL OBSERVABLE CONSTRUCTOR");
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 console.log("COMPONENT CONSTRUCTOR");
16870 config = config || {};
16871 if(config.tagName || config.dom || typeof config == "string"){ // element object
16872 config = {el: config, id: config.id || config};
16874 this.initialConfig = config;
16876 Roo.apply(this, config);
16880 * Fires after the component is disabled.
16881 * @param {Roo.Component} this
16886 * Fires after the component is enabled.
16887 * @param {Roo.Component} this
16891 * @event beforeshow
16892 * Fires before the component is shown. Return false to stop the show.
16893 * @param {Roo.Component} this
16898 * Fires after the component is shown.
16899 * @param {Roo.Component} this
16903 * @event beforehide
16904 * Fires before the component is hidden. Return false to stop the hide.
16905 * @param {Roo.Component} this
16910 * Fires after the component is hidden.
16911 * @param {Roo.Component} this
16915 * @event beforerender
16916 * Fires before the component is rendered. Return false to stop the render.
16917 * @param {Roo.Component} this
16919 beforerender : true,
16922 * Fires after the component is rendered.
16923 * @param {Roo.Component} this
16927 * @event beforedestroy
16928 * Fires before the component is destroyed. Return false to stop the destroy.
16929 * @param {Roo.Component} this
16931 beforedestroy : true,
16934 * Fires after the component is destroyed.
16935 * @param {Roo.Component} this
16940 this.id = "roo-comp-" + (++Roo.Component.AUTO_ID);
16942 Roo.ComponentMgr.register(this);
16943 Roo.Component.superclass.constructor.call(this);
16944 this.initComponent();
16945 if(this.renderTo){ // not supported by all components yet. use at your own risk!
16946 this.render(this.renderTo);
16947 delete this.renderTo;
16952 Roo.Component.AUTO_ID = 1000;
16954 Roo.extend(Roo.Component, Roo.util.Observable, {
16956 * @scope Roo.Component.prototype
16958 * true if this component is hidden. Read-only.
16963 * true if this component is disabled. Read-only.
16968 * true if this component has been rendered. Read-only.
16972 /** @cfg {String} disableClass
16973 * CSS class added to the component when it is disabled (defaults to "x-item-disabled").
16975 disabledClass : "x-item-disabled",
16976 /** @cfg {Boolean} allowDomMove
16977 * Whether the component can move the Dom node when rendering (defaults to true).
16979 allowDomMove : true,
16980 /** @cfg {String} hideMode (display|visibility)
16981 * How this component should hidden. Supported values are
16982 * "visibility" (css visibility), "offsets" (negative offset position) and
16983 * "display" (css display) - defaults to "display".
16985 hideMode: 'display',
16988 ctype : "Roo.Component",
16991 * @cfg {String} actionMode
16992 * which property holds the element that used for hide() / show() / disable() / enable()
16993 * default is 'el' for forms you probably want to set this to fieldEl
16998 getActionEl : function(){
16999 return this[this.actionMode];
17002 initComponent : Roo.emptyFn,
17004 * If this is a lazy rendering component, render it to its container element.
17005 * @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.
17007 render : function(container, position){
17013 if(this.fireEvent("beforerender", this) === false){
17017 if(!container && this.el){
17018 this.el = Roo.get(this.el);
17019 container = this.el.dom.parentNode;
17020 this.allowDomMove = false;
17022 this.container = Roo.get(container);
17023 this.rendered = true;
17024 if(position !== undefined){
17025 if(typeof position == 'number'){
17026 position = this.container.dom.childNodes[position];
17028 position = Roo.getDom(position);
17031 this.onRender(this.container, position || null);
17033 this.el.addClass(this.cls);
17037 this.el.applyStyles(this.style);
17040 this.fireEvent("render", this);
17041 this.afterRender(this.container);
17054 // default function is not really useful
17055 onRender : function(ct, position){
17057 this.el = Roo.get(this.el);
17058 if(this.allowDomMove !== false){
17059 ct.dom.insertBefore(this.el.dom, position);
17065 getAutoCreate : function(){
17066 var cfg = typeof this.autoCreate == "object" ?
17067 this.autoCreate : Roo.apply({}, this.defaultAutoCreate);
17068 if(this.id && !cfg.id){
17075 afterRender : Roo.emptyFn,
17078 * Destroys this component by purging any event listeners, removing the component's element from the DOM,
17079 * removing the component from its {@link Roo.Container} (if applicable) and unregistering it from {@link Roo.ComponentMgr}.
17081 destroy : function(){
17082 if(this.fireEvent("beforedestroy", this) !== false){
17083 this.purgeListeners();
17084 this.beforeDestroy();
17086 this.el.removeAllListeners();
17088 if(this.actionMode == "container"){
17089 this.container.remove();
17093 Roo.ComponentMgr.unregister(this);
17094 this.fireEvent("destroy", this);
17099 beforeDestroy : function(){
17104 onDestroy : function(){
17109 * Returns the underlying {@link Roo.Element}.
17110 * @return {Roo.Element} The element
17112 getEl : function(){
17117 * Returns the id of this component.
17120 getId : function(){
17125 * Try to focus this component.
17126 * @param {Boolean} selectText True to also select the text in this component (if applicable)
17127 * @return {Roo.Component} this
17129 focus : function(selectText){
17132 if(selectText === true){
17133 this.el.dom.select();
17148 * Disable this component.
17149 * @return {Roo.Component} this
17151 disable : function(){
17155 this.disabled = true;
17156 this.fireEvent("disable", this);
17161 onDisable : function(){
17162 this.getActionEl().addClass(this.disabledClass);
17163 this.el.dom.disabled = true;
17167 * Enable this component.
17168 * @return {Roo.Component} this
17170 enable : function(){
17174 this.disabled = false;
17175 this.fireEvent("enable", this);
17180 onEnable : function(){
17181 this.getActionEl().removeClass(this.disabledClass);
17182 this.el.dom.disabled = false;
17186 * Convenience function for setting disabled/enabled by boolean.
17187 * @param {Boolean} disabled
17189 setDisabled : function(disabled){
17190 this[disabled ? "disable" : "enable"]();
17194 * Show this component.
17195 * @return {Roo.Component} this
17198 if(this.fireEvent("beforeshow", this) !== false){
17199 this.hidden = false;
17203 this.fireEvent("show", this);
17209 onShow : function(){
17210 var ae = this.getActionEl();
17211 if(this.hideMode == 'visibility'){
17212 ae.dom.style.visibility = "visible";
17213 }else if(this.hideMode == 'offsets'){
17214 ae.removeClass('x-hidden');
17216 ae.dom.style.display = "";
17221 * Hide this component.
17222 * @return {Roo.Component} this
17225 if(this.fireEvent("beforehide", this) !== false){
17226 this.hidden = true;
17230 this.fireEvent("hide", this);
17236 onHide : function(){
17237 var ae = this.getActionEl();
17238 if(this.hideMode == 'visibility'){
17239 ae.dom.style.visibility = "hidden";
17240 }else if(this.hideMode == 'offsets'){
17241 ae.addClass('x-hidden');
17243 ae.dom.style.display = "none";
17248 * Convenience function to hide or show this component by boolean.
17249 * @param {Boolean} visible True to show, false to hide
17250 * @return {Roo.Component} this
17252 setVisible: function(visible){
17262 * Returns true if this component is visible.
17264 isVisible : function(){
17265 return this.getActionEl().isVisible();
17268 cloneConfig : function(overrides){
17269 overrides = overrides || {};
17270 var id = overrides.id || Roo.id();
17271 var cfg = Roo.applyIf(overrides, this.initialConfig);
17272 cfg.id = id; // prevent dup id
17273 return new this.constructor(cfg);
17277 * Ext JS Library 1.1.1
17278 * Copyright(c) 2006-2007, Ext JS, LLC.
17280 * Originally Released Under LGPL - original licence link has changed is not relivant.
17283 * <script type="text/javascript">
17287 * @class Roo.BoxComponent
17288 * @extends Roo.Component
17289 * Base class for any visual {@link Roo.Component} that uses a box container. BoxComponent provides automatic box
17290 * model adjustments for sizing and positioning and will work correctly withnin the Component rendering model. All
17291 * container classes should subclass BoxComponent so that they will work consistently when nested within other Roo
17292 * layout containers.
17294 * @param {Roo.Element/String/Object} config The configuration options.
17296 Roo.BoxComponent = function(config){
17297 Roo.Component.call(this, config);
17301 * Fires after the component is resized.
17302 * @param {Roo.Component} this
17303 * @param {Number} adjWidth The box-adjusted width that was set
17304 * @param {Number} adjHeight The box-adjusted height that was set
17305 * @param {Number} rawWidth The width that was originally specified
17306 * @param {Number} rawHeight The height that was originally specified
17311 * Fires after the component is moved.
17312 * @param {Roo.Component} this
17313 * @param {Number} x The new x position
17314 * @param {Number} y The new y position
17320 Roo.extend(Roo.BoxComponent, Roo.Component, {
17321 // private, set in afterRender to signify that the component has been rendered
17323 // private, used to defer height settings to subclasses
17324 deferHeight: false,
17325 /** @cfg {Number} width
17326 * width (optional) size of component
17328 /** @cfg {Number} height
17329 * height (optional) size of component
17333 * Sets the width and height of the component. This method fires the resize event. This method can accept
17334 * either width and height as separate numeric arguments, or you can pass a size object like {width:10, height:20}.
17335 * @param {Number/Object} width The new width to set, or a size object in the format {width, height}
17336 * @param {Number} height The new height to set (not required if a size object is passed as the first arg)
17337 * @return {Roo.BoxComponent} this
17339 setSize : function(w, h){
17340 // support for standard size objects
17341 if(typeof w == 'object'){
17346 if(!this.boxReady){
17352 // prevent recalcs when not needed
17353 if(this.lastSize && this.lastSize.width == w && this.lastSize.height == h){
17356 this.lastSize = {width: w, height: h};
17358 var adj = this.adjustSize(w, h);
17359 var aw = adj.width, ah = adj.height;
17360 if(aw !== undefined || ah !== undefined){ // this code is nasty but performs better with floaters
17361 var rz = this.getResizeEl();
17362 if(!this.deferHeight && aw !== undefined && ah !== undefined){
17363 rz.setSize(aw, ah);
17364 }else if(!this.deferHeight && ah !== undefined){
17366 }else if(aw !== undefined){
17369 this.onResize(aw, ah, w, h);
17370 this.fireEvent('resize', this, aw, ah, w, h);
17376 * Gets the current size of the component's underlying element.
17377 * @return {Object} An object containing the element's size {width: (element width), height: (element height)}
17379 getSize : function(){
17380 return this.el.getSize();
17384 * Gets the current XY position of the component's underlying element.
17385 * @param {Boolean} local (optional) If true the element's left and top are returned instead of page XY (defaults to false)
17386 * @return {Array} The XY position of the element (e.g., [100, 200])
17388 getPosition : function(local){
17389 if(local === true){
17390 return [this.el.getLeft(true), this.el.getTop(true)];
17392 return this.xy || this.el.getXY();
17396 * Gets the current box measurements of the component's underlying element.
17397 * @param {Boolean} local (optional) If true the element's left and top are returned instead of page XY (defaults to false)
17398 * @returns {Object} box An object in the format {x, y, width, height}
17400 getBox : function(local){
17401 var s = this.el.getSize();
17403 s.x = this.el.getLeft(true);
17404 s.y = this.el.getTop(true);
17406 var xy = this.xy || this.el.getXY();
17414 * Sets the current box measurements of the component's underlying element.
17415 * @param {Object} box An object in the format {x, y, width, height}
17416 * @returns {Roo.BoxComponent} this
17418 updateBox : function(box){
17419 this.setSize(box.width, box.height);
17420 this.setPagePosition(box.x, box.y);
17425 getResizeEl : function(){
17426 return this.resizeEl || this.el;
17430 getPositionEl : function(){
17431 return this.positionEl || this.el;
17435 * Sets the left and top of the component. To set the page XY position instead, use {@link #setPagePosition}.
17436 * This method fires the move event.
17437 * @param {Number} left The new left
17438 * @param {Number} top The new top
17439 * @returns {Roo.BoxComponent} this
17441 setPosition : function(x, y){
17444 if(!this.boxReady){
17447 var adj = this.adjustPosition(x, y);
17448 var ax = adj.x, ay = adj.y;
17450 var el = this.getPositionEl();
17451 if(ax !== undefined || ay !== undefined){
17452 if(ax !== undefined && ay !== undefined){
17453 el.setLeftTop(ax, ay);
17454 }else if(ax !== undefined){
17456 }else if(ay !== undefined){
17459 this.onPosition(ax, ay);
17460 this.fireEvent('move', this, ax, ay);
17466 * Sets the page XY position of the component. To set the left and top instead, use {@link #setPosition}.
17467 * This method fires the move event.
17468 * @param {Number} x The new x position
17469 * @param {Number} y The new y position
17470 * @returns {Roo.BoxComponent} this
17472 setPagePosition : function(x, y){
17475 if(!this.boxReady){
17478 if(x === undefined || y === undefined){ // cannot translate undefined points
17481 var p = this.el.translatePoints(x, y);
17482 this.setPosition(p.left, p.top);
17487 onRender : function(ct, position){
17488 Roo.BoxComponent.superclass.onRender.call(this, ct, position);
17490 this.resizeEl = Roo.get(this.resizeEl);
17492 if(this.positionEl){
17493 this.positionEl = Roo.get(this.positionEl);
17498 afterRender : function(){
17499 Roo.BoxComponent.superclass.afterRender.call(this);
17500 this.boxReady = true;
17501 this.setSize(this.width, this.height);
17502 if(this.x || this.y){
17503 this.setPosition(this.x, this.y);
17505 if(this.pageX || this.pageY){
17506 this.setPagePosition(this.pageX, this.pageY);
17511 * Force the component's size to recalculate based on the underlying element's current height and width.
17512 * @returns {Roo.BoxComponent} this
17514 syncSize : function(){
17515 delete this.lastSize;
17516 this.setSize(this.el.getWidth(), this.el.getHeight());
17521 * Called after the component is resized, this method is empty by default but can be implemented by any
17522 * subclass that needs to perform custom logic after a resize occurs.
17523 * @param {Number} adjWidth The box-adjusted width that was set
17524 * @param {Number} adjHeight The box-adjusted height that was set
17525 * @param {Number} rawWidth The width that was originally specified
17526 * @param {Number} rawHeight The height that was originally specified
17528 onResize : function(adjWidth, adjHeight, rawWidth, rawHeight){
17533 * Called after the component is moved, this method is empty by default but can be implemented by any
17534 * subclass that needs to perform custom logic after a move occurs.
17535 * @param {Number} x The new x position
17536 * @param {Number} y The new y position
17538 onPosition : function(x, y){
17543 adjustSize : function(w, h){
17544 if(this.autoWidth){
17547 if(this.autoHeight){
17550 return {width : w, height: h};
17554 adjustPosition : function(x, y){
17555 return {x : x, y: y};
17559 * Ext JS Library 1.1.1
17560 * Copyright(c) 2006-2007, Ext JS, LLC.
17562 * Originally Released Under LGPL - original licence link has changed is not relivant.
17565 * <script type="text/javascript">
17570 * @extends Roo.Element
17571 * An extended {@link Roo.Element} object that supports a shadow and shim, constrain to viewport and
17572 * automatic maintaining of shadow/shim positions.
17573 * @cfg {Boolean} shim False to disable the iframe shim in browsers which need one (defaults to true)
17574 * @cfg {String/Boolean} shadow True to create a shadow element with default class "x-layer-shadow", or
17575 * you can pass a string with a CSS class name. False turns off the shadow.
17576 * @cfg {Object} dh DomHelper object config to create element with (defaults to {tag: "div", cls: "x-layer"}).
17577 * @cfg {Boolean} constrain False to disable constrain to viewport (defaults to true)
17578 * @cfg {String} cls CSS class to add to the element
17579 * @cfg {Number} zindex Starting z-index (defaults to 11000)
17580 * @cfg {Number} shadowOffset Number of pixels to offset the shadow (defaults to 3)
17582 * @param {Object} config An object with config options.
17583 * @param {String/HTMLElement} existingEl (optional) Uses an existing DOM element. If the element is not found it creates it.
17586 Roo.Layer = function(config, existingEl){
17587 config = config || {};
17588 var dh = Roo.DomHelper;
17589 var cp = config.parentEl, pel = cp ? Roo.getDom(cp) : document.body;
17591 this.dom = Roo.getDom(existingEl);
17594 var o = config.dh || {tag: "div", cls: "x-layer"};
17595 this.dom = dh.append(pel, o);
17598 this.addClass(config.cls);
17600 this.constrain = config.constrain !== false;
17601 this.visibilityMode = Roo.Element.VISIBILITY;
17603 this.id = this.dom.id = config.id;
17605 this.id = Roo.id(this.dom);
17607 this.zindex = config.zindex || this.getZIndex();
17608 this.position("absolute", this.zindex);
17610 this.shadowOffset = config.shadowOffset || 4;
17611 this.shadow = new Roo.Shadow({
17612 offset : this.shadowOffset,
17613 mode : config.shadow
17616 this.shadowOffset = 0;
17618 this.useShim = config.shim !== false && Roo.useShims;
17619 this.useDisplay = config.useDisplay;
17623 var supr = Roo.Element.prototype;
17625 // shims are shared among layer to keep from having 100 iframes
17628 Roo.extend(Roo.Layer, Roo.Element, {
17630 getZIndex : function(){
17631 return this.zindex || parseInt(this.getStyle("z-index"), 10) || 11000;
17634 getShim : function(){
17641 var shim = shims.shift();
17643 shim = this.createShim();
17644 shim.enableDisplayMode('block');
17645 shim.dom.style.display = 'none';
17646 shim.dom.style.visibility = 'visible';
17648 var pn = this.dom.parentNode;
17649 if(shim.dom.parentNode != pn){
17650 pn.insertBefore(shim.dom, this.dom);
17652 shim.setStyle('z-index', this.getZIndex()-2);
17657 hideShim : function(){
17659 this.shim.setDisplayed(false);
17660 shims.push(this.shim);
17665 disableShadow : function(){
17667 this.shadowDisabled = true;
17668 this.shadow.hide();
17669 this.lastShadowOffset = this.shadowOffset;
17670 this.shadowOffset = 0;
17674 enableShadow : function(show){
17676 this.shadowDisabled = false;
17677 this.shadowOffset = this.lastShadowOffset;
17678 delete this.lastShadowOffset;
17686 // this code can execute repeatedly in milliseconds (i.e. during a drag) so
17687 // code size was sacrificed for effeciency (e.g. no getBox/setBox, no XY calls)
17688 sync : function(doShow){
17689 var sw = this.shadow;
17690 if(!this.updating && this.isVisible() && (sw || this.useShim)){
17691 var sh = this.getShim();
17693 var w = this.getWidth(),
17694 h = this.getHeight();
17696 var l = this.getLeft(true),
17697 t = this.getTop(true);
17699 if(sw && !this.shadowDisabled){
17700 if(doShow && !sw.isVisible()){
17703 sw.realign(l, t, w, h);
17709 // fit the shim behind the shadow, so it is shimmed too
17710 var a = sw.adjusts, s = sh.dom.style;
17711 s.left = (Math.min(l, l+a.l))+"px";
17712 s.top = (Math.min(t, t+a.t))+"px";
17713 s.width = (w+a.w)+"px";
17714 s.height = (h+a.h)+"px";
17721 sh.setLeftTop(l, t);
17728 destroy : function(){
17731 this.shadow.hide();
17733 this.removeAllListeners();
17734 var pn = this.dom.parentNode;
17736 pn.removeChild(this.dom);
17738 Roo.Element.uncache(this.id);
17741 remove : function(){
17746 beginUpdate : function(){
17747 this.updating = true;
17751 endUpdate : function(){
17752 this.updating = false;
17757 hideUnders : function(negOffset){
17759 this.shadow.hide();
17765 constrainXY : function(){
17766 if(this.constrain){
17767 var vw = Roo.lib.Dom.getViewWidth(),
17768 vh = Roo.lib.Dom.getViewHeight();
17769 var s = Roo.get(document).getScroll();
17771 var xy = this.getXY();
17772 var x = xy[0], y = xy[1];
17773 var w = this.dom.offsetWidth+this.shadowOffset, h = this.dom.offsetHeight+this.shadowOffset;
17774 // only move it if it needs it
17776 // first validate right/bottom
17777 if((x + w) > vw+s.left){
17778 x = vw - w - this.shadowOffset;
17781 if((y + h) > vh+s.top){
17782 y = vh - h - this.shadowOffset;
17785 // then make sure top/left isn't negative
17796 var ay = this.avoidY;
17797 if(y <= ay && (y+h) >= ay){
17803 supr.setXY.call(this, xy);
17809 isVisible : function(){
17810 return this.visible;
17814 showAction : function(){
17815 this.visible = true; // track visibility to prevent getStyle calls
17816 if(this.useDisplay === true){
17817 this.setDisplayed("");
17818 }else if(this.lastXY){
17819 supr.setXY.call(this, this.lastXY);
17820 }else if(this.lastLT){
17821 supr.setLeftTop.call(this, this.lastLT[0], this.lastLT[1]);
17826 hideAction : function(){
17827 this.visible = false;
17828 if(this.useDisplay === true){
17829 this.setDisplayed(false);
17831 this.setLeftTop(-10000,-10000);
17835 // overridden Element method
17836 setVisible : function(v, a, d, c, e){
17841 var cb = function(){
17846 }.createDelegate(this);
17847 supr.setVisible.call(this, true, true, d, cb, e);
17850 this.hideUnders(true);
17859 }.createDelegate(this);
17861 supr.setVisible.call(this, v, a, d, cb, e);
17870 storeXY : function(xy){
17871 delete this.lastLT;
17875 storeLeftTop : function(left, top){
17876 delete this.lastXY;
17877 this.lastLT = [left, top];
17881 beforeFx : function(){
17882 this.beforeAction();
17883 return Roo.Layer.superclass.beforeFx.apply(this, arguments);
17887 afterFx : function(){
17888 Roo.Layer.superclass.afterFx.apply(this, arguments);
17889 this.sync(this.isVisible());
17893 beforeAction : function(){
17894 if(!this.updating && this.shadow){
17895 this.shadow.hide();
17899 // overridden Element method
17900 setLeft : function(left){
17901 this.storeLeftTop(left, this.getTop(true));
17902 supr.setLeft.apply(this, arguments);
17906 setTop : function(top){
17907 this.storeLeftTop(this.getLeft(true), top);
17908 supr.setTop.apply(this, arguments);
17912 setLeftTop : function(left, top){
17913 this.storeLeftTop(left, top);
17914 supr.setLeftTop.apply(this, arguments);
17918 setXY : function(xy, a, d, c, e){
17920 this.beforeAction();
17922 var cb = this.createCB(c);
17923 supr.setXY.call(this, xy, a, d, cb, e);
17930 createCB : function(c){
17941 // overridden Element method
17942 setX : function(x, a, d, c, e){
17943 this.setXY([x, this.getY()], a, d, c, e);
17946 // overridden Element method
17947 setY : function(y, a, d, c, e){
17948 this.setXY([this.getX(), y], a, d, c, e);
17951 // overridden Element method
17952 setSize : function(w, h, a, d, c, e){
17953 this.beforeAction();
17954 var cb = this.createCB(c);
17955 supr.setSize.call(this, w, h, a, d, cb, e);
17961 // overridden Element method
17962 setWidth : function(w, a, d, c, e){
17963 this.beforeAction();
17964 var cb = this.createCB(c);
17965 supr.setWidth.call(this, w, a, d, cb, e);
17971 // overridden Element method
17972 setHeight : function(h, a, d, c, e){
17973 this.beforeAction();
17974 var cb = this.createCB(c);
17975 supr.setHeight.call(this, h, a, d, cb, e);
17981 // overridden Element method
17982 setBounds : function(x, y, w, h, a, d, c, e){
17983 this.beforeAction();
17984 var cb = this.createCB(c);
17986 this.storeXY([x, y]);
17987 supr.setXY.call(this, [x, y]);
17988 supr.setSize.call(this, w, h, a, d, cb, e);
17991 supr.setBounds.call(this, x, y, w, h, a, d, cb, e);
17997 * Sets the z-index of this layer and adjusts any shadow and shim z-indexes. The layer z-index is automatically
17998 * incremented by two more than the value passed in so that it always shows above any shadow or shim (the shadow
17999 * element, if any, will be assigned z-index + 1, and the shim element, if any, will be assigned the unmodified z-index).
18000 * @param {Number} zindex The new z-index to set
18001 * @return {this} The Layer
18003 setZIndex : function(zindex){
18004 this.zindex = zindex;
18005 this.setStyle("z-index", zindex + 2);
18007 this.shadow.setZIndex(zindex + 1);
18010 this.shim.setStyle("z-index", zindex);
18015 * Original code for Roojs - LGPL
18016 * <script type="text/javascript">
18020 * @class Roo.XComponent
18021 * A delayed Element creator...
18022 * Or a way to group chunks of interface together.
18023 * technically this is a wrapper around a tree of Roo elements (which defines a 'module'),
18024 * used in conjunction with XComponent.build() it will create an instance of each element,
18025 * then call addxtype() to build the User interface.
18027 * Mypart.xyx = new Roo.XComponent({
18029 parent : 'Mypart.xyz', // empty == document.element.!!
18033 disabled : function() {}
18035 tree : function() { // return an tree of xtype declared components
18039 xtype : 'NestedLayoutPanel',
18046 * It can be used to build a big heiracy, with parent etc.
18047 * or you can just use this to render a single compoent to a dom element
18048 * MYPART.render(Roo.Element | String(id) | dom_element )
18055 * Roo is designed primarily as a single page application, so the UI build for a standard interface will
18056 * expect a single 'TOP' level module normally indicated by the 'parent' of the XComponent definition being defined as false.
18058 * Each sub module is expected to have a parent pointing to the class name of it's parent module.
18060 * When the top level is false, a 'Roo.BorderLayout' is created and the element is flagged as 'topModule'
18061 * - if mulitple topModules exist, the last one is defined as the top module.
18065 * When the top level or multiple modules are to embedded into a existing HTML page,
18066 * the parent element can container '#id' of the element where the module will be drawn.
18070 * Unlike classic Roo, the bootstrap tends not to be used as a single page.
18071 * it relies more on a include mechanism, where sub modules are included into an outer page.
18072 * This is normally managed by the builder tools using Roo.apply( options, Included.Sub.Module )
18074 * Bootstrap Roo Included elements
18076 * Our builder application needs the ability to preview these sub compoennts. They will normally have parent=false set,
18077 * hence confusing the component builder as it thinks there are multiple top level elements.
18079 * String Over-ride & Translations
18081 * Our builder application writes all the strings as _strings and _named_strings. This is to enable the translation of elements,
18082 * and also the 'overlaying of string values - needed when different versions of the same application with different text content
18083 * are needed. @see Roo.XComponent.overlayString
18087 * @extends Roo.util.Observable
18089 * @param cfg {Object} configuration of component
18092 Roo.XComponent = function(cfg) {
18093 Roo.apply(this, cfg);
18097 * Fires when this the componnt is built
18098 * @param {Roo.XComponent} c the component
18103 this.region = this.region || 'center'; // default..
18104 Roo.XComponent.register(this);
18105 this.modules = false;
18106 this.el = false; // where the layout goes..
18110 Roo.extend(Roo.XComponent, Roo.util.Observable, {
18113 * The created element (with Roo.factory())
18114 * @type {Roo.Layout}
18120 * for BC - use el in new code
18121 * @type {Roo.Layout}
18127 * for BC - use el in new code
18128 * @type {Roo.Layout}
18133 * @cfg {Function|boolean} disabled
18134 * If this module is disabled by some rule, return true from the funtion
18139 * @cfg {String} parent
18140 * Name of parent element which it get xtype added to..
18145 * @cfg {String} order
18146 * Used to set the order in which elements are created (usefull for multiple tabs)
18151 * @cfg {String} name
18152 * String to display while loading.
18156 * @cfg {String} region
18157 * Region to render component to (defaults to center)
18162 * @cfg {Array} items
18163 * A single item array - the first element is the root of the tree..
18164 * It's done this way to stay compatible with the Xtype system...
18170 * The method that retuns the tree of parts that make up this compoennt
18177 * render element to dom or tree
18178 * @param {Roo.Element|String|DomElement} optional render to if parent is not set.
18181 render : function(el)
18185 var hp = this.parent ? 1 : 0;
18186 Roo.debug && Roo.log(this);
18188 var tree = this._tree ? this._tree() : this.tree();
18191 if (!el && typeof(this.parent) == 'string' && this.parent.substring(0,1) == '#') {
18192 // if parent is a '#.....' string, then let's use that..
18193 var ename = this.parent.substr(1);
18194 this.parent = false;
18195 Roo.debug && Roo.log(ename);
18197 case 'bootstrap-body':
18198 if (typeof(tree.el) != 'undefined' && tree.el == document.body) {
18199 // this is the BorderLayout standard?
18200 this.parent = { el : true };
18203 if (["Nest", "Content", "Grid", "Tree"].indexOf(tree.xtype) > -1) {
18204 // need to insert stuff...
18206 el : new Roo.bootstrap.layout.Border({
18207 el : document.body,
18213 tabPosition: 'top',
18214 //resizeTabs: true,
18215 alwaysShowTabs: true,
18225 if (typeof(Roo.bootstrap.Body) != 'undefined' ) {
18226 this.parent = { el : new Roo.bootstrap.Body() };
18227 Roo.debug && Roo.log("setting el to doc body");
18230 throw "Container is bootstrap body, but Roo.bootstrap.Body is not defined";
18234 this.parent = { el : true};
18237 el = Roo.get(ename);
18238 if (typeof(Roo.bootstrap) != 'undefined' && tree['|xns'] == 'Roo.bootstrap') {
18239 this.parent = { el : true};
18246 if (!el && !this.parent) {
18247 Roo.debug && Roo.log("Warning - element can not be found :#" + ename );
18252 Roo.debug && Roo.log("EL:");
18253 Roo.debug && Roo.log(el);
18254 Roo.debug && Roo.log("this.parent.el:");
18255 Roo.debug && Roo.log(this.parent.el);
18258 // altertive root elements ??? - we need a better way to indicate these.
18259 var is_alt = Roo.XComponent.is_alt ||
18260 (typeof(tree.el) != 'undefined' && tree.el == document.body) ||
18261 (typeof(Roo.bootstrap) != 'undefined' && tree.xns == Roo.bootstrap) ||
18262 (typeof(Roo.mailer) != 'undefined' && tree.xns == Roo.mailer) ;
18266 if (!this.parent && is_alt) {
18267 //el = Roo.get(document.body);
18268 this.parent = { el : true };
18273 if (!this.parent) {
18275 Roo.debug && Roo.log("no parent - creating one");
18277 el = el ? Roo.get(el) : false;
18279 if (typeof(Roo.BorderLayout) == 'undefined' ) {
18282 el : new Roo.bootstrap.layout.Border({
18283 el: el || document.body,
18289 tabPosition: 'top',
18290 //resizeTabs: true,
18291 alwaysShowTabs: false,
18294 overflow: 'visible'
18300 // it's a top level one..
18302 el : new Roo.BorderLayout(el || document.body, {
18307 tabPosition: 'top',
18308 //resizeTabs: true,
18309 alwaysShowTabs: el && hp? false : true,
18310 hideTabs: el || !hp ? true : false,
18318 if (!this.parent.el) {
18319 // probably an old style ctor, which has been disabled.
18323 // The 'tree' method is '_tree now'
18325 tree.region = tree.region || this.region;
18326 var is_body = false;
18327 if (this.parent.el === true) {
18328 // bootstrap... - body..
18332 this.parent.el = Roo.factory(tree);
18336 this.el = this.parent.el.addxtype(tree, undefined, is_body);
18337 this.fireEvent('built', this);
18339 this.panel = this.el;
18340 this.layout = this.panel.layout;
18341 this.parentLayout = this.parent.layout || false;
18347 Roo.apply(Roo.XComponent, {
18349 * @property hideProgress
18350 * true to disable the building progress bar.. usefull on single page renders.
18353 hideProgress : false,
18355 * @property buildCompleted
18356 * True when the builder has completed building the interface.
18359 buildCompleted : false,
18362 * @property topModule
18363 * the upper most module - uses document.element as it's constructor.
18370 * @property modules
18371 * array of modules to be created by registration system.
18372 * @type {Array} of Roo.XComponent
18377 * @property elmodules
18378 * array of modules to be created by which use #ID
18379 * @type {Array} of Roo.XComponent
18386 * Is an alternative Root - normally used by bootstrap or other systems,
18387 * where the top element in the tree can wrap 'body'
18388 * @type {boolean} (default false)
18393 * @property build_from_html
18394 * Build elements from html - used by bootstrap HTML stuff
18395 * - this is cleared after build is completed
18396 * @type {boolean} (default false)
18399 build_from_html : false,
18401 * Register components to be built later.
18403 * This solves the following issues
18404 * - Building is not done on page load, but after an authentication process has occured.
18405 * - Interface elements are registered on page load
18406 * - Parent Interface elements may not be loaded before child, so this handles that..
18413 module : 'Pman.Tab.projectMgr',
18415 parent : 'Pman.layout',
18416 disabled : false, // or use a function..
18419 * * @param {Object} details about module
18421 register : function(obj) {
18423 Roo.XComponent.event.fireEvent('register', obj);
18424 switch(typeof(obj.disabled) ) {
18430 if ( obj.disabled() ) {
18436 if (obj.disabled || obj.region == '#disabled') {
18442 this.modules.push(obj);
18446 * convert a string to an object..
18447 * eg. 'AAA.BBB' -> finds AAA.BBB
18451 toObject : function(str)
18453 if (!str || typeof(str) == 'object') {
18456 if (str.substring(0,1) == '#') {
18460 var ar = str.split('.');
18465 eval('if (typeof ' + rt + ' == "undefined"){ o = false;} o = ' + rt + ';');
18467 throw "Module not found : " + str;
18471 throw "Module not found : " + str;
18473 Roo.each(ar, function(e) {
18474 if (typeof(o[e]) == 'undefined') {
18475 throw "Module not found : " + str;
18486 * move modules into their correct place in the tree..
18489 preBuild : function ()
18492 Roo.each(this.modules , function (obj)
18494 Roo.XComponent.event.fireEvent('beforebuild', obj);
18496 var opar = obj.parent;
18498 obj.parent = this.toObject(opar);
18500 Roo.debug && Roo.log("parent:toObject failed: " + e.toString());
18505 Roo.debug && Roo.log("GOT top level module");
18506 Roo.debug && Roo.log(obj);
18507 obj.modules = new Roo.util.MixedCollection(false,
18508 function(o) { return o.order + '' }
18510 this.topModule = obj;
18513 // parent is a string (usually a dom element name..)
18514 if (typeof(obj.parent) == 'string') {
18515 this.elmodules.push(obj);
18518 if (obj.parent.constructor != Roo.XComponent) {
18519 Roo.debug && Roo.log("Warning : Object Parent is not instance of XComponent:" + obj.name)
18521 if (!obj.parent.modules) {
18522 obj.parent.modules = new Roo.util.MixedCollection(false,
18523 function(o) { return o.order + '' }
18526 if (obj.parent.disabled) {
18527 obj.disabled = true;
18529 obj.parent.modules.add(obj);
18534 * make a list of modules to build.
18535 * @return {Array} list of modules.
18538 buildOrder : function()
18541 var cmp = function(a,b) {
18542 return String(a).toUpperCase() > String(b).toUpperCase() ? 1 : -1;
18544 if ((!this.topModule || !this.topModule.modules) && !this.elmodules.length) {
18545 throw "No top level modules to build";
18548 // make a flat list in order of modules to build.
18549 var mods = this.topModule ? [ this.topModule ] : [];
18552 // elmodules (is a list of DOM based modules )
18553 Roo.each(this.elmodules, function(e) {
18555 if (!this.topModule &&
18556 typeof(e.parent) == 'string' &&
18557 e.parent.substring(0,1) == '#' &&
18558 Roo.get(e.parent.substr(1))
18561 _this.topModule = e;
18567 // add modules to their parents..
18568 var addMod = function(m) {
18569 Roo.debug && Roo.log("build Order: add: " + m.name);
18572 if (m.modules && !m.disabled) {
18573 Roo.debug && Roo.log("build Order: " + m.modules.length + " child modules");
18574 m.modules.keySort('ASC', cmp );
18575 Roo.debug && Roo.log("build Order: " + m.modules.length + " child modules (after sort)");
18577 m.modules.each(addMod);
18579 Roo.debug && Roo.log("build Order: no child modules");
18581 // not sure if this is used any more..
18583 m.finalize.name = m.name + " (clean up) ";
18584 mods.push(m.finalize);
18588 if (this.topModule && this.topModule.modules) {
18589 this.topModule.modules.keySort('ASC', cmp );
18590 this.topModule.modules.each(addMod);
18596 * Build the registered modules.
18597 * @param {Object} parent element.
18598 * @param {Function} optional method to call after module has been added.
18602 build : function(opts)
18605 if (typeof(opts) != 'undefined') {
18606 Roo.apply(this,opts);
18610 var mods = this.buildOrder();
18612 //this.allmods = mods;
18613 //Roo.debug && Roo.log(mods);
18615 if (!mods.length) { // should not happen
18616 throw "NO modules!!!";
18620 var msg = "Building Interface...";
18621 // flash it up as modal - so we store the mask!?
18622 if (!this.hideProgress && Roo.MessageBox) {
18623 Roo.MessageBox.show({ title: 'loading' });
18624 Roo.MessageBox.show({
18625 title: "Please wait...",
18635 var total = mods.length;
18638 var progressRun = function() {
18639 if (!mods.length) {
18640 Roo.debug && Roo.log('hide?');
18641 if (!this.hideProgress && Roo.MessageBox) {
18642 Roo.MessageBox.hide();
18644 Roo.XComponent.build_from_html = false; // reset, so dialogs will be build from javascript
18646 Roo.XComponent.event.fireEvent('buildcomplete', _this.topModule);
18652 var m = mods.shift();
18655 Roo.debug && Roo.log(m);
18656 // not sure if this is supported any more.. - modules that are are just function
18657 if (typeof(m) == 'function') {
18659 return progressRun.defer(10, _this);
18663 msg = "Building Interface " + (total - mods.length) +
18665 (m.name ? (' - ' + m.name) : '');
18666 Roo.debug && Roo.log(msg);
18667 if (!_this.hideProgress && Roo.MessageBox) {
18668 Roo.MessageBox.updateProgress( (total - mods.length)/total, msg );
18672 // is the module disabled?
18673 var disabled = (typeof(m.disabled) == 'function') ?
18674 m.disabled.call(m.module.disabled) : m.disabled;
18678 return progressRun(); // we do not update the display!
18686 // it's 10 on top level, and 1 on others??? why...
18687 return progressRun.defer(10, _this);
18690 progressRun.defer(1, _this);
18696 * Overlay a set of modified strings onto a component
18697 * This is dependant on our builder exporting the strings and 'named strings' elements.
18699 * @param {Object} element to overlay on - eg. Pman.Dialog.Login
18700 * @param {Object} associative array of 'named' string and it's new value.
18703 overlayStrings : function( component, strings )
18705 if (typeof(component['_named_strings']) == 'undefined') {
18706 throw "ERROR: component does not have _named_strings";
18708 for ( var k in strings ) {
18709 var md = typeof(component['_named_strings'][k]) == 'undefined' ? false : component['_named_strings'][k];
18710 if (md !== false) {
18711 component['_strings'][md] = strings[k];
18713 Roo.log('could not find named string: ' + k + ' in');
18714 Roo.log(component);
18729 * wrapper for event.on - aliased later..
18730 * Typically use to register a event handler for register:
18732 * eg. Roo.XComponent.on('register', function(comp) { comp.disable = true } );
18741 Roo.XComponent.event = new Roo.util.Observable({
18745 * Fires when an Component is registered,
18746 * set the disable property on the Component to stop registration.
18747 * @param {Roo.XComponent} c the component being registerd.
18752 * @event beforebuild
18753 * Fires before each Component is built
18754 * can be used to apply permissions.
18755 * @param {Roo.XComponent} c the component being registerd.
18758 'beforebuild' : true,
18760 * @event buildcomplete
18761 * Fires on the top level element when all elements have been built
18762 * @param {Roo.XComponent} the top level component.
18764 'buildcomplete' : true
18769 Roo.XComponent.on = Roo.XComponent.event.on.createDelegate(Roo.XComponent.event);
18772 * marked - a markdown parser
18773 * Copyright (c) 2011-2014, Christopher Jeffrey. (MIT Licensed)
18774 * https://github.com/chjj/marked
18780 * Roo.Markdown - is a very crude wrapper around marked..
18784 * alert( Roo.Markdown.toHtml("Markdown *rocks*.") );
18786 * Note: move the sample code to the bottom of this
18787 * file before uncommenting it.
18792 Roo.Markdown.toHtml = function(text) {
18794 var c = new Roo.Markdown.marked.setOptions({
18795 renderer: new Roo.Markdown.marked.Renderer(),
18806 text = text.replace(/\\\n/g,' ');
18807 return Roo.Markdown.marked(text);
18812 // Wraps all "globals" so that the only thing
18813 // exposed is makeHtml().
18819 * eval:var:unescape
18827 var escape = function (html, encode) {
18829 .replace(!encode ? /&(?!#?\w+;)/g : /&/g, '&')
18830 .replace(/</g, '<')
18831 .replace(/>/g, '>')
18832 .replace(/"/g, '"')
18833 .replace(/'/g, ''');
18836 var unescape = function (html) {
18837 // explicitly match decimal, hex, and named HTML entities
18838 return html.replace(/&(#(?:\d+)|(?:#x[0-9A-Fa-f]+)|(?:\w+));?/g, function(_, n) {
18839 n = n.toLowerCase();
18840 if (n === 'colon') { return ':'; }
18841 if (n.charAt(0) === '#') {
18842 return n.charAt(1) === 'x'
18843 ? String.fromCharCode(parseInt(n.substring(2), 16))
18844 : String.fromCharCode(+n.substring(1));
18850 var replace = function (regex, opt) {
18851 regex = regex.source;
18853 return function self(name, val) {
18854 if (!name) { return new RegExp(regex, opt); }
18855 val = val.source || val;
18856 val = val.replace(/(^|[^\[])\^/g, '$1');
18857 regex = regex.replace(name, val);
18866 var noop = function () {}
18872 var merge = function (obj) {
18877 for (; i < arguments.length; i++) {
18878 target = arguments[i];
18879 for (key in target) {
18880 if (Object.prototype.hasOwnProperty.call(target, key)) {
18881 obj[key] = target[key];
18891 * Block-Level Grammar
18899 code: /^( {4}[^\n]+\n*)+/,
18901 hr: /^( *[-*_]){3,} *(?:\n+|$)/,
18902 heading: /^ *(#{1,6}) *([^\n]+?) *#* *(?:\n+|$)/,
18904 lheading: /^([^\n]+)\n *(=|-){2,} *(?:\n+|$)/,
18905 blockquote: /^( *>[^\n]+(\n(?!def)[^\n]+)*\n*)+/,
18906 list: /^( *)(bull) [\s\S]+?(?:hr|def|\n{2,}(?! )(?!\1bull )\n*|\s*$)/,
18907 html: /^ *(?:comment *(?:\n|\s*$)|closed *(?:\n{2,}|\s*$)|closing *(?:\n{2,}|\s*$))/,
18908 def: /^ *\[([^\]]+)\]: *<?([^\s>]+)>?(?: +["(]([^\n]+)[")])? *(?:\n+|$)/,
18910 paragraph: /^((?:[^\n]+\n?(?!hr|heading|lheading|blockquote|tag|def))+)\n*/,
18914 block.bullet = /(?:[*+-]|\d+\.)/;
18915 block.item = /^( *)(bull) [^\n]*(?:\n(?!\1bull )[^\n]*)*/;
18916 block.item = replace(block.item, 'gm')
18917 (/bull/g, block.bullet)
18920 block.list = replace(block.list)
18921 (/bull/g, block.bullet)
18922 ('hr', '\\n+(?=\\1?(?:[-*_] *){3,}(?:\\n+|$))')
18923 ('def', '\\n+(?=' + block.def.source + ')')
18926 block.blockquote = replace(block.blockquote)
18930 block._tag = '(?!(?:'
18931 + 'a|em|strong|small|s|cite|q|dfn|abbr|data|time|code'
18932 + '|var|samp|kbd|sub|sup|i|b|u|mark|ruby|rt|rp|bdi|bdo'
18933 + '|span|br|wbr|ins|del|img)\\b)\\w+(?!:/|[^\\w\\s@]*@)\\b';
18935 block.html = replace(block.html)
18936 ('comment', /<!--[\s\S]*?-->/)
18937 ('closed', /<(tag)[\s\S]+?<\/\1>/)
18938 ('closing', /<tag(?:"[^"]*"|'[^']*'|[^'">])*?>/)
18939 (/tag/g, block._tag)
18942 block.paragraph = replace(block.paragraph)
18944 ('heading', block.heading)
18945 ('lheading', block.lheading)
18946 ('blockquote', block.blockquote)
18947 ('tag', '<' + block._tag)
18952 * Normal Block Grammar
18955 block.normal = merge({}, block);
18958 * GFM Block Grammar
18961 block.gfm = merge({}, block.normal, {
18962 fences: /^ *(`{3,}|~{3,})[ \.]*(\S+)? *\n([\s\S]*?)\s*\1 *(?:\n+|$)/,
18964 heading: /^ *(#{1,6}) +([^\n]+?) *#* *(?:\n+|$)/
18967 block.gfm.paragraph = replace(block.paragraph)
18969 + block.gfm.fences.source.replace('\\1', '\\2') + '|'
18970 + block.list.source.replace('\\1', '\\3') + '|')
18974 * GFM + Tables Block Grammar
18977 block.tables = merge({}, block.gfm, {
18978 nptable: /^ *(\S.*\|.*)\n *([-:]+ *\|[-| :]*)\n((?:.*\|.*(?:\n|$))*)\n*/,
18979 table: /^ *\|(.+)\n *\|( *[-:]+[-| :]*)\n((?: *\|.*(?:\n|$))*)\n*/
18986 var Lexer = function (options) {
18988 this.tokens.links = {};
18989 this.options = options || marked.defaults;
18990 this.rules = block.normal;
18992 if (this.options.gfm) {
18993 if (this.options.tables) {
18994 this.rules = block.tables;
18996 this.rules = block.gfm;
19002 * Expose Block Rules
19005 Lexer.rules = block;
19008 * Static Lex Method
19011 Lexer.lex = function(src, options) {
19012 var lexer = new Lexer(options);
19013 return lexer.lex(src);
19020 Lexer.prototype.lex = function(src) {
19022 .replace(/\r\n|\r/g, '\n')
19023 .replace(/\t/g, ' ')
19024 .replace(/\u00a0/g, ' ')
19025 .replace(/\u2424/g, '\n');
19027 return this.token(src, true);
19034 Lexer.prototype.token = function(src, top, bq) {
19035 var src = src.replace(/^ +$/gm, '')
19048 if (cap = this.rules.newline.exec(src)) {
19049 src = src.substring(cap[0].length);
19050 if (cap[0].length > 1) {
19058 if (cap = this.rules.code.exec(src)) {
19059 src = src.substring(cap[0].length);
19060 cap = cap[0].replace(/^ {4}/gm, '');
19063 text: !this.options.pedantic
19064 ? cap.replace(/\n+$/, '')
19071 if (cap = this.rules.fences.exec(src)) {
19072 src = src.substring(cap[0].length);
19082 if (cap = this.rules.heading.exec(src)) {
19083 src = src.substring(cap[0].length);
19086 depth: cap[1].length,
19092 // table no leading pipe (gfm)
19093 if (top && (cap = this.rules.nptable.exec(src))) {
19094 src = src.substring(cap[0].length);
19098 header: cap[1].replace(/^ *| *\| *$/g, '').split(/ *\| */),
19099 align: cap[2].replace(/^ *|\| *$/g, '').split(/ *\| */),
19100 cells: cap[3].replace(/\n$/, '').split('\n')
19103 for (i = 0; i < item.align.length; i++) {
19104 if (/^ *-+: *$/.test(item.align[i])) {
19105 item.align[i] = 'right';
19106 } else if (/^ *:-+: *$/.test(item.align[i])) {
19107 item.align[i] = 'center';
19108 } else if (/^ *:-+ *$/.test(item.align[i])) {
19109 item.align[i] = 'left';
19111 item.align[i] = null;
19115 for (i = 0; i < item.cells.length; i++) {
19116 item.cells[i] = item.cells[i].split(/ *\| */);
19119 this.tokens.push(item);
19125 if (cap = this.rules.lheading.exec(src)) {
19126 src = src.substring(cap[0].length);
19129 depth: cap[2] === '=' ? 1 : 2,
19136 if (cap = this.rules.hr.exec(src)) {
19137 src = src.substring(cap[0].length);
19145 if (cap = this.rules.blockquote.exec(src)) {
19146 src = src.substring(cap[0].length);
19149 type: 'blockquote_start'
19152 cap = cap[0].replace(/^ *> ?/gm, '');
19154 // Pass `top` to keep the current
19155 // "toplevel" state. This is exactly
19156 // how markdown.pl works.
19157 this.token(cap, top, true);
19160 type: 'blockquote_end'
19167 if (cap = this.rules.list.exec(src)) {
19168 src = src.substring(cap[0].length);
19172 type: 'list_start',
19173 ordered: bull.length > 1
19176 // Get each top-level item.
19177 cap = cap[0].match(this.rules.item);
19183 for (; i < l; i++) {
19186 // Remove the list item's bullet
19187 // so it is seen as the next token.
19188 space = item.length;
19189 item = item.replace(/^ *([*+-]|\d+\.) +/, '');
19191 // Outdent whatever the
19192 // list item contains. Hacky.
19193 if (~item.indexOf('\n ')) {
19194 space -= item.length;
19195 item = !this.options.pedantic
19196 ? item.replace(new RegExp('^ {1,' + space + '}', 'gm'), '')
19197 : item.replace(/^ {1,4}/gm, '');
19200 // Determine whether the next list item belongs here.
19201 // Backpedal if it does not belong in this list.
19202 if (this.options.smartLists && i !== l - 1) {
19203 b = block.bullet.exec(cap[i + 1])[0];
19204 if (bull !== b && !(bull.length > 1 && b.length > 1)) {
19205 src = cap.slice(i + 1).join('\n') + src;
19210 // Determine whether item is loose or not.
19211 // Use: /(^|\n)(?! )[^\n]+\n\n(?!\s*$)/
19212 // for discount behavior.
19213 loose = next || /\n\n(?!\s*$)/.test(item);
19215 next = item.charAt(item.length - 1) === '\n';
19216 if (!loose) { loose = next; }
19221 ? 'loose_item_start'
19222 : 'list_item_start'
19226 this.token(item, false, bq);
19229 type: 'list_item_end'
19241 if (cap = this.rules.html.exec(src)) {
19242 src = src.substring(cap[0].length);
19244 type: this.options.sanitize
19247 pre: !this.options.sanitizer
19248 && (cap[1] === 'pre' || cap[1] === 'script' || cap[1] === 'style'),
19255 if ((!bq && top) && (cap = this.rules.def.exec(src))) {
19256 src = src.substring(cap[0].length);
19257 this.tokens.links[cap[1].toLowerCase()] = {
19265 if (top && (cap = this.rules.table.exec(src))) {
19266 src = src.substring(cap[0].length);
19270 header: cap[1].replace(/^ *| *\| *$/g, '').split(/ *\| */),
19271 align: cap[2].replace(/^ *|\| *$/g, '').split(/ *\| */),
19272 cells: cap[3].replace(/(?: *\| *)?\n$/, '').split('\n')
19275 for (i = 0; i < item.align.length; i++) {
19276 if (/^ *-+: *$/.test(item.align[i])) {
19277 item.align[i] = 'right';
19278 } else if (/^ *:-+: *$/.test(item.align[i])) {
19279 item.align[i] = 'center';
19280 } else if (/^ *:-+ *$/.test(item.align[i])) {
19281 item.align[i] = 'left';
19283 item.align[i] = null;
19287 for (i = 0; i < item.cells.length; i++) {
19288 item.cells[i] = item.cells[i]
19289 .replace(/^ *\| *| *\| *$/g, '')
19293 this.tokens.push(item);
19298 // top-level paragraph
19299 if (top && (cap = this.rules.paragraph.exec(src))) {
19300 src = src.substring(cap[0].length);
19303 text: cap[1].charAt(cap[1].length - 1) === '\n'
19304 ? cap[1].slice(0, -1)
19311 if (cap = this.rules.text.exec(src)) {
19312 // Top-level should never reach here.
19313 src = src.substring(cap[0].length);
19323 Error('Infinite loop on byte: ' + src.charCodeAt(0));
19327 return this.tokens;
19331 * Inline-Level Grammar
19335 escape: /^\\([\\`*{}\[\]()#+\-.!_>])/,
19336 autolink: /^<([^ >]+(@|:\/)[^ >]+)>/,
19338 tag: /^<!--[\s\S]*?-->|^<\/?\w+(?:"[^"]*"|'[^']*'|[^'">])*?>/,
19339 link: /^!?\[(inside)\]\(href\)/,
19340 reflink: /^!?\[(inside)\]\s*\[([^\]]*)\]/,
19341 nolink: /^!?\[((?:\[[^\]]*\]|[^\[\]])*)\]/,
19342 strong: /^__([\s\S]+?)__(?!_)|^\*\*([\s\S]+?)\*\*(?!\*)/,
19343 em: /^\b_((?:[^_]|__)+?)_\b|^\*((?:\*\*|[\s\S])+?)\*(?!\*)/,
19344 code: /^(`+)\s*([\s\S]*?[^`])\s*\1(?!`)/,
19345 br: /^ {2,}\n(?!\s*$)/,
19347 text: /^[\s\S]+?(?=[\\<!\[_*`]| {2,}\n|$)/
19350 inline._inside = /(?:\[[^\]]*\]|[^\[\]]|\](?=[^\[]*\]))*/;
19351 inline._href = /\s*<?([\s\S]*?)>?(?:\s+['"]([\s\S]*?)['"])?\s*/;
19353 inline.link = replace(inline.link)
19354 ('inside', inline._inside)
19355 ('href', inline._href)
19358 inline.reflink = replace(inline.reflink)
19359 ('inside', inline._inside)
19363 * Normal Inline Grammar
19366 inline.normal = merge({}, inline);
19369 * Pedantic Inline Grammar
19372 inline.pedantic = merge({}, inline.normal, {
19373 strong: /^__(?=\S)([\s\S]*?\S)__(?!_)|^\*\*(?=\S)([\s\S]*?\S)\*\*(?!\*)/,
19374 em: /^_(?=\S)([\s\S]*?\S)_(?!_)|^\*(?=\S)([\s\S]*?\S)\*(?!\*)/
19378 * GFM Inline Grammar
19381 inline.gfm = merge({}, inline.normal, {
19382 escape: replace(inline.escape)('])', '~|])')(),
19383 url: /^(https?:\/\/[^\s<]+[^<.,:;"')\]\s])/,
19384 del: /^~~(?=\S)([\s\S]*?\S)~~/,
19385 text: replace(inline.text)
19387 ('|', '|https?://|')
19392 * GFM + Line Breaks Inline Grammar
19395 inline.breaks = merge({}, inline.gfm, {
19396 br: replace(inline.br)('{2,}', '*')(),
19397 text: replace(inline.gfm.text)('{2,}', '*')()
19401 * Inline Lexer & Compiler
19404 var InlineLexer = function (links, options) {
19405 this.options = options || marked.defaults;
19406 this.links = links;
19407 this.rules = inline.normal;
19408 this.renderer = this.options.renderer || new Renderer;
19409 this.renderer.options = this.options;
19413 Error('Tokens array requires a `links` property.');
19416 if (this.options.gfm) {
19417 if (this.options.breaks) {
19418 this.rules = inline.breaks;
19420 this.rules = inline.gfm;
19422 } else if (this.options.pedantic) {
19423 this.rules = inline.pedantic;
19428 * Expose Inline Rules
19431 InlineLexer.rules = inline;
19434 * Static Lexing/Compiling Method
19437 InlineLexer.output = function(src, links, options) {
19438 var inline = new InlineLexer(links, options);
19439 return inline.output(src);
19446 InlineLexer.prototype.output = function(src) {
19455 if (cap = this.rules.escape.exec(src)) {
19456 src = src.substring(cap[0].length);
19462 if (cap = this.rules.autolink.exec(src)) {
19463 src = src.substring(cap[0].length);
19464 if (cap[2] === '@') {
19465 text = cap[1].charAt(6) === ':'
19466 ? this.mangle(cap[1].substring(7))
19467 : this.mangle(cap[1]);
19468 href = this.mangle('mailto:') + text;
19470 text = escape(cap[1]);
19473 out += this.renderer.link(href, null, text);
19478 if (!this.inLink && (cap = this.rules.url.exec(src))) {
19479 src = src.substring(cap[0].length);
19480 text = escape(cap[1]);
19482 out += this.renderer.link(href, null, text);
19487 if (cap = this.rules.tag.exec(src)) {
19488 if (!this.inLink && /^<a /i.test(cap[0])) {
19489 this.inLink = true;
19490 } else if (this.inLink && /^<\/a>/i.test(cap[0])) {
19491 this.inLink = false;
19493 src = src.substring(cap[0].length);
19494 out += this.options.sanitize
19495 ? this.options.sanitizer
19496 ? this.options.sanitizer(cap[0])
19503 if (cap = this.rules.link.exec(src)) {
19504 src = src.substring(cap[0].length);
19505 this.inLink = true;
19506 out += this.outputLink(cap, {
19510 this.inLink = false;
19515 if ((cap = this.rules.reflink.exec(src))
19516 || (cap = this.rules.nolink.exec(src))) {
19517 src = src.substring(cap[0].length);
19518 link = (cap[2] || cap[1]).replace(/\s+/g, ' ');
19519 link = this.links[link.toLowerCase()];
19520 if (!link || !link.href) {
19521 out += cap[0].charAt(0);
19522 src = cap[0].substring(1) + src;
19525 this.inLink = true;
19526 out += this.outputLink(cap, link);
19527 this.inLink = false;
19532 if (cap = this.rules.strong.exec(src)) {
19533 src = src.substring(cap[0].length);
19534 out += this.renderer.strong(this.output(cap[2] || cap[1]));
19539 if (cap = this.rules.em.exec(src)) {
19540 src = src.substring(cap[0].length);
19541 out += this.renderer.em(this.output(cap[2] || cap[1]));
19546 if (cap = this.rules.code.exec(src)) {
19547 src = src.substring(cap[0].length);
19548 out += this.renderer.codespan(escape(cap[2], true));
19553 if (cap = this.rules.br.exec(src)) {
19554 src = src.substring(cap[0].length);
19555 out += this.renderer.br();
19560 if (cap = this.rules.del.exec(src)) {
19561 src = src.substring(cap[0].length);
19562 out += this.renderer.del(this.output(cap[1]));
19567 if (cap = this.rules.text.exec(src)) {
19568 src = src.substring(cap[0].length);
19569 out += this.renderer.text(escape(this.smartypants(cap[0])));
19575 Error('Infinite loop on byte: ' + src.charCodeAt(0));
19586 InlineLexer.prototype.outputLink = function(cap, link) {
19587 var href = escape(link.href)
19588 , title = link.title ? escape(link.title) : null;
19590 return cap[0].charAt(0) !== '!'
19591 ? this.renderer.link(href, title, this.output(cap[1]))
19592 : this.renderer.image(href, title, escape(cap[1]));
19596 * Smartypants Transformations
19599 InlineLexer.prototype.smartypants = function(text) {
19600 if (!this.options.smartypants) { return text; }
19603 .replace(/---/g, '\u2014')
19605 .replace(/--/g, '\u2013')
19607 .replace(/(^|[-\u2014/(\[{"\s])'/g, '$1\u2018')
19608 // closing singles & apostrophes
19609 .replace(/'/g, '\u2019')
19611 .replace(/(^|[-\u2014/(\[{\u2018\s])"/g, '$1\u201c')
19613 .replace(/"/g, '\u201d')
19615 .replace(/\.{3}/g, '\u2026');
19622 InlineLexer.prototype.mangle = function(text) {
19623 if (!this.options.mangle) { return text; }
19629 for (; i < l; i++) {
19630 ch = text.charCodeAt(i);
19631 if (Math.random() > 0.5) {
19632 ch = 'x' + ch.toString(16);
19634 out += '&#' + ch + ';';
19645 * eval:var:Renderer
19648 var Renderer = function (options) {
19649 this.options = options || {};
19652 Renderer.prototype.code = function(code, lang, escaped) {
19653 if (this.options.highlight) {
19654 var out = this.options.highlight(code, lang);
19655 if (out != null && out !== code) {
19660 // hack!!! - it's already escapeD?
19665 return '<pre><code>'
19666 + (escaped ? code : escape(code, true))
19667 + '\n</code></pre>';
19670 return '<pre><code class="'
19671 + this.options.langPrefix
19672 + escape(lang, true)
19674 + (escaped ? code : escape(code, true))
19675 + '\n</code></pre>\n';
19678 Renderer.prototype.blockquote = function(quote) {
19679 return '<blockquote>\n' + quote + '</blockquote>\n';
19682 Renderer.prototype.html = function(html) {
19686 Renderer.prototype.heading = function(text, level, raw) {
19690 + this.options.headerPrefix
19691 + raw.toLowerCase().replace(/[^\w]+/g, '-')
19699 Renderer.prototype.hr = function() {
19700 return this.options.xhtml ? '<hr/>\n' : '<hr>\n';
19703 Renderer.prototype.list = function(body, ordered) {
19704 var type = ordered ? 'ol' : 'ul';
19705 return '<' + type + '>\n' + body + '</' + type + '>\n';
19708 Renderer.prototype.listitem = function(text) {
19709 return '<li>' + text + '</li>\n';
19712 Renderer.prototype.paragraph = function(text) {
19713 return '<p>' + text + '</p>\n';
19716 Renderer.prototype.table = function(header, body) {
19717 return '<table class="table table-striped">\n'
19727 Renderer.prototype.tablerow = function(content) {
19728 return '<tr>\n' + content + '</tr>\n';
19731 Renderer.prototype.tablecell = function(content, flags) {
19732 var type = flags.header ? 'th' : 'td';
19733 var tag = flags.align
19734 ? '<' + type + ' style="text-align:' + flags.align + '">'
19735 : '<' + type + '>';
19736 return tag + content + '</' + type + '>\n';
19739 // span level renderer
19740 Renderer.prototype.strong = function(text) {
19741 return '<strong>' + text + '</strong>';
19744 Renderer.prototype.em = function(text) {
19745 return '<em>' + text + '</em>';
19748 Renderer.prototype.codespan = function(text) {
19749 return '<code>' + text + '</code>';
19752 Renderer.prototype.br = function() {
19753 return this.options.xhtml ? '<br/>' : '<br>';
19756 Renderer.prototype.del = function(text) {
19757 return '<del>' + text + '</del>';
19760 Renderer.prototype.link = function(href, title, text) {
19761 if (this.options.sanitize) {
19763 var prot = decodeURIComponent(unescape(href))
19764 .replace(/[^\w:]/g, '')
19769 if (prot.indexOf('javascript:') === 0 || prot.indexOf('vbscript:') === 0) {
19773 var out = '<a href="' + href + '"';
19775 out += ' title="' + title + '"';
19777 out += '>' + text + '</a>';
19781 Renderer.prototype.image = function(href, title, text) {
19782 var out = '<img src="' + href + '" alt="' + text + '"';
19784 out += ' title="' + title + '"';
19786 out += this.options.xhtml ? '/>' : '>';
19790 Renderer.prototype.text = function(text) {
19795 * Parsing & Compiling
19801 var Parser= function (options) {
19804 this.options = options || marked.defaults;
19805 this.options.renderer = this.options.renderer || new Renderer;
19806 this.renderer = this.options.renderer;
19807 this.renderer.options = this.options;
19811 * Static Parse Method
19814 Parser.parse = function(src, options, renderer) {
19815 var parser = new Parser(options, renderer);
19816 return parser.parse(src);
19823 Parser.prototype.parse = function(src) {
19824 this.inline = new InlineLexer(src.links, this.options, this.renderer);
19825 this.tokens = src.reverse();
19828 while (this.next()) {
19839 Parser.prototype.next = function() {
19840 return this.token = this.tokens.pop();
19844 * Preview Next Token
19847 Parser.prototype.peek = function() {
19848 return this.tokens[this.tokens.length - 1] || 0;
19852 * Parse Text Tokens
19855 Parser.prototype.parseText = function() {
19856 var body = this.token.text;
19858 while (this.peek().type === 'text') {
19859 body += '\n' + this.next().text;
19862 return this.inline.output(body);
19866 * Parse Current Token
19869 Parser.prototype.tok = function() {
19870 switch (this.token.type) {
19875 return this.renderer.hr();
19878 return this.renderer.heading(
19879 this.inline.output(this.token.text),
19884 return this.renderer.code(this.token.text,
19886 this.token.escaped);
19899 for (i = 0; i < this.token.header.length; i++) {
19900 flags = { header: true, align: this.token.align[i] };
19901 cell += this.renderer.tablecell(
19902 this.inline.output(this.token.header[i]),
19903 { header: true, align: this.token.align[i] }
19906 header += this.renderer.tablerow(cell);
19908 for (i = 0; i < this.token.cells.length; i++) {
19909 row = this.token.cells[i];
19912 for (j = 0; j < row.length; j++) {
19913 cell += this.renderer.tablecell(
19914 this.inline.output(row[j]),
19915 { header: false, align: this.token.align[j] }
19919 body += this.renderer.tablerow(cell);
19921 return this.renderer.table(header, body);
19923 case 'blockquote_start': {
19926 while (this.next().type !== 'blockquote_end') {
19927 body += this.tok();
19930 return this.renderer.blockquote(body);
19932 case 'list_start': {
19934 , ordered = this.token.ordered;
19936 while (this.next().type !== 'list_end') {
19937 body += this.tok();
19940 return this.renderer.list(body, ordered);
19942 case 'list_item_start': {
19945 while (this.next().type !== 'list_item_end') {
19946 body += this.token.type === 'text'
19951 return this.renderer.listitem(body);
19953 case 'loose_item_start': {
19956 while (this.next().type !== 'list_item_end') {
19957 body += this.tok();
19960 return this.renderer.listitem(body);
19963 var html = !this.token.pre && !this.options.pedantic
19964 ? this.inline.output(this.token.text)
19966 return this.renderer.html(html);
19968 case 'paragraph': {
19969 return this.renderer.paragraph(this.inline.output(this.token.text));
19972 return this.renderer.paragraph(this.parseText());
19984 var marked = function (src, opt, callback) {
19985 if (callback || typeof opt === 'function') {
19991 opt = merge({}, marked.defaults, opt || {});
19993 var highlight = opt.highlight
19999 tokens = Lexer.lex(src, opt)
20001 return callback(e);
20004 pending = tokens.length;
20008 var done = function(err) {
20010 opt.highlight = highlight;
20011 return callback(err);
20017 out = Parser.parse(tokens, opt);
20022 opt.highlight = highlight;
20026 : callback(null, out);
20029 if (!highlight || highlight.length < 3) {
20033 delete opt.highlight;
20035 if (!pending) { return done(); }
20037 for (; i < tokens.length; i++) {
20039 if (token.type !== 'code') {
20040 return --pending || done();
20042 return highlight(token.text, token.lang, function(err, code) {
20043 if (err) { return done(err); }
20044 if (code == null || code === token.text) {
20045 return --pending || done();
20048 token.escaped = true;
20049 --pending || done();
20057 if (opt) { opt = merge({}, marked.defaults, opt); }
20058 return Parser.parse(Lexer.lex(src, opt), opt);
20060 e.message += '\nPlease report this to https://github.com/chjj/marked.';
20061 if ((opt || marked.defaults).silent) {
20062 return '<p>An error occured:</p><pre>'
20063 + escape(e.message + '', true)
20075 marked.setOptions = function(opt) {
20076 merge(marked.defaults, opt);
20080 marked.defaults = {
20091 langPrefix: 'lang-',
20092 smartypants: false,
20094 renderer: new Renderer,
20102 marked.Parser = Parser;
20103 marked.parser = Parser.parse;
20105 marked.Renderer = Renderer;
20107 marked.Lexer = Lexer;
20108 marked.lexer = Lexer.lex;
20110 marked.InlineLexer = InlineLexer;
20111 marked.inlineLexer = InlineLexer.output;
20113 marked.parse = marked;
20115 Roo.Markdown.marked = marked;
20119 * Ext JS Library 1.1.1
20120 * Copyright(c) 2006-2007, Ext JS, LLC.
20122 * Originally Released Under LGPL - original licence link has changed is not relivant.
20125 * <script type="text/javascript">
20131 * These classes are derivatives of the similarly named classes in the YUI Library.
20132 * The original license:
20133 * Copyright (c) 2006, Yahoo! Inc. All rights reserved.
20134 * Code licensed under the BSD License:
20135 * http://developer.yahoo.net/yui/license.txt
20140 var Event=Roo.EventManager;
20141 var Dom=Roo.lib.Dom;
20144 * @class Roo.dd.DragDrop
20145 * @extends Roo.util.Observable
20146 * Defines the interface and base operation of items that that can be
20147 * dragged or can be drop targets. It was designed to be extended, overriding
20148 * the event handlers for startDrag, onDrag, onDragOver and onDragOut.
20149 * Up to three html elements can be associated with a DragDrop instance:
20151 * <li>linked element: the element that is passed into the constructor.
20152 * This is the element which defines the boundaries for interaction with
20153 * other DragDrop objects.</li>
20154 * <li>handle element(s): The drag operation only occurs if the element that
20155 * was clicked matches a handle element. By default this is the linked
20156 * element, but there are times that you will want only a portion of the
20157 * linked element to initiate the drag operation, and the setHandleElId()
20158 * method provides a way to define this.</li>
20159 * <li>drag element: this represents the element that would be moved along
20160 * with the cursor during a drag operation. By default, this is the linked
20161 * element itself as in {@link Roo.dd.DD}. setDragElId() lets you define
20162 * a separate element that would be moved, as in {@link Roo.dd.DDProxy}.
20165 * This class should not be instantiated until the onload event to ensure that
20166 * the associated elements are available.
20167 * The following would define a DragDrop obj that would interact with any
20168 * other DragDrop obj in the "group1" group:
20170 * dd = new Roo.dd.DragDrop("div1", "group1");
20172 * Since none of the event handlers have been implemented, nothing would
20173 * actually happen if you were to run the code above. Normally you would
20174 * override this class or one of the default implementations, but you can
20175 * also override the methods you want on an instance of the class...
20177 * dd.onDragDrop = function(e, id) {
20178 * alert("dd was dropped on " + id);
20182 * @param {String} id of the element that is linked to this instance
20183 * @param {String} sGroup the group of related DragDrop objects
20184 * @param {object} config an object containing configurable attributes
20185 * Valid properties for DragDrop:
20186 * padding, isTarget, maintainOffset, primaryButtonOnly
20188 Roo.dd.DragDrop = function(id, sGroup, config) {
20190 this.init(id, sGroup, config);
20195 Roo.extend(Roo.dd.DragDrop, Roo.util.Observable , {
20198 * The id of the element associated with this object. This is what we
20199 * refer to as the "linked element" because the size and position of
20200 * this element is used to determine when the drag and drop objects have
20208 * Configuration attributes passed into the constructor
20215 * The id of the element that will be dragged. By default this is same
20216 * as the linked element , but could be changed to another element. Ex:
20218 * @property dragElId
20225 * the id of the element that initiates the drag operation. By default
20226 * this is the linked element, but could be changed to be a child of this
20227 * element. This lets us do things like only starting the drag when the
20228 * header element within the linked html element is clicked.
20229 * @property handleElId
20236 * An associative array of HTML tags that will be ignored if clicked.
20237 * @property invalidHandleTypes
20238 * @type {string: string}
20240 invalidHandleTypes: null,
20243 * An associative array of ids for elements that will be ignored if clicked
20244 * @property invalidHandleIds
20245 * @type {string: string}
20247 invalidHandleIds: null,
20250 * An indexted array of css class names for elements that will be ignored
20252 * @property invalidHandleClasses
20255 invalidHandleClasses: null,
20258 * The linked element's absolute X position at the time the drag was
20260 * @property startPageX
20267 * The linked element's absolute X position at the time the drag was
20269 * @property startPageY
20276 * The group defines a logical collection of DragDrop objects that are
20277 * related. Instances only get events when interacting with other
20278 * DragDrop object in the same group. This lets us define multiple
20279 * groups using a single DragDrop subclass if we want.
20281 * @type {string: string}
20286 * Individual drag/drop instances can be locked. This will prevent
20287 * onmousedown start drag.
20295 * Lock this instance
20298 lock: function() { this.locked = true; },
20301 * Unlock this instace
20304 unlock: function() { this.locked = false; },
20307 * By default, all insances can be a drop target. This can be disabled by
20308 * setting isTarget to false.
20315 * The padding configured for this drag and drop object for calculating
20316 * the drop zone intersection with this object.
20323 * Cached reference to the linked element
20324 * @property _domRef
20330 * Internal typeof flag
20331 * @property __ygDragDrop
20334 __ygDragDrop: true,
20337 * Set to true when horizontal contraints are applied
20338 * @property constrainX
20345 * Set to true when vertical contraints are applied
20346 * @property constrainY
20353 * The left constraint
20361 * The right constraint
20369 * The up constraint
20378 * The down constraint
20386 * Maintain offsets when we resetconstraints. Set to true when you want
20387 * the position of the element relative to its parent to stay the same
20388 * when the page changes
20390 * @property maintainOffset
20393 maintainOffset: false,
20396 * Array of pixel locations the element will snap to if we specified a
20397 * horizontal graduation/interval. This array is generated automatically
20398 * when you define a tick interval.
20405 * Array of pixel locations the element will snap to if we specified a
20406 * vertical graduation/interval. This array is generated automatically
20407 * when you define a tick interval.
20414 * By default the drag and drop instance will only respond to the primary
20415 * button click (left button for a right-handed mouse). Set to true to
20416 * allow drag and drop to start with any mouse click that is propogated
20418 * @property primaryButtonOnly
20421 primaryButtonOnly: true,
20424 * The availabe property is false until the linked dom element is accessible.
20425 * @property available
20431 * By default, drags can only be initiated if the mousedown occurs in the
20432 * region the linked element is. This is done in part to work around a
20433 * bug in some browsers that mis-report the mousedown if the previous
20434 * mouseup happened outside of the window. This property is set to true
20435 * if outer handles are defined.
20437 * @property hasOuterHandles
20441 hasOuterHandles: false,
20444 * Code that executes immediately before the startDrag event
20445 * @method b4StartDrag
20448 b4StartDrag: function(x, y) { },
20451 * Abstract method called after a drag/drop object is clicked
20452 * and the drag or mousedown time thresholds have beeen met.
20453 * @method startDrag
20454 * @param {int} X click location
20455 * @param {int} Y click location
20457 startDrag: function(x, y) { /* override this */ },
20460 * Code that executes immediately before the onDrag event
20464 b4Drag: function(e) { },
20467 * Abstract method called during the onMouseMove event while dragging an
20470 * @param {Event} e the mousemove event
20472 onDrag: function(e) { /* override this */ },
20475 * Abstract method called when this element fist begins hovering over
20476 * another DragDrop obj
20477 * @method onDragEnter
20478 * @param {Event} e the mousemove event
20479 * @param {String|DragDrop[]} id In POINT mode, the element
20480 * id this is hovering over. In INTERSECT mode, an array of one or more
20481 * dragdrop items being hovered over.
20483 onDragEnter: function(e, id) { /* override this */ },
20486 * Code that executes immediately before the onDragOver event
20487 * @method b4DragOver
20490 b4DragOver: function(e) { },
20493 * Abstract method called when this element is hovering over another
20495 * @method onDragOver
20496 * @param {Event} e the mousemove event
20497 * @param {String|DragDrop[]} id In POINT mode, the element
20498 * id this is hovering over. In INTERSECT mode, an array of dd items
20499 * being hovered over.
20501 onDragOver: function(e, id) { /* override this */ },
20504 * Code that executes immediately before the onDragOut event
20505 * @method b4DragOut
20508 b4DragOut: function(e) { },
20511 * Abstract method called when we are no longer hovering over an element
20512 * @method onDragOut
20513 * @param {Event} e the mousemove event
20514 * @param {String|DragDrop[]} id In POINT mode, the element
20515 * id this was hovering over. In INTERSECT mode, an array of dd items
20516 * that the mouse is no longer over.
20518 onDragOut: function(e, id) { /* override this */ },
20521 * Code that executes immediately before the onDragDrop event
20522 * @method b4DragDrop
20525 b4DragDrop: function(e) { },
20528 * Abstract method called when this item is dropped on another DragDrop
20530 * @method onDragDrop
20531 * @param {Event} e the mouseup event
20532 * @param {String|DragDrop[]} id In POINT mode, the element
20533 * id this was dropped on. In INTERSECT mode, an array of dd items this
20536 onDragDrop: function(e, id) { /* override this */ },
20539 * Abstract method called when this item is dropped on an area with no
20541 * @method onInvalidDrop
20542 * @param {Event} e the mouseup event
20544 onInvalidDrop: function(e) { /* override this */ },
20547 * Code that executes immediately before the endDrag event
20548 * @method b4EndDrag
20551 b4EndDrag: function(e) { },
20554 * Fired when we are done dragging the object
20556 * @param {Event} e the mouseup event
20558 endDrag: function(e) { /* override this */ },
20561 * Code executed immediately before the onMouseDown event
20562 * @method b4MouseDown
20563 * @param {Event} e the mousedown event
20566 b4MouseDown: function(e) { },
20569 * Event handler that fires when a drag/drop obj gets a mousedown
20570 * @method onMouseDown
20571 * @param {Event} e the mousedown event
20573 onMouseDown: function(e) { /* override this */ },
20576 * Event handler that fires when a drag/drop obj gets a mouseup
20577 * @method onMouseUp
20578 * @param {Event} e the mouseup event
20580 onMouseUp: function(e) { /* override this */ },
20583 * Override the onAvailable method to do what is needed after the initial
20584 * position was determined.
20585 * @method onAvailable
20587 onAvailable: function () {
20591 * Provides default constraint padding to "constrainTo" elements (defaults to {left: 0, right:0, top:0, bottom:0}).
20594 defaultPadding : {left:0, right:0, top:0, bottom:0},
20597 * Initializes the drag drop object's constraints to restrict movement to a certain element.
20601 var dd = new Roo.dd.DDProxy("dragDiv1", "proxytest",
20602 { dragElId: "existingProxyDiv" });
20603 dd.startDrag = function(){
20604 this.constrainTo("parent-id");
20607 * Or you can initalize it using the {@link Roo.Element} object:
20609 Roo.get("dragDiv1").initDDProxy("proxytest", {dragElId: "existingProxyDiv"}, {
20610 startDrag : function(){
20611 this.constrainTo("parent-id");
20615 * @param {String/HTMLElement/Element} constrainTo The element to constrain to.
20616 * @param {Object/Number} pad (optional) Pad provides a way to specify "padding" of the constraints,
20617 * and can be either a number for symmetrical padding (4 would be equal to {left:4, right:4, top:4, bottom:4}) or
20618 * an object containing the sides to pad. For example: {right:10, bottom:10}
20619 * @param {Boolean} inContent (optional) Constrain the draggable in the content box of the element (inside padding and borders)
20621 constrainTo : function(constrainTo, pad, inContent){
20622 if(typeof pad == "number"){
20623 pad = {left: pad, right:pad, top:pad, bottom:pad};
20625 pad = pad || this.defaultPadding;
20626 var b = Roo.get(this.getEl()).getBox();
20627 var ce = Roo.get(constrainTo);
20628 var s = ce.getScroll();
20629 var c, cd = ce.dom;
20630 if(cd == document.body){
20631 c = { x: s.left, y: s.top, width: Roo.lib.Dom.getViewWidth(), height: Roo.lib.Dom.getViewHeight()};
20634 c = {x : xy[0]+s.left, y: xy[1]+s.top, width: cd.clientWidth, height: cd.clientHeight};
20638 var topSpace = b.y - c.y;
20639 var leftSpace = b.x - c.x;
20641 this.resetConstraints();
20642 this.setXConstraint(leftSpace - (pad.left||0), // left
20643 c.width - leftSpace - b.width - (pad.right||0) //right
20645 this.setYConstraint(topSpace - (pad.top||0), //top
20646 c.height - topSpace - b.height - (pad.bottom||0) //bottom
20651 * Returns a reference to the linked element
20653 * @return {HTMLElement} the html element
20655 getEl: function() {
20656 if (!this._domRef) {
20657 this._domRef = Roo.getDom(this.id);
20660 return this._domRef;
20664 * Returns a reference to the actual element to drag. By default this is
20665 * the same as the html element, but it can be assigned to another
20666 * element. An example of this can be found in Roo.dd.DDProxy
20667 * @method getDragEl
20668 * @return {HTMLElement} the html element
20670 getDragEl: function() {
20671 return Roo.getDom(this.dragElId);
20675 * Sets up the DragDrop object. Must be called in the constructor of any
20676 * Roo.dd.DragDrop subclass
20678 * @param id the id of the linked element
20679 * @param {String} sGroup the group of related items
20680 * @param {object} config configuration attributes
20682 init: function(id, sGroup, config) {
20683 this.initTarget(id, sGroup, config);
20684 if (!Roo.isTouch) {
20685 Event.on(this.id, "mousedown", this.handleMouseDown, this);
20687 Event.on(this.id, "touchstart", this.handleMouseDown, this);
20688 // Event.on(this.id, "selectstart", Event.preventDefault);
20692 * Initializes Targeting functionality only... the object does not
20693 * get a mousedown handler.
20694 * @method initTarget
20695 * @param id the id of the linked element
20696 * @param {String} sGroup the group of related items
20697 * @param {object} config configuration attributes
20699 initTarget: function(id, sGroup, config) {
20701 // configuration attributes
20702 this.config = config || {};
20704 // create a local reference to the drag and drop manager
20705 this.DDM = Roo.dd.DDM;
20706 // initialize the groups array
20709 // assume that we have an element reference instead of an id if the
20710 // parameter is not a string
20711 if (typeof id !== "string") {
20718 // add to an interaction group
20719 this.addToGroup((sGroup) ? sGroup : "default");
20721 // We don't want to register this as the handle with the manager
20722 // so we just set the id rather than calling the setter.
20723 this.handleElId = id;
20725 // the linked element is the element that gets dragged by default
20726 this.setDragElId(id);
20728 // by default, clicked anchors will not start drag operations.
20729 this.invalidHandleTypes = { A: "A" };
20730 this.invalidHandleIds = {};
20731 this.invalidHandleClasses = [];
20733 this.applyConfig();
20735 this.handleOnAvailable();
20739 * Applies the configuration parameters that were passed into the constructor.
20740 * This is supposed to happen at each level through the inheritance chain. So
20741 * a DDProxy implentation will execute apply config on DDProxy, DD, and
20742 * DragDrop in order to get all of the parameters that are available in
20744 * @method applyConfig
20746 applyConfig: function() {
20748 // configurable properties:
20749 // padding, isTarget, maintainOffset, primaryButtonOnly
20750 this.padding = this.config.padding || [0, 0, 0, 0];
20751 this.isTarget = (this.config.isTarget !== false);
20752 this.maintainOffset = (this.config.maintainOffset);
20753 this.primaryButtonOnly = (this.config.primaryButtonOnly !== false);
20758 * Executed when the linked element is available
20759 * @method handleOnAvailable
20762 handleOnAvailable: function() {
20763 this.available = true;
20764 this.resetConstraints();
20765 this.onAvailable();
20769 * Configures the padding for the target zone in px. Effectively expands
20770 * (or reduces) the virtual object size for targeting calculations.
20771 * Supports css-style shorthand; if only one parameter is passed, all sides
20772 * will have that padding, and if only two are passed, the top and bottom
20773 * will have the first param, the left and right the second.
20774 * @method setPadding
20775 * @param {int} iTop Top pad
20776 * @param {int} iRight Right pad
20777 * @param {int} iBot Bot pad
20778 * @param {int} iLeft Left pad
20780 setPadding: function(iTop, iRight, iBot, iLeft) {
20781 // this.padding = [iLeft, iRight, iTop, iBot];
20782 if (!iRight && 0 !== iRight) {
20783 this.padding = [iTop, iTop, iTop, iTop];
20784 } else if (!iBot && 0 !== iBot) {
20785 this.padding = [iTop, iRight, iTop, iRight];
20787 this.padding = [iTop, iRight, iBot, iLeft];
20792 * Stores the initial placement of the linked element.
20793 * @method setInitialPosition
20794 * @param {int} diffX the X offset, default 0
20795 * @param {int} diffY the Y offset, default 0
20797 setInitPosition: function(diffX, diffY) {
20798 var el = this.getEl();
20800 if (!this.DDM.verifyEl(el)) {
20804 var dx = diffX || 0;
20805 var dy = diffY || 0;
20807 var p = Dom.getXY( el );
20809 this.initPageX = p[0] - dx;
20810 this.initPageY = p[1] - dy;
20812 this.lastPageX = p[0];
20813 this.lastPageY = p[1];
20816 this.setStartPosition(p);
20820 * Sets the start position of the element. This is set when the obj
20821 * is initialized, the reset when a drag is started.
20822 * @method setStartPosition
20823 * @param pos current position (from previous lookup)
20826 setStartPosition: function(pos) {
20827 var p = pos || Dom.getXY( this.getEl() );
20828 this.deltaSetXY = null;
20830 this.startPageX = p[0];
20831 this.startPageY = p[1];
20835 * Add this instance to a group of related drag/drop objects. All
20836 * instances belong to at least one group, and can belong to as many
20837 * groups as needed.
20838 * @method addToGroup
20839 * @param sGroup {string} the name of the group
20841 addToGroup: function(sGroup) {
20842 this.groups[sGroup] = true;
20843 this.DDM.regDragDrop(this, sGroup);
20847 * Remove's this instance from the supplied interaction group
20848 * @method removeFromGroup
20849 * @param {string} sGroup The group to drop
20851 removeFromGroup: function(sGroup) {
20852 if (this.groups[sGroup]) {
20853 delete this.groups[sGroup];
20856 this.DDM.removeDDFromGroup(this, sGroup);
20860 * Allows you to specify that an element other than the linked element
20861 * will be moved with the cursor during a drag
20862 * @method setDragElId
20863 * @param id {string} the id of the element that will be used to initiate the drag
20865 setDragElId: function(id) {
20866 this.dragElId = id;
20870 * Allows you to specify a child of the linked element that should be
20871 * used to initiate the drag operation. An example of this would be if
20872 * you have a content div with text and links. Clicking anywhere in the
20873 * content area would normally start the drag operation. Use this method
20874 * to specify that an element inside of the content div is the element
20875 * that starts the drag operation.
20876 * @method setHandleElId
20877 * @param id {string} the id of the element that will be used to
20878 * initiate the drag.
20880 setHandleElId: function(id) {
20881 if (typeof id !== "string") {
20884 this.handleElId = id;
20885 this.DDM.regHandle(this.id, id);
20889 * Allows you to set an element outside of the linked element as a drag
20891 * @method setOuterHandleElId
20892 * @param id the id of the element that will be used to initiate the drag
20894 setOuterHandleElId: function(id) {
20895 if (typeof id !== "string") {
20898 Event.on(id, "mousedown",
20899 this.handleMouseDown, this);
20900 this.setHandleElId(id);
20902 this.hasOuterHandles = true;
20906 * Remove all drag and drop hooks for this element
20909 unreg: function() {
20910 Event.un(this.id, "mousedown",
20911 this.handleMouseDown);
20912 Event.un(this.id, "touchstart",
20913 this.handleMouseDown);
20914 this._domRef = null;
20915 this.DDM._remove(this);
20918 destroy : function(){
20923 * Returns true if this instance is locked, or the drag drop mgr is locked
20924 * (meaning that all drag/drop is disabled on the page.)
20926 * @return {boolean} true if this obj or all drag/drop is locked, else
20929 isLocked: function() {
20930 return (this.DDM.isLocked() || this.locked);
20934 * Fired when this object is clicked
20935 * @method handleMouseDown
20937 * @param {Roo.dd.DragDrop} oDD the clicked dd object (this dd obj)
20940 handleMouseDown: function(e, oDD){
20942 if (!Roo.isTouch && this.primaryButtonOnly && e.button != 0) {
20943 //Roo.log('not touch/ button !=0');
20946 if (e.browserEvent.touches && e.browserEvent.touches.length != 1) {
20947 return; // double touch..
20951 if (this.isLocked()) {
20952 //Roo.log('locked');
20956 this.DDM.refreshCache(this.groups);
20957 // Roo.log([Roo.lib.Event.getPageX(e), Roo.lib.Event.getPageY(e)]);
20958 var pt = new Roo.lib.Point(Roo.lib.Event.getPageX(e), Roo.lib.Event.getPageY(e));
20959 if (!this.hasOuterHandles && !this.DDM.isOverTarget(pt, this) ) {
20960 //Roo.log('no outer handes or not over target');
20963 // Roo.log('check validator');
20964 if (this.clickValidator(e)) {
20965 // Roo.log('validate success');
20966 // set the initial element position
20967 this.setStartPosition();
20970 this.b4MouseDown(e);
20971 this.onMouseDown(e);
20973 this.DDM.handleMouseDown(e, this);
20975 this.DDM.stopEvent(e);
20983 clickValidator: function(e) {
20984 var target = e.getTarget();
20985 return ( this.isValidHandleChild(target) &&
20986 (this.id == this.handleElId ||
20987 this.DDM.handleWasClicked(target, this.id)) );
20991 * Allows you to specify a tag name that should not start a drag operation
20992 * when clicked. This is designed to facilitate embedding links within a
20993 * drag handle that do something other than start the drag.
20994 * @method addInvalidHandleType
20995 * @param {string} tagName the type of element to exclude
20997 addInvalidHandleType: function(tagName) {
20998 var type = tagName.toUpperCase();
20999 this.invalidHandleTypes[type] = type;
21003 * Lets you to specify an element id for a child of a drag handle
21004 * that should not initiate a drag
21005 * @method addInvalidHandleId
21006 * @param {string} id the element id of the element you wish to ignore
21008 addInvalidHandleId: function(id) {
21009 if (typeof id !== "string") {
21012 this.invalidHandleIds[id] = id;
21016 * Lets you specify a css class of elements that will not initiate a drag
21017 * @method addInvalidHandleClass
21018 * @param {string} cssClass the class of the elements you wish to ignore
21020 addInvalidHandleClass: function(cssClass) {
21021 this.invalidHandleClasses.push(cssClass);
21025 * Unsets an excluded tag name set by addInvalidHandleType
21026 * @method removeInvalidHandleType
21027 * @param {string} tagName the type of element to unexclude
21029 removeInvalidHandleType: function(tagName) {
21030 var type = tagName.toUpperCase();
21031 // this.invalidHandleTypes[type] = null;
21032 delete this.invalidHandleTypes[type];
21036 * Unsets an invalid handle id
21037 * @method removeInvalidHandleId
21038 * @param {string} id the id of the element to re-enable
21040 removeInvalidHandleId: function(id) {
21041 if (typeof id !== "string") {
21044 delete this.invalidHandleIds[id];
21048 * Unsets an invalid css class
21049 * @method removeInvalidHandleClass
21050 * @param {string} cssClass the class of the element(s) you wish to
21053 removeInvalidHandleClass: function(cssClass) {
21054 for (var i=0, len=this.invalidHandleClasses.length; i<len; ++i) {
21055 if (this.invalidHandleClasses[i] == cssClass) {
21056 delete this.invalidHandleClasses[i];
21062 * Checks the tag exclusion list to see if this click should be ignored
21063 * @method isValidHandleChild
21064 * @param {HTMLElement} node the HTMLElement to evaluate
21065 * @return {boolean} true if this is a valid tag type, false if not
21067 isValidHandleChild: function(node) {
21070 // var n = (node.nodeName == "#text") ? node.parentNode : node;
21073 nodeName = node.nodeName.toUpperCase();
21075 nodeName = node.nodeName;
21077 valid = valid && !this.invalidHandleTypes[nodeName];
21078 valid = valid && !this.invalidHandleIds[node.id];
21080 for (var i=0, len=this.invalidHandleClasses.length; valid && i<len; ++i) {
21081 valid = !Dom.hasClass(node, this.invalidHandleClasses[i]);
21090 * Create the array of horizontal tick marks if an interval was specified
21091 * in setXConstraint().
21092 * @method setXTicks
21095 setXTicks: function(iStartX, iTickSize) {
21097 this.xTickSize = iTickSize;
21101 for (var i = this.initPageX; i >= this.minX; i = i - iTickSize) {
21103 this.xTicks[this.xTicks.length] = i;
21108 for (i = this.initPageX; i <= this.maxX; i = i + iTickSize) {
21110 this.xTicks[this.xTicks.length] = i;
21115 this.xTicks.sort(this.DDM.numericSort) ;
21119 * Create the array of vertical tick marks if an interval was specified in
21120 * setYConstraint().
21121 * @method setYTicks
21124 setYTicks: function(iStartY, iTickSize) {
21126 this.yTickSize = iTickSize;
21130 for (var i = this.initPageY; i >= this.minY; i = i - iTickSize) {
21132 this.yTicks[this.yTicks.length] = i;
21137 for (i = this.initPageY; i <= this.maxY; i = i + iTickSize) {
21139 this.yTicks[this.yTicks.length] = i;
21144 this.yTicks.sort(this.DDM.numericSort) ;
21148 * By default, the element can be dragged any place on the screen. Use
21149 * this method to limit the horizontal travel of the element. Pass in
21150 * 0,0 for the parameters if you want to lock the drag to the y axis.
21151 * @method setXConstraint
21152 * @param {int} iLeft the number of pixels the element can move to the left
21153 * @param {int} iRight the number of pixels the element can move to the
21155 * @param {int} iTickSize optional parameter for specifying that the
21157 * should move iTickSize pixels at a time.
21159 setXConstraint: function(iLeft, iRight, iTickSize) {
21160 this.leftConstraint = iLeft;
21161 this.rightConstraint = iRight;
21163 this.minX = this.initPageX - iLeft;
21164 this.maxX = this.initPageX + iRight;
21165 if (iTickSize) { this.setXTicks(this.initPageX, iTickSize); }
21167 this.constrainX = true;
21171 * Clears any constraints applied to this instance. Also clears ticks
21172 * since they can't exist independent of a constraint at this time.
21173 * @method clearConstraints
21175 clearConstraints: function() {
21176 this.constrainX = false;
21177 this.constrainY = false;
21182 * Clears any tick interval defined for this instance
21183 * @method clearTicks
21185 clearTicks: function() {
21186 this.xTicks = null;
21187 this.yTicks = null;
21188 this.xTickSize = 0;
21189 this.yTickSize = 0;
21193 * By default, the element can be dragged any place on the screen. Set
21194 * this to limit the vertical travel of the element. Pass in 0,0 for the
21195 * parameters if you want to lock the drag to the x axis.
21196 * @method setYConstraint
21197 * @param {int} iUp the number of pixels the element can move up
21198 * @param {int} iDown the number of pixels the element can move down
21199 * @param {int} iTickSize optional parameter for specifying that the
21200 * element should move iTickSize pixels at a time.
21202 setYConstraint: function(iUp, iDown, iTickSize) {
21203 this.topConstraint = iUp;
21204 this.bottomConstraint = iDown;
21206 this.minY = this.initPageY - iUp;
21207 this.maxY = this.initPageY + iDown;
21208 if (iTickSize) { this.setYTicks(this.initPageY, iTickSize); }
21210 this.constrainY = true;
21215 * resetConstraints must be called if you manually reposition a dd element.
21216 * @method resetConstraints
21217 * @param {boolean} maintainOffset
21219 resetConstraints: function() {
21222 // Maintain offsets if necessary
21223 if (this.initPageX || this.initPageX === 0) {
21224 // figure out how much this thing has moved
21225 var dx = (this.maintainOffset) ? this.lastPageX - this.initPageX : 0;
21226 var dy = (this.maintainOffset) ? this.lastPageY - this.initPageY : 0;
21228 this.setInitPosition(dx, dy);
21230 // This is the first time we have detected the element's position
21232 this.setInitPosition();
21235 if (this.constrainX) {
21236 this.setXConstraint( this.leftConstraint,
21237 this.rightConstraint,
21241 if (this.constrainY) {
21242 this.setYConstraint( this.topConstraint,
21243 this.bottomConstraint,
21249 * Normally the drag element is moved pixel by pixel, but we can specify
21250 * that it move a number of pixels at a time. This method resolves the
21251 * location when we have it set up like this.
21253 * @param {int} val where we want to place the object
21254 * @param {int[]} tickArray sorted array of valid points
21255 * @return {int} the closest tick
21258 getTick: function(val, tickArray) {
21261 // If tick interval is not defined, it is effectively 1 pixel,
21262 // so we return the value passed to us.
21264 } else if (tickArray[0] >= val) {
21265 // The value is lower than the first tick, so we return the first
21267 return tickArray[0];
21269 for (var i=0, len=tickArray.length; i<len; ++i) {
21271 if (tickArray[next] && tickArray[next] >= val) {
21272 var diff1 = val - tickArray[i];
21273 var diff2 = tickArray[next] - val;
21274 return (diff2 > diff1) ? tickArray[i] : tickArray[next];
21278 // The value is larger than the last tick, so we return the last
21280 return tickArray[tickArray.length - 1];
21287 * @return {string} string representation of the dd obj
21289 toString: function() {
21290 return ("DragDrop " + this.id);
21298 * Ext JS Library 1.1.1
21299 * Copyright(c) 2006-2007, Ext JS, LLC.
21301 * Originally Released Under LGPL - original licence link has changed is not relivant.
21304 * <script type="text/javascript">
21309 * The drag and drop utility provides a framework for building drag and drop
21310 * applications. In addition to enabling drag and drop for specific elements,
21311 * the drag and drop elements are tracked by the manager class, and the
21312 * interactions between the various elements are tracked during the drag and
21313 * the implementing code is notified about these important moments.
21316 // Only load the library once. Rewriting the manager class would orphan
21317 // existing drag and drop instances.
21318 if (!Roo.dd.DragDropMgr) {
21321 * @class Roo.dd.DragDropMgr
21322 * DragDropMgr is a singleton that tracks the element interaction for
21323 * all DragDrop items in the window. Generally, you will not call
21324 * this class directly, but it does have helper methods that could
21325 * be useful in your DragDrop implementations.
21328 Roo.dd.DragDropMgr = function() {
21330 var Event = Roo.EventManager;
21335 * Two dimensional Array of registered DragDrop objects. The first
21336 * dimension is the DragDrop item group, the second the DragDrop
21339 * @type {string: string}
21346 * Array of element ids defined as drag handles. Used to determine
21347 * if the element that generated the mousedown event is actually the
21348 * handle and not the html element itself.
21349 * @property handleIds
21350 * @type {string: string}
21357 * the DragDrop object that is currently being dragged
21358 * @property dragCurrent
21366 * the DragDrop object(s) that are being hovered over
21367 * @property dragOvers
21375 * the X distance between the cursor and the object being dragged
21384 * the Y distance between the cursor and the object being dragged
21393 * Flag to determine if we should prevent the default behavior of the
21394 * events we define. By default this is true, but this can be set to
21395 * false if you need the default behavior (not recommended)
21396 * @property preventDefault
21400 preventDefault: true,
21403 * Flag to determine if we should stop the propagation of the events
21404 * we generate. This is true by default but you may want to set it to
21405 * false if the html element contains other features that require the
21407 * @property stopPropagation
21411 stopPropagation: true,
21414 * Internal flag that is set to true when drag and drop has been
21416 * @property initialized
21423 * All drag and drop can be disabled.
21431 * Called the first time an element is registered.
21437 this.initialized = true;
21441 * In point mode, drag and drop interaction is defined by the
21442 * location of the cursor during the drag/drop
21450 * In intersect mode, drag and drop interactio nis defined by the
21451 * overlap of two or more drag and drop objects.
21452 * @property INTERSECT
21459 * The current drag and drop mode. Default: POINT
21467 * Runs method on all drag and drop objects
21468 * @method _execOnAll
21472 _execOnAll: function(sMethod, args) {
21473 for (var i in this.ids) {
21474 for (var j in this.ids[i]) {
21475 var oDD = this.ids[i][j];
21476 if (! this.isTypeOfDD(oDD)) {
21479 oDD[sMethod].apply(oDD, args);
21485 * Drag and drop initialization. Sets up the global event handlers
21490 _onLoad: function() {
21494 if (!Roo.isTouch) {
21495 Event.on(document, "mouseup", this.handleMouseUp, this, true);
21496 Event.on(document, "mousemove", this.handleMouseMove, this, true);
21498 Event.on(document, "touchend", this.handleMouseUp, this, true);
21499 Event.on(document, "touchmove", this.handleMouseMove, this, true);
21501 Event.on(window, "unload", this._onUnload, this, true);
21502 Event.on(window, "resize", this._onResize, this, true);
21503 // Event.on(window, "mouseout", this._test);
21508 * Reset constraints on all drag and drop objs
21509 * @method _onResize
21513 _onResize: function(e) {
21514 this._execOnAll("resetConstraints", []);
21518 * Lock all drag and drop functionality
21522 lock: function() { this.locked = true; },
21525 * Unlock all drag and drop functionality
21529 unlock: function() { this.locked = false; },
21532 * Is drag and drop locked?
21534 * @return {boolean} True if drag and drop is locked, false otherwise.
21537 isLocked: function() { return this.locked; },
21540 * Location cache that is set for all drag drop objects when a drag is
21541 * initiated, cleared when the drag is finished.
21542 * @property locationCache
21549 * Set useCache to false if you want to force object the lookup of each
21550 * drag and drop linked element constantly during a drag.
21551 * @property useCache
21558 * The number of pixels that the mouse needs to move after the
21559 * mousedown before the drag is initiated. Default=3;
21560 * @property clickPixelThresh
21564 clickPixelThresh: 3,
21567 * The number of milliseconds after the mousedown event to initiate the
21568 * drag if we don't get a mouseup event. Default=1000
21569 * @property clickTimeThresh
21573 clickTimeThresh: 350,
21576 * Flag that indicates that either the drag pixel threshold or the
21577 * mousdown time threshold has been met
21578 * @property dragThreshMet
21583 dragThreshMet: false,
21586 * Timeout used for the click time threshold
21587 * @property clickTimeout
21592 clickTimeout: null,
21595 * The X position of the mousedown event stored for later use when a
21596 * drag threshold is met.
21605 * The Y position of the mousedown event stored for later use when a
21606 * drag threshold is met.
21615 * Each DragDrop instance must be registered with the DragDropMgr.
21616 * This is executed in DragDrop.init()
21617 * @method regDragDrop
21618 * @param {DragDrop} oDD the DragDrop object to register
21619 * @param {String} sGroup the name of the group this element belongs to
21622 regDragDrop: function(oDD, sGroup) {
21623 if (!this.initialized) { this.init(); }
21625 if (!this.ids[sGroup]) {
21626 this.ids[sGroup] = {};
21628 this.ids[sGroup][oDD.id] = oDD;
21632 * Removes the supplied dd instance from the supplied group. Executed
21633 * by DragDrop.removeFromGroup, so don't call this function directly.
21634 * @method removeDDFromGroup
21638 removeDDFromGroup: function(oDD, sGroup) {
21639 if (!this.ids[sGroup]) {
21640 this.ids[sGroup] = {};
21643 var obj = this.ids[sGroup];
21644 if (obj && obj[oDD.id]) {
21645 delete obj[oDD.id];
21650 * Unregisters a drag and drop item. This is executed in
21651 * DragDrop.unreg, use that method instead of calling this directly.
21656 _remove: function(oDD) {
21657 for (var g in oDD.groups) {
21658 if (g && this.ids[g][oDD.id]) {
21659 delete this.ids[g][oDD.id];
21662 delete this.handleIds[oDD.id];
21666 * Each DragDrop handle element must be registered. This is done
21667 * automatically when executing DragDrop.setHandleElId()
21668 * @method regHandle
21669 * @param {String} sDDId the DragDrop id this element is a handle for
21670 * @param {String} sHandleId the id of the element that is the drag
21674 regHandle: function(sDDId, sHandleId) {
21675 if (!this.handleIds[sDDId]) {
21676 this.handleIds[sDDId] = {};
21678 this.handleIds[sDDId][sHandleId] = sHandleId;
21682 * Utility function to determine if a given element has been
21683 * registered as a drag drop item.
21684 * @method isDragDrop
21685 * @param {String} id the element id to check
21686 * @return {boolean} true if this element is a DragDrop item,
21690 isDragDrop: function(id) {
21691 return ( this.getDDById(id) ) ? true : false;
21695 * Returns the drag and drop instances that are in all groups the
21696 * passed in instance belongs to.
21697 * @method getRelated
21698 * @param {DragDrop} p_oDD the obj to get related data for
21699 * @param {boolean} bTargetsOnly if true, only return targetable objs
21700 * @return {DragDrop[]} the related instances
21703 getRelated: function(p_oDD, bTargetsOnly) {
21705 for (var i in p_oDD.groups) {
21706 for (j in this.ids[i]) {
21707 var dd = this.ids[i][j];
21708 if (! this.isTypeOfDD(dd)) {
21711 if (!bTargetsOnly || dd.isTarget) {
21712 oDDs[oDDs.length] = dd;
21721 * Returns true if the specified dd target is a legal target for
21722 * the specifice drag obj
21723 * @method isLegalTarget
21724 * @param {DragDrop} the drag obj
21725 * @param {DragDrop} the target
21726 * @return {boolean} true if the target is a legal target for the
21730 isLegalTarget: function (oDD, oTargetDD) {
21731 var targets = this.getRelated(oDD, true);
21732 for (var i=0, len=targets.length;i<len;++i) {
21733 if (targets[i].id == oTargetDD.id) {
21742 * My goal is to be able to transparently determine if an object is
21743 * typeof DragDrop, and the exact subclass of DragDrop. typeof
21744 * returns "object", oDD.constructor.toString() always returns
21745 * "DragDrop" and not the name of the subclass. So for now it just
21746 * evaluates a well-known variable in DragDrop.
21747 * @method isTypeOfDD
21748 * @param {Object} the object to evaluate
21749 * @return {boolean} true if typeof oDD = DragDrop
21752 isTypeOfDD: function (oDD) {
21753 return (oDD && oDD.__ygDragDrop);
21757 * Utility function to determine if a given element has been
21758 * registered as a drag drop handle for the given Drag Drop object.
21760 * @param {String} id the element id to check
21761 * @return {boolean} true if this element is a DragDrop handle, false
21765 isHandle: function(sDDId, sHandleId) {
21766 return ( this.handleIds[sDDId] &&
21767 this.handleIds[sDDId][sHandleId] );
21771 * Returns the DragDrop instance for a given id
21772 * @method getDDById
21773 * @param {String} id the id of the DragDrop object
21774 * @return {DragDrop} the drag drop object, null if it is not found
21777 getDDById: function(id) {
21778 for (var i in this.ids) {
21779 if (this.ids[i][id]) {
21780 return this.ids[i][id];
21787 * Fired after a registered DragDrop object gets the mousedown event.
21788 * Sets up the events required to track the object being dragged
21789 * @method handleMouseDown
21790 * @param {Event} e the event
21791 * @param oDD the DragDrop object being dragged
21795 handleMouseDown: function(e, oDD) {
21797 Roo.QuickTips.disable();
21799 this.currentTarget = e.getTarget();
21801 this.dragCurrent = oDD;
21803 var el = oDD.getEl();
21805 // track start position
21806 this.startX = e.getPageX();
21807 this.startY = e.getPageY();
21809 this.deltaX = this.startX - el.offsetLeft;
21810 this.deltaY = this.startY - el.offsetTop;
21812 this.dragThreshMet = false;
21814 this.clickTimeout = setTimeout(
21816 var DDM = Roo.dd.DDM;
21817 DDM.startDrag(DDM.startX, DDM.startY);
21819 this.clickTimeThresh );
21823 * Fired when either the drag pixel threshol or the mousedown hold
21824 * time threshold has been met.
21825 * @method startDrag
21826 * @param x {int} the X position of the original mousedown
21827 * @param y {int} the Y position of the original mousedown
21830 startDrag: function(x, y) {
21831 clearTimeout(this.clickTimeout);
21832 if (this.dragCurrent) {
21833 this.dragCurrent.b4StartDrag(x, y);
21834 this.dragCurrent.startDrag(x, y);
21836 this.dragThreshMet = true;
21840 * Internal function to handle the mouseup event. Will be invoked
21841 * from the context of the document.
21842 * @method handleMouseUp
21843 * @param {Event} e the event
21847 handleMouseUp: function(e) {
21850 Roo.QuickTips.enable();
21852 if (! this.dragCurrent) {
21856 clearTimeout(this.clickTimeout);
21858 if (this.dragThreshMet) {
21859 this.fireEvents(e, true);
21869 * Utility to stop event propagation and event default, if these
21870 * features are turned on.
21871 * @method stopEvent
21872 * @param {Event} e the event as returned by this.getEvent()
21875 stopEvent: function(e){
21876 if(this.stopPropagation) {
21877 e.stopPropagation();
21880 if (this.preventDefault) {
21881 e.preventDefault();
21886 * Internal function to clean up event handlers after the drag
21887 * operation is complete
21889 * @param {Event} e the event
21893 stopDrag: function(e) {
21894 // Fire the drag end event for the item that was dragged
21895 if (this.dragCurrent) {
21896 if (this.dragThreshMet) {
21897 this.dragCurrent.b4EndDrag(e);
21898 this.dragCurrent.endDrag(e);
21901 this.dragCurrent.onMouseUp(e);
21904 this.dragCurrent = null;
21905 this.dragOvers = {};
21909 * Internal function to handle the mousemove event. Will be invoked
21910 * from the context of the html element.
21912 * @TODO figure out what we can do about mouse events lost when the
21913 * user drags objects beyond the window boundary. Currently we can
21914 * detect this in internet explorer by verifying that the mouse is
21915 * down during the mousemove event. Firefox doesn't give us the
21916 * button state on the mousemove event.
21917 * @method handleMouseMove
21918 * @param {Event} e the event
21922 handleMouseMove: function(e) {
21923 if (! this.dragCurrent) {
21927 // var button = e.which || e.button;
21929 // check for IE mouseup outside of page boundary
21930 if (Roo.isIE && (e.button !== 0 && e.button !== 1 && e.button !== 2)) {
21932 return this.handleMouseUp(e);
21935 if (!this.dragThreshMet) {
21936 var diffX = Math.abs(this.startX - e.getPageX());
21937 var diffY = Math.abs(this.startY - e.getPageY());
21938 if (diffX > this.clickPixelThresh ||
21939 diffY > this.clickPixelThresh) {
21940 this.startDrag(this.startX, this.startY);
21944 if (this.dragThreshMet) {
21945 this.dragCurrent.b4Drag(e);
21946 this.dragCurrent.onDrag(e);
21947 if(!this.dragCurrent.moveOnly){
21948 this.fireEvents(e, false);
21958 * Iterates over all of the DragDrop elements to find ones we are
21959 * hovering over or dropping on
21960 * @method fireEvents
21961 * @param {Event} e the event
21962 * @param {boolean} isDrop is this a drop op or a mouseover op?
21966 fireEvents: function(e, isDrop) {
21967 var dc = this.dragCurrent;
21969 // If the user did the mouse up outside of the window, we could
21970 // get here even though we have ended the drag.
21971 if (!dc || dc.isLocked()) {
21975 var pt = e.getPoint();
21977 // cache the previous dragOver array
21983 var enterEvts = [];
21985 // Check to see if the object(s) we were hovering over is no longer
21986 // being hovered over so we can fire the onDragOut event
21987 for (var i in this.dragOvers) {
21989 var ddo = this.dragOvers[i];
21991 if (! this.isTypeOfDD(ddo)) {
21995 if (! this.isOverTarget(pt, ddo, this.mode)) {
21996 outEvts.push( ddo );
21999 oldOvers[i] = true;
22000 delete this.dragOvers[i];
22003 for (var sGroup in dc.groups) {
22005 if ("string" != typeof sGroup) {
22009 for (i in this.ids[sGroup]) {
22010 var oDD = this.ids[sGroup][i];
22011 if (! this.isTypeOfDD(oDD)) {
22015 if (oDD.isTarget && !oDD.isLocked() && oDD != dc) {
22016 if (this.isOverTarget(pt, oDD, this.mode)) {
22017 // look for drop interactions
22019 dropEvts.push( oDD );
22020 // look for drag enter and drag over interactions
22023 // initial drag over: dragEnter fires
22024 if (!oldOvers[oDD.id]) {
22025 enterEvts.push( oDD );
22026 // subsequent drag overs: dragOver fires
22028 overEvts.push( oDD );
22031 this.dragOvers[oDD.id] = oDD;
22039 if (outEvts.length) {
22040 dc.b4DragOut(e, outEvts);
22041 dc.onDragOut(e, outEvts);
22044 if (enterEvts.length) {
22045 dc.onDragEnter(e, enterEvts);
22048 if (overEvts.length) {
22049 dc.b4DragOver(e, overEvts);
22050 dc.onDragOver(e, overEvts);
22053 if (dropEvts.length) {
22054 dc.b4DragDrop(e, dropEvts);
22055 dc.onDragDrop(e, dropEvts);
22059 // fire dragout events
22061 for (i=0, len=outEvts.length; i<len; ++i) {
22062 dc.b4DragOut(e, outEvts[i].id);
22063 dc.onDragOut(e, outEvts[i].id);
22066 // fire enter events
22067 for (i=0,len=enterEvts.length; i<len; ++i) {
22068 // dc.b4DragEnter(e, oDD.id);
22069 dc.onDragEnter(e, enterEvts[i].id);
22072 // fire over events
22073 for (i=0,len=overEvts.length; i<len; ++i) {
22074 dc.b4DragOver(e, overEvts[i].id);
22075 dc.onDragOver(e, overEvts[i].id);
22078 // fire drop events
22079 for (i=0, len=dropEvts.length; i<len; ++i) {
22080 dc.b4DragDrop(e, dropEvts[i].id);
22081 dc.onDragDrop(e, dropEvts[i].id);
22086 // notify about a drop that did not find a target
22087 if (isDrop && !dropEvts.length) {
22088 dc.onInvalidDrop(e);
22094 * Helper function for getting the best match from the list of drag
22095 * and drop objects returned by the drag and drop events when we are
22096 * in INTERSECT mode. It returns either the first object that the
22097 * cursor is over, or the object that has the greatest overlap with
22098 * the dragged element.
22099 * @method getBestMatch
22100 * @param {DragDrop[]} dds The array of drag and drop objects
22102 * @return {DragDrop} The best single match
22105 getBestMatch: function(dds) {
22107 // Return null if the input is not what we expect
22108 //if (!dds || !dds.length || dds.length == 0) {
22110 // If there is only one item, it wins
22111 //} else if (dds.length == 1) {
22113 var len = dds.length;
22118 // Loop through the targeted items
22119 for (var i=0; i<len; ++i) {
22121 // If the cursor is over the object, it wins. If the
22122 // cursor is over multiple matches, the first one we come
22124 if (dd.cursorIsOver) {
22127 // Otherwise the object with the most overlap wins
22130 winner.overlap.getArea() < dd.overlap.getArea()) {
22141 * Refreshes the cache of the top-left and bottom-right points of the
22142 * drag and drop objects in the specified group(s). This is in the
22143 * format that is stored in the drag and drop instance, so typical
22146 * Roo.dd.DragDropMgr.refreshCache(ddinstance.groups);
22150 * Roo.dd.DragDropMgr.refreshCache({group1:true, group2:true});
22152 * @TODO this really should be an indexed array. Alternatively this
22153 * method could accept both.
22154 * @method refreshCache
22155 * @param {Object} groups an associative array of groups to refresh
22158 refreshCache: function(groups) {
22159 for (var sGroup in groups) {
22160 if ("string" != typeof sGroup) {
22163 for (var i in this.ids[sGroup]) {
22164 var oDD = this.ids[sGroup][i];
22166 if (this.isTypeOfDD(oDD)) {
22167 // if (this.isTypeOfDD(oDD) && oDD.isTarget) {
22168 var loc = this.getLocation(oDD);
22170 this.locationCache[oDD.id] = loc;
22172 delete this.locationCache[oDD.id];
22173 // this will unregister the drag and drop object if
22174 // the element is not in a usable state
22183 * This checks to make sure an element exists and is in the DOM. The
22184 * main purpose is to handle cases where innerHTML is used to remove
22185 * drag and drop objects from the DOM. IE provides an 'unspecified
22186 * error' when trying to access the offsetParent of such an element
22188 * @param {HTMLElement} el the element to check
22189 * @return {boolean} true if the element looks usable
22192 verifyEl: function(el) {
22197 parent = el.offsetParent;
22200 parent = el.offsetParent;
22211 * Returns a Region object containing the drag and drop element's position
22212 * and size, including the padding configured for it
22213 * @method getLocation
22214 * @param {DragDrop} oDD the drag and drop object to get the
22216 * @return {Roo.lib.Region} a Region object representing the total area
22217 * the element occupies, including any padding
22218 * the instance is configured for.
22221 getLocation: function(oDD) {
22222 if (! this.isTypeOfDD(oDD)) {
22226 var el = oDD.getEl(), pos, x1, x2, y1, y2, t, r, b, l;
22229 pos= Roo.lib.Dom.getXY(el);
22237 x2 = x1 + el.offsetWidth;
22239 y2 = y1 + el.offsetHeight;
22241 t = y1 - oDD.padding[0];
22242 r = x2 + oDD.padding[1];
22243 b = y2 + oDD.padding[2];
22244 l = x1 - oDD.padding[3];
22246 return new Roo.lib.Region( t, r, b, l );
22250 * Checks the cursor location to see if it over the target
22251 * @method isOverTarget
22252 * @param {Roo.lib.Point} pt The point to evaluate
22253 * @param {DragDrop} oTarget the DragDrop object we are inspecting
22254 * @return {boolean} true if the mouse is over the target
22258 isOverTarget: function(pt, oTarget, intersect) {
22259 // use cache if available
22260 var loc = this.locationCache[oTarget.id];
22261 if (!loc || !this.useCache) {
22262 loc = this.getLocation(oTarget);
22263 this.locationCache[oTarget.id] = loc;
22271 oTarget.cursorIsOver = loc.contains( pt );
22273 // DragDrop is using this as a sanity check for the initial mousedown
22274 // in this case we are done. In POINT mode, if the drag obj has no
22275 // contraints, we are also done. Otherwise we need to evaluate the
22276 // location of the target as related to the actual location of the
22277 // dragged element.
22278 var dc = this.dragCurrent;
22279 if (!dc || !dc.getTargetCoord ||
22280 (!intersect && !dc.constrainX && !dc.constrainY)) {
22281 return oTarget.cursorIsOver;
22284 oTarget.overlap = null;
22286 // Get the current location of the drag element, this is the
22287 // location of the mouse event less the delta that represents
22288 // where the original mousedown happened on the element. We
22289 // need to consider constraints and ticks as well.
22290 var pos = dc.getTargetCoord(pt.x, pt.y);
22292 var el = dc.getDragEl();
22293 var curRegion = new Roo.lib.Region( pos.y,
22294 pos.x + el.offsetWidth,
22295 pos.y + el.offsetHeight,
22298 var overlap = curRegion.intersect(loc);
22301 oTarget.overlap = overlap;
22302 return (intersect) ? true : oTarget.cursorIsOver;
22309 * unload event handler
22310 * @method _onUnload
22314 _onUnload: function(e, me) {
22315 Roo.dd.DragDropMgr.unregAll();
22319 * Cleans up the drag and drop events and objects.
22324 unregAll: function() {
22326 if (this.dragCurrent) {
22328 this.dragCurrent = null;
22331 this._execOnAll("unreg", []);
22333 for (i in this.elementCache) {
22334 delete this.elementCache[i];
22337 this.elementCache = {};
22342 * A cache of DOM elements
22343 * @property elementCache
22350 * Get the wrapper for the DOM element specified
22351 * @method getElWrapper
22352 * @param {String} id the id of the element to get
22353 * @return {Roo.dd.DDM.ElementWrapper} the wrapped element
22355 * @deprecated This wrapper isn't that useful
22358 getElWrapper: function(id) {
22359 var oWrapper = this.elementCache[id];
22360 if (!oWrapper || !oWrapper.el) {
22361 oWrapper = this.elementCache[id] =
22362 new this.ElementWrapper(Roo.getDom(id));
22368 * Returns the actual DOM element
22369 * @method getElement
22370 * @param {String} id the id of the elment to get
22371 * @return {Object} The element
22372 * @deprecated use Roo.getDom instead
22375 getElement: function(id) {
22376 return Roo.getDom(id);
22380 * Returns the style property for the DOM element (i.e.,
22381 * document.getElById(id).style)
22383 * @param {String} id the id of the elment to get
22384 * @return {Object} The style property of the element
22385 * @deprecated use Roo.getDom instead
22388 getCss: function(id) {
22389 var el = Roo.getDom(id);
22390 return (el) ? el.style : null;
22394 * Inner class for cached elements
22395 * @class DragDropMgr.ElementWrapper
22400 ElementWrapper: function(el) {
22405 this.el = el || null;
22410 this.id = this.el && el.id;
22412 * A reference to the style property
22415 this.css = this.el && el.style;
22419 * Returns the X position of an html element
22421 * @param el the element for which to get the position
22422 * @return {int} the X coordinate
22424 * @deprecated use Roo.lib.Dom.getX instead
22427 getPosX: function(el) {
22428 return Roo.lib.Dom.getX(el);
22432 * Returns the Y position of an html element
22434 * @param el the element for which to get the position
22435 * @return {int} the Y coordinate
22436 * @deprecated use Roo.lib.Dom.getY instead
22439 getPosY: function(el) {
22440 return Roo.lib.Dom.getY(el);
22444 * Swap two nodes. In IE, we use the native method, for others we
22445 * emulate the IE behavior
22447 * @param n1 the first node to swap
22448 * @param n2 the other node to swap
22451 swapNode: function(n1, n2) {
22455 var p = n2.parentNode;
22456 var s = n2.nextSibling;
22459 p.insertBefore(n1, n2);
22460 } else if (n2 == n1.nextSibling) {
22461 p.insertBefore(n2, n1);
22463 n1.parentNode.replaceChild(n2, n1);
22464 p.insertBefore(n1, s);
22470 * Returns the current scroll position
22471 * @method getScroll
22475 getScroll: function () {
22476 var t, l, dde=document.documentElement, db=document.body;
22477 if (dde && (dde.scrollTop || dde.scrollLeft)) {
22479 l = dde.scrollLeft;
22486 return { top: t, left: l };
22490 * Returns the specified element style property
22492 * @param {HTMLElement} el the element
22493 * @param {string} styleProp the style property
22494 * @return {string} The value of the style property
22495 * @deprecated use Roo.lib.Dom.getStyle
22498 getStyle: function(el, styleProp) {
22499 return Roo.fly(el).getStyle(styleProp);
22503 * Gets the scrollTop
22504 * @method getScrollTop
22505 * @return {int} the document's scrollTop
22508 getScrollTop: function () { return this.getScroll().top; },
22511 * Gets the scrollLeft
22512 * @method getScrollLeft
22513 * @return {int} the document's scrollTop
22516 getScrollLeft: function () { return this.getScroll().left; },
22519 * Sets the x/y position of an element to the location of the
22522 * @param {HTMLElement} moveEl The element to move
22523 * @param {HTMLElement} targetEl The position reference element
22526 moveToEl: function (moveEl, targetEl) {
22527 var aCoord = Roo.lib.Dom.getXY(targetEl);
22528 Roo.lib.Dom.setXY(moveEl, aCoord);
22532 * Numeric array sort function
22533 * @method numericSort
22536 numericSort: function(a, b) { return (a - b); },
22540 * @property _timeoutCount
22547 * Trying to make the load order less important. Without this we get
22548 * an error if this file is loaded before the Event Utility.
22549 * @method _addListeners
22553 _addListeners: function() {
22554 var DDM = Roo.dd.DDM;
22555 if ( Roo.lib.Event && document ) {
22558 if (DDM._timeoutCount > 2000) {
22560 setTimeout(DDM._addListeners, 10);
22561 if (document && document.body) {
22562 DDM._timeoutCount += 1;
22569 * Recursively searches the immediate parent and all child nodes for
22570 * the handle element in order to determine wheter or not it was
22572 * @method handleWasClicked
22573 * @param node the html element to inspect
22576 handleWasClicked: function(node, id) {
22577 if (this.isHandle(id, node.id)) {
22580 // check to see if this is a text node child of the one we want
22581 var p = node.parentNode;
22584 if (this.isHandle(id, p.id)) {
22599 // shorter alias, save a few bytes
22600 Roo.dd.DDM = Roo.dd.DragDropMgr;
22601 Roo.dd.DDM._addListeners();
22605 * Ext JS Library 1.1.1
22606 * Copyright(c) 2006-2007, Ext JS, LLC.
22608 * Originally Released Under LGPL - original licence link has changed is not relivant.
22611 * <script type="text/javascript">
22616 * A DragDrop implementation where the linked element follows the
22617 * mouse cursor during a drag.
22618 * @extends Roo.dd.DragDrop
22620 * @param {String} id the id of the linked element
22621 * @param {String} sGroup the group of related DragDrop items
22622 * @param {object} config an object containing configurable attributes
22623 * Valid properties for DD:
22626 Roo.dd.DD = function(id, sGroup, config) {
22628 this.init(id, sGroup, config);
22632 Roo.extend(Roo.dd.DD, Roo.dd.DragDrop, {
22635 * When set to true, the utility automatically tries to scroll the browser
22636 * window wehn a drag and drop element is dragged near the viewport boundary.
22637 * Defaults to true.
22644 * Sets the pointer offset to the distance between the linked element's top
22645 * left corner and the location the element was clicked
22646 * @method autoOffset
22647 * @param {int} iPageX the X coordinate of the click
22648 * @param {int} iPageY the Y coordinate of the click
22650 autoOffset: function(iPageX, iPageY) {
22651 var x = iPageX - this.startPageX;
22652 var y = iPageY - this.startPageY;
22653 this.setDelta(x, y);
22657 * Sets the pointer offset. You can call this directly to force the
22658 * offset to be in a particular location (e.g., pass in 0,0 to set it
22659 * to the center of the object)
22661 * @param {int} iDeltaX the distance from the left
22662 * @param {int} iDeltaY the distance from the top
22664 setDelta: function(iDeltaX, iDeltaY) {
22665 this.deltaX = iDeltaX;
22666 this.deltaY = iDeltaY;
22670 * Sets the drag element to the location of the mousedown or click event,
22671 * maintaining the cursor location relative to the location on the element
22672 * that was clicked. Override this if you want to place the element in a
22673 * location other than where the cursor is.
22674 * @method setDragElPos
22675 * @param {int} iPageX the X coordinate of the mousedown or drag event
22676 * @param {int} iPageY the Y coordinate of the mousedown or drag event
22678 setDragElPos: function(iPageX, iPageY) {
22679 // the first time we do this, we are going to check to make sure
22680 // the element has css positioning
22682 var el = this.getDragEl();
22683 this.alignElWithMouse(el, iPageX, iPageY);
22687 * Sets the element to the location of the mousedown or click event,
22688 * maintaining the cursor location relative to the location on the element
22689 * that was clicked. Override this if you want to place the element in a
22690 * location other than where the cursor is.
22691 * @method alignElWithMouse
22692 * @param {HTMLElement} el the element to move
22693 * @param {int} iPageX the X coordinate of the mousedown or drag event
22694 * @param {int} iPageY the Y coordinate of the mousedown or drag event
22696 alignElWithMouse: function(el, iPageX, iPageY) {
22697 var oCoord = this.getTargetCoord(iPageX, iPageY);
22698 var fly = el.dom ? el : Roo.fly(el);
22699 if (!this.deltaSetXY) {
22700 var aCoord = [oCoord.x, oCoord.y];
22702 var newLeft = fly.getLeft(true);
22703 var newTop = fly.getTop(true);
22704 this.deltaSetXY = [ newLeft - oCoord.x, newTop - oCoord.y ];
22706 fly.setLeftTop(oCoord.x + this.deltaSetXY[0], oCoord.y + this.deltaSetXY[1]);
22709 this.cachePosition(oCoord.x, oCoord.y);
22710 this.autoScroll(oCoord.x, oCoord.y, el.offsetHeight, el.offsetWidth);
22715 * Saves the most recent position so that we can reset the constraints and
22716 * tick marks on-demand. We need to know this so that we can calculate the
22717 * number of pixels the element is offset from its original position.
22718 * @method cachePosition
22719 * @param iPageX the current x position (optional, this just makes it so we
22720 * don't have to look it up again)
22721 * @param iPageY the current y position (optional, this just makes it so we
22722 * don't have to look it up again)
22724 cachePosition: function(iPageX, iPageY) {
22726 this.lastPageX = iPageX;
22727 this.lastPageY = iPageY;
22729 var aCoord = Roo.lib.Dom.getXY(this.getEl());
22730 this.lastPageX = aCoord[0];
22731 this.lastPageY = aCoord[1];
22736 * Auto-scroll the window if the dragged object has been moved beyond the
22737 * visible window boundary.
22738 * @method autoScroll
22739 * @param {int} x the drag element's x position
22740 * @param {int} y the drag element's y position
22741 * @param {int} h the height of the drag element
22742 * @param {int} w the width of the drag element
22745 autoScroll: function(x, y, h, w) {
22748 // The client height
22749 var clientH = Roo.lib.Dom.getViewWidth();
22751 // The client width
22752 var clientW = Roo.lib.Dom.getViewHeight();
22754 // The amt scrolled down
22755 var st = this.DDM.getScrollTop();
22757 // The amt scrolled right
22758 var sl = this.DDM.getScrollLeft();
22760 // Location of the bottom of the element
22763 // Location of the right of the element
22766 // The distance from the cursor to the bottom of the visible area,
22767 // adjusted so that we don't scroll if the cursor is beyond the
22768 // element drag constraints
22769 var toBot = (clientH + st - y - this.deltaY);
22771 // The distance from the cursor to the right of the visible area
22772 var toRight = (clientW + sl - x - this.deltaX);
22775 // How close to the edge the cursor must be before we scroll
22776 // var thresh = (document.all) ? 100 : 40;
22779 // How many pixels to scroll per autoscroll op. This helps to reduce
22780 // clunky scrolling. IE is more sensitive about this ... it needs this
22781 // value to be higher.
22782 var scrAmt = (document.all) ? 80 : 30;
22784 // Scroll down if we are near the bottom of the visible page and the
22785 // obj extends below the crease
22786 if ( bot > clientH && toBot < thresh ) {
22787 window.scrollTo(sl, st + scrAmt);
22790 // Scroll up if the window is scrolled down and the top of the object
22791 // goes above the top border
22792 if ( y < st && st > 0 && y - st < thresh ) {
22793 window.scrollTo(sl, st - scrAmt);
22796 // Scroll right if the obj is beyond the right border and the cursor is
22797 // near the border.
22798 if ( right > clientW && toRight < thresh ) {
22799 window.scrollTo(sl + scrAmt, st);
22802 // Scroll left if the window has been scrolled to the right and the obj
22803 // extends past the left border
22804 if ( x < sl && sl > 0 && x - sl < thresh ) {
22805 window.scrollTo(sl - scrAmt, st);
22811 * Finds the location the element should be placed if we want to move
22812 * it to where the mouse location less the click offset would place us.
22813 * @method getTargetCoord
22814 * @param {int} iPageX the X coordinate of the click
22815 * @param {int} iPageY the Y coordinate of the click
22816 * @return an object that contains the coordinates (Object.x and Object.y)
22819 getTargetCoord: function(iPageX, iPageY) {
22822 var x = iPageX - this.deltaX;
22823 var y = iPageY - this.deltaY;
22825 if (this.constrainX) {
22826 if (x < this.minX) { x = this.minX; }
22827 if (x > this.maxX) { x = this.maxX; }
22830 if (this.constrainY) {
22831 if (y < this.minY) { y = this.minY; }
22832 if (y > this.maxY) { y = this.maxY; }
22835 x = this.getTick(x, this.xTicks);
22836 y = this.getTick(y, this.yTicks);
22843 * Sets up config options specific to this class. Overrides
22844 * Roo.dd.DragDrop, but all versions of this method through the
22845 * inheritance chain are called
22847 applyConfig: function() {
22848 Roo.dd.DD.superclass.applyConfig.call(this);
22849 this.scroll = (this.config.scroll !== false);
22853 * Event that fires prior to the onMouseDown event. Overrides
22856 b4MouseDown: function(e) {
22857 // this.resetConstraints();
22858 this.autoOffset(e.getPageX(),
22863 * Event that fires prior to the onDrag event. Overrides
22866 b4Drag: function(e) {
22867 this.setDragElPos(e.getPageX(),
22871 toString: function() {
22872 return ("DD " + this.id);
22875 //////////////////////////////////////////////////////////////////////////
22876 // Debugging ygDragDrop events that can be overridden
22877 //////////////////////////////////////////////////////////////////////////
22879 startDrag: function(x, y) {
22882 onDrag: function(e) {
22885 onDragEnter: function(e, id) {
22888 onDragOver: function(e, id) {
22891 onDragOut: function(e, id) {
22894 onDragDrop: function(e, id) {
22897 endDrag: function(e) {
22904 * Ext JS Library 1.1.1
22905 * Copyright(c) 2006-2007, Ext JS, LLC.
22907 * Originally Released Under LGPL - original licence link has changed is not relivant.
22910 * <script type="text/javascript">
22914 * @class Roo.dd.DDProxy
22915 * A DragDrop implementation that inserts an empty, bordered div into
22916 * the document that follows the cursor during drag operations. At the time of
22917 * the click, the frame div is resized to the dimensions of the linked html
22918 * element, and moved to the exact location of the linked element.
22920 * References to the "frame" element refer to the single proxy element that
22921 * was created to be dragged in place of all DDProxy elements on the
22924 * @extends Roo.dd.DD
22926 * @param {String} id the id of the linked html element
22927 * @param {String} sGroup the group of related DragDrop objects
22928 * @param {object} config an object containing configurable attributes
22929 * Valid properties for DDProxy in addition to those in DragDrop:
22930 * resizeFrame, centerFrame, dragElId
22932 Roo.dd.DDProxy = function(id, sGroup, config) {
22934 this.init(id, sGroup, config);
22940 * The default drag frame div id
22941 * @property Roo.dd.DDProxy.dragElId
22945 Roo.dd.DDProxy.dragElId = "ygddfdiv";
22947 Roo.extend(Roo.dd.DDProxy, Roo.dd.DD, {
22950 * By default we resize the drag frame to be the same size as the element
22951 * we want to drag (this is to get the frame effect). We can turn it off
22952 * if we want a different behavior.
22953 * @property resizeFrame
22959 * By default the frame is positioned exactly where the drag element is, so
22960 * we use the cursor offset provided by Roo.dd.DD. Another option that works only if
22961 * you do not have constraints on the obj is to have the drag frame centered
22962 * around the cursor. Set centerFrame to true for this effect.
22963 * @property centerFrame
22966 centerFrame: false,
22969 * Creates the proxy element if it does not yet exist
22970 * @method createFrame
22972 createFrame: function() {
22974 var body = document.body;
22976 if (!body || !body.firstChild) {
22977 setTimeout( function() { self.createFrame(); }, 50 );
22981 var div = this.getDragEl();
22984 div = document.createElement("div");
22985 div.id = this.dragElId;
22988 s.position = "absolute";
22989 s.visibility = "hidden";
22991 s.border = "2px solid #aaa";
22994 // appendChild can blow up IE if invoked prior to the window load event
22995 // while rendering a table. It is possible there are other scenarios
22996 // that would cause this to happen as well.
22997 body.insertBefore(div, body.firstChild);
23002 * Initialization for the drag frame element. Must be called in the
23003 * constructor of all subclasses
23004 * @method initFrame
23006 initFrame: function() {
23007 this.createFrame();
23010 applyConfig: function() {
23011 Roo.dd.DDProxy.superclass.applyConfig.call(this);
23013 this.resizeFrame = (this.config.resizeFrame !== false);
23014 this.centerFrame = (this.config.centerFrame);
23015 this.setDragElId(this.config.dragElId || Roo.dd.DDProxy.dragElId);
23019 * Resizes the drag frame to the dimensions of the clicked object, positions
23020 * it over the object, and finally displays it
23021 * @method showFrame
23022 * @param {int} iPageX X click position
23023 * @param {int} iPageY Y click position
23026 showFrame: function(iPageX, iPageY) {
23027 var el = this.getEl();
23028 var dragEl = this.getDragEl();
23029 var s = dragEl.style;
23031 this._resizeProxy();
23033 if (this.centerFrame) {
23034 this.setDelta( Math.round(parseInt(s.width, 10)/2),
23035 Math.round(parseInt(s.height, 10)/2) );
23038 this.setDragElPos(iPageX, iPageY);
23040 Roo.fly(dragEl).show();
23044 * The proxy is automatically resized to the dimensions of the linked
23045 * element when a drag is initiated, unless resizeFrame is set to false
23046 * @method _resizeProxy
23049 _resizeProxy: function() {
23050 if (this.resizeFrame) {
23051 var el = this.getEl();
23052 Roo.fly(this.getDragEl()).setSize(el.offsetWidth, el.offsetHeight);
23056 // overrides Roo.dd.DragDrop
23057 b4MouseDown: function(e) {
23058 var x = e.getPageX();
23059 var y = e.getPageY();
23060 this.autoOffset(x, y);
23061 this.setDragElPos(x, y);
23064 // overrides Roo.dd.DragDrop
23065 b4StartDrag: function(x, y) {
23066 // show the drag frame
23067 this.showFrame(x, y);
23070 // overrides Roo.dd.DragDrop
23071 b4EndDrag: function(e) {
23072 Roo.fly(this.getDragEl()).hide();
23075 // overrides Roo.dd.DragDrop
23076 // By default we try to move the element to the last location of the frame.
23077 // This is so that the default behavior mirrors that of Roo.dd.DD.
23078 endDrag: function(e) {
23080 var lel = this.getEl();
23081 var del = this.getDragEl();
23083 // Show the drag frame briefly so we can get its position
23084 del.style.visibility = "";
23087 // Hide the linked element before the move to get around a Safari
23089 lel.style.visibility = "hidden";
23090 Roo.dd.DDM.moveToEl(lel, del);
23091 del.style.visibility = "hidden";
23092 lel.style.visibility = "";
23097 beforeMove : function(){
23101 afterDrag : function(){
23105 toString: function() {
23106 return ("DDProxy " + this.id);
23112 * Ext JS Library 1.1.1
23113 * Copyright(c) 2006-2007, Ext JS, LLC.
23115 * Originally Released Under LGPL - original licence link has changed is not relivant.
23118 * <script type="text/javascript">
23122 * @class Roo.dd.DDTarget
23123 * A DragDrop implementation that does not move, but can be a drop
23124 * target. You would get the same result by simply omitting implementation
23125 * for the event callbacks, but this way we reduce the processing cost of the
23126 * event listener and the callbacks.
23127 * @extends Roo.dd.DragDrop
23129 * @param {String} id the id of the element that is a drop target
23130 * @param {String} sGroup the group of related DragDrop objects
23131 * @param {object} config an object containing configurable attributes
23132 * Valid properties for DDTarget in addition to those in
23136 Roo.dd.DDTarget = function(id, sGroup, config) {
23138 this.initTarget(id, sGroup, config);
23140 if (config && (config.listeners || config.events)) {
23141 Roo.dd.DragDrop.superclass.constructor.call(this, {
23142 listeners : config.listeners || {},
23143 events : config.events || {}
23148 // Roo.dd.DDTarget.prototype = new Roo.dd.DragDrop();
23149 Roo.extend(Roo.dd.DDTarget, Roo.dd.DragDrop, {
23150 toString: function() {
23151 return ("DDTarget " + this.id);
23156 * Ext JS Library 1.1.1
23157 * Copyright(c) 2006-2007, Ext JS, LLC.
23159 * Originally Released Under LGPL - original licence link has changed is not relivant.
23162 * <script type="text/javascript">
23167 * @class Roo.dd.ScrollManager
23168 * Provides automatic scrolling of overflow regions in the page during drag operations.<br><br>
23169 * <b>Note: This class uses "Point Mode" and is untested in "Intersect Mode".</b>
23172 Roo.dd.ScrollManager = function(){
23173 var ddm = Roo.dd.DragDropMgr;
23180 var onStop = function(e){
23185 var triggerRefresh = function(){
23186 if(ddm.dragCurrent){
23187 ddm.refreshCache(ddm.dragCurrent.groups);
23191 var doScroll = function(){
23192 if(ddm.dragCurrent){
23193 var dds = Roo.dd.ScrollManager;
23195 if(proc.el.scroll(proc.dir, dds.increment)){
23199 proc.el.scroll(proc.dir, dds.increment, true, dds.animDuration, triggerRefresh);
23204 var clearProc = function(){
23206 clearInterval(proc.id);
23213 var startProc = function(el, dir){
23214 Roo.log('scroll startproc');
23218 proc.id = setInterval(doScroll, Roo.dd.ScrollManager.frequency);
23221 var onFire = function(e, isDrop){
23223 if(isDrop || !ddm.dragCurrent){ return; }
23224 var dds = Roo.dd.ScrollManager;
23225 if(!dragEl || dragEl != ddm.dragCurrent){
23226 dragEl = ddm.dragCurrent;
23227 // refresh regions on drag start
23228 dds.refreshCache();
23231 var xy = Roo.lib.Event.getXY(e);
23232 var pt = new Roo.lib.Point(xy[0], xy[1]);
23233 for(var id in els){
23234 var el = els[id], r = el._region;
23235 if(r && r.contains(pt) && el.isScrollable()){
23236 if(r.bottom - pt.y <= dds.thresh){
23238 startProc(el, "down");
23241 }else if(r.right - pt.x <= dds.thresh){
23243 startProc(el, "left");
23246 }else if(pt.y - r.top <= dds.thresh){
23248 startProc(el, "up");
23251 }else if(pt.x - r.left <= dds.thresh){
23253 startProc(el, "right");
23262 ddm.fireEvents = ddm.fireEvents.createSequence(onFire, ddm);
23263 ddm.stopDrag = ddm.stopDrag.createSequence(onStop, ddm);
23267 * Registers new overflow element(s) to auto scroll
23268 * @param {String/HTMLElement/Element/Array} el The id of or the element to be scrolled or an array of either
23270 register : function(el){
23271 if(el instanceof Array){
23272 for(var i = 0, len = el.length; i < len; i++) {
23273 this.register(el[i]);
23279 Roo.dd.ScrollManager.els = els;
23283 * Unregisters overflow element(s) so they are no longer scrolled
23284 * @param {String/HTMLElement/Element/Array} el The id of or the element to be removed or an array of either
23286 unregister : function(el){
23287 if(el instanceof Array){
23288 for(var i = 0, len = el.length; i < len; i++) {
23289 this.unregister(el[i]);
23298 * The number of pixels from the edge of a container the pointer needs to be to
23299 * trigger scrolling (defaults to 25)
23305 * The number of pixels to scroll in each scroll increment (defaults to 50)
23311 * The frequency of scrolls in milliseconds (defaults to 500)
23317 * True to animate the scroll (defaults to true)
23323 * The animation duration in seconds -
23324 * MUST BE less than Roo.dd.ScrollManager.frequency! (defaults to .4)
23330 * Manually trigger a cache refresh.
23332 refreshCache : function(){
23333 for(var id in els){
23334 if(typeof els[id] == 'object'){ // for people extending the object prototype
23335 els[id]._region = els[id].getRegion();
23342 * Ext JS Library 1.1.1
23343 * Copyright(c) 2006-2007, Ext JS, LLC.
23345 * Originally Released Under LGPL - original licence link has changed is not relivant.
23348 * <script type="text/javascript">
23353 * @class Roo.dd.Registry
23354 * Provides easy access to all drag drop components that are registered on a page. Items can be retrieved either
23355 * directly by DOM node id, or by passing in the drag drop event that occurred and looking up the event target.
23358 Roo.dd.Registry = function(){
23361 var autoIdSeed = 0;
23363 var getId = function(el, autogen){
23364 if(typeof el == "string"){
23368 if(!id && autogen !== false){
23369 id = "roodd-" + (++autoIdSeed);
23377 * Register a drag drop element
23378 * @param {String|HTMLElement} element The id or DOM node to register
23379 * @param {Object} data (optional) A custom data object that will be passed between the elements that are involved
23380 * in drag drop operations. You can populate this object with any arbitrary properties that your own code
23381 * knows how to interpret, plus there are some specific properties known to the Registry that should be
23382 * populated in the data object (if applicable):
23384 Value Description<br />
23385 --------- ------------------------------------------<br />
23386 handles Array of DOM nodes that trigger dragging<br />
23387 for the element being registered<br />
23388 isHandle True if the element passed in triggers<br />
23389 dragging itself, else false
23392 register : function(el, data){
23394 if(typeof el == "string"){
23395 el = document.getElementById(el);
23398 elements[getId(el)] = data;
23399 if(data.isHandle !== false){
23400 handles[data.ddel.id] = data;
23403 var hs = data.handles;
23404 for(var i = 0, len = hs.length; i < len; i++){
23405 handles[getId(hs[i])] = data;
23411 * Unregister a drag drop element
23412 * @param {String|HTMLElement} element The id or DOM node to unregister
23414 unregister : function(el){
23415 var id = getId(el, false);
23416 var data = elements[id];
23418 delete elements[id];
23420 var hs = data.handles;
23421 for(var i = 0, len = hs.length; i < len; i++){
23422 delete handles[getId(hs[i], false)];
23429 * Returns the handle registered for a DOM Node by id
23430 * @param {String|HTMLElement} id The DOM node or id to look up
23431 * @return {Object} handle The custom handle data
23433 getHandle : function(id){
23434 if(typeof id != "string"){ // must be element?
23437 return handles[id];
23441 * Returns the handle that is registered for the DOM node that is the target of the event
23442 * @param {Event} e The event
23443 * @return {Object} handle The custom handle data
23445 getHandleFromEvent : function(e){
23446 var t = Roo.lib.Event.getTarget(e);
23447 return t ? handles[t.id] : null;
23451 * Returns a custom data object that is registered for a DOM node by id
23452 * @param {String|HTMLElement} id The DOM node or id to look up
23453 * @return {Object} data The custom data
23455 getTarget : function(id){
23456 if(typeof id != "string"){ // must be element?
23459 return elements[id];
23463 * Returns a custom data object that is registered for the DOM node that is the target of the event
23464 * @param {Event} e The event
23465 * @return {Object} data The custom data
23467 getTargetFromEvent : function(e){
23468 var t = Roo.lib.Event.getTarget(e);
23469 return t ? elements[t.id] || handles[t.id] : null;
23474 * Ext JS Library 1.1.1
23475 * Copyright(c) 2006-2007, Ext JS, LLC.
23477 * Originally Released Under LGPL - original licence link has changed is not relivant.
23480 * <script type="text/javascript">
23485 * @class Roo.dd.StatusProxy
23486 * A specialized drag proxy that supports a drop status icon, {@link Roo.Layer} styles and auto-repair. This is the
23487 * default drag proxy used by all Roo.dd components.
23489 * @param {Object} config
23491 Roo.dd.StatusProxy = function(config){
23492 Roo.apply(this, config);
23493 this.id = this.id || Roo.id();
23494 this.el = new Roo.Layer({
23496 id: this.id, tag: "div", cls: "x-dd-drag-proxy "+this.dropNotAllowed, children: [
23497 {tag: "div", cls: "x-dd-drop-icon"},
23498 {tag: "div", cls: "x-dd-drag-ghost"}
23501 shadow: !config || config.shadow !== false
23503 this.ghost = Roo.get(this.el.dom.childNodes[1]);
23504 this.dropStatus = this.dropNotAllowed;
23507 Roo.dd.StatusProxy.prototype = {
23509 * @cfg {String} dropAllowed
23510 * The CSS class to apply to the status element when drop is allowed (defaults to "x-dd-drop-ok").
23512 dropAllowed : "x-dd-drop-ok",
23514 * @cfg {String} dropNotAllowed
23515 * The CSS class to apply to the status element when drop is not allowed (defaults to "x-dd-drop-nodrop").
23517 dropNotAllowed : "x-dd-drop-nodrop",
23520 * Updates the proxy's visual element to indicate the status of whether or not drop is allowed
23521 * over the current target element.
23522 * @param {String} cssClass The css class for the new drop status indicator image
23524 setStatus : function(cssClass){
23525 cssClass = cssClass || this.dropNotAllowed;
23526 if(this.dropStatus != cssClass){
23527 this.el.replaceClass(this.dropStatus, cssClass);
23528 this.dropStatus = cssClass;
23533 * Resets the status indicator to the default dropNotAllowed value
23534 * @param {Boolean} clearGhost True to also remove all content from the ghost, false to preserve it
23536 reset : function(clearGhost){
23537 this.el.dom.className = "x-dd-drag-proxy " + this.dropNotAllowed;
23538 this.dropStatus = this.dropNotAllowed;
23540 this.ghost.update("");
23545 * Updates the contents of the ghost element
23546 * @param {String} html The html that will replace the current innerHTML of the ghost element
23548 update : function(html){
23549 if(typeof html == "string"){
23550 this.ghost.update(html);
23552 this.ghost.update("");
23553 html.style.margin = "0";
23554 this.ghost.dom.appendChild(html);
23556 // ensure float = none set?? cant remember why though.
23557 var el = this.ghost.dom.firstChild;
23559 Roo.fly(el).setStyle('float', 'none');
23564 * Returns the underlying proxy {@link Roo.Layer}
23565 * @return {Roo.Layer} el
23567 getEl : function(){
23572 * Returns the ghost element
23573 * @return {Roo.Element} el
23575 getGhost : function(){
23581 * @param {Boolean} clear True to reset the status and clear the ghost contents, false to preserve them
23583 hide : function(clear){
23591 * Stops the repair animation if it's currently running
23594 if(this.anim && this.anim.isAnimated && this.anim.isAnimated()){
23600 * Displays this proxy
23607 * Force the Layer to sync its shadow and shim positions to the element
23614 * Causes the proxy to return to its position of origin via an animation. Should be called after an
23615 * invalid drop operation by the item being dragged.
23616 * @param {Array} xy The XY position of the element ([x, y])
23617 * @param {Function} callback The function to call after the repair is complete
23618 * @param {Object} scope The scope in which to execute the callback
23620 repair : function(xy, callback, scope){
23621 this.callback = callback;
23622 this.scope = scope;
23623 if(xy && this.animRepair !== false){
23624 this.el.addClass("x-dd-drag-repair");
23625 this.el.hideUnders(true);
23626 this.anim = this.el.shift({
23627 duration: this.repairDuration || .5,
23631 callback: this.afterRepair,
23635 this.afterRepair();
23640 afterRepair : function(){
23642 if(typeof this.callback == "function"){
23643 this.callback.call(this.scope || this);
23645 this.callback = null;
23650 * Ext JS Library 1.1.1
23651 * Copyright(c) 2006-2007, Ext JS, LLC.
23653 * Originally Released Under LGPL - original licence link has changed is not relivant.
23656 * <script type="text/javascript">
23660 * @class Roo.dd.DragSource
23661 * @extends Roo.dd.DDProxy
23662 * A simple class that provides the basic implementation needed to make any element draggable.
23664 * @param {String/HTMLElement/Element} el The container element
23665 * @param {Object} config
23667 Roo.dd.DragSource = function(el, config){
23668 this.el = Roo.get(el);
23669 this.dragData = {};
23671 Roo.apply(this, config);
23674 this.proxy = new Roo.dd.StatusProxy();
23677 Roo.dd.DragSource.superclass.constructor.call(this, this.el.dom, this.ddGroup || this.group,
23678 {dragElId : this.proxy.id, resizeFrame: false, isTarget: false, scroll: this.scroll === true});
23680 this.dragging = false;
23683 Roo.extend(Roo.dd.DragSource, Roo.dd.DDProxy, {
23685 * @cfg {String} dropAllowed
23686 * The CSS class returned to the drag source when drop is allowed (defaults to "x-dd-drop-ok").
23688 dropAllowed : "x-dd-drop-ok",
23690 * @cfg {String} dropNotAllowed
23691 * The CSS class returned to the drag source when drop is not allowed (defaults to "x-dd-drop-nodrop").
23693 dropNotAllowed : "x-dd-drop-nodrop",
23696 * Returns the data object associated with this drag source
23697 * @return {Object} data An object containing arbitrary data
23699 getDragData : function(e){
23700 return this.dragData;
23704 onDragEnter : function(e, id){
23705 var target = Roo.dd.DragDropMgr.getDDById(id);
23706 this.cachedTarget = target;
23707 if(this.beforeDragEnter(target, e, id) !== false){
23708 if(target.isNotifyTarget){
23709 var status = target.notifyEnter(this, e, this.dragData);
23710 this.proxy.setStatus(status);
23712 this.proxy.setStatus(this.dropAllowed);
23715 if(this.afterDragEnter){
23717 * An empty function by default, but provided so that you can perform a custom action
23718 * when the dragged item enters the drop target by providing an implementation.
23719 * @param {Roo.dd.DragDrop} target The drop target
23720 * @param {Event} e The event object
23721 * @param {String} id The id of the dragged element
23722 * @method afterDragEnter
23724 this.afterDragEnter(target, e, id);
23730 * An empty function by default, but provided so that you can perform a custom action
23731 * before the dragged item enters the drop target and optionally cancel the onDragEnter.
23732 * @param {Roo.dd.DragDrop} target The drop target
23733 * @param {Event} e The event object
23734 * @param {String} id The id of the dragged element
23735 * @return {Boolean} isValid True if the drag event is valid, else false to cancel
23737 beforeDragEnter : function(target, e, id){
23742 alignElWithMouse: function() {
23743 Roo.dd.DragSource.superclass.alignElWithMouse.apply(this, arguments);
23748 onDragOver : function(e, id){
23749 var target = this.cachedTarget || Roo.dd.DragDropMgr.getDDById(id);
23750 if(this.beforeDragOver(target, e, id) !== false){
23751 if(target.isNotifyTarget){
23752 var status = target.notifyOver(this, e, this.dragData);
23753 this.proxy.setStatus(status);
23756 if(this.afterDragOver){
23758 * An empty function by default, but provided so that you can perform a custom action
23759 * while the dragged item is over the drop target by providing an implementation.
23760 * @param {Roo.dd.DragDrop} target The drop target
23761 * @param {Event} e The event object
23762 * @param {String} id The id of the dragged element
23763 * @method afterDragOver
23765 this.afterDragOver(target, e, id);
23771 * An empty function by default, but provided so that you can perform a custom action
23772 * while the dragged item is over the drop target and optionally cancel the onDragOver.
23773 * @param {Roo.dd.DragDrop} target The drop target
23774 * @param {Event} e The event object
23775 * @param {String} id The id of the dragged element
23776 * @return {Boolean} isValid True if the drag event is valid, else false to cancel
23778 beforeDragOver : function(target, e, id){
23783 onDragOut : function(e, id){
23784 var target = this.cachedTarget || Roo.dd.DragDropMgr.getDDById(id);
23785 if(this.beforeDragOut(target, e, id) !== false){
23786 if(target.isNotifyTarget){
23787 target.notifyOut(this, e, this.dragData);
23789 this.proxy.reset();
23790 if(this.afterDragOut){
23792 * An empty function by default, but provided so that you can perform a custom action
23793 * after the dragged item is dragged out of the target without dropping.
23794 * @param {Roo.dd.DragDrop} target The drop target
23795 * @param {Event} e The event object
23796 * @param {String} id The id of the dragged element
23797 * @method afterDragOut
23799 this.afterDragOut(target, e, id);
23802 this.cachedTarget = null;
23806 * An empty function by default, but provided so that you can perform a custom action before the dragged
23807 * item is dragged out of the target without dropping, and optionally cancel the onDragOut.
23808 * @param {Roo.dd.DragDrop} target The drop target
23809 * @param {Event} e The event object
23810 * @param {String} id The id of the dragged element
23811 * @return {Boolean} isValid True if the drag event is valid, else false to cancel
23813 beforeDragOut : function(target, e, id){
23818 onDragDrop : function(e, id){
23819 var target = this.cachedTarget || Roo.dd.DragDropMgr.getDDById(id);
23820 if(this.beforeDragDrop(target, e, id) !== false){
23821 if(target.isNotifyTarget){
23822 if(target.notifyDrop(this, e, this.dragData)){ // valid drop?
23823 this.onValidDrop(target, e, id);
23825 this.onInvalidDrop(target, e, id);
23828 this.onValidDrop(target, e, id);
23831 if(this.afterDragDrop){
23833 * An empty function by default, but provided so that you can perform a custom action
23834 * after a valid drag drop has occurred by providing an implementation.
23835 * @param {Roo.dd.DragDrop} target The drop target
23836 * @param {Event} e The event object
23837 * @param {String} id The id of the dropped element
23838 * @method afterDragDrop
23840 this.afterDragDrop(target, e, id);
23843 delete this.cachedTarget;
23847 * An empty function by default, but provided so that you can perform a custom action before the dragged
23848 * item is dropped onto the target and optionally cancel the onDragDrop.
23849 * @param {Roo.dd.DragDrop} target The drop target
23850 * @param {Event} e The event object
23851 * @param {String} id The id of the dragged element
23852 * @return {Boolean} isValid True if the drag drop event is valid, else false to cancel
23854 beforeDragDrop : function(target, e, id){
23859 onValidDrop : function(target, e, id){
23861 if(this.afterValidDrop){
23863 * An empty function by default, but provided so that you can perform a custom action
23864 * after a valid drop has occurred by providing an implementation.
23865 * @param {Object} target The target DD
23866 * @param {Event} e The event object
23867 * @param {String} id The id of the dropped element
23868 * @method afterInvalidDrop
23870 this.afterValidDrop(target, e, id);
23875 getRepairXY : function(e, data){
23876 return this.el.getXY();
23880 onInvalidDrop : function(target, e, id){
23881 this.beforeInvalidDrop(target, e, id);
23882 if(this.cachedTarget){
23883 if(this.cachedTarget.isNotifyTarget){
23884 this.cachedTarget.notifyOut(this, e, this.dragData);
23886 this.cacheTarget = null;
23888 this.proxy.repair(this.getRepairXY(e, this.dragData), this.afterRepair, this);
23890 if(this.afterInvalidDrop){
23892 * An empty function by default, but provided so that you can perform a custom action
23893 * after an invalid drop has occurred by providing an implementation.
23894 * @param {Event} e The event object
23895 * @param {String} id The id of the dropped element
23896 * @method afterInvalidDrop
23898 this.afterInvalidDrop(e, id);
23903 afterRepair : function(){
23905 this.el.highlight(this.hlColor || "c3daf9");
23907 this.dragging = false;
23911 * An empty function by default, but provided so that you can perform a custom action after an invalid
23912 * drop has occurred.
23913 * @param {Roo.dd.DragDrop} target The drop target
23914 * @param {Event} e The event object
23915 * @param {String} id The id of the dragged element
23916 * @return {Boolean} isValid True if the invalid drop should proceed, else false to cancel
23918 beforeInvalidDrop : function(target, e, id){
23923 handleMouseDown : function(e){
23924 if(this.dragging) {
23927 var data = this.getDragData(e);
23928 if(data && this.onBeforeDrag(data, e) !== false){
23929 this.dragData = data;
23931 Roo.dd.DragSource.superclass.handleMouseDown.apply(this, arguments);
23936 * An empty function by default, but provided so that you can perform a custom action before the initial
23937 * drag event begins and optionally cancel it.
23938 * @param {Object} data An object containing arbitrary data to be shared with drop targets
23939 * @param {Event} e The event object
23940 * @return {Boolean} isValid True if the drag event is valid, else false to cancel
23942 onBeforeDrag : function(data, e){
23947 * An empty function by default, but provided so that you can perform a custom action once the initial
23948 * drag event has begun. The drag cannot be canceled from this function.
23949 * @param {Number} x The x position of the click on the dragged object
23950 * @param {Number} y The y position of the click on the dragged object
23952 onStartDrag : Roo.emptyFn,
23954 // private - YUI override
23955 startDrag : function(x, y){
23956 this.proxy.reset();
23957 this.dragging = true;
23958 this.proxy.update("");
23959 this.onInitDrag(x, y);
23964 onInitDrag : function(x, y){
23965 var clone = this.el.dom.cloneNode(true);
23966 clone.id = Roo.id(); // prevent duplicate ids
23967 this.proxy.update(clone);
23968 this.onStartDrag(x, y);
23973 * Returns the drag source's underlying {@link Roo.dd.StatusProxy}
23974 * @return {Roo.dd.StatusProxy} proxy The StatusProxy
23976 getProxy : function(){
23981 * Hides the drag source's {@link Roo.dd.StatusProxy}
23983 hideProxy : function(){
23985 this.proxy.reset(true);
23986 this.dragging = false;
23990 triggerCacheRefresh : function(){
23991 Roo.dd.DDM.refreshCache(this.groups);
23994 // private - override to prevent hiding
23995 b4EndDrag: function(e) {
23998 // private - override to prevent moving
23999 endDrag : function(e){
24000 this.onEndDrag(this.dragData, e);
24004 onEndDrag : function(data, e){
24007 // private - pin to cursor
24008 autoOffset : function(x, y) {
24009 this.setDelta(-12, -20);
24013 * Ext JS Library 1.1.1
24014 * Copyright(c) 2006-2007, Ext JS, LLC.
24016 * Originally Released Under LGPL - original licence link has changed is not relivant.
24019 * <script type="text/javascript">
24024 * @class Roo.dd.DropTarget
24025 * @extends Roo.dd.DDTarget
24026 * A simple class that provides the basic implementation needed to make any element a drop target that can have
24027 * draggable items dropped onto it. The drop has no effect until an implementation of notifyDrop is provided.
24029 * @param {String/HTMLElement/Element} el The container element
24030 * @param {Object} config
24032 Roo.dd.DropTarget = function(el, config){
24033 this.el = Roo.get(el);
24035 var listeners = false; ;
24036 if (config && config.listeners) {
24037 listeners= config.listeners;
24038 delete config.listeners;
24040 Roo.apply(this, config);
24042 if(this.containerScroll){
24043 Roo.dd.ScrollManager.register(this.el);
24047 * @scope Roo.dd.DropTarget
24052 * The function a {@link Roo.dd.DragSource} calls once to notify this drop target that the source is now over the
24053 * target. This default implementation adds the CSS class specified by overClass (if any) to the drop element
24054 * and returns the dropAllowed config value. This method should be overridden if drop validation is required.
24056 * IMPORTANT : it should set this.valid to true|false
24058 * @param {Roo.dd.DragSource} source The drag source that was dragged over this drop target
24059 * @param {Event} e The event
24060 * @param {Object} data An object containing arbitrary data supplied by the drag source
24066 * The function a {@link Roo.dd.DragSource} calls continuously while it is being dragged over the target.
24067 * This method will be called on every mouse movement while the drag source is over the drop target.
24068 * This default implementation simply returns the dropAllowed config value.
24070 * IMPORTANT : it should set this.valid to true|false
24072 * @param {Roo.dd.DragSource} source The drag source that was dragged over this drop target
24073 * @param {Event} e The event
24074 * @param {Object} data An object containing arbitrary data supplied by the drag source
24080 * The function a {@link Roo.dd.DragSource} calls once to notify this drop target that the source has been dragged
24081 * out of the target without dropping. This default implementation simply removes the CSS class specified by
24082 * overClass (if any) from the drop element.
24085 * @param {Roo.dd.DragSource} source The drag source that was dragged over this drop target
24086 * @param {Event} e The event
24087 * @param {Object} data An object containing arbitrary data supplied by the drag source
24093 * The function a {@link Roo.dd.DragSource} calls once to notify this drop target that the dragged item has
24094 * been dropped on it. This method has no default implementation and returns false, so you must provide an
24095 * implementation that does something to process the drop event and returns true so that the drag source's
24096 * repair action does not run.
24098 * IMPORTANT : it should set this.success
24100 * @param {Roo.dd.DragSource} source The drag source that was dragged over this drop target
24101 * @param {Event} e The event
24102 * @param {Object} data An object containing arbitrary data supplied by the drag source
24108 Roo.dd.DropTarget.superclass.constructor.call( this,
24110 this.ddGroup || this.group,
24113 listeners : listeners || {}
24121 Roo.extend(Roo.dd.DropTarget, Roo.dd.DDTarget, {
24123 * @cfg {String} overClass
24124 * The CSS class applied to the drop target element while the drag source is over it (defaults to "").
24127 * @cfg {String} ddGroup
24128 * The drag drop group to handle drop events for
24132 * @cfg {String} dropAllowed
24133 * The CSS class returned to the drag source when drop is allowed (defaults to "x-dd-drop-ok").
24135 dropAllowed : "x-dd-drop-ok",
24137 * @cfg {String} dropNotAllowed
24138 * The CSS class returned to the drag source when drop is not allowed (defaults to "x-dd-drop-nodrop").
24140 dropNotAllowed : "x-dd-drop-nodrop",
24142 * @cfg {boolean} success
24143 * set this after drop listener..
24147 * @cfg {boolean|String} valid true/false or string (ok-add/ok-sub/ok/nodrop)
24148 * if the drop point is valid for over/enter..
24155 isNotifyTarget : true,
24160 notifyEnter : function(dd, e, data)
24163 this.fireEvent('enter', dd, e, data);
24164 if(this.overClass){
24165 this.el.addClass(this.overClass);
24167 return typeof(this.valid) == 'string' ? 'x-dd-drop-' + this.valid : (
24168 this.valid ? this.dropAllowed : this.dropNotAllowed
24175 notifyOver : function(dd, e, data)
24178 this.fireEvent('over', dd, e, data);
24179 return typeof(this.valid) == 'string' ? 'x-dd-drop-' + this.valid : (
24180 this.valid ? this.dropAllowed : this.dropNotAllowed
24187 notifyOut : function(dd, e, data)
24189 this.fireEvent('out', dd, e, data);
24190 if(this.overClass){
24191 this.el.removeClass(this.overClass);
24198 notifyDrop : function(dd, e, data)
24200 this.success = false;
24201 this.fireEvent('drop', dd, e, data);
24202 return this.success;
24206 * Ext JS Library 1.1.1
24207 * Copyright(c) 2006-2007, Ext JS, LLC.
24209 * Originally Released Under LGPL - original licence link has changed is not relivant.
24212 * <script type="text/javascript">
24217 * @class Roo.dd.DragZone
24218 * @extends Roo.dd.DragSource
24219 * This class provides a container DD instance that proxies for multiple child node sources.<br />
24220 * By default, this class requires that draggable child nodes are registered with {@link Roo.dd.Registry}.
24222 * @param {String/HTMLElement/Element} el The container element
24223 * @param {Object} config
24225 Roo.dd.DragZone = function(el, config){
24226 Roo.dd.DragZone.superclass.constructor.call(this, el, config);
24227 if(this.containerScroll){
24228 Roo.dd.ScrollManager.register(this.el);
24232 Roo.extend(Roo.dd.DragZone, Roo.dd.DragSource, {
24234 * @cfg {Boolean} containerScroll True to register this container with the Scrollmanager
24235 * for auto scrolling during drag operations.
24238 * @cfg {String} hlColor The color to use when visually highlighting the drag source in the afterRepair
24239 * method after a failed drop (defaults to "c3daf9" - light blue)
24243 * Called when a mousedown occurs in this container. Looks in {@link Roo.dd.Registry}
24244 * for a valid target to drag based on the mouse down. Override this method
24245 * to provide your own lookup logic (e.g. finding a child by class name). Make sure your returned
24246 * object has a "ddel" attribute (with an HTML Element) for other functions to work.
24247 * @param {EventObject} e The mouse down event
24248 * @return {Object} The dragData
24250 getDragData : function(e){
24251 return Roo.dd.Registry.getHandleFromEvent(e);
24255 * Called once drag threshold has been reached to initialize the proxy element. By default, it clones the
24256 * this.dragData.ddel
24257 * @param {Number} x The x position of the click on the dragged object
24258 * @param {Number} y The y position of the click on the dragged object
24259 * @return {Boolean} true to continue the drag, false to cancel
24261 onInitDrag : function(x, y){
24262 this.proxy.update(this.dragData.ddel.cloneNode(true));
24263 this.onStartDrag(x, y);
24268 * Called after a repair of an invalid drop. By default, highlights this.dragData.ddel
24270 afterRepair : function(){
24272 Roo.Element.fly(this.dragData.ddel).highlight(this.hlColor || "c3daf9");
24274 this.dragging = false;
24278 * Called before a repair of an invalid drop to get the XY to animate to. By default returns
24279 * the XY of this.dragData.ddel
24280 * @param {EventObject} e The mouse up event
24281 * @return {Array} The xy location (e.g. [100, 200])
24283 getRepairXY : function(e){
24284 return Roo.Element.fly(this.dragData.ddel).getXY();
24288 * Ext JS Library 1.1.1
24289 * Copyright(c) 2006-2007, Ext JS, LLC.
24291 * Originally Released Under LGPL - original licence link has changed is not relivant.
24294 * <script type="text/javascript">
24297 * @class Roo.dd.DropZone
24298 * @extends Roo.dd.DropTarget
24299 * This class provides a container DD instance that proxies for multiple child node targets.<br />
24300 * By default, this class requires that child nodes accepting drop are registered with {@link Roo.dd.Registry}.
24302 * @param {String/HTMLElement/Element} el The container element
24303 * @param {Object} config
24305 Roo.dd.DropZone = function(el, config){
24306 Roo.dd.DropZone.superclass.constructor.call(this, el, config);
24309 Roo.extend(Roo.dd.DropZone, Roo.dd.DropTarget, {
24311 * Returns a custom data object associated with the DOM node that is the target of the event. By default
24312 * this looks up the event target in the {@link Roo.dd.Registry}, although you can override this method to
24313 * provide your own custom lookup.
24314 * @param {Event} e The event
24315 * @return {Object} data The custom data
24317 getTargetFromEvent : function(e){
24318 return Roo.dd.Registry.getTargetFromEvent(e);
24322 * Called internally when the DropZone determines that a {@link Roo.dd.DragSource} has entered a drop node
24323 * that it has registered. This method has no default implementation and should be overridden to provide
24324 * node-specific processing if necessary.
24325 * @param {Object} nodeData The custom data associated with the drop node (this is the same value returned from
24326 * {@link #getTargetFromEvent} for this node)
24327 * @param {Roo.dd.DragSource} source The drag source that was dragged over this drop zone
24328 * @param {Event} e The event
24329 * @param {Object} data An object containing arbitrary data supplied by the drag source
24331 onNodeEnter : function(n, dd, e, data){
24336 * Called internally while the DropZone determines that a {@link Roo.dd.DragSource} is over a drop node
24337 * that it has registered. The default implementation returns this.dropNotAllowed, so it should be
24338 * overridden to provide the proper feedback.
24339 * @param {Object} nodeData The custom data associated with the drop node (this is the same value returned from
24340 * {@link #getTargetFromEvent} for this node)
24341 * @param {Roo.dd.DragSource} source The drag source that was dragged over this drop zone
24342 * @param {Event} e The event
24343 * @param {Object} data An object containing arbitrary data supplied by the drag source
24344 * @return {String} status The CSS class that communicates the drop status back to the source so that the
24345 * underlying {@link Roo.dd.StatusProxy} can be updated
24347 onNodeOver : function(n, dd, e, data){
24348 return this.dropAllowed;
24352 * Called internally when the DropZone determines that a {@link Roo.dd.DragSource} has been dragged out of
24353 * the drop node without dropping. This method has no default implementation and should be overridden to provide
24354 * node-specific processing if necessary.
24355 * @param {Object} nodeData The custom data associated with the drop node (this is the same value returned from
24356 * {@link #getTargetFromEvent} for this node)
24357 * @param {Roo.dd.DragSource} source The drag source that was dragged over this drop zone
24358 * @param {Event} e The event
24359 * @param {Object} data An object containing arbitrary data supplied by the drag source
24361 onNodeOut : function(n, dd, e, data){
24366 * Called internally when the DropZone determines that a {@link Roo.dd.DragSource} has been dropped onto
24367 * the drop node. The default implementation returns false, so it should be overridden to provide the
24368 * appropriate processing of the drop event and return true so that the drag source's repair action does not run.
24369 * @param {Object} nodeData The custom data associated with the drop node (this is the same value returned from
24370 * {@link #getTargetFromEvent} for this node)
24371 * @param {Roo.dd.DragSource} source The drag source that was dragged over this drop zone
24372 * @param {Event} e The event
24373 * @param {Object} data An object containing arbitrary data supplied by the drag source
24374 * @return {Boolean} True if the drop was valid, else false
24376 onNodeDrop : function(n, dd, e, data){
24381 * Called internally while the DropZone determines that a {@link Roo.dd.DragSource} is being dragged over it,
24382 * but not over any of its registered drop nodes. The default implementation returns this.dropNotAllowed, so
24383 * it should be overridden to provide the proper feedback if necessary.
24384 * @param {Roo.dd.DragSource} source The drag source that was dragged over this drop zone
24385 * @param {Event} e The event
24386 * @param {Object} data An object containing arbitrary data supplied by the drag source
24387 * @return {String} status The CSS class that communicates the drop status back to the source so that the
24388 * underlying {@link Roo.dd.StatusProxy} can be updated
24390 onContainerOver : function(dd, e, data){
24391 return this.dropNotAllowed;
24395 * Called internally when the DropZone determines that a {@link Roo.dd.DragSource} has been dropped on it,
24396 * but not on any of its registered drop nodes. The default implementation returns false, so it should be
24397 * overridden to provide the appropriate processing of the drop event if you need the drop zone itself to
24398 * be able to accept drops. It should return true when valid so that the drag source's repair action does not run.
24399 * @param {Roo.dd.DragSource} source The drag source that was dragged over this drop zone
24400 * @param {Event} e The event
24401 * @param {Object} data An object containing arbitrary data supplied by the drag source
24402 * @return {Boolean} True if the drop was valid, else false
24404 onContainerDrop : function(dd, e, data){
24409 * The function a {@link Roo.dd.DragSource} calls once to notify this drop zone that the source is now over
24410 * the zone. The default implementation returns this.dropNotAllowed and expects that only registered drop
24411 * nodes can process drag drop operations, so if you need the drop zone itself to be able to process drops
24412 * you should override this method and provide a custom implementation.
24413 * @param {Roo.dd.DragSource} source The drag source that was dragged over this drop zone
24414 * @param {Event} e The event
24415 * @param {Object} data An object containing arbitrary data supplied by the drag source
24416 * @return {String} status The CSS class that communicates the drop status back to the source so that the
24417 * underlying {@link Roo.dd.StatusProxy} can be updated
24419 notifyEnter : function(dd, e, data){
24420 return this.dropNotAllowed;
24424 * The function a {@link Roo.dd.DragSource} calls continuously while it is being dragged over the drop zone.
24425 * This method will be called on every mouse movement while the drag source is over the drop zone.
24426 * It will call {@link #onNodeOver} while the drag source is over a registered node, and will also automatically
24427 * delegate to the appropriate node-specific methods as necessary when the drag source enters and exits
24428 * registered nodes ({@link #onNodeEnter}, {@link #onNodeOut}). If the drag source is not currently over a
24429 * registered node, it will call {@link #onContainerOver}.
24430 * @param {Roo.dd.DragSource} source The drag source that was dragged over this drop zone
24431 * @param {Event} e The event
24432 * @param {Object} data An object containing arbitrary data supplied by the drag source
24433 * @return {String} status The CSS class that communicates the drop status back to the source so that the
24434 * underlying {@link Roo.dd.StatusProxy} can be updated
24436 notifyOver : function(dd, e, data){
24437 var n = this.getTargetFromEvent(e);
24438 if(!n){ // not over valid drop target
24439 if(this.lastOverNode){
24440 this.onNodeOut(this.lastOverNode, dd, e, data);
24441 this.lastOverNode = null;
24443 return this.onContainerOver(dd, e, data);
24445 if(this.lastOverNode != n){
24446 if(this.lastOverNode){
24447 this.onNodeOut(this.lastOverNode, dd, e, data);
24449 this.onNodeEnter(n, dd, e, data);
24450 this.lastOverNode = n;
24452 return this.onNodeOver(n, dd, e, data);
24456 * The function a {@link Roo.dd.DragSource} calls once to notify this drop zone that the source has been dragged
24457 * out of the zone without dropping. If the drag source is currently over a registered node, the notification
24458 * will be delegated to {@link #onNodeOut} for node-specific handling, otherwise it will be ignored.
24459 * @param {Roo.dd.DragSource} source The drag source that was dragged over this drop target
24460 * @param {Event} e The event
24461 * @param {Object} data An object containing arbitrary data supplied by the drag zone
24463 notifyOut : function(dd, e, data){
24464 if(this.lastOverNode){
24465 this.onNodeOut(this.lastOverNode, dd, e, data);
24466 this.lastOverNode = null;
24471 * The function a {@link Roo.dd.DragSource} calls once to notify this drop zone that the dragged item has
24472 * been dropped on it. The drag zone will look up the target node based on the event passed in, and if there
24473 * is a node registered for that event, it will delegate to {@link #onNodeDrop} for node-specific handling,
24474 * otherwise it will call {@link #onContainerDrop}.
24475 * @param {Roo.dd.DragSource} source The drag source that was dragged over this drop zone
24476 * @param {Event} e The event
24477 * @param {Object} data An object containing arbitrary data supplied by the drag source
24478 * @return {Boolean} True if the drop was valid, else false
24480 notifyDrop : function(dd, e, data){
24481 if(this.lastOverNode){
24482 this.onNodeOut(this.lastOverNode, dd, e, data);
24483 this.lastOverNode = null;
24485 var n = this.getTargetFromEvent(e);
24487 this.onNodeDrop(n, dd, e, data) :
24488 this.onContainerDrop(dd, e, data);
24492 triggerCacheRefresh : function(){
24493 Roo.dd.DDM.refreshCache(this.groups);