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