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.BasicForm</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.BasicForm-props"><img src="resources/s.gif" class="item-icon icon-prop">Properties</a>
35 <a class="inner-link" href="#Roo.form.BasicForm-methods"><img src="resources/s.gif" class="item-icon icon-method">Methods</a>
36 <a class="inner-link" href="#Roo.form.BasicForm-events"><img src="resources/s.gif" class="item-icon icon-event">Events</a>
37 <a class="inner-link" href="#Roo.form.BasicForm-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 class="elbow" src="../../images/default/tree/elbow-end.gif"/>Roo.form.BasicForm
52 <!-- ============================== class title / details ============================ -->
55 <h1 class="classTitle">
57 Class Roo.form.BasicForm
60 <table cellspacing="0" class="class-summary-table">
62 <tr><td class="label">Package:</td><td class="hd-info">Roo.form</td></tr>
64 <tr><td class="label">Defined In:</td><td class="hd-info">
66 <a href="./src/Roo_form_BasicForm.js.html">Roo/form/BasicForm.js</a>.
69 <tr><td class="label">Class:</td><td class="hd-info">BasicForm</td></tr>
72 <tr><td class="label">Subclasses:</td><td class="hd-info">
73 <a href="./Roo.form.Form.html#constructor" roo:cls="Roo.form.Form.html#constructor">Roo.form.Form</a>
81 <tr><td class="label">Extends:</td><td class="hd-info">
82 <a href="./Roo.util.Observable.html#constructor" roo:cls="Roo.util.Observable.html#constructor">Roo.util.Observable</a>
90 <!-- ============================== class summary ========================== -->
91 <div class="description">
92 Supplies the functionality to do "actions" on forms and initialize Roo.form.Field types on existing markup.
96 <!-- ============================== Class comment block... ========================== -->
98 <div class="comments">
99 <b>Class Comments / Notes</B> =>
100 <u onclick="parent.CommentDialog.showCommentId = 'Roo.form.BasicForm';">[Add Your comment/notes about this class]</u>
102 <iframe frameborder="0" id="comments-Roo.form" style="border: none;width:100%;"
103 src="/blog.php/GtkDjsComments/Roo.form.BasicForm.html"></iframe>
108 <!-- ============================== config options ========================== -->
113 <div class="hr"></div>
114 <a id="Roo.form.BasicForm-configs"></a>
120 <table cellspacing="0" class="member-table">
121 <caption>Config Options (Usually are also Properties)</caption>
125 <th class="sig-header" colspan="2">Options</th>
127 <th class="msource-header">Defined By</th>
134 <tr class="config-row expandable config-row-alt0 notInherited">
135 <td class="micon"><a class="exi" href="#expand"> </a></td>
138 <a id="Roo.form.BasicForm-cfg-baseParams" name=".baseParams"></a>
139 <div class="fixedFont">
140 <b class="itemname">baseParams</b> : <a href="http://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference:Global_Objects:Object">Object</a>
146 <div class="short">Parameters to pass with all requests.</div>
151 Parameters to pass with all requests. e.g. baseParams: {id: '123', foo: 'bar'}.
167 <tr class="config-row expandable config-row-alt1 notInherited">
168 <td class="micon"><a class="exi" href="#expand"> </a></td>
171 <a id="Roo.form.BasicForm-cfg-errorReader" name=".errorReader"></a>
172 <div class="fixedFont">
173 <b class="itemname">errorReader</b> : DataReader
179 <div class="short">An Roo.data.DataReader (e.g.</div>
184 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.
200 <tr class="config-row expandable config-row-alt0 notInherited">
201 <td class="micon"><a class="exi" href="#expand"> </a></td>
204 <a id="Roo.form.BasicForm-cfg-fileUpload" name=".fileUpload"></a>
205 <div class="fixedFont">
206 <b class="itemname">fileUpload</b> : <a href="http://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference:Global_Objects:Boolean">Boolean</a>
212 <div class="short">Set to true if this form is a file upload.</div>
217 Set to true if this form is a file upload.
233 <tr class="config-row expandable config-row-alt1">
234 <td class="micon"><a class="exi" href="#expand"> </a></td>
237 <a id="Roo.util.Observable-cfg-listeners" name=".listeners"></a>
238 <div class="fixedFont">
239 <b class="itemname">listeners</b> : <a href="http://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference:Global_Objects:Object">Object</a>
245 <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>
250 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>
260 <a href="./Roo.util.Observable.html#constructor" roo:cls="Roo.util.Observable.html#constructor">Roo.util.Observable</a>
266 <tr class="config-row expandable config-row-alt0 notInherited">
267 <td class="micon"><a class="exi" href="#expand"> </a></td>
270 <a id="Roo.form.BasicForm-cfg-method" name=".method"></a>
271 <div class="fixedFont">
272 <b class="itemname">method</b> : <a href="./String.html#constructor" roo:cls="String.html#constructor">String</a>
278 <div class="short">The request method to use (GET or POST) for form actions if one isn't supplied in the action options.</div>
283 The request method to use (GET or POST) for form actions if one isn't supplied in the action options.
299 <tr class="config-row expandable config-row-alt1 notInherited">
300 <td class="micon"><a class="exi" href="#expand"> </a></td>
303 <a id="Roo.form.BasicForm-cfg-reader" name=".reader"></a>
304 <div class="fixedFont">
305 <b class="itemname">reader</b> : DataReader
311 <div class="short">An Roo.data.DataReader (e.g.</div>
316 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.
332 <tr class="config-row expandable config-row-alt0 notInherited">
333 <td class="micon"><a class="exi" href="#expand"> </a></td>
336 <a id="Roo.form.BasicForm-cfg-timeout" name=".timeout"></a>
337 <div class="fixedFont">
338 <b class="itemname">timeout</b> : <a href="./Number.html#constructor" roo:cls="Number.html#constructor">Number</a>
344 <div class="short">Timeout for form actions in seconds (default is 30 seconds).</div>
349 Timeout for form actions in seconds (default is 30 seconds).
365 <tr class="config-row expandable config-row-alt1 notInherited">
366 <td class="micon"><a class="exi" href="#expand"> </a></td>
369 <a id="Roo.form.BasicForm-cfg-trackResetOnLoad" name=".trackResetOnLoad"></a>
370 <div class="fixedFont">
371 <b class="itemname">trackResetOnLoad</b> : <a href="http://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference:Global_Objects:Boolean">Boolean</a>
377 <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>
382 If set to true, form.reset() resets to the last loaded<br/>or setValues() data instead of when the form was first created.
398 <tr class="config-row expandable config-row-alt0 notInherited">
399 <td class="micon"><a class="exi" href="#expand"> </a></td>
402 <a id="Roo.form.BasicForm-cfg-url" name=".url"></a>
403 <div class="fixedFont">
404 <b class="itemname">url</b> : <a href="./String.html#constructor" roo:cls="String.html#constructor">String</a>
410 <div class="short">The URL to use for form actions if one isn't supplied in the action options.</div>
415 The URL to use for form actions if one isn't supplied in the action options.
441 <!-- ============================== public properties ==================== -->
445 <a id="Roo.form.BasicForm-props"></a>
451 <table cellspacing="0" class="member-table">
452 <caption class="Empty">Public Properties - Has None</caption>
458 <!-- ============================== methods summary / details ======================== -->
461 <a id="Roo.form.BasicForm-methods"></a>
462 <!-- constructor?? -->
469 <!-- then dynamics first -->
476 <table cellspacing="0" class="member-table">
477 <caption>Public Methods</caption>
479 <th class="sig-header" colspan="2">Method</th>
480 <th class="msource-header">Defined By</th>
490 <tr class="method-row config-row-alt0 expandable notInherited">
491 <td class="micon"><a class="exi" href="#expand"> </a></td>
495 <a id="Roo.form-method-BasicForm" name=".BasicForm"></a>
496 <div class="fixedFont">
497 <span class="attributes">new <B>Roo.form.</B></span><b class="itemname">BasicForm</b>
499 (<a href="./String.html#constructor" roo:cls="String.html#constructor">String</a>/HTMLElement/Roo.Element <B><i>el</i></B>, <a href="http://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference:Global_Objects:Object">Object</a> <B><i>config</i></B>)
507 <div class="short">Create a new Roo.form.BasicForm</div>
514 Create a new Roo.form.BasicForm
517 <dl class="detailList">
518 <dt class="heading">Parameters:</dt>
521 <span class="fixedFont"><a href="./String.html#constructor" roo:cls="String.html#constructor">String</a>/HTMLElement/Roo.Element</span> <b>el</b>
524 <dd>The form element or its id</dd>
527 <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>
530 <dd>Configuration options</dd>
554 <tr class="method-row config-row-alt1 expandable notInherited">
555 <td class="micon"><a class="exi" href="#expand"> </a></td>
559 <a id="Roo.form.BasicForm-method-add" name=".add"></a>
560 <div class="fixedFont">
561 <span class="attributes"></span><b class="itemname">add</b>
563 (Field <B><i>field1</i></B>, Field <B><i>field2</i></B>, Field <B><i>etc</i></B>)
578 <div class="short">Add Roo.form components to this form.</div>
584 Add Roo.form components to this form.
591 <dl class="detailList">
592 <dt class="heading">Parameters:</dt>
595 <span class="fixedFont">Field</span> <b>field1</b>
601 <span class="fixedFont">Field</span> <b>field2</b>
607 <span class="fixedFont">Field</span> <b>etc</b>
618 <dl class="detailList">
619 <dt class="heading">Returns:</dt>
621 <dd><span class="fixedFont">BasicForm</span> this</dd>
643 <tr class="method-row config-row-alt0 expandable">
644 <td class="micon"><a class="exi" href="#expand"> </a></td>
648 <a id="Roo.util.Observable-method-addEvents" name=".addEvents"></a>
649 <div class="fixedFont">
650 <span class="attributes"></span><b class="itemname">addEvents</b>
652 (<a href="http://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference:Global_Objects:Object">Object</a> <B><i>object</i></B>)
659 <div class="short">Used to define events on this Observable</div>
665 Used to define events on this Observable
672 <dl class="detailList">
673 <dt class="heading">Parameters:</dt>
676 <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>
679 <dd>The object with the events defined</dd>
699 <a href="./Roo.util.Observable.html#constructor" roo:cls="Roo.util.Observable.html#constructor">Roo.util.Observable</a>
705 <tr class="method-row config-row-alt1 expandable notInherited">
706 <td class="micon"><a class="exi" href="#expand"> </a></td>
710 <a id="Roo.form.BasicForm-method-addForm" name=".addForm"></a>
711 <div class="fixedFont">
712 <span class="attributes"></span><b class="itemname">addForm</b>
714 (<a href="./Roo.form.Form.html#constructor" roo:cls="Roo.form.Form.html#constructor">Roo.form.Form</a> <B><i>form</i></B>)
721 <div class="short">Add a secondary form to this one, <br/>Used to provide tabbed forms.</div>
727 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.
734 <dl class="detailList">
735 <dt class="heading">Parameters:</dt>
738 <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>
767 <tr class="method-row config-row-alt0 expandable">
768 <td class="micon"><a class="exi" href="#expand"> </a></td>
772 <a id="Roo.util.Observable-method-addListener" name=".addListener"></a>
773 <div class="fixedFont">
774 <span class="attributes"></span><b class="itemname">addListener</b>
776 (<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>)
783 <div class="short">Appends an event handler to this component</div>
789 Appends an event handler to this component
796 <dl class="detailList">
797 <dt class="heading">Parameters:</dt>
800 <span class="fixedFont"><a href="./String.html#constructor" roo:cls="String.html#constructor">String</a></span> <b>eventName</b>
803 <dd>The type of event to listen for</dd>
806 <span class="fixedFont"><a href="./Function.html#constructor" roo:cls="Function.html#constructor">Function</a></span> <b>handler</b>
809 <dd>The method the event invokes</dd>
812 <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>
815 <dd>(optional) The scope in which to execute the handler<br/>function. The handler function's "this" context.</dd>
818 <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>
821 <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>
841 <a href="./Roo.util.Observable.html#constructor" roo:cls="Roo.util.Observable.html#constructor">Roo.util.Observable</a>
847 <tr class="method-row config-row-alt1 expandable notInherited">
848 <td class="micon"><a class="exi" href="#expand"> </a></td>
852 <a id="Roo.form.BasicForm-method-applyIfToFields" name=".applyIfToFields"></a>
853 <div class="fixedFont">
854 <span class="attributes"></span><b class="itemname">applyIfToFields</b>
856 (<a href="http://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference:Global_Objects:Object">Object</a> <B><i>values</i></B>)
871 <div class="short">Calls {<b>link</b> Ext<b>applyIf</b>} for all field in this form with the passed object.</div>
877 Calls {<b>link</b> Ext<b>applyIf</b>} for all field in this form with the passed object.
884 <dl class="detailList">
885 <dt class="heading">Parameters:</dt>
888 <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>
899 <dl class="detailList">
900 <dt class="heading">Returns:</dt>
902 <dd><span class="fixedFont">BasicForm</span> this</dd>
924 <tr class="method-row config-row-alt0 expandable notInherited">
925 <td class="micon"><a class="exi" href="#expand"> </a></td>
929 <a id="Roo.form.BasicForm-method-applyToFields" name=".applyToFields"></a>
930 <div class="fixedFont">
931 <span class="attributes"></span><b class="itemname">applyToFields</b>
933 (<a href="http://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference:Global_Objects:Object">Object</a> <B><i>values</i></B>)
948 <div class="short">Calls {<b>link</b> Ext<b>apply</b>} for all fields in this form with the passed object.</div>
954 Calls {<b>link</b> Ext<b>apply</b>} for all fields in this form with the passed object.
961 <dl class="detailList">
962 <dt class="heading">Parameters:</dt>
965 <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>
976 <dl class="detailList">
977 <dt class="heading">Returns:</dt>
979 <dd><span class="fixedFont">BasicForm</span> this</dd>
1001 <tr class="method-row config-row-alt1 expandable notInherited">
1002 <td class="micon"><a class="exi" href="#expand"> </a></td>
1006 <a id="Roo.form.BasicForm-method-clearInvalid" name=".clearInvalid"></a>
1007 <div class="fixedFont">
1008 <span class="attributes"></span><b class="itemname">clearInvalid</b>
1025 <div class="short">Clears all invalid messages in this form.</div>
1031 Clears all invalid messages in this form.
1042 <dl class="detailList">
1043 <dt class="heading">Returns:</dt>
1045 <dd><span class="fixedFont">BasicForm</span> this</dd>
1059 <td class="msource">
1067 <tr class="method-row config-row-alt0 expandable notInherited">
1068 <td class="micon"><a class="exi" href="#expand"> </a></td>
1072 <a id="Roo.form.BasicForm-method-doAction" name=".doAction"></a>
1073 <div class="fixedFont">
1074 <span class="attributes"></span><b class="itemname">doAction</b>
1076 (<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>)
1091 <div class="short">Performs a predefined action (submit or load) or custom actions you define on this form.</div>
1097 Performs a predefined action (submit or load) or custom actions you define on this form.
1104 <dl class="detailList">
1105 <dt class="heading">Parameters:</dt>
1108 <span class="fixedFont"><a href="./String.html#constructor" roo:cls="String.html#constructor">String</a></span> <b>actionName</b>
1111 <dd>The name of the action type</dd>
1114 <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>
1117 <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>
1125 <dl class="detailList">
1126 <dt class="heading">Returns:</dt>
1128 <dd><span class="fixedFont">BasicForm</span> this</dd>
1142 <td class="msource">
1150 <tr class="method-row config-row-alt1 expandable notInherited">
1151 <td class="micon"><a class="exi" href="#expand"> </a></td>
1155 <a id="Roo.form.BasicForm-method-findField" name=".findField"></a>
1156 <div class="fixedFont">
1157 <span class="attributes"></span><b class="itemname">findField</b>
1159 (<a href="./String.html#constructor" roo:cls="String.html#constructor">String</a> <B><i>id</i></B>)
1174 <div class="short">Find a Roo.form.Field in this form by id, dataIndex, name or hiddenName</div>
1180 Find a Roo.form.Field in this form by id, dataIndex, name or hiddenName
1187 <dl class="detailList">
1188 <dt class="heading">Parameters:</dt>
1191 <span class="fixedFont"><a href="./String.html#constructor" roo:cls="String.html#constructor">String</a></span> <b>id</b>
1194 <dd>The value to search for</dd>
1202 <dl class="detailList">
1203 <dt class="heading">Returns:</dt>
1219 <td class="msource">
1227 <tr class="method-row config-row-alt0 expandable">
1228 <td class="micon"><a class="exi" href="#expand"> </a></td>
1232 <a id="Roo.util.Observable-method-fireEvent" name=".fireEvent"></a>
1233 <div class="fixedFont">
1234 <span class="attributes"></span><b class="itemname">fireEvent</b>
1236 (<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>)
1242 <a href="http://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference:Global_Objects:Boolean">Boolean</a>
1251 <div class="short">Fires the specified event with the passed parameters (minus the event name).</div>
1257 Fires the specified event with the passed parameters (minus the event name).
1264 <dl class="detailList">
1265 <dt class="heading">Parameters:</dt>
1268 <span class="fixedFont"><a href="./String.html#constructor" roo:cls="String.html#constructor">String</a></span> <b>eventName</b>
1274 <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>
1277 <dd>Variable number of parameters are passed to handlers</dd>
1285 <dl class="detailList">
1286 <dt class="heading">Returns:</dt>
1288 <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>
1302 <td class="msource">
1304 <a href="./Roo.util.Observable.html#constructor" roo:cls="Roo.util.Observable.html#constructor">Roo.util.Observable</a>
1310 <tr class="method-row config-row-alt1 expandable notInherited">
1311 <td class="micon"><a class="exi" href="#expand"> </a></td>
1315 <a id="Roo.form.BasicForm-method-getFieldValues" name=".getFieldValues"></a>
1316 <div class="fixedFont">
1317 <span class="attributes"></span><b class="itemname">getFieldValues</b>
1325 <a href="http://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference:Global_Objects:Object">Object</a>
1334 <div class="short">Returns the fields in this form as an object with key/value pairs.</div>
1340 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.
1351 <dl class="detailList">
1352 <dt class="heading">Returns:</dt>
1354 <dd><span class="fixedFont"><a href="http://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference:Global_Objects:Object">Object</a></span> </dd>
1368 <td class="msource">
1376 <tr class="method-row config-row-alt0 expandable notInherited">
1377 <td class="micon"><a class="exi" href="#expand"> </a></td>
1381 <a id="Roo.form.BasicForm-method-getValues" name=".getValues"></a>
1382 <div class="fixedFont">
1383 <span class="attributes"></span><b class="itemname">getValues</b>
1385 (<a href="http://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference:Global_Objects:Boolean">Boolean</a> <B><i>asString</i></B>)
1391 <a href="http://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference:Global_Objects:Object">Object</a>
1400 <div class="short">Returns the fields in this form as an object with key/value pairs.</div>
1406 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.
1413 <dl class="detailList">
1414 <dt class="heading">Parameters:</dt>
1417 <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>
1428 <dl class="detailList">
1429 <dt class="heading">Returns:</dt>
1431 <dd><span class="fixedFont"><a href="http://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference:Global_Objects:Object">Object</a></span> </dd>
1445 <td class="msource">
1453 <tr class="method-row config-row-alt1 expandable notInherited">
1454 <td class="micon"><a class="exi" href="#expand"> </a></td>
1458 <a id="Roo.form.BasicForm-method-hasChanged" name=".hasChanged"></a>
1459 <div class="fixedFont">
1460 <span class="attributes"></span><b class="itemname">hasChanged</b>
1477 <div class="short">Returns true if any fields in this form have changed since their original load.</div>
1483 Returns true if any fields in this form have changed since their original load. (New version)
1494 <dl class="detailList">
1495 <dt class="heading">Returns:</dt>
1511 <td class="msource">
1519 <tr class="method-row config-row-alt0 expandable">
1520 <td class="micon"><a class="exi" href="#expand"> </a></td>
1524 <a id="Roo.util.Observable-method-hasListener" name=".hasListener"></a>
1525 <div class="fixedFont">
1526 <span class="attributes"></span><b class="itemname">hasListener</b>
1528 (<a href="./String.html#constructor" roo:cls="String.html#constructor">String</a> <B><i>eventName</i></B>)
1534 <a href="http://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference:Global_Objects:Boolean">Boolean</a>
1543 <div class="short">Checks to see if this object has any listeners for a specified event</div>
1549 Checks to see if this object has any listeners for a specified event
1556 <dl class="detailList">
1557 <dt class="heading">Parameters:</dt>
1560 <span class="fixedFont"><a href="./String.html#constructor" roo:cls="String.html#constructor">String</a></span> <b>eventName</b>
1563 <dd>The name of the event to check for</dd>
1571 <dl class="detailList">
1572 <dt class="heading">Returns:</dt>
1574 <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>
1588 <td class="msource">
1590 <a href="./Roo.util.Observable.html#constructor" roo:cls="Roo.util.Observable.html#constructor">Roo.util.Observable</a>
1596 <tr class="method-row config-row-alt1 expandable notInherited">
1597 <td class="micon"><a class="exi" href="#expand"> </a></td>
1601 <a id="Roo.form.BasicForm-method-isDirty" name=".isDirty"></a>
1602 <div class="fixedFont">
1603 <span class="attributes"></span><b class="itemname">isDirty</b>
1620 <div class="short">DEPRICATED Returns true if any fields in this form have changed since their original load.</div>
1626 DEPRICATED Returns true if any fields in this form have changed since their original load.
1637 <dl class="detailList">
1638 <dt class="heading">Returns:</dt>
1654 <td class="msource">
1662 <tr class="method-row config-row-alt0 expandable notInherited">
1663 <td class="micon"><a class="exi" href="#expand"> </a></td>
1667 <a id="Roo.form.BasicForm-method-isValid" name=".isValid"></a>
1668 <div class="fixedFont">
1669 <span class="attributes"></span><b class="itemname">isValid</b>
1686 <div class="short">Returns true if client-side validation on the form is successful.</div>
1692 Returns true if client-side validation on the form is successful.
1703 <dl class="detailList">
1704 <dt class="heading">Returns:</dt>
1720 <td class="msource">
1728 <tr class="method-row config-row-alt1 expandable notInherited">
1729 <td class="micon"><a class="exi" href="#expand"> </a></td>
1733 <a id="Roo.form.BasicForm-method-load" name=".load"></a>
1734 <div class="fixedFont">
1735 <span class="attributes"></span><b class="itemname">load</b>
1737 (<a href="http://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference:Global_Objects:Object">Object</a> <B><i>options</i></B>)
1752 <div class="short">Shortcut to do a load action.</div>
1758 Shortcut to do a load action.
1765 <dl class="detailList">
1766 <dt class="heading">Parameters:</dt>
1769 <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>
1772 <dd>The options to pass to the action (see {<b>link</b> <b>doAction</b>} for details)</dd>
1780 <dl class="detailList">
1781 <dt class="heading">Returns:</dt>
1783 <dd><span class="fixedFont">BasicForm</span> this</dd>
1797 <td class="msource">
1805 <tr class="method-row config-row-alt0 expandable notInherited">
1806 <td class="micon"><a class="exi" href="#expand"> </a></td>
1810 <a id="Roo.form.BasicForm-method-loadRecord" name=".loadRecord"></a>
1811 <div class="fixedFont">
1812 <span class="attributes"></span><b class="itemname">loadRecord</b>
1814 (Record <B><i>record</i></B>)
1829 <div class="short">Loads an Roo.data.Record into this form.</div>
1835 Loads an Roo.data.Record into this form.
1842 <dl class="detailList">
1843 <dt class="heading">Parameters:</dt>
1846 <span class="fixedFont">Record</span> <b>record</b>
1849 <dd>The record to load</dd>
1857 <dl class="detailList">
1858 <dt class="heading">Returns:</dt>
1860 <dd><span class="fixedFont">BasicForm</span> this</dd>
1874 <td class="msource">
1882 <tr class="method-row config-row-alt1 expandable notInherited">
1883 <td class="micon"><a class="exi" href="#expand"> </a></td>
1887 <a id="Roo.form.BasicForm-method-markInvalid" name=".markInvalid"></a>
1888 <div class="fixedFont">
1889 <span class="attributes"></span><b class="itemname">markInvalid</b>
1891 (<a href="./Array.html#constructor" roo:cls="Array.html#constructor">Array</a>/Object <B><i>errors</i></B>)
1906 <div class="short">Mark fields in this form invalid in bulk.</div>
1912 Mark fields in this form invalid in bulk.
1919 <dl class="detailList">
1920 <dt class="heading">Parameters:</dt>
1923 <span class="fixedFont"><a href="./Array.html#constructor" roo:cls="Array.html#constructor">Array</a>/Object</span> <b>errors</b>
1926 <dd>Either an array in the form [{id:'fieldId', msg:'The message'},...] or an object hash of {id: msg, id2: msg2}</dd>
1934 <dl class="detailList">
1935 <dt class="heading">Returns:</dt>
1937 <dd><span class="fixedFont">BasicForm</span> this</dd>
1951 <td class="msource">
1959 <tr class="method-row config-row-alt0 expandable">
1960 <td class="micon"><a class="exi" href="#expand"> </a></td>
1964 <a id="Roo.util.Observable-method-on" name=".on"></a>
1965 <div class="fixedFont">
1966 <span class="attributes"></span><b class="itemname">on</b>
1968 (<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>)
1975 <div class="short">Appends an event handler to this element (shorthand for addListener)</div>
1981 Appends an event handler to this element (shorthand for addListener)
1988 <dl class="detailList">
1989 <dt class="heading">Parameters:</dt>
1992 <span class="fixedFont"><a href="./String.html#constructor" roo:cls="String.html#constructor">String</a></span> <b>eventName</b>
1995 <dd>The type of event to listen for</dd>
1998 <span class="fixedFont"><a href="./Function.html#constructor" roo:cls="Function.html#constructor">Function</a></span> <b>handler</b>
2001 <dd>The method the event invokes</dd>
2004 <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>
2007 <dd>(optional) The scope in which to execute the handler<br/>function. The handler function's "this" context.</dd>
2010 <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>
2031 <td class="msource">
2033 <a href="./Roo.util.Observable.html#constructor" roo:cls="Roo.util.Observable.html#constructor">Roo.util.Observable</a>
2039 <tr class="method-row config-row-alt1 expandable">
2040 <td class="micon"><a class="exi" href="#expand"> </a></td>
2044 <a id="Roo.util.Observable-method-purgeListeners" name=".purgeListeners"></a>
2045 <div class="fixedFont">
2046 <span class="attributes"></span><b class="itemname">purgeListeners</b>
2055 <div class="short">Removes all listeners for this object</div>
2061 Removes all listeners for this object
2082 <td class="msource">
2084 <a href="./Roo.util.Observable.html#constructor" roo:cls="Roo.util.Observable.html#constructor">Roo.util.Observable</a>
2090 <tr class="method-row config-row-alt0 expandable notInherited">
2091 <td class="micon"><a class="exi" href="#expand"> </a></td>
2095 <a id="Roo.form.BasicForm-method-remove" name=".remove"></a>
2096 <div class="fixedFont">
2097 <span class="attributes"></span><b class="itemname">remove</b>
2099 (Field <B><i>field</i></B>)
2114 <div class="short">Removes a field from the items collection (does NOT remove its markup).</div>
2120 Removes a field from the items collection (does NOT remove its markup).
2127 <dl class="detailList">
2128 <dt class="heading">Parameters:</dt>
2131 <span class="fixedFont">Field</span> <b>field</b>
2142 <dl class="detailList">
2143 <dt class="heading">Returns:</dt>
2145 <dd><span class="fixedFont">BasicForm</span> this</dd>
2159 <td class="msource">
2167 <tr class="method-row config-row-alt1 expandable">
2168 <td class="micon"><a class="exi" href="#expand"> </a></td>
2172 <a id="Roo.util.Observable-method-removeListener" name=".removeListener"></a>
2173 <div class="fixedFont">
2174 <span class="attributes"></span><b class="itemname">removeListener</b>
2176 (<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>)
2183 <div class="short">Removes a listener</div>
2196 <dl class="detailList">
2197 <dt class="heading">Parameters:</dt>
2200 <span class="fixedFont"><a href="./String.html#constructor" roo:cls="String.html#constructor">String</a></span> <b>eventName</b>
2203 <dd>The type of event to listen for</dd>
2206 <span class="fixedFont"><a href="./Function.html#constructor" roo:cls="Function.html#constructor">Function</a></span> <b>handler</b>
2209 <dd>The handler to remove</dd>
2212 <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>
2215 <dd>(optional) The scope (this object) for the handler</dd>
2233 <td class="msource">
2235 <a href="./Roo.util.Observable.html#constructor" roo:cls="Roo.util.Observable.html#constructor">Roo.util.Observable</a>
2241 <tr class="method-row config-row-alt0 expandable notInherited">
2242 <td class="micon"><a class="exi" href="#expand"> </a></td>
2246 <a id="Roo.form.BasicForm-method-render" name=".render"></a>
2247 <div class="fixedFont">
2248 <span class="attributes"></span><b class="itemname">render</b>
2265 <div class="short">Looks at the fields in this form, checks them for an id attribute,<br/>and calls applyTo on the existing dom element with that id.</div>
2271 Looks at the fields in this form, checks them for an id attribute,<br/>and calls applyTo on the existing dom element with that id.
2282 <dl class="detailList">
2283 <dt class="heading">Returns:</dt>
2285 <dd><span class="fixedFont">BasicForm</span> this</dd>
2299 <td class="msource">
2307 <tr class="method-row config-row-alt1 expandable notInherited">
2308 <td class="micon"><a class="exi" href="#expand"> </a></td>
2312 <a id="Roo.form.BasicForm-method-reset" name=".reset"></a>
2313 <div class="fixedFont">
2314 <span class="attributes"></span><b class="itemname">reset</b>
2331 <div class="short">Resets this form.</div>
2348 <dl class="detailList">
2349 <dt class="heading">Returns:</dt>
2351 <dd><span class="fixedFont">BasicForm</span> this</dd>
2365 <td class="msource">
2373 <tr class="method-row config-row-alt0 expandable notInherited">
2374 <td class="micon"><a class="exi" href="#expand"> </a></td>
2378 <a id="Roo.form.BasicForm-method-resetHasChanged" name=".resetHasChanged"></a>
2379 <div class="fixedFont">
2380 <span class="attributes"></span><b class="itemname">resetHasChanged</b>
2397 <div class="short">Resets all hasChanged to 'false' -<br/>The old 'isDirty' used 'original value.</div>
2403 Resets all hasChanged to 'false' -<br/>The old 'isDirty' used 'original value..' however this breaks reset() and a few other things.<br/>So hasChanged storage is only to be used for this purpose
2414 <dl class="detailList">
2415 <dt class="heading">Returns:</dt>
2431 <td class="msource">
2439 <tr class="method-row config-row-alt1 expandable notInherited">
2440 <td class="micon"><a class="exi" href="#expand"> </a></td>
2444 <a id="Roo.form.BasicForm-method-setValues" name=".setValues"></a>
2445 <div class="fixedFont">
2446 <span class="attributes"></span><b class="itemname">setValues</b>
2448 (<a href="./Array.html#constructor" roo:cls="Array.html#constructor">Array</a>/Object <B><i>values</i></B>)
2463 <div class="short">Set values for fields in this form in bulk.</div>
2469 Set values for fields in this form in bulk.
2476 <dl class="detailList">
2477 <dt class="heading">Parameters:</dt>
2480 <span class="fixedFont"><a href="./Array.html#constructor" roo:cls="Array.html#constructor">Array</a>/Object</span> <b>values</b>
2483 <dd>Either an array in the form [{id:'fieldId', value:'foo'},...] or an object hash of {id: value, id2: value2}</dd>
2491 <dl class="detailList">
2492 <dt class="heading">Returns:</dt>
2494 <dd><span class="fixedFont">BasicForm</span> this</dd>
2508 <td class="msource">
2516 <tr class="method-row config-row-alt0 expandable notInherited">
2517 <td class="micon"><a class="exi" href="#expand"> </a></td>
2521 <a id="Roo.form.BasicForm-method-submit" name=".submit"></a>
2522 <div class="fixedFont">
2523 <span class="attributes"></span><b class="itemname">submit</b>
2525 (<a href="http://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference:Global_Objects:Object">Object</a> <B><i>options</i></B>)
2540 <div class="short">Shortcut to do a submit action.</div>
2546 Shortcut to do a submit action.
2553 <dl class="detailList">
2554 <dt class="heading">Parameters:</dt>
2557 <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>
2560 <dd>The options to pass to the action (see {<b>link</b> <b>doAction</b>} for details)</dd>
2568 <dl class="detailList">
2569 <dt class="heading">Returns:</dt>
2571 <dd><span class="fixedFont">BasicForm</span> this</dd>
2585 <td class="msource">
2593 <tr class="method-row config-row-alt1 expandable">
2594 <td class="micon"><a class="exi" href="#expand"> </a></td>
2598 <a id="Roo.util.Observable-method-un" name=".un"></a>
2599 <div class="fixedFont">
2600 <span class="attributes"></span><b class="itemname">un</b>
2602 (<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>)
2609 <div class="short">Removes a listener (shorthand for removeListener)</div>
2615 Removes a listener (shorthand for removeListener)
2622 <dl class="detailList">
2623 <dt class="heading">Parameters:</dt>
2626 <span class="fixedFont"><a href="./String.html#constructor" roo:cls="String.html#constructor">String</a></span> <b>eventName</b>
2629 <dd>The type of event to listen for</dd>
2632 <span class="fixedFont"><a href="./Function.html#constructor" roo:cls="Function.html#constructor">Function</a></span> <b>handler</b>
2635 <dd>The handler to remove</dd>
2638 <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>
2641 <dd>(optional) The scope (this object) for the handler</dd>
2659 <td class="msource">
2661 <a href="./Roo.util.Observable.html#constructor" roo:cls="Roo.util.Observable.html#constructor">Roo.util.Observable</a>
2667 <tr class="method-row config-row-alt0 expandable notInherited">
2668 <td class="micon"><a class="exi" href="#expand"> </a></td>
2672 <a id="Roo.form.BasicForm-method-updateRecord" name=".updateRecord"></a>
2673 <div class="fixedFont">
2674 <span class="attributes"></span><b class="itemname">updateRecord</b>
2676 (Record <B><i>record</i></B>)
2691 <div class="short">Persists the values in this form into the passed Roo.data.Record object in a beginEdit/endEdit block.</div>
2697 Persists the values in this form into the passed Roo.data.Record object in a beginEdit/endEdit block.
2704 <dl class="detailList">
2705 <dt class="heading">Parameters:</dt>
2708 <span class="fixedFont">Record</span> <b>record</b>
2711 <dd>The record to edit</dd>
2719 <dl class="detailList">
2720 <dt class="heading">Returns:</dt>
2722 <dd><span class="fixedFont">BasicForm</span> this</dd>
2736 <td class="msource">
2747 <!-- ============================== events summary / details ======================== -->
2750 <a id="Roo.form.BasicForm-events"></a>
2759 <table cellspacing="0" class="member-table">
2760 <caption>Events</caption>
2763 <th class="sig-header" colspan="2">Event</th>
2764 <th class="msource-header">Defined By</th>
2773 <tr class="method-row expandable config-row-alt0 notInherited">
2774 <td class="micon"><a class="exi" href="#expand"> </a></td>
2777 <a id="Roo.form.BasicForm-event-*actioncomplete"></a>
2779 <div class="fixedFont">
2780 <b class="itemname">actioncomplete</b> (Form <B><i>this</i></B>, Action <B><i>action</i></B>)
2786 <div class="short">Fires when an action is completed.
2792 Fires when an action is completed.
2798 <dl class="detailList">
2799 <dt class="heading">Parameters:</dt>
2802 <span class="fixedFont">Form</span> <b>this</b>
2808 <span class="fixedFont">Action</span> <b>action</b>
2811 <dd>The action that completed</dd>
2829 <td class="msource">
2834 <tr class="method-row expandable config-row-alt1 notInherited">
2835 <td class="micon"><a class="exi" href="#expand"> </a></td>
2838 <a id="Roo.form.BasicForm-event-*actionfailed"></a>
2840 <div class="fixedFont">
2841 <b class="itemname">actionfailed</b> (Form <B><i>this</i></B>, Action <B><i>action</i></B>)
2847 <div class="short">Fires when an action fails.
2853 Fires when an action fails.
2859 <dl class="detailList">
2860 <dt class="heading">Parameters:</dt>
2863 <span class="fixedFont">Form</span> <b>this</b>
2869 <span class="fixedFont">Action</span> <b>action</b>
2872 <dd>The action that failed</dd>
2890 <td class="msource">
2895 <tr class="method-row expandable config-row-alt0 notInherited">
2896 <td class="micon"><a class="exi" href="#expand"> </a></td>
2899 <a id="Roo.form.BasicForm-event-*beforeaction"></a>
2901 <div class="fixedFont">
2902 <b class="itemname">beforeaction</b> (Form <B><i>this</i></B>, Action <B><i>action</i></B>)
2908 <div class="short">Fires before any action is performed.
2914 Fires before any action is performed. Return false to cancel the action.
2920 <dl class="detailList">
2921 <dt class="heading">Parameters:</dt>
2924 <span class="fixedFont">Form</span> <b>this</b>
2930 <span class="fixedFont">Action</span> <b>action</b>
2933 <dd>The action to be performed</dd>
2951 <td class="msource">
2963 <!-- ============================== footer ================================= -->
2964 <div class="fineprint" style="clear:both">
2966 Documentation generated by <a href="http://www.akbkhome.com" target="_blankt">Introspection Doc Generator</a> on Fri Jul 13 2018 14:10:54 GMT+0800 (HKT)
2968 <a href="http://www.jsdoctoolkit.org/" target="_blank">JsDoc Toolkit</a>