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.Editor</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.Editor-props"><img src="resources/s.gif" class="item-icon icon-prop">Properties</a>
35 <a class="inner-link" href="#Roo.Editor-methods"><img src="resources/s.gif" class="item-icon icon-method">Methods</a>
36 <a class="inner-link" href="#Roo.Editor-events"><img src="resources/s.gif" class="item-icon icon-event">Events</a>
37 <a class="inner-link" href="#Roo.Editor-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.Component.html#constructor" roo:cls="Roo.Component.html#constructor">Roo.Component</a>
47 <img src="../../images/default/s.gif" height="1" width="20"/><img class="elbow" src="../../images/default/tree/elbow-end.gif"/>Roo.Editor
52 <!-- ============================== class title / details ============================ -->
55 <h1 class="classTitle">
60 <table cellspacing="0" class="class-summary-table">
62 <tr><td class="label">Package:</td><td class="hd-info">Roo</td></tr>
64 <tr><td class="label">Defined In:</td><td class="hd-info">
66 <a href="./src/Roo_Editor.js.html">Roo/Editor.js</a>.
69 <tr><td class="label">Class:</td><td class="hd-info">Editor</td></tr>
74 <tr><td class="label">Extends:</td><td class="hd-info">
75 <a href="./Roo.Component.html#constructor" roo:cls="Roo.Component.html#constructor">Roo.Component</a>
83 <!-- ============================== class summary ========================== -->
84 <div class="description">
85 A base editor field that handles displaying/hiding on demand and has some built-in sizing and event handling logic.
89 <!-- ============================== Class comment block... ========================== -->
91 <div class="comments">
92 <b>Class Comments / Notes</B> =>
93 <u onclick="parent.CommentDialog.showCommentId = 'Roo.Editor';">[Add Your comment/notes about this class]</u>
95 <iframe frameborder="0" id="comments-Roo" style="border: none;width:100%;"
96 src="/blog.php/GtkDjsComments/Roo.Editor.html"></iframe>
101 <!-- ============================== config options ========================== -->
106 <div class="hr"></div>
107 <a id="Roo.Editor-configs"></a>
113 <table cellspacing="0" class="member-table">
114 <caption>Config Options (Usually are also Properties)</caption>
118 <th class="sig-header" colspan="2">Options</th>
120 <th class="msource-header">Defined By</th>
127 <tr class="config-row expandable config-row-alt0 notInherited">
128 <td class="micon"><a class="exi" href="#expand"> </a></td>
131 <a id="Roo.Editor-cfg-alignment" name=".alignment"></a>
132 <div class="fixedFont">
133 <b class="itemname">alignment</b> : <a href="./String.html#constructor" roo:cls="String.html#constructor">String</a>
139 <div class="short">The position to align to (see {<b>link</b> Roo.Element<b>alignTo</b>} for more details, defaults to "c-c?").</div>
143 <div class="long">The position to align to (see {<b>link</b> Roo.Element<b>alignTo</b>} for more details, defaults to "c-c?").</div>
157 <tr class="config-row expandable config-row-alt1 notInherited">
158 <td class="micon"><a class="exi" href="#expand"> </a></td>
161 <a id="Roo.Editor-cfg-autosize" name=".autosize"></a>
162 <div class="fixedFont">
163 <b class="itemname">autosize</b> : <a href="http://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference:Global_Objects:Boolean">Boolean</a>/String
169 <div class="short">True for the editor to automatically adopt the size of the underlying field, "width" to adopt the width only,<br/>or "height" to adopt the height only (defaults to false)</div>
173 <div class="long">True for the editor to automatically adopt the size of the underlying field, "width" to adopt the width only,<br/>or "height" to adopt the height only (defaults to false)</div>
187 <tr class="config-row expandable config-row-alt0 notInherited">
188 <td class="micon"><a class="exi" href="#expand"> </a></td>
191 <a id="Roo.Editor-cfg-cancelOnEsc" name=".cancelOnEsc"></a>
192 <div class="fixedFont">
193 <b class="itemname">cancelOnEsc</b> : <a href="http://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference:Global_Objects:Boolean">Boolean</a>
199 <div class="short">True to cancel the edit when the escape key is pressed (defaults to false)</div>
203 <div class="long">True to cancel the edit when the escape key is pressed (defaults to false)</div>
217 <tr class="config-row expandable config-row-alt1 notInherited">
218 <td class="micon"><a class="exi" href="#expand"> </a></td>
221 <a id="Roo.Editor-cfg-completeOnEnter" name=".completeOnEnter"></a>
222 <div class="fixedFont">
223 <b class="itemname">completeOnEnter</b> : <a href="http://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference:Global_Objects:Boolean">Boolean</a>
229 <div class="short">True to complete the edit when the enter key is pressed (defaults to false)</div>
233 <div class="long">True to complete the edit when the enter key is pressed (defaults to false)</div>
247 <tr class="config-row expandable config-row-alt0 notInherited">
248 <td class="micon"><a class="exi" href="#expand"> </a></td>
251 <a id="Roo.Editor-cfg-constrain" name=".constrain"></a>
252 <div class="fixedFont">
253 <b class="itemname">constrain</b> : <a href="http://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference:Global_Objects:Boolean">Boolean</a>
259 <div class="short">True to constrain the editor to the viewport</div>
263 <div class="long">True to constrain the editor to the viewport</div>
277 <tr class="config-row expandable config-row-alt1 notInherited">
278 <td class="micon"><a class="exi" href="#expand"> </a></td>
281 <a id="Roo.Editor-cfg-hideEl" name=".hideEl"></a>
282 <div class="fixedFont">
283 <b class="itemname">hideEl</b> : <a href="http://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference:Global_Objects:Boolean">Boolean</a>
289 <div class="short">False to keep the bound element visible while the editor is displayed (defaults to true)</div>
293 <div class="long">False to keep the bound element visible while the editor is displayed (defaults to true)</div>
307 <tr class="config-row expandable config-row-alt0 notInherited">
308 <td class="micon"><a class="exi" href="#expand"> </a></td>
311 <a id="Roo.Editor-cfg-ignoreNoChange" name=".ignoreNoChange"></a>
312 <div class="fixedFont">
313 <b class="itemname">ignoreNoChange</b> : <a href="http://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference:Global_Objects:Boolean">Boolean</a>
319 <div class="short">True to skip the the edit completion process (no save, no events fired) if the user completes an edit and<br/>the value has not changed (defaults to false).</div>
323 <div class="long">True to skip the the edit completion process (no save, no events fired) if the user completes an edit and<br/>the value has not changed (defaults to false). Applies only to string values - edits for other data types<br/>will never be ignored.</div>
337 <tr class="config-row expandable config-row-alt1 notInherited">
338 <td class="micon"><a class="exi" href="#expand"> </a></td>
341 <a id="Roo.Editor-cfg-revertInvalid" name=".revertInvalid"></a>
342 <div class="fixedFont">
343 <b class="itemname">revertInvalid</b> : <a href="http://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference:Global_Objects:Boolean">Boolean</a>
349 <div class="short">True to automatically revert the field value and cancel the edit when the user completes an edit and the field<br/>validation fails (defaults to true)</div>
353 <div class="long">True to automatically revert the field value and cancel the edit when the user completes an edit and the field<br/>validation fails (defaults to true)</div>
367 <tr class="config-row expandable config-row-alt0 notInherited">
368 <td class="micon"><a class="exi" href="#expand"> </a></td>
371 <a id="Roo.Editor-cfg-shadow" name=".shadow"></a>
372 <div class="fixedFont">
373 <b class="itemname">shadow</b> : <a href="http://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference:Global_Objects:Boolean">Boolean</a>/String
379 <div class="short">"sides" for sides/bottom only, "frame" for 4-way shadow, and "drop"<br/>for bottom-right shadow (defaults to "frame")</div>
383 <div class="long">"sides" for sides/bottom only, "frame" for 4-way shadow, and "drop"<br/>for bottom-right shadow (defaults to "frame")</div>
397 <tr class="config-row expandable config-row-alt1 notInherited">
398 <td class="micon"><a class="exi" href="#expand"> </a></td>
401 <a id="Roo.Editor-cfg-updateEl" name=".updateEl"></a>
402 <div class="fixedFont">
403 <b class="itemname">updateEl</b> : <a href="http://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference:Global_Objects:Boolean">Boolean</a>
409 <div class="short">True to update the innerHTML of the bound element when the update completes (defaults to false)</div>
413 <div class="long">True to update the innerHTML of the bound element when the update completes (defaults to false)</div>
427 <tr class="config-row expandable config-row-alt0 notInherited">
428 <td class="micon"><a class="exi" href="#expand"> </a></td>
431 <a id="Roo.Editor-cfg-value" name=".value"></a>
432 <div class="fixedFont">
433 <b class="itemname">value</b> : Mixed
439 <div class="short">The data value of the underlying field (defaults to "")</div>
443 <div class="long">The data value of the underlying field (defaults to "")</div>
467 <!-- ============================== public properties ==================== -->
471 <a id="Roo.Editor-props"></a>
477 <table cellspacing="0" class="member-table">
478 <caption class="Empty">Public Properties - Has None</caption>
484 <!-- ============================== methods summary / details ======================== -->
487 <a id="Roo.Editor-methods"></a>
488 <!-- constructor?? -->
495 <!-- then dynamics first -->
502 <table cellspacing="0" class="member-table">
503 <caption>Public Methods</caption>
505 <th class="sig-header" colspan="2">Method</th>
506 <th class="msource-header">Defined By</th>
516 <tr class="method-row config-row-alt0 expandable notInherited">
517 <td class="micon"><a class="exi" href="#expand"> </a></td>
521 <a id="Roo-method-Editor" name=".Editor"></a>
522 <div class="fixedFont">
523 <span class="attributes">new <B>Roo.</B></span><b class="itemname">Editor</b>
525 (<a href="./Roo.form.Field.html#constructor" roo:cls="Roo.form.Field.html#constructor">Roo.form.Field</a> <B><i>field</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>)
533 <div class="short">Create a new Roo.Editor</div>
540 Create a new Roo.Editor
543 <dl class="detailList">
544 <dt class="heading">Parameters:</dt>
547 <span class="fixedFont"><a href="./Roo.form.Field.html#constructor" roo:cls="Roo.form.Field.html#constructor">Roo.form.Field</a></span> <b>field</b>
550 <dd>The Field object (or descendant)</dd>
553 <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>
556 <dd>The config object</dd>
580 <tr class="method-row config-row-alt1 expandable notInherited">
581 <td class="micon"><a class="exi" href="#expand"> </a></td>
585 <a id="Roo.Editor-method-cancelEdit" name=".cancelEdit"></a>
586 <div class="fixedFont">
587 <span class="attributes"></span><b class="itemname">cancelEdit</b>
589 (<a href="http://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference:Global_Objects:Boolean">Boolean</a> <B><i>remainVisible</i></B>)
596 <div class="short">Cancels the editing process and hides the editor without persisting any changes.</div>
602 Cancels the editing process and hides the editor without persisting any changes. The field value will be<br/>reverted to the original starting value.
609 <dl class="detailList">
610 <dt class="heading">Parameters:</dt>
613 <span class="fixedFont"><a href="http://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference:Global_Objects:Boolean">Boolean</a></span> <b>remainVisible</b>
616 <dd>Override the default behavior and keep the editor visible after<br/>cancel (defaults to false)</dd>
642 <tr class="method-row config-row-alt0 expandable notInherited">
643 <td class="micon"><a class="exi" href="#expand"> </a></td>
647 <a id="Roo.Editor-method-completeEdit" name=".completeEdit"></a>
648 <div class="fixedFont">
649 <span class="attributes"></span><b class="itemname">completeEdit</b>
651 (<a href="http://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference:Global_Objects:Boolean">Boolean</a> <B><i>remainVisible</i></B>)
658 <div class="short">Ends the editing process, persists the changed value to the underlying field, and hides the editor.</div>
664 Ends the editing process, persists the changed value to the underlying field, and hides the editor.
671 <dl class="detailList">
672 <dt class="heading">Parameters:</dt>
675 <span class="fixedFont"><a href="http://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference:Global_Objects:Boolean">Boolean</a></span> <b>remainVisible</b>
678 <dd>Override the default behavior and keep the editor visible after edit (defaults to false)</dd>
704 <tr class="method-row config-row-alt1 expandable notInherited">
705 <td class="micon"><a class="exi" href="#expand"> </a></td>
709 <a id="Roo.Editor-method-getValue" name=".getValue"></a>
710 <div class="fixedFont">
711 <span class="attributes"></span><b class="itemname">getValue</b>
728 <div class="short">Gets the data value of the editor</div>
734 Gets the data value of the editor
745 <dl class="detailList">
746 <dt class="heading">Returns:</dt>
748 <dd><span class="fixedFont">Mixed</span> The data value</dd>
770 <tr class="method-row config-row-alt0 expandable notInherited">
771 <td class="micon"><a class="exi" href="#expand"> </a></td>
775 <a id="Roo.Editor-method-realign" name=".realign"></a>
776 <div class="fixedFont">
777 <span class="attributes"></span><b class="itemname">realign</b>
786 <div class="short">Realigns the editor to the bound field based on the current alignment config value.</div>
792 Realigns the editor to the bound field based on the current alignment config value.
821 <tr class="method-row config-row-alt1 expandable notInherited">
822 <td class="micon"><a class="exi" href="#expand"> </a></td>
826 <a id="Roo.Editor-method-setSize" name=".setSize"></a>
827 <div class="fixedFont">
828 <span class="attributes"></span><b class="itemname">setSize</b>
830 (<a href="./Number.html#constructor" roo:cls="Number.html#constructor">Number</a> <B><i>width</i></B>, <a href="./Number.html#constructor" roo:cls="Number.html#constructor">Number</a> <B><i>height</i></B>)
837 <div class="short">Sets the height and width of this editor.</div>
843 Sets the height and width of this editor.
850 <dl class="detailList">
851 <dt class="heading">Parameters:</dt>
854 <span class="fixedFont"><a href="./Number.html#constructor" roo:cls="Number.html#constructor">Number</a></span> <b>width</b>
857 <dd>The new width</dd>
860 <span class="fixedFont"><a href="./Number.html#constructor" roo:cls="Number.html#constructor">Number</a></span> <b>height</b>
863 <dd>The new height</dd>
889 <tr class="method-row config-row-alt0 expandable notInherited">
890 <td class="micon"><a class="exi" href="#expand"> </a></td>
894 <a id="Roo.Editor-method-setValue" name=".setValue"></a>
895 <div class="fixedFont">
896 <span class="attributes"></span><b class="itemname">setValue</b>
898 (Mixed <B><i>value</i></B>)
905 <div class="short">Sets the data value of the editor</div>
911 Sets the data value of the editor
918 <dl class="detailList">
919 <dt class="heading">Parameters:</dt>
922 <span class="fixedFont">Mixed</span> <b>value</b>
925 <dd>Any valid value supported by the underlying field</dd>
951 <tr class="method-row config-row-alt1 expandable notInherited">
952 <td class="micon"><a class="exi" href="#expand"> </a></td>
956 <a id="Roo.Editor-method-startEdit" name=".startEdit"></a>
957 <div class="fixedFont">
958 <span class="attributes"></span><b class="itemname">startEdit</b>
960 (<a href="./String.html#constructor" roo:cls="String.html#constructor">String</a>/HTMLElement/Element <B><i>el</i></B>, <a href="./String.html#constructor" roo:cls="String.html#constructor">String</a> <B><i>value</i></B>)
967 <div class="short">Starts the editing process and shows the editor.</div>
973 Starts the editing process and shows the editor.
980 <dl class="detailList">
981 <dt class="heading">Parameters:</dt>
984 <span class="fixedFont"><a href="./String.html#constructor" roo:cls="String.html#constructor">String</a>/HTMLElement/Element</span> <b>el</b>
987 <dd>The element to edit</dd>
990 <span class="fixedFont"><a href="./String.html#constructor" roo:cls="String.html#constructor">String</a></span> <b>value</b>
993 <dd>(optional) A value to initialize the editor with. If a value is not provided, it defaults<br/>to the innerHTML of el.</dd>
1011 <td class="msource">
1022 <!-- ============================== events summary / details ======================== -->
1025 <a id="Roo.Editor-events"></a>
1034 <table cellspacing="0" class="member-table">
1035 <caption>Events</caption>
1038 <th class="sig-header" colspan="2">Event</th>
1039 <th class="msource-header">Defined By</th>
1048 <tr class="method-row expandable config-row-alt0 notInherited">
1049 <td class="micon"><a class="exi" href="#expand"> </a></td>
1052 <a id="Roo.Editor-event-*beforecomplete"></a>
1054 <div class="fixedFont">
1055 <b class="itemname">beforecomplete</b> (Editor <B><i>this</i></B>, Mixed <B><i>value</i></B>, Mixed <B><i>startValue</i></B>)
1061 <div class="short">Fires after a change has been made to the field, but before the change is reflected in the underlying<br/>field.
1067 Fires after a change has been made to the field, but before the change is reflected in the underlying<br/>field. Saving the change to the field can be canceled by returning false from the handler of this event.<br/>Note that if the value has not changed and ignoreNoChange = true, the editing will still end but this<br/>event will not fire since no edit actually occurred.
1073 <dl class="detailList">
1074 <dt class="heading">Parameters:</dt>
1077 <span class="fixedFont">Editor</span> <b>this</b>
1083 <span class="fixedFont">Mixed</span> <b>value</b>
1086 <dd>The current field value</dd>
1089 <span class="fixedFont">Mixed</span> <b>startValue</b>
1092 <dd>The original field value</dd>
1110 <td class="msource">
1115 <tr class="method-row expandable config-row-alt1 notInherited">
1116 <td class="micon"><a class="exi" href="#expand"> </a></td>
1119 <a id="Roo.Editor-event-*beforestartedit"></a>
1121 <div class="fixedFont">
1122 <b class="itemname">beforestartedit</b> (Editor <B><i>this</i></B>, <a href="./Roo.Element.html#constructor" roo:cls="Roo.Element.html#constructor">Roo.Element</a> <B><i>boundEl</i></B>, Mixed <B><i>value</i></B>)
1128 <div class="short">Fires when editing is initiated, but before the value changes.
1134 Fires when editing is initiated, but before the value changes. Editing can be canceled by returning<br/>false from the handler of this event.
1140 <dl class="detailList">
1141 <dt class="heading">Parameters:</dt>
1144 <span class="fixedFont">Editor</span> <b>this</b>
1150 <span class="fixedFont"><a href="./Roo.Element.html#constructor" roo:cls="Roo.Element.html#constructor">Roo.Element</a></span> <b>boundEl</b>
1153 <dd>The underlying element bound to this editor</dd>
1156 <span class="fixedFont">Mixed</span> <b>value</b>
1159 <dd>The field value being set</dd>
1177 <td class="msource">
1182 <tr class="method-row expandable config-row-alt0 notInherited">
1183 <td class="micon"><a class="exi" href="#expand"> </a></td>
1186 <a id="Roo.Editor-event-*complete"></a>
1188 <div class="fixedFont">
1189 <b class="itemname">complete</b> (Editor <B><i>this</i></B>, Mixed <B><i>value</i></B>, Mixed <B><i>startValue</i></B>)
1195 <div class="short">Fires after editing is complete and any changed value has been written to the underlying field.
1201 Fires after editing is complete and any changed value has been written to the underlying field.
1207 <dl class="detailList">
1208 <dt class="heading">Parameters:</dt>
1211 <span class="fixedFont">Editor</span> <b>this</b>
1217 <span class="fixedFont">Mixed</span> <b>value</b>
1220 <dd>The current field value</dd>
1223 <span class="fixedFont">Mixed</span> <b>startValue</b>
1226 <dd>The original field value</dd>
1244 <td class="msource">
1249 <tr class="method-row expandable config-row-alt1 notInherited">
1250 <td class="micon"><a class="exi" href="#expand"> </a></td>
1253 <a id="Roo.Editor-event-*specialkey"></a>
1255 <div class="fixedFont">
1256 <b class="itemname">specialkey</b> (<a href="./Roo.form.Field.html#constructor" roo:cls="Roo.form.Field.html#constructor">Roo.form.Field</a> <B><i>this</i></B>, <a href="./Roo.EventObject.html#constructor" roo:cls="Roo.EventObject.html#constructor">Roo.EventObject</a> <B><i>e</i></B>)
1262 <div class="short">Fires when any key related to navigation (arrows, tab, enter, esc, etc.
1268 Fires when any key related to navigation (arrows, tab, enter, esc, etc.) is pressed. You can check<br/>{<b>link</b> Roo.EventObject<b>getKey</b>} to determine which key was pressed.
1274 <dl class="detailList">
1275 <dt class="heading">Parameters:</dt>
1278 <span class="fixedFont"><a href="./Roo.form.Field.html#constructor" roo:cls="Roo.form.Field.html#constructor">Roo.form.Field</a></span> <b>this</b>
1284 <span class="fixedFont"><a href="./Roo.EventObject.html#constructor" roo:cls="Roo.EventObject.html#constructor">Roo.EventObject</a></span> <b>e</b>
1287 <dd>The event object</dd>
1305 <td class="msource">
1310 <tr class="method-row expandable config-row-alt0 notInherited">
1311 <td class="micon"><a class="exi" href="#expand"> </a></td>
1314 <a id="Roo.Editor-event-*startedit"></a>
1316 <div class="fixedFont">
1317 <b class="itemname">startedit</b> (<a href="./Roo.Element.html#constructor" roo:cls="Roo.Element.html#constructor">Roo.Element</a> <B><i>boundEl</i></B>, Mixed <B><i>value</i></B>)
1323 <div class="short">Fires when this editor is displayed
1329 Fires when this editor is displayed
1335 <dl class="detailList">
1336 <dt class="heading">Parameters:</dt>
1339 <span class="fixedFont"><a href="./Roo.Element.html#constructor" roo:cls="Roo.Element.html#constructor">Roo.Element</a></span> <b>boundEl</b>
1342 <dd>The underlying element bound to this editor</dd>
1345 <span class="fixedFont">Mixed</span> <b>value</b>
1348 <dd>The starting field value</dd>
1366 <td class="msource">
1378 <!-- ============================== footer ================================= -->
1379 <div class="fineprint" style="clear:both">
1381 Documentation generated by <a href="http://www.akbkhome.com" target="_blankt">Introspection Doc Generator</a> on Fri Jul 16 2010 15:55:22 GMT+0800 (HKT)
1383 <a href="http://www.jsdoctoolkit.org/" target="_blank">JsDoc Toolkit</a>