sync
[roojs1] / docs / symbols / Roo.json
1 {
2   "name" : "Roo",
3   "augments" : [],
4   "childClasses" : [],
5   "desc" : "Roo core utilities and functions.",
6   "isSingleton" : true,
7   "isStatic" : false,
8   "isBuiltin" : false,
9   "memberOf" : "Roo",
10   "example" : "",
11   "deprecated" : "",
12   "since" : "",
13   "see" : "",
14   "params" : [],
15   "returns" : [],
16   "throws" : "",
17   "requires" : "",
18   "config" : [],
19   "methods" : [
20     {
21       "name" : "each",
22       "type" : "function",
23       "desc" : "Iterates an array calling the passed function with each item, stopping if your function returns false. If the\npassed array is not really an array, your function is called once with it.\nThe supplied function is called with (Object item, Number index, Array allItems).",
24       "sig" : "(array, fn, scope)",
25       "static" : true,
26       "memberOf" : "",
27       "isStatic" : true,
28       "isConstructor" : false,
29       "isPrivate" : false,
30       "example" : "",
31       "deprecated" : "",
32       "since" : "",
33       "see" : "",
34       "exceptions" : "",
35       "requires" : "",
36       "params" : [
37         {
38           "name" : "array",
39           "type" : "Array/NodeList/Mixed",
40           "desc" : "",
41           "isOptional" : false
42         },
43         {
44           "name" : "fn",
45           "type" : "Function",
46           "desc" : "",
47           "isOptional" : false
48         },
49         {
50           "name" : "scope",
51           "type" : "Object",
52           "desc" : "",
53           "isOptional" : false
54         }
55       ],
56       "returns" : []
57     },
58     {
59       "name" : "get",
60       "type" : "function",
61       "desc" : "Static method to retrieve Element objects. Uses simple caching to consistently return the same object.\nAutomatically fixes if an object was recreated with the same id via AJAX or DOM.\nShorthand of {@link Roo.Element#get}",
62       "sig" : "(el)",
63       "static" : true,
64       "memberOf" : "",
65       "isStatic" : true,
66       "isConstructor" : false,
67       "isPrivate" : false,
68       "example" : "",
69       "deprecated" : "",
70       "since" : "",
71       "see" : "",
72       "exceptions" : "",
73       "requires" : "",
74       "params" : [
75         {
76           "name" : "el",
77           "type" : "String/HTMLElement/Element",
78           "desc" : "The id of the node, a DOM Node or an existing Element.",
79           "isOptional" : false
80         }
81       ],
82       "returns" : [
83         {
84           "name" : "",
85           "type" : "Element",
86           "desc" : "The Element object"
87         }
88       ]
89     },
90     {
91       "name" : "decode",
92       "type" : "function",
93       "desc" : "Shorthand for {@link Roo.util.JSON#decode}",
94       "sig" : "()\n{\n\n}",
95       "static" : true,
96       "memberOf" : "",
97       "isStatic" : true,
98       "isConstructor" : false,
99       "isPrivate" : false,
100       "example" : "",
101       "deprecated" : "",
102       "since" : "",
103       "see" : "",
104       "exceptions" : "",
105       "requires" : "",
106       "params" : [],
107       "returns" : []
108     },
109     {
110       "name" : "getDom",
111       "type" : "function",
112       "desc" : "Return the dom node for the passed string (id), dom node, or Roo.Element",
113       "sig" : "(el)",
114       "static" : true,
115       "memberOf" : "",
116       "isStatic" : true,
117       "isConstructor" : false,
118       "isPrivate" : false,
119       "example" : "",
120       "deprecated" : "",
121       "since" : "",
122       "see" : "",
123       "exceptions" : "",
124       "requires" : "",
125       "params" : [
126         {
127           "name" : "el",
128           "type" : "String/HTMLElement/Roo.Element",
129           "desc" : "",
130           "isOptional" : false
131         }
132       ],
133       "returns" : [
134         {
135           "name" : "",
136           "type" : "",
137           "desc" : "HTMLElement"
138         }
139       ]
140     },
141     {
142       "name" : "urlEncode",
143       "type" : "function",
144       "desc" : "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.",
145       "sig" : "(o)",
146       "static" : true,
147       "memberOf" : "",
148       "isStatic" : true,
149       "isConstructor" : false,
150       "isPrivate" : false,
151       "example" : "",
152       "deprecated" : "",
153       "since" : "",
154       "see" : "",
155       "exceptions" : "",
156       "requires" : "",
157       "params" : [
158         {
159           "name" : "o",
160           "type" : "Object",
161           "desc" : "",
162           "isOptional" : false
163         }
164       ],
165       "returns" : [
166         {
167           "name" : "",
168           "type" : "String",
169           "desc" : ""
170         }
171       ]
172     },
173     {
174       "name" : "addBehaviors",
175       "type" : "function",
176       "desc" : "Applies event listeners to elements by selectors when the document is ready.\nThe event name is specified with an @ suffix.\n<pre><code>\nRoo.addBehaviors({\n   // add a listener for click on all anchors in element with id foo\n   '#foo a@click' : function(e, t){\n       // do something\n   },\n\n   // add the same listener to multiple selectors (separated by comma BEFORE the @)\n   '#foo a, #bar span.some-class@mouseover' : function(){\n       // do something\n   }\n});\n</code></pre>",
177       "sig" : "(obj)",
178       "static" : true,
179       "memberOf" : "",
180       "isStatic" : true,
181       "isConstructor" : false,
182       "isPrivate" : false,
183       "example" : "",
184       "deprecated" : "",
185       "since" : "",
186       "see" : "",
187       "exceptions" : "",
188       "requires" : "",
189       "params" : [
190         {
191           "name" : "obj",
192           "type" : "Object",
193           "desc" : "The list of behaviors to apply",
194           "isOptional" : false
195         }
196       ],
197       "returns" : []
198     },
199     {
200       "name" : "getGridSize",
201       "type" : "function",
202       "desc" : "Find the current bootstrap width Grid size\nNote xs is the default for smaller.. - this is currently used by grids to render correct columns",
203       "sig" : "()\n{\n\n}",
204       "static" : true,
205       "memberOf" : "",
206       "isStatic" : true,
207       "isConstructor" : false,
208       "isPrivate" : false,
209       "example" : "",
210       "deprecated" : "",
211       "since" : "",
212       "see" : "",
213       "exceptions" : "",
214       "requires" : "",
215       "params" : [],
216       "returns" : []
217     },
218     {
219       "name" : "factory",
220       "type" : "function",
221       "desc" : "Creates namespaces to be used for scoping variables and classes so that they are not global.  Usage:\n<pre><code>\nRoo.factory({ xns: Roo.data, xtype : 'Store', .....});\nRoo.factory(conf, Roo.data);\n</code></pre>",
222       "sig" : "(classname, namespace)",
223       "static" : true,
224       "memberOf" : "",
225       "isStatic" : true,
226       "isConstructor" : false,
227       "isPrivate" : false,
228       "example" : "",
229       "deprecated" : "",
230       "since" : "",
231       "see" : "",
232       "exceptions" : "",
233       "requires" : "",
234       "params" : [
235         {
236           "name" : "classname",
237           "type" : "String",
238           "desc" : "",
239           "isOptional" : false
240         },
241         {
242           "name" : "namespace",
243           "type" : "String",
244           "desc" : "(optional)",
245           "isOptional" : false
246         }
247       ],
248       "returns" : []
249     },
250     {
251       "name" : "apply",
252       "type" : "function",
253       "desc" : "Copies all the properties of config to obj.",
254       "sig" : "(obj, config, defaults)",
255       "static" : true,
256       "memberOf" : "",
257       "isStatic" : true,
258       "isConstructor" : false,
259       "isPrivate" : false,
260       "example" : "",
261       "deprecated" : "",
262       "since" : "",
263       "see" : "",
264       "exceptions" : "",
265       "requires" : "",
266       "params" : [
267         {
268           "name" : "obj",
269           "type" : "Object",
270           "desc" : "The receiver of the properties",
271           "isOptional" : false
272         },
273         {
274           "name" : "config",
275           "type" : "Object",
276           "desc" : "The source of the properties",
277           "isOptional" : false
278         },
279         {
280           "name" : "defaults",
281           "type" : "Object",
282           "desc" : "A different object that will also be applied for default values",
283           "isOptional" : false
284         }
285       ],
286       "returns" : [
287         {
288           "name" : "",
289           "type" : "Object",
290           "desc" : "returns obj"
291         }
292       ]
293     },
294     {
295       "name" : "onReady",
296       "type" : "function",
297       "desc" : "Fires when the document is ready (before onload and before images are loaded).  Shorthand of {@link Roo.EventManager#onDocumentReady}.",
298       "sig" : "(fn, scope, override)",
299       "static" : true,
300       "memberOf" : "",
301       "isStatic" : true,
302       "isConstructor" : false,
303       "isPrivate" : false,
304       "example" : "",
305       "deprecated" : "",
306       "since" : "",
307       "see" : "",
308       "exceptions" : "",
309       "requires" : "",
310       "params" : [
311         {
312           "name" : "fn",
313           "type" : "Function",
314           "desc" : "The method the event invokes",
315           "isOptional" : false
316         },
317         {
318           "name" : "scope",
319           "type" : "Object",
320           "desc" : "An  object that becomes the scope of the handler",
321           "isOptional" : false
322         },
323         {
324           "name" : "override",
325           "type" : "boolean",
326           "desc" : "If true, the obj passed in becomes\n                            the execution scope of the listener",
327           "isOptional" : false
328         }
329       ],
330       "returns" : []
331     },
332     {
333       "name" : "select",
334       "type" : "function",
335       "desc" : "Selects elements based on the passed CSS selector to enable working on them as 1.",
336       "sig" : "(selector, unique, root)",
337       "static" : true,
338       "memberOf" : "",
339       "isStatic" : true,
340       "isConstructor" : false,
341       "isPrivate" : false,
342       "example" : "",
343       "deprecated" : "",
344       "since" : "",
345       "see" : "",
346       "exceptions" : "",
347       "requires" : "",
348       "params" : [
349         {
350           "name" : "selector",
351           "type" : "String/Array",
352           "desc" : "The CSS selector or an array of elements",
353           "isOptional" : false
354         },
355         {
356           "name" : "unique",
357           "type" : "Boolean",
358           "desc" : "(optional) true to create a unique Roo.Element for each element (defaults to a shared flyweight object)",
359           "isOptional" : false
360         },
361         {
362           "name" : "root",
363           "type" : "HTMLElement/String",
364           "desc" : "(optional) The root element of the query or id of the root",
365           "isOptional" : false
366         }
367       ],
368       "returns" : [
369         {
370           "name" : "",
371           "type" : "CompositeElementLite/CompositeElement",
372           "desc" : ""
373         }
374       ]
375     },
376     {
377       "name" : "applyIf",
378       "type" : "function",
379       "desc" : "Copies all the properties of config to obj if they don't already exist.",
380       "sig" : "(obj, config)",
381       "static" : true,
382       "memberOf" : "",
383       "isStatic" : true,
384       "isConstructor" : false,
385       "isPrivate" : false,
386       "example" : "",
387       "deprecated" : "",
388       "since" : "",
389       "see" : "",
390       "exceptions" : "",
391       "requires" : "",
392       "params" : [
393         {
394           "name" : "obj",
395           "type" : "Object",
396           "desc" : "The receiver of the properties",
397           "isOptional" : false
398         },
399         {
400           "name" : "config",
401           "type" : "Object",
402           "desc" : "The source of the properties",
403           "isOptional" : false
404         }
405       ],
406       "returns" : [
407         {
408           "name" : "",
409           "type" : "Object",
410           "desc" : "returns obj"
411         }
412       ]
413     },
414     {
415       "name" : "getCmp",
416       "type" : "function",
417       "desc" : "Shorthand for {@link Roo.ComponentMgr#get}",
418       "sig" : "(id)",
419       "static" : true,
420       "memberOf" : "",
421       "isStatic" : true,
422       "isConstructor" : false,
423       "isPrivate" : false,
424       "example" : "",
425       "deprecated" : "",
426       "since" : "",
427       "see" : "",
428       "exceptions" : "",
429       "requires" : "",
430       "params" : [
431         {
432           "name" : "id",
433           "type" : "String",
434           "desc" : "",
435           "isOptional" : false
436         }
437       ],
438       "returns" : [
439         {
440           "name" : "",
441           "type" : "",
442           "desc" : "Roo.Component"
443         }
444       ]
445     },
446     {
447       "name" : "id",
448       "type" : "function",
449       "desc" : "Generates unique ids. If the element already has an id, it is unchanged",
450       "sig" : "(el, prefix)",
451       "static" : true,
452       "memberOf" : "",
453       "isStatic" : true,
454       "isConstructor" : false,
455       "isPrivate" : false,
456       "example" : "",
457       "deprecated" : "",
458       "since" : "",
459       "see" : "",
460       "exceptions" : "",
461       "requires" : "",
462       "params" : [
463         {
464           "name" : "el",
465           "type" : "String/HTMLElement/Element",
466           "desc" : "(optional) The element to generate an id for",
467           "isOptional" : false
468         },
469         {
470           "name" : "prefix",
471           "type" : "String",
472           "desc" : "(optional) Id prefix (defaults \"Roo-gen\")",
473           "isOptional" : false
474         }
475       ],
476       "returns" : [
477         {
478           "name" : "",
479           "type" : "String",
480           "desc" : "The generated Id."
481         }
482       ]
483     },
484     {
485       "name" : "encodeURIComponent",
486       "type" : "function",
487       "desc" : "Safe version of encodeURIComponent",
488       "sig" : "(data)",
489       "static" : true,
490       "memberOf" : "",
491       "isStatic" : true,
492       "isConstructor" : false,
493       "isPrivate" : false,
494       "example" : "",
495       "deprecated" : "",
496       "since" : "",
497       "see" : "",
498       "exceptions" : "",
499       "requires" : "",
500       "params" : [
501         {
502           "name" : "data",
503           "type" : "String",
504           "desc" : "",
505           "isOptional" : false
506         }
507       ],
508       "returns" : [
509         {
510           "name" : "",
511           "type" : "String",
512           "desc" : ""
513         }
514       ]
515     },
516     {
517       "name" : "encode",
518       "type" : "function",
519       "desc" : "Shorthand for {@link Roo.util.JSON#encode}",
520       "sig" : "()\n{\n\n}",
521       "static" : true,
522       "memberOf" : "",
523       "isStatic" : true,
524       "isConstructor" : false,
525       "isPrivate" : false,
526       "example" : "",
527       "deprecated" : "",
528       "since" : "",
529       "see" : "",
530       "exceptions" : "",
531       "requires" : "",
532       "params" : [],
533       "returns" : []
534     },
535     {
536       "name" : "fly",
537       "type" : "function",
538       "desc" : "Gets the globally shared flyweight Element, with the passed node as the active element. Do not store a reference to this element -\nthe dom node can be overwritten by other code.\nShorthand of {@link Roo.Element#fly}",
539       "sig" : "(el, named)",
540       "static" : true,
541       "memberOf" : "",
542       "isStatic" : true,
543       "isConstructor" : false,
544       "isPrivate" : false,
545       "example" : "",
546       "deprecated" : "",
547       "since" : "",
548       "see" : "",
549       "exceptions" : "",
550       "requires" : "",
551       "params" : [
552         {
553           "name" : "el",
554           "type" : "String/HTMLElement",
555           "desc" : "The dom node or id",
556           "isOptional" : false
557         },
558         {
559           "name" : "named",
560           "type" : "String",
561           "desc" : "(optional) Allows for creation of named reusable flyweights to\n                                 prevent conflicts (e.g. internally Roo uses \"_internal\")",
562           "isOptional" : false
563         }
564       ],
565       "returns" : [
566         {
567           "name" : "",
568           "type" : "Element",
569           "desc" : "The shared Element object"
570         }
571       ]
572     },
573     {
574       "name" : "isEmpty",
575       "type" : "function",
576       "desc" : "Returns true if the passed value is null, undefined or an empty string (optional).",
577       "sig" : "(value, allowBlank)",
578       "static" : true,
579       "memberOf" : "",
580       "isStatic" : true,
581       "isConstructor" : false,
582       "isPrivate" : false,
583       "example" : "",
584       "deprecated" : "",
585       "since" : "",
586       "see" : "",
587       "exceptions" : "",
588       "requires" : "",
589       "params" : [
590         {
591           "name" : "value",
592           "type" : "Mixed",
593           "desc" : "The value to test",
594           "isOptional" : false
595         },
596         {
597           "name" : "allowBlank",
598           "type" : "Boolean",
599           "desc" : "(optional) Pass true if an empty string is not considered empty",
600           "isOptional" : false
601         }
602       ],
603       "returns" : [
604         {
605           "name" : "",
606           "type" : "Boolean",
607           "desc" : ""
608         }
609       ]
610     },
611     {
612       "name" : "query",
613       "type" : "function",
614       "desc" : "Selects an array of DOM nodes by CSS/XPath selector. Shorthand of {@link Roo.DomQuery#select}",
615       "sig" : "(path, root)",
616       "static" : true,
617       "memberOf" : "",
618       "isStatic" : true,
619       "isConstructor" : false,
620       "isPrivate" : false,
621       "example" : "",
622       "deprecated" : "",
623       "since" : "",
624       "see" : "",
625       "exceptions" : "",
626       "requires" : "",
627       "params" : [
628         {
629           "name" : "path",
630           "type" : "String",
631           "desc" : "The selector/xpath query",
632           "isOptional" : false
633         },
634         {
635           "name" : "root",
636           "type" : "Node",
637           "desc" : "(optional) The start of the query (defaults to document).",
638           "isOptional" : false
639         }
640       ],
641       "returns" : [
642         {
643           "name" : "",
644           "type" : "Array",
645           "desc" : ""
646         }
647       ]
648     },
649     {
650       "name" : "urlDecode",
651       "type" : "function",
652       "desc" : "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]}.",
653       "sig" : "(string, overwrite)",
654       "static" : true,
655       "memberOf" : "",
656       "isStatic" : true,
657       "isConstructor" : false,
658       "isPrivate" : false,
659       "example" : "",
660       "deprecated" : "",
661       "since" : "",
662       "see" : "",
663       "exceptions" : "",
664       "requires" : "",
665       "params" : [
666         {
667           "name" : "string",
668           "type" : "String",
669           "desc" : "",
670           "isOptional" : false
671         },
672         {
673           "name" : "overwrite",
674           "type" : "Boolean",
675           "desc" : "(optional) Items of the same name will overwrite previous values instead of creating an an array (Defaults to false).",
676           "isOptional" : false
677         }
678       ],
679       "returns" : [
680         {
681           "name" : "",
682           "type" : "Object",
683           "desc" : "A literal with members"
684         }
685       ]
686     },
687     {
688       "name" : "escapeRe",
689       "type" : "function",
690       "desc" : "Escapes the passed string for use in a regular expression",
691       "sig" : "(str)",
692       "static" : true,
693       "memberOf" : "",
694       "isStatic" : true,
695       "isConstructor" : false,
696       "isPrivate" : false,
697       "example" : "",
698       "deprecated" : "",
699       "since" : "",
700       "see" : "",
701       "exceptions" : "",
702       "requires" : "",
703       "params" : [
704         {
705           "name" : "str",
706           "type" : "String",
707           "desc" : "",
708           "isOptional" : false
709         }
710       ],
711       "returns" : [
712         {
713           "name" : "",
714           "type" : "String",
715           "desc" : ""
716         }
717       ]
718     },
719     {
720       "name" : "extend",
721       "type" : "function",
722       "desc" : "Extends one class with another class and optionally overrides members with the passed literal. This class\nalso adds the function \"override()\" to the class that can be used to override\nmembers on an instance.",
723       "sig" : "(subclass, superclass, overrides)",
724       "static" : true,
725       "memberOf" : "",
726       "isStatic" : true,
727       "isConstructor" : false,
728       "isPrivate" : false,
729       "example" : "",
730       "deprecated" : "",
731       "since" : "",
732       "see" : "",
733       "exceptions" : "",
734       "requires" : "",
735       "params" : [
736         {
737           "name" : "subclass",
738           "type" : "Object",
739           "desc" : "The class inheriting the functionality",
740           "isOptional" : false
741         },
742         {
743           "name" : "superclass",
744           "type" : "Object",
745           "desc" : "The class being extended",
746           "isOptional" : false
747         },
748         {
749           "name" : "overrides",
750           "type" : "Object",
751           "desc" : "(optional) A literal with members",
752           "isOptional" : false
753         }
754       ],
755       "returns" : []
756     },
757     {
758       "name" : "override",
759       "type" : "function",
760       "desc" : "Adds a list of functions to the prototype of an existing class, overwriting any existing methods with the same name.\nUsage:<pre><code>\nRoo.override(MyClass, {\n    newMethod1: function(){\n        // etc.\n    },\n    newMethod2: function(foo){\n        // etc.\n    }\n});\n </code></pre>",
761       "sig" : "(origclass, overrides)",
762       "static" : true,
763       "memberOf" : "",
764       "isStatic" : true,
765       "isConstructor" : false,
766       "isPrivate" : false,
767       "example" : "",
768       "deprecated" : "",
769       "since" : "",
770       "see" : "",
771       "exceptions" : "",
772       "requires" : "",
773       "params" : [
774         {
775           "name" : "origclass",
776           "type" : "Object",
777           "desc" : "The class to override",
778           "isOptional" : false
779         },
780         {
781           "name" : "overrides",
782           "type" : "Object",
783           "desc" : "The list of functions to add to origClass.  This should be specified as an object literal\ncontaining one or more methods.",
784           "isOptional" : false
785         }
786       ],
787       "returns" : []
788     },
789     {
790       "name" : "selectNode",
791       "type" : "function",
792       "desc" : "Selects a single element as a Roo Element\nThis is about as close as you can get to jQuery's $('do crazy stuff')",
793       "sig" : "(selector, root)",
794       "static" : true,
795       "memberOf" : "",
796       "isStatic" : true,
797       "isConstructor" : false,
798       "isPrivate" : false,
799       "example" : "",
800       "deprecated" : "",
801       "since" : "",
802       "see" : "",
803       "exceptions" : "",
804       "requires" : "",
805       "params" : [
806         {
807           "name" : "selector",
808           "type" : "String",
809           "desc" : "The selector/xpath query",
810           "isOptional" : false
811         },
812         {
813           "name" : "root",
814           "type" : "Node",
815           "desc" : "(optional) The start of the query (defaults to document).",
816           "isOptional" : false
817         }
818       ],
819       "returns" : [
820         {
821           "name" : "",
822           "type" : "Roo.Element",
823           "desc" : ""
824         }
825       ]
826     },
827     {
828       "name" : "type",
829       "type" : "function",
830       "desc" : "Returns the type of object that is passed in. If the object passed in is null or undefined it\nreturn false otherwise it returns one of the following values:<ul>\n<li><b>string</b>: If the object passed is a string</li>\n<li><b>number</b>: If the object passed is a number</li>\n<li><b>boolean</b>: If the object passed is a boolean value</li>\n<li><b>function</b>: If the object passed is a function reference</li>\n<li><b>object</b>: If the object passed is an object</li>\n<li><b>array</b>: If the object passed is an array</li>\n<li><b>regexp</b>: If the object passed is a regular expression</li>\n<li><b>element</b>: If the object passed is a DOM Element</li>\n<li><b>nodelist</b>: If the object passed is a DOM NodeList</li>\n<li><b>textnode</b>: If the object passed is a DOM text node and contains something other than whitespace</li>\n<li><b>whitespace</b>: If the object passed is a DOM text node and contains only whitespace</li>",
831       "sig" : "(object)",
832       "static" : true,
833       "memberOf" : "",
834       "isStatic" : true,
835       "isConstructor" : false,
836       "isPrivate" : false,
837       "example" : "",
838       "deprecated" : "",
839       "since" : "",
840       "see" : "",
841       "exceptions" : "",
842       "requires" : "",
843       "params" : [
844         {
845           "name" : "object",
846           "type" : "Mixed",
847           "desc" : "",
848           "isOptional" : false
849         }
850       ],
851       "returns" : [
852         {
853           "name" : "",
854           "type" : "String",
855           "desc" : ""
856         }
857       ]
858     }
859   ],
860   "events" : []
861 }