enable grammerly in editor
[roojs1] / docs / symbols / Roo.form.Form.json
1 {
2   "name" : "Roo.form.Form",
3   "augments" : [
4     "Roo.form.BasicForm",
5     "Roo.util.Observable"
6   ],
7   "desc" : "Adds the ability to dynamically render forms with JavaScript to {@link Roo.form.BasicForm}.",
8   "isSingleton" : false,
9   "isStatic" : false,
10   "isBuiltin" : false,
11   "memberOf" : "Form",
12   "example" : "",
13   "deprecated" : "",
14   "since" : "",
15   "see" : "",
16   "params" : [
17     {
18       "name" : "config",
19       "type" : "Object",
20       "desc" : "Configuration options",
21       "isOptional" : false
22     }
23   ],
24   "returns" : [],
25   "config" : [
26     {
27       "name" : "labelAlign",
28       "type" : "String",
29       "desc" : "Valid values are \"left,\" \"top\" and \"right\" (defaults to \"left\").\nThis property cascades to child containers if not set.",
30       "memberOf" : "Roo.form.Form",
31       "optvals" : []
32     },
33     {
34       "name" : "listeners",
35       "type" : "Object",
36       "desc" : "list of events and functions to call for this object, \nFor example :\n<pre><code>\n    listeners :  { \n       'click' : function(e) {\n           ..... \n        } ,\n        .... \n    } \n  </code></pre>",
37       "memberOf" : "Roo.util.Observable",
38       "optvals" : []
39     },
40     {
41       "name" : "formData",
42       "type" : "boolean|FormData",
43       "desc" : "- true to use new 'FormData' post, or set to a new FormData({dom form}) Object, if\nsending a formdata with extra parameters - eg uploaded elements.",
44       "memberOf" : "Roo.form.Form",
45       "optvals" : []
46     },
47     {
48       "name" : "monitorValid",
49       "type" : "Boolean",
50       "desc" : "If true the form monitors its valid state <b>client-side</b> and\nfires a looping event with that state. This is required to bind buttons to the valid\nstate using the config value formBind:true on the button.",
51       "memberOf" : "Roo.form.Form",
52       "optvals" : []
53     },
54     {
55       "name" : "fileUpload",
56       "type" : "Boolean",
57       "desc" : "Set to true if this form is a file upload.",
58       "memberOf" : "Roo.form.BasicForm",
59       "optvals" : []
60     },
61     {
62       "name" : "progressUrl",
63       "type" : "String",
64       "desc" : "- Url to return progress data",
65       "memberOf" : "Roo.form.Form",
66       "optvals" : []
67     },
68     {
69       "name" : "minButtonWidth",
70       "type" : "Number",
71       "desc" : "Minimum width of all buttons in pixels (defaults to 75)",
72       "memberOf" : "Roo.form.Form",
73       "optvals" : []
74     },
75     {
76       "name" : "buttonAlign",
77       "type" : "String",
78       "desc" : "Valid values are \"left,\" \"center\" and \"right\" (defaults to \"center\")",
79       "memberOf" : "Roo.form.Form",
80       "optvals" : []
81     },
82     {
83       "name" : "method",
84       "type" : "String",
85       "desc" : "The request method to use (GET or POST) for form actions if one isn't supplied in the action options.",
86       "memberOf" : "Roo.form.BasicForm",
87       "optvals" : []
88     },
89     {
90       "name" : "errorMask",
91       "type" : "Boolean",
92       "desc" : "e) default false",
93       "memberOf" : "Roo.form.BasicForm",
94       "optvals" : [
95         "true",
96         "false"
97       ]
98     },
99     {
100       "name" : "labelWidth",
101       "type" : "Number",
102       "desc" : "The width of labels. This property cascades to child containers.",
103       "memberOf" : "Roo.form.Form",
104       "optvals" : []
105     },
106     {
107       "name" : "itemCls",
108       "type" : "String",
109       "desc" : "A css class to apply to the x-form-item of fields. This property cascades to child containers.",
110       "memberOf" : "Roo.form.Form",
111       "optvals" : []
112     },
113     {
114       "name" : "timeout",
115       "type" : "Number",
116       "desc" : "Timeout for form actions in seconds (default is 30 seconds).",
117       "memberOf" : "Roo.form.BasicForm",
118       "optvals" : []
119     },
120     {
121       "name" : "monitorPoll",
122       "type" : "Number",
123       "desc" : "The milliseconds to poll valid state, ignored if monitorValid is not true (defaults to 200)",
124       "memberOf" : "Roo.form.Form",
125       "optvals" : []
126     },
127     {
128       "name" : "baseParams",
129       "type" : "Object",
130       "desc" : "Parameters to pass with all requests. e.g. baseParams: {id: '123', foo: 'bar'}.",
131       "memberOf" : "Roo.form.BasicForm",
132       "optvals" : []
133     },
134     {
135       "name" : "trackResetOnLoad",
136       "type" : "Boolean",
137       "desc" : "If set to true, form.reset() resets to the last loaded\nor setValues() data instead of when the form was first created.",
138       "memberOf" : "Roo.form.BasicForm",
139       "optvals" : []
140     },
141     {
142       "name" : "reader",
143       "type" : "DataReader",
144       "desc" : "An Roo.data.DataReader (e.g. {@link Roo.data.XmlReader}) to be used to read data when executing \"load\" actions.\nThis is optional as there is built-in support for processing JSON.",
145       "memberOf" : "Roo.form.BasicForm",
146       "optvals" : []
147     },
148     {
149       "name" : "errorReader",
150       "type" : "DataReader",
151       "desc" : "An Roo.data.DataReader (e.g. {@link Roo.data.XmlReader}) to be used to read data when reading validation errors on \"submit\" actions.\nThis is completely optional as there is built-in support for processing JSON.",
152       "memberOf" : "Roo.form.BasicForm",
153       "optvals" : []
154     },
155     {
156       "name" : "url",
157       "type" : "String",
158       "desc" : "The URL to use for form actions if one isn't supplied in the action options.",
159       "memberOf" : "Roo.form.BasicForm",
160       "optvals" : []
161     },
162     {
163       "name" : "maskOffset",
164       "type" : "Number",
165       "desc" : "Default 100",
166       "memberOf" : "Roo.form.BasicForm",
167       "optvals" : []
168     }
169   ],
170   "methods" : [
171     {
172       "name" : "addxtype",
173       "desc" : "Adds a series of form elements (using the xtype property as the factory method.\nValid xtypes are:  TextField, TextArea .... Button, Layout, FieldSet, Column, (and 'end' to close a block)",
174       "isStatic" : false,
175       "isConstructor" : false,
176       "isPrivate" : false,
177       "memberOf" : "Roo.form.Form",
178       "example" : "",
179       "deprecated" : "",
180       "since" : "",
181       "see" : "",
182       "params" : [
183         {
184           "name" : "config",
185           "type" : "Object",
186           "desc" : "",
187           "isOptional" : false
188         }
189       ],
190       "returns" : []
191     },
192     {
193       "name" : "fieldset",
194       "desc" : "Opens a new {@link Roo.form.FieldSet} container in the layout stack. If fields are passed after the config, the\nfields are added and the fieldset is closed. If no fields are passed the fieldset remains open\nuntil end() is called.",
195       "isStatic" : false,
196       "isConstructor" : false,
197       "isPrivate" : false,
198       "memberOf" : "Roo.form.Form",
199       "example" : "",
200       "deprecated" : "",
201       "since" : "",
202       "see" : "",
203       "params" : [
204         {
205           "name" : "config",
206           "type" : "Object",
207           "desc" : "The config to pass to the fieldset",
208           "isOptional" : false
209         },
210         {
211           "name" : "field1",
212           "type" : "Field",
213           "desc" : "(optional)",
214           "isOptional" : false
215         },
216         {
217           "name" : "field2",
218           "type" : "Field",
219           "desc" : "(optional)",
220           "isOptional" : false
221         },
222         {
223           "name" : "etc",
224           "type" : "Field",
225           "desc" : "(optional)",
226           "isOptional" : false
227         }
228       ],
229       "returns" : [
230         {
231           "name" : "",
232           "type" : "",
233           "desc" : "FieldSet The fieldset container object"
234         }
235       ]
236     },
237     {
238       "name" : "start",
239       "desc" : "Opens the passed container in the layout stack. The container can be any {@link Roo.form.Layout} or subclass.",
240       "isStatic" : false,
241       "isConstructor" : false,
242       "isPrivate" : false,
243       "memberOf" : "Roo.form.Form",
244       "example" : "",
245       "deprecated" : "",
246       "since" : "",
247       "see" : "",
248       "params" : [
249         {
250           "name" : "container",
251           "type" : "Object",
252           "desc" : "A Roo.form.Layout or subclass of Layout",
253           "isOptional" : false
254         }
255       ],
256       "returns" : [
257         {
258           "name" : "",
259           "type" : "Form",
260           "desc" : "this"
261         }
262       ]
263     },
264     {
265       "name" : "container",
266       "desc" : "Opens a new {@link Roo.form.Layout} container in the layout stack. If fields are passed after the config, the\nfields are added and the container is closed. If no fields are passed the container remains open\nuntil end() is called.",
267       "isStatic" : false,
268       "isConstructor" : false,
269       "isPrivate" : false,
270       "memberOf" : "Roo.form.Form",
271       "example" : "",
272       "deprecated" : "",
273       "since" : "",
274       "see" : "",
275       "params" : [
276         {
277           "name" : "config",
278           "type" : "Object",
279           "desc" : "The config to pass to the Layout",
280           "isOptional" : false
281         },
282         {
283           "name" : "field1",
284           "type" : "Field",
285           "desc" : "(optional)",
286           "isOptional" : false
287         },
288         {
289           "name" : "field2",
290           "type" : "Field",
291           "desc" : "(optional)",
292           "isOptional" : false
293         },
294         {
295           "name" : "etc",
296           "type" : "Field",
297           "desc" : "(optional)",
298           "isOptional" : false
299         }
300       ],
301       "returns" : [
302         {
303           "name" : "",
304           "type" : "",
305           "desc" : "Layout The container object"
306         }
307       ]
308     },
309     {
310       "name" : "render",
311       "desc" : "Render this form into the passed container. This should only be called once!",
312       "isStatic" : false,
313       "isConstructor" : false,
314       "isPrivate" : false,
315       "memberOf" : "Roo.form.Form",
316       "example" : "",
317       "deprecated" : "",
318       "since" : "",
319       "see" : "",
320       "params" : [
321         {
322           "name" : "container",
323           "type" : "String/HTMLElement/Element",
324           "desc" : "The element this component should be rendered into",
325           "isOptional" : false
326         }
327       ],
328       "returns" : [
329         {
330           "name" : "",
331           "type" : "Form",
332           "desc" : "this"
333         }
334       ]
335     },
336     {
337       "name" : "startMonitoring",
338       "desc" : "Starts monitoring of the valid state of this form. Usually this is done by passing the config\noption \"monitorValid\"",
339       "isStatic" : false,
340       "isConstructor" : false,
341       "isPrivate" : false,
342       "memberOf" : "Roo.form.Form",
343       "example" : "",
344       "deprecated" : "",
345       "since" : "",
346       "see" : "",
347       "params" : [],
348       "returns" : []
349     },
350     {
351       "name" : "addButton",
352       "desc" : "Adds a button to the footer of the form - this <b>must</b> be called before the form is rendered.",
353       "isStatic" : false,
354       "isConstructor" : false,
355       "isPrivate" : false,
356       "memberOf" : "Roo.form.Form",
357       "example" : "",
358       "deprecated" : "",
359       "since" : "",
360       "see" : "",
361       "params" : [
362         {
363           "name" : "config",
364           "type" : "String/Object",
365           "desc" : "A string becomes the button text, an object can either be a Button config\nobject or a valid Roo.DomHelper element config",
366           "isOptional" : false
367         },
368         {
369           "name" : "handler",
370           "type" : "Function",
371           "desc" : "The function called when the button is clicked",
372           "isOptional" : false
373         },
374         {
375           "name" : "scope",
376           "type" : "Object",
377           "desc" : "(optional) The scope of the handler function",
378           "isOptional" : false
379         }
380       ],
381       "returns" : [
382         {
383           "name" : "",
384           "type" : "Roo.Button",
385           "desc" : ""
386         }
387       ]
388     },
389     {
390       "name" : "stopMonitoring",
391       "desc" : "Stops monitoring of the valid state of this form",
392       "isStatic" : false,
393       "isConstructor" : false,
394       "isPrivate" : false,
395       "memberOf" : "Roo.form.Form",
396       "example" : "",
397       "deprecated" : "",
398       "since" : "",
399       "see" : "",
400       "params" : [],
401       "returns" : []
402     },
403     {
404       "name" : "add",
405       "desc" : "Add Roo.form components to the current open container (e.g. column, fieldset, etc.).  Fields added via this method\ncan also be passed with an additional property of fieldLabel, which if supplied, will provide the text to display\nas the label of the field.",
406       "isStatic" : false,
407       "isConstructor" : false,
408       "isPrivate" : false,
409       "memberOf" : "Roo.form.Form",
410       "example" : "",
411       "deprecated" : "",
412       "since" : "",
413       "see" : "",
414       "params" : [
415         {
416           "name" : "field1",
417           "type" : "Field",
418           "desc" : "",
419           "isOptional" : false
420         },
421         {
422           "name" : "field2",
423           "type" : "Field",
424           "desc" : "(optional)",
425           "isOptional" : false
426         }
427       ],
428       "returns" : [
429         {
430           "name" : "",
431           "type" : "Form",
432           "desc" : "this"
433         }
434       ]
435     },
436     {
437       "name" : "findbyId",
438       "desc" : "Find any element that has been added to a form, using it's ID or name\nThis can include framesets, columns etc. along with regular fields..",
439       "isStatic" : false,
440       "isConstructor" : false,
441       "isPrivate" : false,
442       "memberOf" : "Roo.form.Form",
443       "example" : "",
444       "deprecated" : "",
445       "since" : "",
446       "see" : "",
447       "params" : [
448         {
449           "name" : "id",
450           "type" : "String",
451           "desc" : "- id or name to find.",
452           "isOptional" : false
453         }
454       ],
455       "returns" : [
456         {
457           "name" : "",
458           "type" : "Element",
459           "desc" : "e - or false if nothing found."
460         }
461       ]
462     },
463     {
464       "name" : "column",
465       "desc" : "Opens a new {@link Roo.form.Column} container in the layout stack. If fields are passed after the config, the\nfields are added and the column is closed. If no fields are passed the column remains open\nuntil end() is called.",
466       "isStatic" : false,
467       "isConstructor" : false,
468       "isPrivate" : false,
469       "memberOf" : "Roo.form.Form",
470       "example" : "",
471       "deprecated" : "",
472       "since" : "",
473       "see" : "",
474       "params" : [
475         {
476           "name" : "config",
477           "type" : "Object",
478           "desc" : "The config to pass to the column",
479           "isOptional" : false
480         },
481         {
482           "name" : "field1",
483           "type" : "Field",
484           "desc" : "(optional)",
485           "isOptional" : false
486         },
487         {
488           "name" : "field2",
489           "type" : "Field",
490           "desc" : "(optional)",
491           "isOptional" : false
492         },
493         {
494           "name" : "etc",
495           "type" : "Field",
496           "desc" : "(optional)",
497           "isOptional" : false
498         }
499       ],
500       "returns" : [
501         {
502           "name" : "",
503           "type" : "",
504           "desc" : "Column The column container object"
505         }
506       ]
507     },
508     {
509       "name" : "end",
510       "desc" : "Closes the current open container",
511       "isStatic" : false,
512       "isConstructor" : false,
513       "isPrivate" : false,
514       "memberOf" : "Roo.form.Form",
515       "example" : "",
516       "deprecated" : "",
517       "since" : "",
518       "see" : "",
519       "params" : [],
520       "returns" : [
521         {
522           "name" : "",
523           "type" : "Form",
524           "desc" : "this"
525         }
526       ]
527     },
528     {
529       "name" : "remove",
530       "desc" : "Removes a field from the items collection (does NOT remove its markup).",
531       "isStatic" : false,
532       "isConstructor" : false,
533       "isPrivate" : false,
534       "memberOf" : "Roo.form.BasicForm",
535       "example" : "",
536       "deprecated" : "",
537       "since" : "",
538       "see" : "",
539       "params" : [
540         {
541           "name" : "field",
542           "type" : "Field",
543           "desc" : "",
544           "isOptional" : false
545         }
546       ],
547       "returns" : [
548         {
549           "name" : "",
550           "type" : "BasicForm",
551           "desc" : "this"
552         }
553       ]
554     },
555     {
556       "name" : "loadRecord",
557       "desc" : "Loads an Roo.data.Record into this form.",
558       "isStatic" : false,
559       "isConstructor" : false,
560       "isPrivate" : false,
561       "memberOf" : "Roo.form.BasicForm",
562       "example" : "",
563       "deprecated" : "",
564       "since" : "",
565       "see" : "",
566       "params" : [
567         {
568           "name" : "record",
569           "type" : "Record",
570           "desc" : "The record to load",
571           "isOptional" : false
572         }
573       ],
574       "returns" : [
575         {
576           "name" : "",
577           "type" : "BasicForm",
578           "desc" : "this"
579         }
580       ]
581     },
582     {
583       "name" : "load",
584       "desc" : "Shortcut to do a load action.",
585       "isStatic" : false,
586       "isConstructor" : false,
587       "isPrivate" : false,
588       "memberOf" : "Roo.form.BasicForm",
589       "example" : "",
590       "deprecated" : "",
591       "since" : "",
592       "see" : "",
593       "params" : [
594         {
595           "name" : "options",
596           "type" : "Object",
597           "desc" : "The options to pass to the action (see {@link #doAction} for details)",
598           "isOptional" : false
599         }
600       ],
601       "returns" : [
602         {
603           "name" : "",
604           "type" : "BasicForm",
605           "desc" : "this"
606         }
607       ]
608     },
609     {
610       "name" : "doAction",
611       "desc" : "Performs a predefined action (submit or load) or custom actions you define on this form.",
612       "isStatic" : false,
613       "isConstructor" : false,
614       "isPrivate" : false,
615       "memberOf" : "Roo.form.BasicForm",
616       "example" : "",
617       "deprecated" : "",
618       "since" : "",
619       "see" : "",
620       "params" : [
621         {
622           "name" : "actionName",
623           "type" : "String",
624           "desc" : "The name of the action type",
625           "isOptional" : false
626         },
627         {
628           "name" : "options",
629           "type" : "Object",
630           "desc" : "(optional) The options to pass to the action.  All of the config options listed\nbelow are supported by both the submit and load actions unless otherwise noted (custom actions could also\naccept other config options):\n<pre>\nProperty          Type             Description\n----------------  ---------------  ----------------------------------------------------------------------------------\nurl               String           The url for the action (defaults to the form's url)\nmethod            String           The form method to use (defaults to the form's method, or POST if not defined)\nparams            String/Object    The params to pass (defaults to the form's baseParams, or none if not defined)\nclientValidation  Boolean          Applies to submit only.  Pass true to call form.isValid() prior to posting to\n                                   validate the form on the client (defaults to false)\n</pre>",
631           "isOptional" : false
632         }
633       ],
634       "returns" : [
635         {
636           "name" : "",
637           "type" : "BasicForm",
638           "desc" : "this"
639         }
640       ]
641     },
642     {
643       "name" : "getValues",
644       "desc" : "Returns the fields in this form as an object with key/value pairs. If multiple fields exist with the same name\nthey are returned as an array.",
645       "isStatic" : false,
646       "isConstructor" : false,
647       "isPrivate" : false,
648       "memberOf" : "Roo.form.BasicForm",
649       "example" : "",
650       "deprecated" : "",
651       "since" : "",
652       "see" : "",
653       "params" : [
654         {
655           "name" : "asString",
656           "type" : "Boolean",
657           "desc" : "",
658           "isOptional" : false
659         }
660       ],
661       "returns" : [
662         {
663           "name" : "",
664           "type" : "Object",
665           "desc" : ""
666         }
667       ]
668     },
669     {
670       "name" : "resetHasChanged",
671       "desc" : "Resets all hasChanged to 'false' -\nThe old 'isDirty' used 'original value..' however this breaks reset() and a few other things.\nSo hasChanged storage is only to be used for this purpose",
672       "isStatic" : false,
673       "isConstructor" : false,
674       "isPrivate" : false,
675       "memberOf" : "Roo.form.BasicForm",
676       "example" : "",
677       "deprecated" : "",
678       "since" : "",
679       "see" : "",
680       "params" : [],
681       "returns" : [
682         {
683           "name" : "",
684           "type" : "",
685           "desc" : "Boolean"
686         }
687       ]
688     },
689     {
690       "name" : "clearInvalid",
691       "desc" : "Clears all invalid messages in this form.",
692       "isStatic" : false,
693       "isConstructor" : false,
694       "isPrivate" : false,
695       "memberOf" : "Roo.form.BasicForm",
696       "example" : "",
697       "deprecated" : "",
698       "since" : "",
699       "see" : "",
700       "params" : [],
701       "returns" : [
702         {
703           "name" : "",
704           "type" : "BasicForm",
705           "desc" : "this"
706         }
707       ]
708     },
709     {
710       "name" : "isDirty",
711       "desc" : "DEPRICATED Returns true if any fields in this form have changed since their original load.",
712       "isStatic" : false,
713       "isConstructor" : false,
714       "isPrivate" : false,
715       "memberOf" : "Roo.form.BasicForm",
716       "example" : "",
717       "deprecated" : "",
718       "since" : "",
719       "see" : "",
720       "params" : [],
721       "returns" : [
722         {
723           "name" : "",
724           "type" : "",
725           "desc" : "Boolean"
726         }
727       ]
728     },
729     {
730       "name" : "updateRecord",
731       "desc" : "Persists the values in this form into the passed Roo.data.Record object in a beginEdit/endEdit block.",
732       "isStatic" : false,
733       "isConstructor" : false,
734       "isPrivate" : false,
735       "memberOf" : "Roo.form.BasicForm",
736       "example" : "",
737       "deprecated" : "",
738       "since" : "",
739       "see" : "",
740       "params" : [
741         {
742           "name" : "record",
743           "type" : "Record",
744           "desc" : "The record to edit",
745           "isOptional" : false
746         }
747       ],
748       "returns" : [
749         {
750           "name" : "",
751           "type" : "BasicForm",
752           "desc" : "this"
753         }
754       ]
755     },
756     {
757       "name" : "hasChanged",
758       "desc" : "Returns true if any fields in this form have changed since their original load. (New version)",
759       "isStatic" : false,
760       "isConstructor" : false,
761       "isPrivate" : false,
762       "memberOf" : "Roo.form.BasicForm",
763       "example" : "",
764       "deprecated" : "",
765       "since" : "",
766       "see" : "",
767       "params" : [],
768       "returns" : [
769         {
770           "name" : "",
771           "type" : "",
772           "desc" : "Boolean"
773         }
774       ]
775     },
776     {
777       "name" : "applyToFields",
778       "desc" : "Calls {@link Ext#apply} for all fields in this form with the passed object.",
779       "isStatic" : false,
780       "isConstructor" : false,
781       "isPrivate" : false,
782       "memberOf" : "Roo.form.BasicForm",
783       "example" : "",
784       "deprecated" : "",
785       "since" : "",
786       "see" : "",
787       "params" : [
788         {
789           "name" : "values",
790           "type" : "Object",
791           "desc" : "",
792           "isOptional" : false
793         }
794       ],
795       "returns" : [
796         {
797           "name" : "",
798           "type" : "BasicForm",
799           "desc" : "this"
800         }
801       ]
802     },
803     {
804       "name" : "getFieldValues",
805       "desc" : "Returns the fields in this form as an object with key/value pairs. \nThis differs from getValues as it calls getValue on each child item, rather than using dom data.",
806       "isStatic" : false,
807       "isConstructor" : false,
808       "isPrivate" : false,
809       "memberOf" : "Roo.form.BasicForm",
810       "example" : "",
811       "deprecated" : "",
812       "since" : "",
813       "see" : "",
814       "params" : [],
815       "returns" : [
816         {
817           "name" : "",
818           "type" : "Object",
819           "desc" : ""
820         }
821       ]
822     },
823     {
824       "name" : "submit",
825       "desc" : "Shortcut to do a submit action.",
826       "isStatic" : false,
827       "isConstructor" : false,
828       "isPrivate" : false,
829       "memberOf" : "Roo.form.BasicForm",
830       "example" : "",
831       "deprecated" : "",
832       "since" : "",
833       "see" : "",
834       "params" : [
835         {
836           "name" : "options",
837           "type" : "Object",
838           "desc" : "The options to pass to the action (see {@link #doAction} for details)",
839           "isOptional" : false
840         }
841       ],
842       "returns" : [
843         {
844           "name" : "",
845           "type" : "BasicForm",
846           "desc" : "this"
847         }
848       ]
849     },
850     {
851       "name" : "markInvalid",
852       "desc" : "Mark fields in this form invalid in bulk.",
853       "isStatic" : false,
854       "isConstructor" : false,
855       "isPrivate" : false,
856       "memberOf" : "Roo.form.BasicForm",
857       "example" : "",
858       "deprecated" : "",
859       "since" : "",
860       "see" : "",
861       "params" : [
862         {
863           "name" : "errors",
864           "type" : "Array/Object",
865           "desc" : "Either an array in the form [{id:'fieldId', msg:'The message'},...] or an object hash of {id: msg, id2: msg2}",
866           "isOptional" : false
867         }
868       ],
869       "returns" : [
870         {
871           "name" : "",
872           "type" : "BasicForm",
873           "desc" : "this"
874         }
875       ]
876     },
877     {
878       "name" : "setValues",
879       "desc" : "Set values for fields in this form in bulk.",
880       "isStatic" : false,
881       "isConstructor" : false,
882       "isPrivate" : false,
883       "memberOf" : "Roo.form.BasicForm",
884       "example" : "",
885       "deprecated" : "",
886       "since" : "",
887       "see" : "",
888       "params" : [
889         {
890           "name" : "values",
891           "type" : "Array/Object",
892           "desc" : "Either an array in the form [{id:'fieldId', value:'foo'},...] or an object hash of {id: value, id2: value2}",
893           "isOptional" : false
894         }
895       ],
896       "returns" : [
897         {
898           "name" : "",
899           "type" : "BasicForm",
900           "desc" : "this"
901         }
902       ]
903     },
904     {
905       "name" : "isValid",
906       "desc" : "Returns true if client-side validation on the form is successful.",
907       "isStatic" : false,
908       "isConstructor" : false,
909       "isPrivate" : false,
910       "memberOf" : "Roo.form.BasicForm",
911       "example" : "",
912       "deprecated" : "",
913       "since" : "",
914       "see" : "",
915       "params" : [],
916       "returns" : [
917         {
918           "name" : "",
919           "type" : "",
920           "desc" : "Boolean"
921         }
922       ]
923     },
924     {
925       "name" : "applyIfToFields",
926       "desc" : "Calls {@link Ext#applyIf} for all field in this form with the passed object.",
927       "isStatic" : false,
928       "isConstructor" : false,
929       "isPrivate" : false,
930       "memberOf" : "Roo.form.BasicForm",
931       "example" : "",
932       "deprecated" : "",
933       "since" : "",
934       "see" : "",
935       "params" : [
936         {
937           "name" : "values",
938           "type" : "Object",
939           "desc" : "",
940           "isOptional" : false
941         }
942       ],
943       "returns" : [
944         {
945           "name" : "",
946           "type" : "BasicForm",
947           "desc" : "this"
948         }
949       ]
950     },
951     {
952       "name" : "findField",
953       "desc" : "Find a Roo.form.Field in this form by id, dataIndex, name or hiddenName",
954       "isStatic" : false,
955       "isConstructor" : false,
956       "isPrivate" : false,
957       "memberOf" : "Roo.form.BasicForm",
958       "example" : "",
959       "deprecated" : "",
960       "since" : "",
961       "see" : "",
962       "params" : [
963         {
964           "name" : "id",
965           "type" : "String",
966           "desc" : "The value to search for",
967           "isOptional" : false
968         }
969       ],
970       "returns" : [
971         {
972           "name" : "",
973           "type" : "",
974           "desc" : "Field"
975         }
976       ]
977     },
978     {
979       "name" : "reset",
980       "desc" : "Resets this form.",
981       "isStatic" : false,
982       "isConstructor" : false,
983       "isPrivate" : false,
984       "memberOf" : "Roo.form.BasicForm",
985       "example" : "",
986       "deprecated" : "",
987       "since" : "",
988       "see" : "",
989       "params" : [],
990       "returns" : [
991         {
992           "name" : "",
993           "type" : "BasicForm",
994           "desc" : "this"
995         }
996       ]
997     },
998     {
999       "name" : "addForm",
1000       "desc" : "Add a secondary form to this one, \nUsed to provide tabbed forms. One form is primary, with hidden values \nwhich mirror the elements from the other forms.",
1001       "isStatic" : false,
1002       "isConstructor" : false,
1003       "isPrivate" : false,
1004       "memberOf" : "Roo.form.BasicForm",
1005       "example" : "",
1006       "deprecated" : "",
1007       "since" : "",
1008       "see" : "",
1009       "params" : [
1010         {
1011           "name" : "form",
1012           "type" : "Roo.form.Form",
1013           "desc" : "to add.",
1014           "isOptional" : false
1015         }
1016       ],
1017       "returns" : []
1018     },
1019     {
1020       "name" : "purgeListeners",
1021       "desc" : "Removes all listeners for this object",
1022       "isStatic" : false,
1023       "isConstructor" : false,
1024       "isPrivate" : false,
1025       "memberOf" : "Roo.util.Observable",
1026       "example" : "",
1027       "deprecated" : "",
1028       "since" : "",
1029       "see" : "",
1030       "params" : [],
1031       "returns" : []
1032     },
1033     {
1034       "name" : "on",
1035       "desc" : "Appends an event handler to this element (shorthand for addListener)",
1036       "isStatic" : false,
1037       "isConstructor" : false,
1038       "isPrivate" : false,
1039       "memberOf" : "Roo.util.Observable",
1040       "example" : "",
1041       "deprecated" : "",
1042       "since" : "",
1043       "see" : "",
1044       "params" : [
1045         {
1046           "name" : "eventName",
1047           "type" : "String",
1048           "desc" : "The type of event to listen for",
1049           "isOptional" : false
1050         },
1051         {
1052           "name" : "handler",
1053           "type" : "Function",
1054           "desc" : "The method the event invokes",
1055           "isOptional" : false
1056         },
1057         {
1058           "name" : "scope",
1059           "type" : "Object",
1060           "desc" : "(optional) The scope in which to execute the handler\nfunction. The handler function's \"this\" context.",
1061           "isOptional" : false
1062         },
1063         {
1064           "name" : "options",
1065           "type" : "Object",
1066           "desc" : "(optional)",
1067           "isOptional" : false
1068         }
1069       ],
1070       "returns" : []
1071     },
1072     {
1073       "name" : "un",
1074       "desc" : "Removes a listener (shorthand for removeListener)",
1075       "isStatic" : false,
1076       "isConstructor" : false,
1077       "isPrivate" : false,
1078       "memberOf" : "Roo.util.Observable",
1079       "example" : "",
1080       "deprecated" : "",
1081       "since" : "",
1082       "see" : "",
1083       "params" : [
1084         {
1085           "name" : "eventName",
1086           "type" : "String",
1087           "desc" : "The type of event to listen for",
1088           "isOptional" : false
1089         },
1090         {
1091           "name" : "handler",
1092           "type" : "Function",
1093           "desc" : "The handler to remove",
1094           "isOptional" : false
1095         },
1096         {
1097           "name" : "scope",
1098           "type" : "Object",
1099           "desc" : "(optional) The scope (this object) for the handler",
1100           "isOptional" : false
1101         }
1102       ],
1103       "returns" : []
1104     },
1105     {
1106       "name" : "addEvents",
1107       "desc" : "Used to define events on this Observable",
1108       "isStatic" : false,
1109       "isConstructor" : false,
1110       "isPrivate" : false,
1111       "memberOf" : "Roo.util.Observable",
1112       "example" : "",
1113       "deprecated" : "",
1114       "since" : "",
1115       "see" : "",
1116       "params" : [
1117         {
1118           "name" : "object",
1119           "type" : "Object",
1120           "desc" : "The object with the events defined",
1121           "isOptional" : false
1122         }
1123       ],
1124       "returns" : []
1125     },
1126     {
1127       "name" : "releaseCapture",
1128       "desc" : "Removes <b>all</b> added captures from the Observable.",
1129       "isStatic" : true,
1130       "isConstructor" : false,
1131       "isPrivate" : false,
1132       "memberOf" : "Roo.util.Observable",
1133       "example" : "",
1134       "deprecated" : "",
1135       "since" : "",
1136       "see" : "",
1137       "params" : [
1138         {
1139           "name" : "o",
1140           "type" : "Observable",
1141           "desc" : "The Observable to release",
1142           "isOptional" : false
1143         }
1144       ],
1145       "returns" : []
1146     },
1147     {
1148       "name" : "removeListener",
1149       "desc" : "Removes a listener",
1150       "isStatic" : false,
1151       "isConstructor" : false,
1152       "isPrivate" : false,
1153       "memberOf" : "Roo.util.Observable",
1154       "example" : "",
1155       "deprecated" : "",
1156       "since" : "",
1157       "see" : "",
1158       "params" : [
1159         {
1160           "name" : "eventName",
1161           "type" : "String",
1162           "desc" : "The type of event to listen for",
1163           "isOptional" : false
1164         },
1165         {
1166           "name" : "handler",
1167           "type" : "Function",
1168           "desc" : "The handler to remove",
1169           "isOptional" : false
1170         },
1171         {
1172           "name" : "scope",
1173           "type" : "Object",
1174           "desc" : "(optional) The scope (this object) for the handler",
1175           "isOptional" : false
1176         }
1177       ],
1178       "returns" : []
1179     },
1180     {
1181       "name" : "fireEvent",
1182       "desc" : "Fires the specified event with the passed parameters (minus the event name).",
1183       "isStatic" : false,
1184       "isConstructor" : false,
1185       "isPrivate" : false,
1186       "memberOf" : "Roo.util.Observable",
1187       "example" : "",
1188       "deprecated" : "",
1189       "since" : "",
1190       "see" : "",
1191       "params" : [
1192         {
1193           "name" : "eventName",
1194           "type" : "String",
1195           "desc" : "",
1196           "isOptional" : false
1197         },
1198         {
1199           "name" : "args",
1200           "type" : "Object...",
1201           "desc" : "Variable number of parameters are passed to handlers",
1202           "isOptional" : false
1203         }
1204       ],
1205       "returns" : [
1206         {
1207           "name" : "",
1208           "type" : "Boolean",
1209           "desc" : "returns false if any of the handlers return false otherwise it returns true"
1210         }
1211       ]
1212     },
1213     {
1214       "name" : "hasListener",
1215       "desc" : "Checks to see if this object has any listeners for a specified event",
1216       "isStatic" : false,
1217       "isConstructor" : false,
1218       "isPrivate" : false,
1219       "memberOf" : "Roo.util.Observable",
1220       "example" : "",
1221       "deprecated" : "",
1222       "since" : "",
1223       "see" : "",
1224       "params" : [
1225         {
1226           "name" : "eventName",
1227           "type" : "String",
1228           "desc" : "The name of the event to check for",
1229           "isOptional" : false
1230         }
1231       ],
1232       "returns" : [
1233         {
1234           "name" : "",
1235           "type" : "Boolean",
1236           "desc" : "True if the event is being listened for, else false"
1237         }
1238       ]
1239     },
1240     {
1241       "name" : "capture",
1242       "desc" : "Starts capture on the specified Observable. All events will be passed\nto the supplied function with the event name + standard signature of the event\n<b>before</b> the event is fired. If the supplied function returns false,\nthe event will not fire.",
1243       "isStatic" : true,
1244       "isConstructor" : false,
1245       "isPrivate" : false,
1246       "memberOf" : "Roo.util.Observable",
1247       "example" : "",
1248       "deprecated" : "",
1249       "since" : "",
1250       "see" : "",
1251       "params" : [
1252         {
1253           "name" : "o",
1254           "type" : "Observable",
1255           "desc" : "The Observable to capture",
1256           "isOptional" : false
1257         },
1258         {
1259           "name" : "fn",
1260           "type" : "Function",
1261           "desc" : "The function to call",
1262           "isOptional" : false
1263         },
1264         {
1265           "name" : "scope",
1266           "type" : "Object",
1267           "desc" : "(optional) The scope (this object) for the fn",
1268           "isOptional" : false
1269         }
1270       ],
1271       "returns" : []
1272     },
1273     {
1274       "name" : "addListener",
1275       "desc" : "Appends an event handler to this component",
1276       "isStatic" : false,
1277       "isConstructor" : false,
1278       "isPrivate" : false,
1279       "memberOf" : "Roo.util.Observable",
1280       "example" : "",
1281       "deprecated" : "",
1282       "since" : "",
1283       "see" : "",
1284       "params" : [
1285         {
1286           "name" : "eventName",
1287           "type" : "String",
1288           "desc" : "The type of event to listen for",
1289           "isOptional" : false
1290         },
1291         {
1292           "name" : "handler",
1293           "type" : "Function",
1294           "desc" : "The method the event invokes",
1295           "isOptional" : false
1296         },
1297         {
1298           "name" : "scope",
1299           "type" : "Object",
1300           "desc" : "(optional) The scope in which to execute the handler\nfunction. The handler function's \"this\" context.",
1301           "isOptional" : false
1302         },
1303         {
1304           "name" : "options",
1305           "type" : "Object",
1306           "desc" : "(optional) An object containing handler configuration\nproperties. This may contain any of the following properties:<ul>\n<li>scope {Object} The scope in which to execute the handler function. The handler function's \"this\" context.</li>\n<li>delay {Number} The number of milliseconds to delay the invocation of the handler after te event fires.</li>\n<li>single {Boolean} True to add a handler to handle just the next firing of the event, and then remove itself.</li>\n<li>buffer {Number} Causes the handler to be scheduled to run in an {@link Roo.util.DelayedTask} delayed\nby the specified number of milliseconds. If the event fires again within that time, the original\nhandler is <em>not</em> invoked, but the new handler is scheduled in its place.</li>\n</ul><br>\n<p>\n<b>Combining Options</b><br>\nUsing the options argument, it is possible to combine different types of listeners:<br>\n<br>\nA normalized, delayed, one-time listener that auto stops the event and passes a custom argument (forumId)\n\t\t<pre><code>\n\t\tel.on('click', this.onClick, this, {\n \t\t\tsingle: true,\n    \t\tdelay: 100,\n    \t\tforumId: 4\n\t\t});\n\t\t</code></pre>\n<p>\n<b>Attaching multiple handlers in 1 call</b><br>\nThe method also allows for a single argument to be passed which is a config object containing properties\nwhich specify multiple handlers.\n<pre><code>\n\t\tel.on({\n\t\t\t'click': {\n        \t\tfn: this.onClick,\n        \t\tscope: this,\n        \t\tdelay: 100\n    \t\t}, \n    \t\t'mouseover': {\n        \t\tfn: this.onMouseOver,\n        \t\tscope: this\n    \t\t},\n    \t\t'mouseout': {\n        \t\tfn: this.onMouseOut,\n        \t\tscope: this\n    \t\t}\n\t\t});\n\t\t</code></pre>\n<p>\nOr a shorthand syntax which passes the same scope object to all handlers:\n     \t<pre><code>\n\t\tel.on({\n\t\t\t'click': this.onClick,\n    \t\t'mouseover': this.onMouseOver,\n    \t\t'mouseout': this.onMouseOut,\n    \t\tscope: this\n\t\t});\n\t\t</code></pre>",
1307           "isOptional" : false
1308         }
1309       ],
1310       "returns" : []
1311     }
1312   ],
1313   "events" : [
1314     {
1315       "name" : "rendered",
1316       "desc" : "Fires when the form is rendered",
1317       "memberOf" : "Roo.form.Form",
1318       "example" : "",
1319       "deprecated" : "",
1320       "since" : "",
1321       "see" : "",
1322       "params" : [
1323         {
1324           "name" : "form",
1325           "type" : "Roo.form.Form",
1326           "desc" : "",
1327           "isOptional" : false
1328         }
1329       ],
1330       "returns" : []
1331     },
1332     {
1333       "name" : "clientvalidation",
1334       "desc" : "If the monitorValid config option is true, this event fires repetitively to notify of valid state",
1335       "memberOf" : "Roo.form.Form",
1336       "example" : "",
1337       "deprecated" : "",
1338       "since" : "",
1339       "see" : "",
1340       "params" : [
1341         {
1342           "name" : "this",
1343           "type" : "Form",
1344           "desc" : "",
1345           "isOptional" : false
1346         },
1347         {
1348           "name" : "valid",
1349           "type" : "Boolean",
1350           "desc" : "true if the form has passed client-side validation",
1351           "isOptional" : false
1352         }
1353       ],
1354       "returns" : []
1355     },
1356     {
1357       "name" : "beforeaction",
1358       "desc" : "Fires before any action is performed. Return false to cancel the action.",
1359       "memberOf" : "Roo.form.BasicForm",
1360       "example" : "",
1361       "deprecated" : "",
1362       "since" : "",
1363       "see" : "",
1364       "params" : [
1365         {
1366           "name" : "this",
1367           "type" : "Form",
1368           "desc" : "",
1369           "isOptional" : false
1370         },
1371         {
1372           "name" : "action",
1373           "type" : "Action",
1374           "desc" : "The action to be performed",
1375           "isOptional" : false
1376         }
1377       ],
1378       "returns" : []
1379     },
1380     {
1381       "name" : "actioncomplete",
1382       "desc" : "Fires when an action is completed.",
1383       "memberOf" : "Roo.form.BasicForm",
1384       "example" : "",
1385       "deprecated" : "",
1386       "since" : "",
1387       "see" : "",
1388       "params" : [
1389         {
1390           "name" : "this",
1391           "type" : "Form",
1392           "desc" : "",
1393           "isOptional" : false
1394         },
1395         {
1396           "name" : "action",
1397           "type" : "Action",
1398           "desc" : "The action that completed",
1399           "isOptional" : false
1400         }
1401       ],
1402       "returns" : []
1403     },
1404     {
1405       "name" : "actionfailed",
1406       "desc" : "Fires when an action fails.",
1407       "memberOf" : "Roo.form.BasicForm",
1408       "example" : "",
1409       "deprecated" : "",
1410       "since" : "",
1411       "see" : "",
1412       "params" : [
1413         {
1414           "name" : "this",
1415           "type" : "Form",
1416           "desc" : "",
1417           "isOptional" : false
1418         },
1419         {
1420           "name" : "action",
1421           "type" : "Action",
1422           "desc" : "The action that failed",
1423           "isOptional" : false
1424         }
1425       ],
1426       "returns" : []
1427     }
1428   ]
1429 }