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')) {
346 if(window.location.href.indexOf("localhost") == -1) {
353 * 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.
357 urlEncode : function(o){
363 var ov = o[key], k = Roo.encodeURIComponent(key);
364 var type = typeof ov;
365 if(type == 'undefined'){
367 }else if(type != "function" && type != "object"){
368 buf.push(k, "=", Roo.encodeURIComponent(ov), "&");
369 }else if(ov instanceof Array){
371 for(var i = 0, len = ov.length; i < len; i++) {
372 buf.push(k, "=", Roo.encodeURIComponent(ov[i] === undefined ? '' : ov[i]), "&");
383 * Safe version of encodeURIComponent
384 * @param {String} data
388 encodeURIComponent : function (data)
391 return encodeURIComponent(data);
392 } catch(e) {} // should be an uri encode error.
394 if (data == '' || data == null){
397 // http://stackoverflow.com/questions/2596483/unicode-and-uri-encoding-decoding-and-escaping-in-javascript
398 function nibble_to_hex(nibble){
399 var chars = '0123456789ABCDEF';
400 return chars.charAt(nibble);
402 data = data.toString();
404 for(var i=0; i<data.length; i++){
405 var c = data.charCodeAt(i);
406 var bs = new Array();
409 bs[0] = 0xF0 | ((c & 0x1C0000) >>> 18);
410 bs[1] = 0x80 | ((c & 0x3F000) >>> 12);
411 bs[2] = 0x80 | ((c & 0xFC0) >>> 6);
412 bs[3] = 0x80 | (c & 0x3F);
413 }else if (c > 0x800){
415 bs[0] = 0xE0 | ((c & 0xF000) >>> 12);
416 bs[1] = 0x80 | ((c & 0xFC0) >>> 6);
417 bs[2] = 0x80 | (c & 0x3F);
420 bs[0] = 0xC0 | ((c & 0x7C0) >>> 6);
421 bs[1] = 0x80 | (c & 0x3F);
426 for(var j=0; j<bs.length; j++){
428 var hex = nibble_to_hex((b & 0xF0) >>> 4)
429 + nibble_to_hex(b &0x0F);
438 * 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]}.
439 * @param {String} string
440 * @param {Boolean} overwrite (optional) Items of the same name will overwrite previous values instead of creating an an array (Defaults to false).
441 * @return {Object} A literal with members
443 urlDecode : function(string, overwrite){
444 if(!string || !string.length){
448 var pairs = string.split('&');
449 var pair, name, value;
450 for(var i = 0, len = pairs.length; i < len; i++){
451 pair = pairs[i].split('=');
452 name = decodeURIComponent(pair[0]);
453 value = decodeURIComponent(pair[1]);
454 if(overwrite !== true){
455 if(typeof obj[name] == "undefined"){
457 }else if(typeof obj[name] == "string"){
458 obj[name] = [obj[name]];
459 obj[name].push(value);
461 obj[name].push(value);
471 * Iterates an array calling the passed function with each item, stopping if your function returns false. If the
472 * passed array is not really an array, your function is called once with it.
473 * The supplied function is called with (Object item, Number index, Array allItems).
474 * @param {Array/NodeList/Mixed} array
475 * @param {Function} fn
476 * @param {Object} scope
478 each : function(array, fn, scope){
479 if(typeof array.length == "undefined" || typeof array == "string"){
482 for(var i = 0, len = array.length; i < len; i++){
483 if(fn.call(scope || array[i], array[i], i, array) === false){ return i; };
488 combine : function(){
489 var as = arguments, l = as.length, r = [];
490 for(var i = 0; i < l; i++){
492 if(a instanceof Array){
494 }else if(a.length !== undefined && !a.substr){
495 r = r.concat(Array.prototype.slice.call(a, 0));
504 * Escapes the passed string for use in a regular expression
505 * @param {String} str
508 escapeRe : function(s) {
509 return s.replace(/([.*+?^${}()|[\]\/\\])/g, "\\$1");
513 callback : function(cb, scope, args, delay){
514 if(typeof cb == "function"){
516 cb.defer(delay, scope, args || []);
518 cb.apply(scope, args || []);
524 * Return the dom node for the passed string (id), dom node, or Roo.Element
525 * @param {String/HTMLElement/Roo.Element} el
526 * @return HTMLElement
528 getDom : function(el){
532 return el.dom ? el.dom : (typeof el == 'string' ? document.getElementById(el) : el);
536 * Shorthand for {@link Roo.ComponentMgr#get}
538 * @return Roo.Component
540 getCmp : function(id){
541 return Roo.ComponentMgr.get(id);
544 num : function(v, defaultValue){
545 if(typeof v != 'number'){
551 destroy : function(){
552 for(var i = 0, a = arguments, len = a.length; i < len; i++) {
556 as.removeAllListeners();
560 if(typeof as.purgeListeners == 'function'){
563 if(typeof as.destroy == 'function'){
570 // inpired by a similar function in mootools library
572 * Returns the type of object that is passed in. If the object passed in is null or undefined it
573 * return false otherwise it returns one of the following values:<ul>
574 * <li><b>string</b>: If the object passed is a string</li>
575 * <li><b>number</b>: If the object passed is a number</li>
576 * <li><b>boolean</b>: If the object passed is a boolean value</li>
577 * <li><b>function</b>: If the object passed is a function reference</li>
578 * <li><b>object</b>: If the object passed is an object</li>
579 * <li><b>array</b>: If the object passed is an array</li>
580 * <li><b>regexp</b>: If the object passed is a regular expression</li>
581 * <li><b>element</b>: If the object passed is a DOM Element</li>
582 * <li><b>nodelist</b>: If the object passed is a DOM NodeList</li>
583 * <li><b>textnode</b>: If the object passed is a DOM text node and contains something other than whitespace</li>
584 * <li><b>whitespace</b>: If the object passed is a DOM text node and contains only whitespace</li>
585 * @param {Mixed} object
589 if(o === undefined || o === null){
596 if(t == 'object' && o.nodeName) {
598 case 1: return 'element';
599 case 3: return (/\S/).test(o.nodeValue) ? 'textnode' : 'whitespace';
602 if(t == 'object' || t == 'function') {
603 switch(o.constructor) {
604 case Array: return 'array';
605 case RegExp: return 'regexp';
607 if(typeof o.length == 'number' && typeof o.item == 'function') {
615 * Returns true if the passed value is null, undefined or an empty string (optional).
616 * @param {Mixed} value The value to test
617 * @param {Boolean} allowBlank (optional) Pass true if an empty string is not considered empty
620 isEmpty : function(v, allowBlank){
621 return v === null || v === undefined || (!allowBlank ? v === '' : false);
629 isFirefox : isFirefox,
641 isBorderBox : isBorderBox,
643 isWindows : isWindows,
651 isAndroid : isAndroid,
656 * By default, Ext intelligently decides whether floating elements should be shimmed. If you are using flash,
657 * you may want to set this to true.
660 useShims : ((isIE && !isIE7) || (isGecko && isMac)),
665 * Selects a single element as a Roo Element
666 * This is about as close as you can get to jQuery's $('do crazy stuff')
667 * @param {String} selector The selector/xpath query
668 * @param {Node} root (optional) The start of the query (defaults to document).
669 * @return {Roo.Element}
671 selectNode : function(selector, root)
673 var node = Roo.DomQuery.selectNode(selector,root);
674 return node ? Roo.get(node) : new Roo.Element(false);
682 Roo.namespace("Roo", "Roo.util", "Roo.grid", "Roo.dd", "Roo.tree", "Roo.data",
683 "Roo.form", "Roo.menu", "Roo.state", "Roo.lib", "Roo.layout",
686 "Roo.bootstrap.dash");