1 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
4 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
7 <meta http-equiv="content-type" content="text/html; charset=undefined" />
8 <meta name="generator" content="JsDoc Toolkit" />
11 <title>JsDoc Reference - Roo.form.Form</title>
14 <link rel="stylesheet" type="text/css" href="../../css/roojs.css" />
15 <link rel="stylesheet" type="text/css" href="../default.css" />
18 <script type="text/javascript" src="../page.js">
25 <body onload="RooDocsPage.onload();">
28 <div class="body-wrap">
30 <!-- ============================== links to methods. ================================= -->
32 <div class="top-tools">
34 <a class="inner-link" href="#Roo.form.Form-props"><img src="resources/s.gif" class="item-icon icon-prop">Properties</a>
35 <a class="inner-link" href="#Roo.form.Form-methods"><img src="resources/s.gif" class="item-icon icon-method">Methods</a>
36 <a class="inner-link" href="#Roo.form.Form-events"><img src="resources/s.gif" class="item-icon icon-event">Events</a>
37 <a class="inner-link" href="#Roo.form.Form-configs"><img src="resources/s.gif" class="item-icon icon-config">Config Options</a>
38 <a class="bookmark" href="NEED_TO_CREATE_DIRECT_LINK_HREF"><img src="resources/s.gif" class="item-icon icon-fav">Direct Link</a>
43 <!-- ============================== inheritance Block. ================================= -->
45 <div class="inheritance res-block">
46 <pre class="res-block-inner"><a href="./Roo.util.Observable.html#constructor" roo:cls="Roo.util.Observable.html#constructor">Roo.util.Observable</a>
47 <img src="../../images/default/s.gif" height="1" width="20"/><img src="../../images/default/tree/elbow-end.gif" class="elbow"/><a href="./Roo.form.BasicForm.html#constructor" roo:cls="Roo.form.BasicForm.html#constructor">Roo.form.BasicForm</a>
48 <img src="../../images/default/s.gif" height="1" width="40"/><img class="elbow" src="../../images/default/tree/elbow-end.gif"/>Roo.form.Form
53 <!-- ============================== class title / details ============================ -->
56 <h1 class="classTitle">
61 <table cellspacing="0" class="class-summary-table">
63 <tr><td class="label">Package:</td><td class="hd-info">Roo.form</td></tr>
65 <tr><td class="label">Defined In:</td><td class="hd-info">
67 <a href="./src/Roo_form_Form.js.html">Roo/form/Form.js</a>.
70 <tr><td class="label">Class:</td><td class="hd-info">Form</td></tr>
75 <tr><td class="label">Extends:</td><td class="hd-info">
76 <a href="./Roo.form.BasicForm.html#constructor" roo:cls="Roo.form.BasicForm.html#constructor">Roo.form.BasicForm</a>
84 <!-- ============================== class summary ========================== -->
85 <div class="description">
86 Adds the ability to dynamically render forms with JavaScript to {<b>link</b> Roo.form.BasicForm}.
90 <!-- ============================== Class comment block... ========================== -->
92 <div class="comments">
93 <b>Class Comments / Notes</B> =>
94 <u onclick="parent.CommentDialog.showCommentId = 'Roo.form.Form';">[Add Your comment/notes about this class]</u>
96 <iframe frameborder="0" id="comments-Roo.form" style="border: none;width:100%;"
97 src="/blog.php/GtkDjsComments/Roo.form.Form.html"></iframe>
102 <!-- ============================== config options ========================== -->
107 <div class="hr"></div>
108 <a id="Roo.form.Form-configs"></a>
114 <table cellspacing="0" class="member-table">
115 <caption>Config Options (Usually are also Properties)</caption>
119 <th class="sig-header" colspan="2">Options</th>
121 <th class="msource-header">Defined By</th>
128 <tr class="config-row expandable config-row-alt0">
129 <td class="micon"><a class="exi" href="#expand"> </a></td>
132 <a id="Roo.form.BasicForm-cfg-baseParams" name=".baseParams"></a>
133 <div class="fixedFont">
134 <b class="itemname">baseParams</b> : <a href="http://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference:Global_Objects:Object">Object</a>
140 <div class="short">Parameters to pass with all requests.</div>
145 Parameters to pass with all requests. e.g. baseParams: {id: '123', foo: 'bar'}.
155 <a href="./Roo.form.BasicForm.html#constructor" roo:cls="Roo.form.BasicForm.html#constructor">Roo.form.BasicForm</a>
161 <tr class="config-row expandable config-row-alt1 notInherited">
162 <td class="micon"><a class="exi" href="#expand"> </a></td>
165 <a id="Roo.form.Form-cfg-buttonAlign" name=".buttonAlign"></a>
166 <div class="fixedFont">
167 <b class="itemname">buttonAlign</b> : <a href="./String.html#constructor" roo:cls="String.html#constructor">String</a>
173 <div class="short">Valid values are "left," "center" and "right" (defaults to "center")</div>
178 Valid values are "left," "center" and "right" (defaults to "center")
194 <tr class="config-row expandable config-row-alt0">
195 <td class="micon"><a class="exi" href="#expand"> </a></td>
198 <a id="Roo.form.BasicForm-cfg-errorReader" name=".errorReader"></a>
199 <div class="fixedFont">
200 <b class="itemname">errorReader</b> : DataReader
206 <div class="short">An Roo.data.DataReader (e.g.</div>
211 An Roo.data.DataReader (e.g. {<b>link</b> Roo.data.XmlReader}) to be used to read data when reading validation errors on "submit" actions.<br/>This is completely optional as there is built-in support for processing JSON.
221 <a href="./Roo.form.BasicForm.html#constructor" roo:cls="Roo.form.BasicForm.html#constructor">Roo.form.BasicForm</a>
227 <tr class="config-row expandable config-row-alt1">
228 <td class="micon"><a class="exi" href="#expand"> </a></td>
231 <a id="Roo.form.BasicForm-cfg-fileUpload" name=".fileUpload"></a>
232 <div class="fixedFont">
233 <b class="itemname">fileUpload</b> : <a href="http://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference:Global_Objects:Boolean">Boolean</a>
239 <div class="short">Set to true if this form is a file upload.</div>
244 Set to true if this form is a file upload.
254 <a href="./Roo.form.BasicForm.html#constructor" roo:cls="Roo.form.BasicForm.html#constructor">Roo.form.BasicForm</a>
260 <tr class="config-row expandable config-row-alt0 notInherited">
261 <td class="micon"><a class="exi" href="#expand"> </a></td>
264 <a id="Roo.form.Form-cfg-itemCls" name=".itemCls"></a>
265 <div class="fixedFont">
266 <b class="itemname">itemCls</b> : <a href="./String.html#constructor" roo:cls="String.html#constructor">String</a>
272 <div class="short">A css class to apply to the x-form-item of fields.</div>
277 A css class to apply to the x-form-item of fields. This property cascades to child containers.
293 <tr class="config-row expandable config-row-alt1 notInherited">
294 <td class="micon"><a class="exi" href="#expand"> </a></td>
297 <a id="Roo.form.Form-cfg-labelAlign" name=".labelAlign"></a>
298 <div class="fixedFont">
299 <b class="itemname">labelAlign</b> : <a href="./String.html#constructor" roo:cls="String.html#constructor">String</a>
305 <div class="short">Valid values are "left," "top" and "right" (defaults to "left").</div>
310 Valid values are "left," "top" and "right" (defaults to "left").<br/>This property cascades to child containers if not set.
326 <tr class="config-row expandable config-row-alt0 notInherited">
327 <td class="micon"><a class="exi" href="#expand"> </a></td>
330 <a id="Roo.form.Form-cfg-labelWidth" name=".labelWidth"></a>
331 <div class="fixedFont">
332 <b class="itemname">labelWidth</b> : <a href="./Number.html#constructor" roo:cls="Number.html#constructor">Number</a>
338 <div class="short">The width of labels.</div>
343 The width of labels. This property cascades to child containers.
359 <tr class="config-row expandable config-row-alt1">
360 <td class="micon"><a class="exi" href="#expand"> </a></td>
363 <a id="Roo.util.Observable-cfg-listeners" name=".listeners"></a>
364 <div class="fixedFont">
365 <b class="itemname">listeners</b> : <a href="http://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference:Global_Objects:Object">Object</a>
371 <div class="short">list of events and functions to call for this object, <br/>For example :<br/><pre><code><br/> listeners : { <br/> 'click' : function(e) {<br/> .</div>
376 list of events and functions to call for this object, <br/>For example :<br/><pre><code><br/> listeners : { <br/> 'click' : function(e) {<br/> ..... <br/> } ,<br/> .... <br/> } <br/> </code></pre>
386 <a href="./Roo.util.Observable.html#constructor" roo:cls="Roo.util.Observable.html#constructor">Roo.util.Observable</a>
392 <tr class="config-row expandable config-row-alt0">
393 <td class="micon"><a class="exi" href="#expand"> </a></td>
396 <a id="Roo.form.BasicForm-cfg-method" name=".method"></a>
397 <div class="fixedFont">
398 <b class="itemname">method</b> : <a href="./String.html#constructor" roo:cls="String.html#constructor">String</a>
404 <div class="short">The request method to use (GET or POST) for form actions if one isn't supplied in the action options.</div>
409 The request method to use (GET or POST) for form actions if one isn't supplied in the action options.
419 <a href="./Roo.form.BasicForm.html#constructor" roo:cls="Roo.form.BasicForm.html#constructor">Roo.form.BasicForm</a>
425 <tr class="config-row expandable config-row-alt1 notInherited">
426 <td class="micon"><a class="exi" href="#expand"> </a></td>
429 <a id="Roo.form.Form-cfg-minButtonWidth" name=".minButtonWidth"></a>
430 <div class="fixedFont">
431 <b class="itemname">minButtonWidth</b> : <a href="./Number.html#constructor" roo:cls="Number.html#constructor">Number</a>
437 <div class="short">Minimum width of all buttons in pixels (defaults to 75)</div>
442 Minimum width of all buttons in pixels (defaults to 75)
458 <tr class="config-row expandable config-row-alt0 notInherited">
459 <td class="micon"><a class="exi" href="#expand"> </a></td>
462 <a id="Roo.form.Form-cfg-monitorPoll" name=".monitorPoll"></a>
463 <div class="fixedFont">
464 <b class="itemname">monitorPoll</b> : <a href="./Number.html#constructor" roo:cls="Number.html#constructor">Number</a>
470 <div class="short">The milliseconds to poll valid state, ignored if monitorValid is not true (defaults to 200)</div>
475 The milliseconds to poll valid state, ignored if monitorValid is not true (defaults to 200)
491 <tr class="config-row expandable config-row-alt1 notInherited">
492 <td class="micon"><a class="exi" href="#expand"> </a></td>
495 <a id="Roo.form.Form-cfg-monitorValid" name=".monitorValid"></a>
496 <div class="fixedFont">
497 <b class="itemname">monitorValid</b> : <a href="http://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference:Global_Objects:Boolean">Boolean</a>
503 <div class="short">If true the form monitors its valid state <b>client-side</b> and<br/>fires a looping event with that state.</div>
508 If true the form monitors its valid state <b>client-side</b> and<br/>fires a looping event with that state. This is required to bind buttons to the valid<br/>state using the config value formBind:true on the button.
524 <tr class="config-row expandable config-row-alt0 notInherited">
525 <td class="micon"><a class="exi" href="#expand"> </a></td>
528 <a id="Roo.form.Form-cfg-progressUrl" name=".progressUrl"></a>
529 <div class="fixedFont">
530 <b class="itemname">progressUrl</b> : <a href="./String.html#constructor" roo:cls="String.html#constructor">String</a>
536 <div class="short">- Url to return progress data</div>
541 - Url to return progress data
557 <tr class="config-row expandable config-row-alt1">
558 <td class="micon"><a class="exi" href="#expand"> </a></td>
561 <a id="Roo.form.BasicForm-cfg-reader" name=".reader"></a>
562 <div class="fixedFont">
563 <b class="itemname">reader</b> : DataReader
569 <div class="short">An Roo.data.DataReader (e.g.</div>
574 An Roo.data.DataReader (e.g. {<b>link</b> Roo.data.XmlReader}) to be used to read data when executing "load" actions.<br/>This is optional as there is built-in support for processing JSON.
584 <a href="./Roo.form.BasicForm.html#constructor" roo:cls="Roo.form.BasicForm.html#constructor">Roo.form.BasicForm</a>
590 <tr class="config-row expandable config-row-alt0">
591 <td class="micon"><a class="exi" href="#expand"> </a></td>
594 <a id="Roo.form.BasicForm-cfg-timeout" name=".timeout"></a>
595 <div class="fixedFont">
596 <b class="itemname">timeout</b> : <a href="./Number.html#constructor" roo:cls="Number.html#constructor">Number</a>
602 <div class="short">Timeout for form actions in seconds (default is 30 seconds).</div>
607 Timeout for form actions in seconds (default is 30 seconds).
617 <a href="./Roo.form.BasicForm.html#constructor" roo:cls="Roo.form.BasicForm.html#constructor">Roo.form.BasicForm</a>
623 <tr class="config-row expandable config-row-alt1">
624 <td class="micon"><a class="exi" href="#expand"> </a></td>
627 <a id="Roo.form.BasicForm-cfg-trackResetOnLoad" name=".trackResetOnLoad"></a>
628 <div class="fixedFont">
629 <b class="itemname">trackResetOnLoad</b> : <a href="http://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference:Global_Objects:Boolean">Boolean</a>
635 <div class="short">If set to true, form.reset() resets to the last loaded<br/>or setValues() data instead of when the form was first created.</div>
640 If set to true, form.reset() resets to the last loaded<br/>or setValues() data instead of when the form was first created.
650 <a href="./Roo.form.BasicForm.html#constructor" roo:cls="Roo.form.BasicForm.html#constructor">Roo.form.BasicForm</a>
656 <tr class="config-row expandable config-row-alt0">
657 <td class="micon"><a class="exi" href="#expand"> </a></td>
660 <a id="Roo.form.BasicForm-cfg-url" name=".url"></a>
661 <div class="fixedFont">
662 <b class="itemname">url</b> : <a href="./String.html#constructor" roo:cls="String.html#constructor">String</a>
668 <div class="short">The URL to use for form actions if one isn't supplied in the action options.</div>
673 The URL to use for form actions if one isn't supplied in the action options.
683 <a href="./Roo.form.BasicForm.html#constructor" roo:cls="Roo.form.BasicForm.html#constructor">Roo.form.BasicForm</a>
699 <!-- ============================== public properties ==================== -->
703 <a id="Roo.form.Form-props"></a>
709 <table cellspacing="0" class="member-table">
710 <caption class="Empty">Public Properties - Has None</caption>
716 <!-- ============================== methods summary / details ======================== -->
719 <a id="Roo.form.Form-methods"></a>
720 <!-- constructor?? -->
727 <!-- then dynamics first -->
734 <table cellspacing="0" class="member-table">
735 <caption>Public Methods</caption>
737 <th class="sig-header" colspan="2">Method</th>
738 <th class="msource-header">Defined By</th>
748 <tr class="method-row config-row-alt0 expandable notInherited">
749 <td class="micon"><a class="exi" href="#expand"> </a></td>
753 <a id="Roo.form-method-Form" name=".Form"></a>
754 <div class="fixedFont">
755 <span class="attributes">new <B>Roo.form.</B></span><b class="itemname">Form</b>
757 (<a href="http://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference:Global_Objects:Object">Object</a> <B><i>config</i></B>)
765 <div class="short">Create a new Roo.form.Form</div>
772 Create a new Roo.form.Form
775 <dl class="detailList">
776 <dt class="heading">Parameters:</dt>
779 <span class="fixedFont"><a href="http://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference:Global_Objects:Object">Object</a></span> <b>config</b>
782 <dd>Configuration options</dd>
806 <tr class="method-row config-row-alt1 expandable notInherited">
807 <td class="micon"><a class="exi" href="#expand"> </a></td>
811 <a id="Roo.form.Form-method-add" name=".add"></a>
812 <div class="fixedFont">
813 <span class="attributes"></span><b class="itemname">add</b>
815 (Field <B><i>field1</i></B>, Field <B><i>field2</i></B>)
830 <div class="short">Add Roo.form components to the current open container (e.g.</div>
836 Add Roo.form components to the current open container (e.g. column, fieldset, etc.). Fields added via this method<br/>can also be passed with an additional property of fieldLabel, which if supplied, will provide the text to display<br/>as the label of the field.
843 <dl class="detailList">
844 <dt class="heading">Parameters:</dt>
847 <span class="fixedFont">Field</span> <b>field1</b>
853 <span class="fixedFont">Field</span> <b>field2</b>
859 <span class="fixedFont">Field</span> <b>etc.</b>
870 <dl class="detailList">
871 <dt class="heading">Returns:</dt>
873 <dd><span class="fixedFont">Form</span> this</dd>
895 <tr class="method-row config-row-alt0 expandable notInherited">
896 <td class="micon"><a class="exi" href="#expand"> </a></td>
900 <a id="Roo.form.Form-method-addButton" name=".addButton"></a>
901 <div class="fixedFont">
902 <span class="attributes"></span><b class="itemname">addButton</b>
904 (<a href="./String.html#constructor" roo:cls="String.html#constructor">String</a>/Object <B><i>config</i></B>, <a href="./Function.html#constructor" roo:cls="Function.html#constructor">Function</a> <B><i>handler</i></B>, <a href="http://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference:Global_Objects:Object">Object</a> <B><i>scope</i></B>)
910 <a href="./Roo.Button.html#constructor" roo:cls="Roo.Button.html#constructor">Roo.Button</a>
919 <div class="short">Adds a button to the footer of the form - this <b>must</b> be called before the form is rendered.</div>
925 Adds a button to the footer of the form - this <b>must</b> be called before the form is rendered.
932 <dl class="detailList">
933 <dt class="heading">Parameters:</dt>
936 <span class="fixedFont"><a href="./String.html#constructor" roo:cls="String.html#constructor">String</a>/Object</span> <b>config</b>
939 <dd>A string becomes the button text, an object can either be a Button config<br/>object or a valid Roo.DomHelper element config</dd>
942 <span class="fixedFont"><a href="./Function.html#constructor" roo:cls="Function.html#constructor">Function</a></span> <b>handler</b>
945 <dd>The function called when the button is clicked</dd>
948 <span class="fixedFont"><a href="http://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference:Global_Objects:Object">Object</a></span> <b>scope</b>
951 <dd>(optional) The scope of the handler function</dd>
959 <dl class="detailList">
960 <dt class="heading">Returns:</dt>
962 <dd><span class="fixedFont"><a href="./Roo.Button.html#constructor" roo:cls="Roo.Button.html#constructor">Roo.Button</a></span> </dd>
984 <tr class="method-row config-row-alt1 expandable">
985 <td class="micon"><a class="exi" href="#expand"> </a></td>
989 <a id="Roo.util.Observable-method-addEvents" name=".addEvents"></a>
990 <div class="fixedFont">
991 <span class="attributes"></span><b class="itemname">addEvents</b>
993 (<a href="http://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference:Global_Objects:Object">Object</a> <B><i>object</i></B>)
1000 <div class="short">Used to define events on this Observable</div>
1006 Used to define events on this Observable
1013 <dl class="detailList">
1014 <dt class="heading">Parameters:</dt>
1017 <span class="fixedFont"><a href="http://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference:Global_Objects:Object">Object</a></span> <b>object</b>
1020 <dd>The object with the events defined</dd>
1038 <td class="msource">
1040 <a href="./Roo.util.Observable.html#constructor" roo:cls="Roo.util.Observable.html#constructor">Roo.util.Observable</a>
1046 <tr class="method-row config-row-alt0 expandable">
1047 <td class="micon"><a class="exi" href="#expand"> </a></td>
1051 <a id="Roo.form.BasicForm-method-addForm" name=".addForm"></a>
1052 <div class="fixedFont">
1053 <span class="attributes"></span><b class="itemname">addForm</b>
1055 (<a href="./Roo.form.Form.html#constructor" roo:cls="Roo.form.Form.html#constructor">Roo.form.Form</a> <B><i>form</i></B>)
1062 <div class="short">Add a secondary form to this one, <br/>Used to provide tabbed forms.</div>
1068 Add a secondary form to this one, <br/>Used to provide tabbed forms. One form is primary, with hidden values <br/>which mirror the elements from the other forms.
1075 <dl class="detailList">
1076 <dt class="heading">Parameters:</dt>
1079 <span class="fixedFont"><a href="./Roo.form.Form.html#constructor" roo:cls="Roo.form.Form.html#constructor">Roo.form.Form</a></span> <b>form</b>
1100 <td class="msource">
1102 <a href="./Roo.form.BasicForm.html#constructor" roo:cls="Roo.form.BasicForm.html#constructor">Roo.form.BasicForm</a>
1108 <tr class="method-row config-row-alt1 expandable">
1109 <td class="micon"><a class="exi" href="#expand"> </a></td>
1113 <a id="Roo.util.Observable-method-addListener" name=".addListener"></a>
1114 <div class="fixedFont">
1115 <span class="attributes"></span><b class="itemname">addListener</b>
1117 (<a href="./String.html#constructor" roo:cls="String.html#constructor">String</a> <B><i>eventName</i></B>, <a href="./Function.html#constructor" roo:cls="Function.html#constructor">Function</a> <B><i>handler</i></B>, <a href="http://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference:Global_Objects:Object">Object</a> <B><i>scope</i></B>, <a href="http://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference:Global_Objects:Object">Object</a> <B><i>options</i></B>)
1124 <div class="short">Appends an event handler to this component</div>
1130 Appends an event handler to this component
1137 <dl class="detailList">
1138 <dt class="heading">Parameters:</dt>
1141 <span class="fixedFont"><a href="./String.html#constructor" roo:cls="String.html#constructor">String</a></span> <b>eventName</b>
1144 <dd>The type of event to listen for</dd>
1147 <span class="fixedFont"><a href="./Function.html#constructor" roo:cls="Function.html#constructor">Function</a></span> <b>handler</b>
1150 <dd>The method the event invokes</dd>
1153 <span class="fixedFont"><a href="http://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference:Global_Objects:Object">Object</a></span> <b>scope</b>
1156 <dd>(optional) The scope in which to execute the handler<br/>function. The handler function's "this" context.</dd>
1159 <span class="fixedFont"><a href="http://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference:Global_Objects:Object">Object</a></span> <b>options</b>
1162 <dd>(optional) An object containing handler configuration<br/>properties. This may contain any of the following properties:<ul><br/><li>scope {Object} The scope in which to execute the handler function. The handler function's "this" context.</li><br/><li>delay {Number} The number of milliseconds to delay the invocation of the handler after te event fires.</li><br/><li>single {Boolean} True to add a handler to handle just the next firing of the event, and then remove itself.</li><br/><li>buffer {Number} Causes the handler to be scheduled to run in an {<b>link</b> Roo.util.DelayedTask} delayed<br/>by the specified number of milliseconds. If the event fires again within that time, the original<br/>handler is <em>not</em> invoked, but the new handler is scheduled in its place.</li><br/></ul><br><br/><p><br/><b>Combining Options</b><br><br/>Using the options argument, it is possible to combine different types of listeners:<br><br/><br><br/>A normalized, delayed, one-time listener that auto stops the event and passes a custom argument (forumId)<br/> <pre><code><br/> el.on('click', this.onClick, this, {<br/> single: true,<br/> delay: 100,<br/> forumId: 4<br/> });<br/> </code></pre><br/><p><br/><b>Attaching multiple handlers in 1 call</b><br><br/>The method also allows for a single argument to be passed which is a config object containing properties<br/>which specify multiple handlers.<br/><pre><code><br/> el.on({<br/> 'click': {<br/> fn: this.onClick,<br/> scope: this,<br/> delay: 100<br/> }, <br/> 'mouseover': {<br/> fn: this.onMouseOver,<br/> scope: this<br/> },<br/> 'mouseout': {<br/> fn: this.onMouseOut,<br/> scope: this<br/> }<br/> });<br/> </code></pre><br/><p><br/>Or a shorthand syntax which passes the same scope object to all handlers:<br/> <pre><code><br/> el.on({<br/> 'click': this.onClick,<br/> 'mouseover': this.onMouseOver,<br/> 'mouseout': this.onMouseOut,<br/> scope: this<br/> });<br/> </code></pre></dd>
1180 <td class="msource">
1182 <a href="./Roo.util.Observable.html#constructor" roo:cls="Roo.util.Observable.html#constructor">Roo.util.Observable</a>
1188 <tr class="method-row config-row-alt0 expandable notInherited">
1189 <td class="micon"><a class="exi" href="#expand"> </a></td>
1193 <a id="Roo.form.Form-method-addxtype" name=".addxtype"></a>
1194 <div class="fixedFont">
1195 <span class="attributes"></span><b class="itemname">addxtype</b>
1197 (<a href="http://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference:Global_Objects:Object">Object</a> <B><i>config</i></B>)
1204 <div class="short">Adds a series of form elements (using the xtype property as the factory method.</div>
1210 Adds a series of form elements (using the xtype property as the factory method.<br/>Valid xtypes are: TextField, TextArea .... Button, Layout, FieldSet, Column, (and 'end' to close a block)
1217 <dl class="detailList">
1218 <dt class="heading">Parameters:</dt>
1221 <span class="fixedFont"><a href="http://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference:Global_Objects:Object">Object</a></span> <b>config</b>
1242 <td class="msource">
1250 <tr class="method-row config-row-alt1 expandable">
1251 <td class="micon"><a class="exi" href="#expand"> </a></td>
1255 <a id="Roo.form.BasicForm-method-applyIfToFields" name=".applyIfToFields"></a>
1256 <div class="fixedFont">
1257 <span class="attributes"></span><b class="itemname">applyIfToFields</b>
1259 (<a href="http://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference:Global_Objects:Object">Object</a> <B><i>values</i></B>)
1274 <div class="short">Calls {<b>link</b> Ext<b>applyIf</b>} for all field in this form with the passed object.</div>
1280 Calls {<b>link</b> Ext<b>applyIf</b>} for all field in this form with the passed object.
1287 <dl class="detailList">
1288 <dt class="heading">Parameters:</dt>
1291 <span class="fixedFont"><a href="http://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference:Global_Objects:Object">Object</a></span> <b>values</b>
1302 <dl class="detailList">
1303 <dt class="heading">Returns:</dt>
1305 <dd><span class="fixedFont">BasicForm</span> this</dd>
1319 <td class="msource">
1321 <a href="./Roo.form.BasicForm.html#constructor" roo:cls="Roo.form.BasicForm.html#constructor">Roo.form.BasicForm</a>
1327 <tr class="method-row config-row-alt0 expandable">
1328 <td class="micon"><a class="exi" href="#expand"> </a></td>
1332 <a id="Roo.form.BasicForm-method-applyToFields" name=".applyToFields"></a>
1333 <div class="fixedFont">
1334 <span class="attributes"></span><b class="itemname">applyToFields</b>
1336 (<a href="http://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference:Global_Objects:Object">Object</a> <B><i>values</i></B>)
1351 <div class="short">Calls {<b>link</b> Ext<b>apply</b>} for all fields in this form with the passed object.</div>
1357 Calls {<b>link</b> Ext<b>apply</b>} for all fields in this form with the passed object.
1364 <dl class="detailList">
1365 <dt class="heading">Parameters:</dt>
1368 <span class="fixedFont"><a href="http://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference:Global_Objects:Object">Object</a></span> <b>values</b>
1379 <dl class="detailList">
1380 <dt class="heading">Returns:</dt>
1382 <dd><span class="fixedFont">BasicForm</span> this</dd>
1396 <td class="msource">
1398 <a href="./Roo.form.BasicForm.html#constructor" roo:cls="Roo.form.BasicForm.html#constructor">Roo.form.BasicForm</a>
1404 <tr class="method-row config-row-alt1 expandable">
1405 <td class="micon"><a class="exi" href="#expand"> </a></td>
1409 <a id="Roo.form.BasicForm-method-clearInvalid" name=".clearInvalid"></a>
1410 <div class="fixedFont">
1411 <span class="attributes"></span><b class="itemname">clearInvalid</b>
1428 <div class="short">Clears all invalid messages in this form.</div>
1434 Clears all invalid messages in this form.
1445 <dl class="detailList">
1446 <dt class="heading">Returns:</dt>
1448 <dd><span class="fixedFont">BasicForm</span> this</dd>
1462 <td class="msource">
1464 <a href="./Roo.form.BasicForm.html#constructor" roo:cls="Roo.form.BasicForm.html#constructor">Roo.form.BasicForm</a>
1470 <tr class="method-row config-row-alt0 expandable notInherited">
1471 <td class="micon"><a class="exi" href="#expand"> </a></td>
1475 <a id="Roo.form.Form-method-column" name=".column"></a>
1476 <div class="fixedFont">
1477 <span class="attributes"></span><b class="itemname">column</b>
1479 (<a href="http://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference:Global_Objects:Object">Object</a> <B><i>config</i></B>, Field <B><i>field1</i></B>, Field <B><i>field2</i></B>, Field <B><i>etc</i></B>)
1494 <div class="short">Opens a new {<b>link</b> Roo.form.Column} container in the layout stack.</div>
1500 Opens a new {<b>link</b> Roo.form.Column} container in the layout stack. If fields are passed after the config, the<br/>fields are added and the column is closed. If no fields are passed the column remains open<br/>until end() is called.
1507 <dl class="detailList">
1508 <dt class="heading">Parameters:</dt>
1511 <span class="fixedFont"><a href="http://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference:Global_Objects:Object">Object</a></span> <b>config</b>
1514 <dd>The config to pass to the column</dd>
1517 <span class="fixedFont">Field</span> <b>field1</b>
1523 <span class="fixedFont">Field</span> <b>field2</b>
1529 <span class="fixedFont">Field</span> <b>etc</b>
1540 <dl class="detailList">
1541 <dt class="heading">Returns:</dt>
1543 <dd> Column The column container object</dd>
1557 <td class="msource">
1565 <tr class="method-row config-row-alt1 expandable notInherited">
1566 <td class="micon"><a class="exi" href="#expand"> </a></td>
1570 <a id="Roo.form.Form-method-container" name=".container"></a>
1571 <div class="fixedFont">
1572 <span class="attributes"></span><b class="itemname">container</b>
1574 (<a href="http://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference:Global_Objects:Object">Object</a> <B><i>config</i></B>, Field <B><i>field1</i></B>, Field <B><i>field2</i></B>, Field <B><i>etc</i></B>)
1589 <div class="short">Opens a new {<b>link</b> Roo.form.Layout} container in the layout stack.</div>
1595 Opens a new {<b>link</b> Roo.form.Layout} container in the layout stack. If fields are passed after the config, the<br/>fields are added and the container is closed. If no fields are passed the container remains open<br/>until end() is called.
1602 <dl class="detailList">
1603 <dt class="heading">Parameters:</dt>
1606 <span class="fixedFont"><a href="http://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference:Global_Objects:Object">Object</a></span> <b>config</b>
1609 <dd>The config to pass to the Layout</dd>
1612 <span class="fixedFont">Field</span> <b>field1</b>
1618 <span class="fixedFont">Field</span> <b>field2</b>
1624 <span class="fixedFont">Field</span> <b>etc</b>
1635 <dl class="detailList">
1636 <dt class="heading">Returns:</dt>
1638 <dd> Layout The container object</dd>
1652 <td class="msource">
1660 <tr class="method-row config-row-alt0 expandable">
1661 <td class="micon"><a class="exi" href="#expand"> </a></td>
1665 <a id="Roo.form.BasicForm-method-doAction" name=".doAction"></a>
1666 <div class="fixedFont">
1667 <span class="attributes"></span><b class="itemname">doAction</b>
1669 (<a href="./String.html#constructor" roo:cls="String.html#constructor">String</a> <B><i>actionName</i></B>, <a href="http://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference:Global_Objects:Object">Object</a> <B><i>options</i></B>)
1684 <div class="short">Performs a predefined action (submit or load) or custom actions you define on this form.</div>
1690 Performs a predefined action (submit or load) or custom actions you define on this form.
1697 <dl class="detailList">
1698 <dt class="heading">Parameters:</dt>
1701 <span class="fixedFont"><a href="./String.html#constructor" roo:cls="String.html#constructor">String</a></span> <b>actionName</b>
1704 <dd>The name of the action type</dd>
1707 <span class="fixedFont"><a href="http://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference:Global_Objects:Object">Object</a></span> <b>options</b>
1710 <dd>(optional) The options to pass to the action. All of the config options listed<br/>below are supported by both the submit and load actions unless otherwise noted (custom actions could also<br/>accept other config options):<br/><pre><br/>Property Type Description<br/>---------------- --------------- ----------------------------------------------------------------------------------<br/>url String The url for the action (defaults to the form's url)<br/>method String The form method to use (defaults to the form's method, or POST if not defined)<br/>params String/Object The params to pass (defaults to the form's baseParams, or none if not defined)<br/>clientValidation Boolean Applies to submit only. Pass true to call form.isValid() prior to posting to<br/> validate the form on the client (defaults to false)<br/></pre></dd>
1718 <dl class="detailList">
1719 <dt class="heading">Returns:</dt>
1721 <dd><span class="fixedFont">BasicForm</span> this</dd>
1735 <td class="msource">
1737 <a href="./Roo.form.BasicForm.html#constructor" roo:cls="Roo.form.BasicForm.html#constructor">Roo.form.BasicForm</a>
1743 <tr class="method-row config-row-alt1 expandable notInherited">
1744 <td class="micon"><a class="exi" href="#expand"> </a></td>
1748 <a id="Roo.form.Form-method-end" name=".end"></a>
1749 <div class="fixedFont">
1750 <span class="attributes"></span><b class="itemname">end</b>
1767 <div class="short">Closes the current open container</div>
1773 Closes the current open container
1784 <dl class="detailList">
1785 <dt class="heading">Returns:</dt>
1787 <dd><span class="fixedFont">Form</span> this</dd>
1801 <td class="msource">
1809 <tr class="method-row config-row-alt0 expandable notInherited">
1810 <td class="micon"><a class="exi" href="#expand"> </a></td>
1814 <a id="Roo.form.Form-method-fieldset" name=".fieldset"></a>
1815 <div class="fixedFont">
1816 <span class="attributes"></span><b class="itemname">fieldset</b>
1818 (<a href="http://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference:Global_Objects:Object">Object</a> <B><i>config</i></B>, Field <B><i>field1</i></B>, Field <B><i>field2</i></B>, Field <B><i>etc</i></B>)
1833 <div class="short">Opens a new {<b>link</b> Roo.form.FieldSet} container in the layout stack.</div>
1839 Opens a new {<b>link</b> Roo.form.FieldSet} container in the layout stack. If fields are passed after the config, the<br/>fields are added and the fieldset is closed. If no fields are passed the fieldset remains open<br/>until end() is called.
1846 <dl class="detailList">
1847 <dt class="heading">Parameters:</dt>
1850 <span class="fixedFont"><a href="http://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference:Global_Objects:Object">Object</a></span> <b>config</b>
1853 <dd>The config to pass to the fieldset</dd>
1856 <span class="fixedFont">Field</span> <b>field1</b>
1862 <span class="fixedFont">Field</span> <b>field2</b>
1868 <span class="fixedFont">Field</span> <b>etc</b>
1879 <dl class="detailList">
1880 <dt class="heading">Returns:</dt>
1882 <dd> FieldSet The fieldset container object</dd>
1896 <td class="msource">
1904 <tr class="method-row config-row-alt1 expandable">
1905 <td class="micon"><a class="exi" href="#expand"> </a></td>
1909 <a id="Roo.form.BasicForm-method-findField" name=".findField"></a>
1910 <div class="fixedFont">
1911 <span class="attributes"></span><b class="itemname">findField</b>
1913 (<a href="./String.html#constructor" roo:cls="String.html#constructor">String</a> <B><i>id</i></B>)
1928 <div class="short">Find a Roo.form.Field in this form by id, dataIndex, name or hiddenName</div>
1934 Find a Roo.form.Field in this form by id, dataIndex, name or hiddenName
1941 <dl class="detailList">
1942 <dt class="heading">Parameters:</dt>
1945 <span class="fixedFont"><a href="./String.html#constructor" roo:cls="String.html#constructor">String</a></span> <b>id</b>
1948 <dd>The value to search for</dd>
1956 <dl class="detailList">
1957 <dt class="heading">Returns:</dt>
1973 <td class="msource">
1975 <a href="./Roo.form.BasicForm.html#constructor" roo:cls="Roo.form.BasicForm.html#constructor">Roo.form.BasicForm</a>
1981 <tr class="method-row config-row-alt0 expandable notInherited">
1982 <td class="micon"><a class="exi" href="#expand"> </a></td>
1986 <a id="Roo.form.Form-method-findbyId" name=".findbyId"></a>
1987 <div class="fixedFont">
1988 <span class="attributes"></span><b class="itemname">findbyId</b>
1990 (<a href="./String.html#constructor" roo:cls="String.html#constructor">String</a> <B><i>id</i></B>)
2005 <div class="short">Find any element that has been added to a form, using it's ID or name<br/>This can include framesets, columns etc.</div>
2011 Find any element that has been added to a form, using it's ID or name<br/>This can include framesets, columns etc. along with regular fields..
2018 <dl class="detailList">
2019 <dt class="heading">Parameters:</dt>
2022 <span class="fixedFont"><a href="./String.html#constructor" roo:cls="String.html#constructor">String</a></span> <b>id</b>
2025 <dd>- id or name to find.</dd>
2033 <dl class="detailList">
2034 <dt class="heading">Returns:</dt>
2036 <dd><span class="fixedFont">Element</span> e - or false if nothing found.</dd>
2050 <td class="msource">
2058 <tr class="method-row config-row-alt1 expandable">
2059 <td class="micon"><a class="exi" href="#expand"> </a></td>
2063 <a id="Roo.util.Observable-method-fireEvent" name=".fireEvent"></a>
2064 <div class="fixedFont">
2065 <span class="attributes"></span><b class="itemname">fireEvent</b>
2067 (<a href="./String.html#constructor" roo:cls="String.html#constructor">String</a> <B><i>eventName</i></B>, <a href="http://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference:Global_Objects:Object">Object...</a> <B><i>args</i></B>)
2073 <a href="http://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference:Global_Objects:Boolean">Boolean</a>
2082 <div class="short">Fires the specified event with the passed parameters (minus the event name).</div>
2088 Fires the specified event with the passed parameters (minus the event name).
2095 <dl class="detailList">
2096 <dt class="heading">Parameters:</dt>
2099 <span class="fixedFont"><a href="./String.html#constructor" roo:cls="String.html#constructor">String</a></span> <b>eventName</b>
2105 <span class="fixedFont"><a href="http://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference:Global_Objects:Object">Object...</a></span> <b>args</b>
2108 <dd>Variable number of parameters are passed to handlers</dd>
2116 <dl class="detailList">
2117 <dt class="heading">Returns:</dt>
2119 <dd><span class="fixedFont"><a href="http://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference:Global_Objects:Boolean">Boolean</a></span> returns false if any of the handlers return false otherwise it returns true</dd>
2133 <td class="msource">
2135 <a href="./Roo.util.Observable.html#constructor" roo:cls="Roo.util.Observable.html#constructor">Roo.util.Observable</a>
2141 <tr class="method-row config-row-alt0 expandable">
2142 <td class="micon"><a class="exi" href="#expand"> </a></td>
2146 <a id="Roo.form.BasicForm-method-getFieldValues" name=".getFieldValues"></a>
2147 <div class="fixedFont">
2148 <span class="attributes"></span><b class="itemname">getFieldValues</b>
2156 <a href="http://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference:Global_Objects:Object">Object</a>
2165 <div class="short">Returns the fields in this form as an object with key/value pairs.</div>
2171 Returns the fields in this form as an object with key/value pairs. <br/>This differs from getValues as it calls getValue on each child item, rather than using dom data.
2182 <dl class="detailList">
2183 <dt class="heading">Returns:</dt>
2185 <dd><span class="fixedFont"><a href="http://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference:Global_Objects:Object">Object</a></span> </dd>
2199 <td class="msource">
2201 <a href="./Roo.form.BasicForm.html#constructor" roo:cls="Roo.form.BasicForm.html#constructor">Roo.form.BasicForm</a>
2207 <tr class="method-row config-row-alt1 expandable">
2208 <td class="micon"><a class="exi" href="#expand"> </a></td>
2212 <a id="Roo.form.BasicForm-method-getValues" name=".getValues"></a>
2213 <div class="fixedFont">
2214 <span class="attributes"></span><b class="itemname">getValues</b>
2216 (<a href="http://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference:Global_Objects:Boolean">Boolean</a> <B><i>asString</i></B>)
2222 <a href="http://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference:Global_Objects:Object">Object</a>
2231 <div class="short">Returns the fields in this form as an object with key/value pairs.</div>
2237 Returns the fields in this form as an object with key/value pairs. If multiple fields exist with the same name<br/>they are returned as an array.
2244 <dl class="detailList">
2245 <dt class="heading">Parameters:</dt>
2248 <span class="fixedFont"><a href="http://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference:Global_Objects:Boolean">Boolean</a></span> <b>asString</b>
2259 <dl class="detailList">
2260 <dt class="heading">Returns:</dt>
2262 <dd><span class="fixedFont"><a href="http://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference:Global_Objects:Object">Object</a></span> </dd>
2276 <td class="msource">
2278 <a href="./Roo.form.BasicForm.html#constructor" roo:cls="Roo.form.BasicForm.html#constructor">Roo.form.BasicForm</a>
2284 <tr class="method-row config-row-alt0 expandable">
2285 <td class="micon"><a class="exi" href="#expand"> </a></td>
2289 <a id="Roo.util.Observable-method-hasListener" name=".hasListener"></a>
2290 <div class="fixedFont">
2291 <span class="attributes"></span><b class="itemname">hasListener</b>
2293 (<a href="./String.html#constructor" roo:cls="String.html#constructor">String</a> <B><i>eventName</i></B>)
2299 <a href="http://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference:Global_Objects:Boolean">Boolean</a>
2308 <div class="short">Checks to see if this object has any listeners for a specified event</div>
2314 Checks to see if this object has any listeners for a specified event
2321 <dl class="detailList">
2322 <dt class="heading">Parameters:</dt>
2325 <span class="fixedFont"><a href="./String.html#constructor" roo:cls="String.html#constructor">String</a></span> <b>eventName</b>
2328 <dd>The name of the event to check for</dd>
2336 <dl class="detailList">
2337 <dt class="heading">Returns:</dt>
2339 <dd><span class="fixedFont"><a href="http://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference:Global_Objects:Boolean">Boolean</a></span> True if the event is being listened for, else false</dd>
2353 <td class="msource">
2355 <a href="./Roo.util.Observable.html#constructor" roo:cls="Roo.util.Observable.html#constructor">Roo.util.Observable</a>
2361 <tr class="method-row config-row-alt1 expandable">
2362 <td class="micon"><a class="exi" href="#expand"> </a></td>
2366 <a id="Roo.form.BasicForm-method-isDirty" name=".isDirty"></a>
2367 <div class="fixedFont">
2368 <span class="attributes"></span><b class="itemname">isDirty</b>
2385 <div class="short">Returns true if any fields in this form have changed since their original load.</div>
2391 Returns true if any fields in this form have changed since their original load.
2402 <dl class="detailList">
2403 <dt class="heading">Returns:</dt>
2419 <td class="msource">
2421 <a href="./Roo.form.BasicForm.html#constructor" roo:cls="Roo.form.BasicForm.html#constructor">Roo.form.BasicForm</a>
2427 <tr class="method-row config-row-alt0 expandable">
2428 <td class="micon"><a class="exi" href="#expand"> </a></td>
2432 <a id="Roo.form.BasicForm-method-isValid" name=".isValid"></a>
2433 <div class="fixedFont">
2434 <span class="attributes"></span><b class="itemname">isValid</b>
2451 <div class="short">Returns true if client-side validation on the form is successful.</div>
2457 Returns true if client-side validation on the form is successful.
2468 <dl class="detailList">
2469 <dt class="heading">Returns:</dt>
2485 <td class="msource">
2487 <a href="./Roo.form.BasicForm.html#constructor" roo:cls="Roo.form.BasicForm.html#constructor">Roo.form.BasicForm</a>
2493 <tr class="method-row config-row-alt1 expandable">
2494 <td class="micon"><a class="exi" href="#expand"> </a></td>
2498 <a id="Roo.form.BasicForm-method-load" name=".load"></a>
2499 <div class="fixedFont">
2500 <span class="attributes"></span><b class="itemname">load</b>
2502 (<a href="http://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference:Global_Objects:Object">Object</a> <B><i>options</i></B>)
2517 <div class="short">Shortcut to do a load action.</div>
2523 Shortcut to do a load action.
2530 <dl class="detailList">
2531 <dt class="heading">Parameters:</dt>
2534 <span class="fixedFont"><a href="http://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference:Global_Objects:Object">Object</a></span> <b>options</b>
2537 <dd>The options to pass to the action (see {<b>link</b> <b>doAction</b>} for details)</dd>
2545 <dl class="detailList">
2546 <dt class="heading">Returns:</dt>
2548 <dd><span class="fixedFont">BasicForm</span> this</dd>
2562 <td class="msource">
2564 <a href="./Roo.form.BasicForm.html#constructor" roo:cls="Roo.form.BasicForm.html#constructor">Roo.form.BasicForm</a>
2570 <tr class="method-row config-row-alt0 expandable">
2571 <td class="micon"><a class="exi" href="#expand"> </a></td>
2575 <a id="Roo.form.BasicForm-method-loadRecord" name=".loadRecord"></a>
2576 <div class="fixedFont">
2577 <span class="attributes"></span><b class="itemname">loadRecord</b>
2579 (Record <B><i>record</i></B>)
2594 <div class="short">Loads an Roo.data.Record into this form.</div>
2600 Loads an Roo.data.Record into this form.
2607 <dl class="detailList">
2608 <dt class="heading">Parameters:</dt>
2611 <span class="fixedFont">Record</span> <b>record</b>
2614 <dd>The record to load</dd>
2622 <dl class="detailList">
2623 <dt class="heading">Returns:</dt>
2625 <dd><span class="fixedFont">BasicForm</span> this</dd>
2639 <td class="msource">
2641 <a href="./Roo.form.BasicForm.html#constructor" roo:cls="Roo.form.BasicForm.html#constructor">Roo.form.BasicForm</a>
2647 <tr class="method-row config-row-alt1 expandable">
2648 <td class="micon"><a class="exi" href="#expand"> </a></td>
2652 <a id="Roo.form.BasicForm-method-markInvalid" name=".markInvalid"></a>
2653 <div class="fixedFont">
2654 <span class="attributes"></span><b class="itemname">markInvalid</b>
2656 (<a href="./Array.html#constructor" roo:cls="Array.html#constructor">Array</a>/Object <B><i>errors</i></B>)
2671 <div class="short">Mark fields in this form invalid in bulk.</div>
2677 Mark fields in this form invalid in bulk.
2684 <dl class="detailList">
2685 <dt class="heading">Parameters:</dt>
2688 <span class="fixedFont"><a href="./Array.html#constructor" roo:cls="Array.html#constructor">Array</a>/Object</span> <b>errors</b>
2691 <dd>Either an array in the form [{id:'fieldId', msg:'The message'},...] or an object hash of {id: msg, id2: msg2}</dd>
2699 <dl class="detailList">
2700 <dt class="heading">Returns:</dt>
2702 <dd><span class="fixedFont">BasicForm</span> this</dd>
2716 <td class="msource">
2718 <a href="./Roo.form.BasicForm.html#constructor" roo:cls="Roo.form.BasicForm.html#constructor">Roo.form.BasicForm</a>
2724 <tr class="method-row config-row-alt0 expandable">
2725 <td class="micon"><a class="exi" href="#expand"> </a></td>
2729 <a id="Roo.util.Observable-method-on" name=".on"></a>
2730 <div class="fixedFont">
2731 <span class="attributes"></span><b class="itemname">on</b>
2733 (<a href="./String.html#constructor" roo:cls="String.html#constructor">String</a> <B><i>eventName</i></B>, <a href="./Function.html#constructor" roo:cls="Function.html#constructor">Function</a> <B><i>handler</i></B>, <a href="http://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference:Global_Objects:Object">Object</a> <B><i>scope</i></B>, <a href="http://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference:Global_Objects:Object">Object</a> <B><i>options</i></B>)
2740 <div class="short">Appends an event handler to this element (shorthand for addListener)</div>
2746 Appends an event handler to this element (shorthand for addListener)
2753 <dl class="detailList">
2754 <dt class="heading">Parameters:</dt>
2757 <span class="fixedFont"><a href="./String.html#constructor" roo:cls="String.html#constructor">String</a></span> <b>eventName</b>
2760 <dd>The type of event to listen for</dd>
2763 <span class="fixedFont"><a href="./Function.html#constructor" roo:cls="Function.html#constructor">Function</a></span> <b>handler</b>
2766 <dd>The method the event invokes</dd>
2769 <span class="fixedFont"><a href="http://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference:Global_Objects:Object">Object</a></span> <b>scope</b>
2772 <dd>(optional) The scope in which to execute the handler<br/>function. The handler function's "this" context.</dd>
2775 <span class="fixedFont"><a href="http://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference:Global_Objects:Object">Object</a></span> <b>options</b>
2796 <td class="msource">
2798 <a href="./Roo.util.Observable.html#constructor" roo:cls="Roo.util.Observable.html#constructor">Roo.util.Observable</a>
2804 <tr class="method-row config-row-alt1 expandable">
2805 <td class="micon"><a class="exi" href="#expand"> </a></td>
2809 <a id="Roo.util.Observable-method-purgeListeners" name=".purgeListeners"></a>
2810 <div class="fixedFont">
2811 <span class="attributes"></span><b class="itemname">purgeListeners</b>
2820 <div class="short">Removes all listeners for this object</div>
2826 Removes all listeners for this object
2847 <td class="msource">
2849 <a href="./Roo.util.Observable.html#constructor" roo:cls="Roo.util.Observable.html#constructor">Roo.util.Observable</a>
2855 <tr class="method-row config-row-alt0 expandable">
2856 <td class="micon"><a class="exi" href="#expand"> </a></td>
2860 <a id="Roo.form.BasicForm-method-remove" name=".remove"></a>
2861 <div class="fixedFont">
2862 <span class="attributes"></span><b class="itemname">remove</b>
2864 (Field <B><i>field</i></B>)
2879 <div class="short">Removes a field from the items collection (does NOT remove its markup).</div>
2885 Removes a field from the items collection (does NOT remove its markup).
2892 <dl class="detailList">
2893 <dt class="heading">Parameters:</dt>
2896 <span class="fixedFont">Field</span> <b>field</b>
2907 <dl class="detailList">
2908 <dt class="heading">Returns:</dt>
2910 <dd><span class="fixedFont">BasicForm</span> this</dd>
2924 <td class="msource">
2926 <a href="./Roo.form.BasicForm.html#constructor" roo:cls="Roo.form.BasicForm.html#constructor">Roo.form.BasicForm</a>
2932 <tr class="method-row config-row-alt1 expandable">
2933 <td class="micon"><a class="exi" href="#expand"> </a></td>
2937 <a id="Roo.util.Observable-method-removeListener" name=".removeListener"></a>
2938 <div class="fixedFont">
2939 <span class="attributes"></span><b class="itemname">removeListener</b>
2941 (<a href="./String.html#constructor" roo:cls="String.html#constructor">String</a> <B><i>eventName</i></B>, <a href="./Function.html#constructor" roo:cls="Function.html#constructor">Function</a> <B><i>handler</i></B>, <a href="http://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference:Global_Objects:Object">Object</a> <B><i>scope</i></B>)
2948 <div class="short">Removes a listener</div>
2961 <dl class="detailList">
2962 <dt class="heading">Parameters:</dt>
2965 <span class="fixedFont"><a href="./String.html#constructor" roo:cls="String.html#constructor">String</a></span> <b>eventName</b>
2968 <dd>The type of event to listen for</dd>
2971 <span class="fixedFont"><a href="./Function.html#constructor" roo:cls="Function.html#constructor">Function</a></span> <b>handler</b>
2974 <dd>The handler to remove</dd>
2977 <span class="fixedFont"><a href="http://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference:Global_Objects:Object">Object</a></span> <b>scope</b>
2980 <dd>(optional) The scope (this object) for the handler</dd>
2998 <td class="msource">
3000 <a href="./Roo.util.Observable.html#constructor" roo:cls="Roo.util.Observable.html#constructor">Roo.util.Observable</a>
3006 <tr class="method-row config-row-alt0 expandable notInherited">
3007 <td class="micon"><a class="exi" href="#expand"> </a></td>
3011 <a id="Roo.form.Form-method-render" name=".render"></a>
3012 <div class="fixedFont">
3013 <span class="attributes"></span><b class="itemname">render</b>
3015 (<a href="./String.html#constructor" roo:cls="String.html#constructor">String</a>/HTMLElement/Element <B><i>container</i></B>)
3030 <div class="short">Render this form into the passed container.</div>
3036 Render this form into the passed container. This should only be called once!
3043 <dl class="detailList">
3044 <dt class="heading">Parameters:</dt>
3047 <span class="fixedFont"><a href="./String.html#constructor" roo:cls="String.html#constructor">String</a>/HTMLElement/Element</span> <b>container</b>
3050 <dd>The element this component should be rendered into</dd>
3058 <dl class="detailList">
3059 <dt class="heading">Returns:</dt>
3061 <dd><span class="fixedFont">Form</span> this</dd>
3075 <td class="msource">
3083 <tr class="method-row config-row-alt1 expandable">
3084 <td class="micon"><a class="exi" href="#expand"> </a></td>
3088 <a id="Roo.form.BasicForm-method-reset" name=".reset"></a>
3089 <div class="fixedFont">
3090 <span class="attributes"></span><b class="itemname">reset</b>
3107 <div class="short">Resets this form.</div>
3124 <dl class="detailList">
3125 <dt class="heading">Returns:</dt>
3127 <dd><span class="fixedFont">BasicForm</span> this</dd>
3141 <td class="msource">
3143 <a href="./Roo.form.BasicForm.html#constructor" roo:cls="Roo.form.BasicForm.html#constructor">Roo.form.BasicForm</a>
3149 <tr class="method-row config-row-alt0 expandable">
3150 <td class="micon"><a class="exi" href="#expand"> </a></td>
3154 <a id="Roo.form.BasicForm-method-setValues" name=".setValues"></a>
3155 <div class="fixedFont">
3156 <span class="attributes"></span><b class="itemname">setValues</b>
3158 (<a href="./Array.html#constructor" roo:cls="Array.html#constructor">Array</a>/Object <B><i>values</i></B>)
3173 <div class="short">Set values for fields in this form in bulk.</div>
3179 Set values for fields in this form in bulk.
3186 <dl class="detailList">
3187 <dt class="heading">Parameters:</dt>
3190 <span class="fixedFont"><a href="./Array.html#constructor" roo:cls="Array.html#constructor">Array</a>/Object</span> <b>values</b>
3193 <dd>Either an array in the form [{id:'fieldId', value:'foo'},...] or an object hash of {id: value, id2: value2}</dd>
3201 <dl class="detailList">
3202 <dt class="heading">Returns:</dt>
3204 <dd><span class="fixedFont">BasicForm</span> this</dd>
3218 <td class="msource">
3220 <a href="./Roo.form.BasicForm.html#constructor" roo:cls="Roo.form.BasicForm.html#constructor">Roo.form.BasicForm</a>
3226 <tr class="method-row config-row-alt1 expandable notInherited">
3227 <td class="micon"><a class="exi" href="#expand"> </a></td>
3231 <a id="Roo.form.Form-method-start" name=".start"></a>
3232 <div class="fixedFont">
3233 <span class="attributes"></span><b class="itemname">start</b>
3235 (<a href="http://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference:Global_Objects:Object">Object</a> <B><i>container</i></B>)
3250 <div class="short">Opens the passed container in the layout stack.</div>
3256 Opens the passed container in the layout stack. The container can be any {<b>link</b> Roo.form.Layout} or subclass.
3263 <dl class="detailList">
3264 <dt class="heading">Parameters:</dt>
3267 <span class="fixedFont"><a href="http://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference:Global_Objects:Object">Object</a></span> <b>container</b>
3270 <dd>A Roo.form.Layout or subclass of Layout</dd>
3278 <dl class="detailList">
3279 <dt class="heading">Returns:</dt>
3281 <dd><span class="fixedFont">Form</span> this</dd>
3295 <td class="msource">
3303 <tr class="method-row config-row-alt0 expandable notInherited">
3304 <td class="micon"><a class="exi" href="#expand"> </a></td>
3308 <a id="Roo.form.Form-method-startMonitoring" name=".startMonitoring"></a>
3309 <div class="fixedFont">
3310 <span class="attributes"></span><b class="itemname">startMonitoring</b>
3319 <div class="short">Starts monitoring of the valid state of this form.</div>
3325 Starts monitoring of the valid state of this form. Usually this is done by passing the config<br/>option "monitorValid"
3346 <td class="msource">
3354 <tr class="method-row config-row-alt1 expandable notInherited">
3355 <td class="micon"><a class="exi" href="#expand"> </a></td>
3359 <a id="Roo.form.Form-method-stopMonitoring" name=".stopMonitoring"></a>
3360 <div class="fixedFont">
3361 <span class="attributes"></span><b class="itemname">stopMonitoring</b>
3370 <div class="short">Stops monitoring of the valid state of this form</div>
3376 Stops monitoring of the valid state of this form
3397 <td class="msource">
3405 <tr class="method-row config-row-alt0 expandable">
3406 <td class="micon"><a class="exi" href="#expand"> </a></td>
3410 <a id="Roo.form.BasicForm-method-submit" name=".submit"></a>
3411 <div class="fixedFont">
3412 <span class="attributes"></span><b class="itemname">submit</b>
3414 (<a href="http://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference:Global_Objects:Object">Object</a> <B><i>options</i></B>)
3429 <div class="short">Shortcut to do a submit action.</div>
3435 Shortcut to do a submit action.
3442 <dl class="detailList">
3443 <dt class="heading">Parameters:</dt>
3446 <span class="fixedFont"><a href="http://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference:Global_Objects:Object">Object</a></span> <b>options</b>
3449 <dd>The options to pass to the action (see {<b>link</b> <b>doAction</b>} for details)</dd>
3457 <dl class="detailList">
3458 <dt class="heading">Returns:</dt>
3460 <dd><span class="fixedFont">BasicForm</span> this</dd>
3474 <td class="msource">
3476 <a href="./Roo.form.BasicForm.html#constructor" roo:cls="Roo.form.BasicForm.html#constructor">Roo.form.BasicForm</a>
3482 <tr class="method-row config-row-alt1 expandable">
3483 <td class="micon"><a class="exi" href="#expand"> </a></td>
3487 <a id="Roo.util.Observable-method-un" name=".un"></a>
3488 <div class="fixedFont">
3489 <span class="attributes"></span><b class="itemname">un</b>
3491 (<a href="./String.html#constructor" roo:cls="String.html#constructor">String</a> <B><i>eventName</i></B>, <a href="./Function.html#constructor" roo:cls="Function.html#constructor">Function</a> <B><i>handler</i></B>, <a href="http://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference:Global_Objects:Object">Object</a> <B><i>scope</i></B>)
3498 <div class="short">Removes a listener (shorthand for removeListener)</div>
3504 Removes a listener (shorthand for removeListener)
3511 <dl class="detailList">
3512 <dt class="heading">Parameters:</dt>
3515 <span class="fixedFont"><a href="./String.html#constructor" roo:cls="String.html#constructor">String</a></span> <b>eventName</b>
3518 <dd>The type of event to listen for</dd>
3521 <span class="fixedFont"><a href="./Function.html#constructor" roo:cls="Function.html#constructor">Function</a></span> <b>handler</b>
3524 <dd>The handler to remove</dd>
3527 <span class="fixedFont"><a href="http://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference:Global_Objects:Object">Object</a></span> <b>scope</b>
3530 <dd>(optional) The scope (this object) for the handler</dd>
3548 <td class="msource">
3550 <a href="./Roo.util.Observable.html#constructor" roo:cls="Roo.util.Observable.html#constructor">Roo.util.Observable</a>
3556 <tr class="method-row config-row-alt0 expandable">
3557 <td class="micon"><a class="exi" href="#expand"> </a></td>
3561 <a id="Roo.form.BasicForm-method-updateRecord" name=".updateRecord"></a>
3562 <div class="fixedFont">
3563 <span class="attributes"></span><b class="itemname">updateRecord</b>
3565 (Record <B><i>record</i></B>)
3580 <div class="short">Persists the values in this form into the passed Roo.data.Record object in a beginEdit/endEdit block.</div>
3586 Persists the values in this form into the passed Roo.data.Record object in a beginEdit/endEdit block.
3593 <dl class="detailList">
3594 <dt class="heading">Parameters:</dt>
3597 <span class="fixedFont">Record</span> <b>record</b>
3600 <dd>The record to edit</dd>
3608 <dl class="detailList">
3609 <dt class="heading">Returns:</dt>
3611 <dd><span class="fixedFont">BasicForm</span> this</dd>
3625 <td class="msource">
3627 <a href="./Roo.form.BasicForm.html#constructor" roo:cls="Roo.form.BasicForm.html#constructor">Roo.form.BasicForm</a>
3636 <!-- ============================== events summary / details ======================== -->
3639 <a id="Roo.form.Form-events"></a>
3648 <table cellspacing="0" class="member-table">
3649 <caption>Events</caption>
3652 <th class="sig-header" colspan="2">Event</th>
3653 <th class="msource-header">Defined By</th>
3662 <tr class="method-row expandable config-row-alt0">
3663 <td class="micon"><a class="exi" href="#expand"> </a></td>
3666 <a id="Roo.form.BasicForm-event-*actioncomplete"></a>
3668 <div class="fixedFont">
3669 <b class="itemname">actioncomplete</b> (Form <B><i>this</i></B>, Action <B><i>action</i></B>)
3675 <div class="short">Fires when an action is completed.
3681 Fires when an action is completed.
3687 <dl class="detailList">
3688 <dt class="heading">Parameters:</dt>
3691 <span class="fixedFont">Form</span> <b>this</b>
3697 <span class="fixedFont">Action</span> <b>action</b>
3700 <dd>The action that completed</dd>
3718 <td class="msource">
3719 <a href="./Roo.form.BasicForm.html#constructor" roo:cls="Roo.form.BasicForm.html#constructor">Roo.form.BasicForm</a>
3723 <tr class="method-row expandable config-row-alt1">
3724 <td class="micon"><a class="exi" href="#expand"> </a></td>
3727 <a id="Roo.form.BasicForm-event-*actionfailed"></a>
3729 <div class="fixedFont">
3730 <b class="itemname">actionfailed</b> (Form <B><i>this</i></B>, Action <B><i>action</i></B>)
3736 <div class="short">Fires when an action fails.
3742 Fires when an action fails.
3748 <dl class="detailList">
3749 <dt class="heading">Parameters:</dt>
3752 <span class="fixedFont">Form</span> <b>this</b>
3758 <span class="fixedFont">Action</span> <b>action</b>
3761 <dd>The action that failed</dd>
3779 <td class="msource">
3780 <a href="./Roo.form.BasicForm.html#constructor" roo:cls="Roo.form.BasicForm.html#constructor">Roo.form.BasicForm</a>
3784 <tr class="method-row expandable config-row-alt0">
3785 <td class="micon"><a class="exi" href="#expand"> </a></td>
3788 <a id="Roo.form.BasicForm-event-*beforeaction"></a>
3790 <div class="fixedFont">
3791 <b class="itemname">beforeaction</b> (Form <B><i>this</i></B>, Action <B><i>action</i></B>)
3797 <div class="short">Fires before any action is performed.
3803 Fires before any action is performed. Return false to cancel the action.
3809 <dl class="detailList">
3810 <dt class="heading">Parameters:</dt>
3813 <span class="fixedFont">Form</span> <b>this</b>
3819 <span class="fixedFont">Action</span> <b>action</b>
3822 <dd>The action to be performed</dd>
3840 <td class="msource">
3841 <a href="./Roo.form.BasicForm.html#constructor" roo:cls="Roo.form.BasicForm.html#constructor">Roo.form.BasicForm</a>
3845 <tr class="method-row expandable config-row-alt1 notInherited">
3846 <td class="micon"><a class="exi" href="#expand"> </a></td>
3849 <a id="Roo.form.Form-event-*clientvalidation"></a>
3851 <div class="fixedFont">
3852 <b class="itemname">clientvalidation</b> (Form <B><i>this</i></B>, <a href="http://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference:Global_Objects:Boolean">Boolean</a> <B><i>valid</i></B>)
3858 <div class="short">If the monitorValid config option is true, this event fires repetitively to notify of valid state
3864 If the monitorValid config option is true, this event fires repetitively to notify of valid state
3870 <dl class="detailList">
3871 <dt class="heading">Parameters:</dt>
3874 <span class="fixedFont">Form</span> <b>this</b>
3880 <span class="fixedFont"><a href="http://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference:Global_Objects:Boolean">Boolean</a></span> <b>valid</b>
3883 <dd>true if the form has passed client-side validation</dd>
3901 <td class="msource">
3906 <tr class="method-row expandable config-row-alt0 notInherited">
3907 <td class="micon"><a class="exi" href="#expand"> </a></td>
3910 <a id="Roo.form.Form-event-*rendered"></a>
3912 <div class="fixedFont">
3913 <b class="itemname">rendered</b> (<a href="./Roo.form.Form.html#constructor" roo:cls="Roo.form.Form.html#constructor">Roo.form.Form</a> <B><i>form</i></B>)
3919 <div class="short">Fires when the form is rendered
3925 Fires when the form is rendered
3931 <dl class="detailList">
3932 <dt class="heading">Parameters:</dt>
3935 <span class="fixedFont"><a href="./Roo.form.Form.html#constructor" roo:cls="Roo.form.Form.html#constructor">Roo.form.Form</a></span> <b>form</b>
3956 <td class="msource">
3968 <!-- ============================== footer ================================= -->
3969 <div class="fineprint" style="clear:both">
3971 Documentation generated by <a href="http://www.akbkhome.com" target="_blankt">Introspection Doc Generator</a> on Fri Apr 15 2016 15:47:51 GMT+0800 (HKT)
3973 <a href="http://www.jsdoctoolkit.org/" target="_blank">JsDoc Toolkit</a>