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