Fix #6893 - fix roo docs
[roojs1] / docs / symbols / Roo.HtmlEditorCore.json
1 {
2   "name" : "Roo.HtmlEditorCore",
3   "augments" : [
4     "Roo.Component",
5     "Roo.util.Observable"
6   ],
7   "desc" : "Provides a the editing component for the HTML editors in Roo. (bootstrap and Roo.form)\n\nany element that has display set to 'none' can cause problems in Safari and Firefox.<br/><br/>",
8   "isSingleton" : false,
9   "isStatic" : false,
10   "isBuiltin" : false,
11   "memberOf" : "HtmlEditorCore",
12   "example" : "",
13   "deprecated" : "",
14   "since" : "",
15   "see" : "",
16   "params" : [],
17   "returns" : [],
18   "config" : [
19     {
20       "name" : "listeners",
21       "type" : "Object",
22       "desc" : "list of events and functions to call for this object, \nFor example :\n<pre><code>\n    listeners :  { \n       'click' : function(e) {\n           ..... \n        } ,\n        .... \n    } \n  </code></pre>",
23       "memberOf" : "Roo.util.Observable",
24       "optvals" : []
25     },
26     {
27       "name" : "the",
28       "type" : "Roo.form.HtmlEditor|Roo.bootstrap.HtmlEditor",
29       "desc" : "owner field",
30       "memberOf" : "Roo.HtmlEditorCore",
31       "optvals" : []
32     },
33     {
34       "name" : "hideMode",
35       "type" : "String",
36       "desc" : "y)\nHow this component should hidden. Supported values are\n\"visibility\" (css visibility), \"offsets\" (negative offset position) and\n\"display\" (css display) - defaults to \"display\".",
37       "memberOf" : "Roo.Component",
38       "optvals" : [
39         "display",
40         "visibility"
41       ]
42     },
43     {
44       "name" : "allowDomMove",
45       "type" : "Boolean",
46       "desc" : "Whether the component can move the Dom node when rendering (defaults to true).",
47       "memberOf" : "Roo.Component",
48       "optvals" : []
49     },
50     {
51       "name" : "actionMode",
52       "type" : "String",
53       "desc" : "which property holds the element that used for  hide() / show() / disable() / enable()\ndefault is 'el' for forms you probably want to set this to fieldEl",
54       "memberOf" : "Roo.Component",
55       "optvals" : []
56     },
57     {
58       "name" : "width",
59       "type" : "Number",
60       "desc" : "(in pixels)",
61       "memberOf" : "Roo.HtmlEditorCore",
62       "optvals" : []
63     },
64     {
65       "name" : "resizable",
66       "type" : "String",
67       "desc" : "'s' or 'se' or 'e' - wrapps the element in a\n                       Roo.resizable.",
68       "memberOf" : "Roo.HtmlEditorCore",
69       "optvals" : []
70     },
71     {
72       "name" : "height",
73       "type" : "Number",
74       "desc" : "(in pixels)",
75       "memberOf" : "Roo.HtmlEditorCore",
76       "optvals" : []
77     },
78     {
79       "name" : "disableClass",
80       "type" : "String",
81       "desc" : "CSS class added to the component when it is disabled (defaults to \"x-item-disabled\").",
82       "memberOf" : "Roo.Component",
83       "optvals" : []
84     },
85     {
86       "name" : "stylesheets",
87       "type" : "Array",
88       "desc" : "url of stylesheets. set to [] to disable stylesheets.",
89       "memberOf" : "Roo.HtmlEditorCore",
90       "optvals" : []
91     }
92   ],
93   "methods" : [
94     {
95       "name" : "relayCmd",
96       "desc" : "Executes a Midas editor command on the editor document and performs necessary focus and\ntoolbar updates. <b>This should only be called after the editor is initialized.</b>",
97       "isStatic" : false,
98       "isConstructor" : false,
99       "isPrivate" : false,
100       "memberOf" : "Roo.HtmlEditorCore",
101       "example" : "",
102       "deprecated" : "",
103       "since" : "",
104       "see" : "",
105       "params" : [
106         {
107           "name" : "cmd",
108           "type" : "String",
109           "desc" : "The Midas command",
110           "isOptional" : false
111         },
112         {
113           "name" : "value",
114           "type" : "String/Boolean",
115           "desc" : "(optional) The value to pass to the command (defaults to null)",
116           "isOptional" : false
117         }
118       ],
119       "returns" : []
120     },
121     {
122       "name" : "execCmd",
123       "desc" : "Executes a Midas editor command directly on the editor document.\nFor visual commands, you should use {@link #relayCmd} instead.\n<b>This should only be called after the editor is initialized.</b>",
124       "isStatic" : false,
125       "isConstructor" : false,
126       "isPrivate" : false,
127       "memberOf" : "Roo.HtmlEditorCore",
128       "example" : "",
129       "deprecated" : "",
130       "since" : "",
131       "see" : "",
132       "params" : [
133         {
134           "name" : "cmd",
135           "type" : "String",
136           "desc" : "The Midas command",
137           "isOptional" : false
138         },
139         {
140           "name" : "value",
141           "type" : "String/Boolean",
142           "desc" : "(optional) The value to pass to the command (defaults to null)",
143           "isOptional" : false
144         }
145       ],
146       "returns" : []
147     },
148     {
149       "name" : "cleanWord",
150       "desc" : "Clean up MS wordisms...",
151       "isStatic" : false,
152       "isConstructor" : false,
153       "isPrivate" : false,
154       "memberOf" : "Roo.HtmlEditorCore",
155       "example" : "",
156       "deprecated" : "",
157       "since" : "",
158       "see" : "",
159       "params" : [],
160       "returns" : []
161     },
162     {
163       "name" : "syncValue",
164       "desc" : "HTML Editor -> Textarea\nProtected method that will not generally be called directly. Syncs the contents\nof the editor iframe with the textarea.",
165       "isStatic" : false,
166       "isConstructor" : false,
167       "isPrivate" : false,
168       "memberOf" : "Roo.HtmlEditorCore",
169       "example" : "",
170       "deprecated" : "",
171       "since" : "",
172       "see" : "",
173       "params" : [],
174       "returns" : []
175     },
176     {
177       "name" : "cleanTableWidths",
178       "desc" : "cleanTableWidths.\n\nQuite often pasting from word etc.. results in tables with column and widths.\nThis does not work well on fluid HTML layouts - like emails. - so this code should hunt an destroy them..",
179       "isStatic" : false,
180       "isConstructor" : false,
181       "isPrivate" : false,
182       "memberOf" : "Roo.HtmlEditorCore",
183       "example" : "",
184       "deprecated" : "",
185       "since" : "",
186       "see" : "",
187       "params" : [],
188       "returns" : []
189     },
190     {
191       "name" : "cleanHtml",
192       "desc" : "Protected method that will not generally be called directly. If you need/want\ncustom HTML cleanup, this is the method you should override.",
193       "isStatic" : false,
194       "isConstructor" : false,
195       "isPrivate" : false,
196       "memberOf" : "Roo.HtmlEditorCore",
197       "example" : "",
198       "deprecated" : "",
199       "since" : "",
200       "see" : "",
201       "params" : [
202         {
203           "name" : "html",
204           "type" : "String",
205           "desc" : "The HTML to be cleaned\nreturn {String} The cleaned HTML",
206           "isOptional" : false
207         }
208       ],
209       "returns" : []
210     },
211     {
212       "name" : "toggleSourceEdit",
213       "desc" : "Toggles the editor between standard and source edit mode.",
214       "isStatic" : false,
215       "isConstructor" : false,
216       "isPrivate" : false,
217       "memberOf" : "Roo.HtmlEditorCore",
218       "example" : "",
219       "deprecated" : "",
220       "since" : "",
221       "see" : "",
222       "params" : [
223         {
224           "name" : "sourceEdit",
225           "type" : "Boolean",
226           "desc" : "(optional) True for source edit, false for standard",
227           "isOptional" : false
228         }
229       ],
230       "returns" : []
231     },
232     {
233       "name" : "getDocMarkup",
234       "desc" : "Protected method that will not generally be called directly. It\nis called when the editor initializes the iframe with HTML contents. Override this method if you\nwant to change the initialization markup of the iframe (e.g. to add stylesheets).",
235       "isStatic" : false,
236       "isConstructor" : false,
237       "isPrivate" : false,
238       "memberOf" : "Roo.HtmlEditorCore",
239       "example" : "",
240       "deprecated" : "",
241       "since" : "",
242       "see" : "",
243       "params" : [],
244       "returns" : []
245     },
246     {
247       "name" : "iterateChildren",
248       "desc" : "iterateChildren of a Node, calling fn each time, using this as the scole..",
249       "isStatic" : false,
250       "isConstructor" : false,
251       "isPrivate" : false,
252       "memberOf" : "Roo.HtmlEditorCore",
253       "example" : "",
254       "deprecated" : "",
255       "since" : "",
256       "see" : "",
257       "params" : [
258         {
259           "name" : "node",
260           "type" : "DomNode",
261           "desc" : "node to iterate children of.",
262           "isOptional" : false
263         },
264         {
265           "name" : "fn",
266           "type" : "Function",
267           "desc" : "method of this class to call on each item.",
268           "isOptional" : false
269         }
270       ],
271       "returns" : []
272     },
273     {
274       "name" : "pushValue",
275       "desc" : "Protected method that will not generally be called directly. Pushes the value of the textarea\ninto the iframe editor.",
276       "isStatic" : false,
277       "isConstructor" : false,
278       "isPrivate" : false,
279       "memberOf" : "Roo.HtmlEditorCore",
280       "example" : "",
281       "deprecated" : "",
282       "since" : "",
283       "see" : "",
284       "params" : [],
285       "returns" : []
286     },
287     {
288       "name" : "rangeIntersectsNode",
289       "desc" : "Range intersection.. the hard stuff...\n '-1' = before\n '0' = hits..\n '1' = after.\n        [ -- selected range --- ]\n  [fail]                        [fail]\n\n   basically..\n     if end is before start or  hits it. fail.\n     if start is after end or hits it fail.\n\n  if either hits (but other is outside. - then it's not",
290       "isStatic" : false,
291       "isConstructor" : false,
292       "isPrivate" : false,
293       "memberOf" : "Roo.HtmlEditorCore",
294       "example" : "",
295       "deprecated" : "",
296       "since" : "",
297       "see" : "",
298       "params" : [],
299       "returns" : []
300     },
301     {
302       "name" : "insertAtCursor",
303       "desc" : "Inserts the passed text at the current cursor position. Note: the editor must be initialized and activated\nto insert tRoo.",
304       "isStatic" : false,
305       "isConstructor" : false,
306       "isPrivate" : false,
307       "memberOf" : "Roo.HtmlEditorCore",
308       "example" : "",
309       "deprecated" : "",
310       "since" : "",
311       "see" : "",
312       "params" : [
313         {
314           "name" : "text",
315           "type" : "String",
316           "desc" : "| dom node..",
317           "isOptional" : false
318         }
319       ],
320       "returns" : []
321     },
322     {
323       "name" : "getId",
324       "desc" : "Returns the id of this component.",
325       "isStatic" : false,
326       "isConstructor" : false,
327       "isPrivate" : false,
328       "memberOf" : "Roo.Component",
329       "example" : "",
330       "deprecated" : "",
331       "since" : "",
332       "see" : "",
333       "params" : [],
334       "returns" : [
335         {
336           "name" : "",
337           "type" : "String",
338           "desc" : ""
339         }
340       ]
341     },
342     {
343       "name" : "render",
344       "desc" : "If this is a lazy rendering component, render it to its container element.",
345       "isStatic" : false,
346       "isConstructor" : false,
347       "isPrivate" : false,
348       "memberOf" : "Roo.Component",
349       "example" : "",
350       "deprecated" : "",
351       "since" : "",
352       "see" : "",
353       "params" : [
354         {
355           "name" : "container",
356           "type" : "String/HTMLElement/Element",
357           "desc" : "(optional) The element this component should be rendered into. If it is being applied to existing markup, this should be left off.",
358           "isOptional" : false
359         }
360       ],
361       "returns" : []
362     },
363     {
364       "name" : "destroy",
365       "desc" : "Destroys this component by purging any event listeners, removing the component's element from the DOM,\nremoving the component from its {@link Roo.Container} (if applicable) and unregistering it from {@link Roo.ComponentMgr}.",
366       "isStatic" : false,
367       "isConstructor" : false,
368       "isPrivate" : false,
369       "memberOf" : "Roo.Component",
370       "example" : "",
371       "deprecated" : "",
372       "since" : "",
373       "see" : "",
374       "params" : [],
375       "returns" : []
376     },
377     {
378       "name" : "isVisible",
379       "desc" : "Returns true if this component is visible.",
380       "isStatic" : false,
381       "isConstructor" : false,
382       "isPrivate" : false,
383       "memberOf" : "Roo.Component",
384       "example" : "",
385       "deprecated" : "",
386       "since" : "",
387       "see" : "",
388       "params" : [],
389       "returns" : []
390     },
391     {
392       "name" : "setDisabled",
393       "desc" : "Convenience function for setting disabled/enabled by boolean.",
394       "isStatic" : false,
395       "isConstructor" : false,
396       "isPrivate" : false,
397       "memberOf" : "Roo.Component",
398       "example" : "",
399       "deprecated" : "",
400       "since" : "",
401       "see" : "",
402       "params" : [
403         {
404           "name" : "disabled",
405           "type" : "Boolean",
406           "desc" : "",
407           "isOptional" : false
408         }
409       ],
410       "returns" : []
411     },
412     {
413       "name" : "hide",
414       "desc" : "Hide this component.",
415       "isStatic" : false,
416       "isConstructor" : false,
417       "isPrivate" : false,
418       "memberOf" : "Roo.Component",
419       "example" : "",
420       "deprecated" : "",
421       "since" : "",
422       "see" : "",
423       "params" : [],
424       "returns" : [
425         {
426           "name" : "",
427           "type" : "Roo.Component",
428           "desc" : "this"
429         }
430       ]
431     },
432     {
433       "name" : "focus",
434       "desc" : "Try to focus this component.",
435       "isStatic" : false,
436       "isConstructor" : false,
437       "isPrivate" : false,
438       "memberOf" : "Roo.Component",
439       "example" : "",
440       "deprecated" : "",
441       "since" : "",
442       "see" : "",
443       "params" : [
444         {
445           "name" : "selectText",
446           "type" : "Boolean",
447           "desc" : "True to also select the text in this component (if applicable)",
448           "isOptional" : false
449         }
450       ],
451       "returns" : [
452         {
453           "name" : "",
454           "type" : "Roo.Component",
455           "desc" : "this"
456         }
457       ]
458     },
459     {
460       "name" : "show",
461       "desc" : "Show this component.",
462       "isStatic" : false,
463       "isConstructor" : false,
464       "isPrivate" : false,
465       "memberOf" : "Roo.Component",
466       "example" : "",
467       "deprecated" : "",
468       "since" : "",
469       "see" : "",
470       "params" : [],
471       "returns" : [
472         {
473           "name" : "",
474           "type" : "Roo.Component",
475           "desc" : "this"
476         }
477       ]
478     },
479     {
480       "name" : "enable",
481       "desc" : "Enable this component.",
482       "isStatic" : false,
483       "isConstructor" : false,
484       "isPrivate" : false,
485       "memberOf" : "Roo.Component",
486       "example" : "",
487       "deprecated" : "",
488       "since" : "",
489       "see" : "",
490       "params" : [],
491       "returns" : [
492         {
493           "name" : "",
494           "type" : "Roo.Component",
495           "desc" : "this"
496         }
497       ]
498     },
499     {
500       "name" : "setVisible",
501       "desc" : "Convenience function to hide or show this component by boolean.",
502       "isStatic" : false,
503       "isConstructor" : false,
504       "isPrivate" : false,
505       "memberOf" : "Roo.Component",
506       "example" : "",
507       "deprecated" : "",
508       "since" : "",
509       "see" : "",
510       "params" : [
511         {
512           "name" : "visible",
513           "type" : "Boolean",
514           "desc" : "True to show, false to hide",
515           "isOptional" : false
516         }
517       ],
518       "returns" : [
519         {
520           "name" : "",
521           "type" : "Roo.Component",
522           "desc" : "this"
523         }
524       ]
525     },
526     {
527       "name" : "disable",
528       "desc" : "Disable this component.",
529       "isStatic" : false,
530       "isConstructor" : false,
531       "isPrivate" : false,
532       "memberOf" : "Roo.Component",
533       "example" : "",
534       "deprecated" : "",
535       "since" : "",
536       "see" : "",
537       "params" : [],
538       "returns" : [
539         {
540           "name" : "",
541           "type" : "Roo.Component",
542           "desc" : "this"
543         }
544       ]
545     },
546     {
547       "name" : "getEl",
548       "desc" : "Returns the underlying {@link Roo.Element}.",
549       "isStatic" : false,
550       "isConstructor" : false,
551       "isPrivate" : false,
552       "memberOf" : "Roo.Component",
553       "example" : "",
554       "deprecated" : "",
555       "since" : "",
556       "see" : "",
557       "params" : [],
558       "returns" : [
559         {
560           "name" : "",
561           "type" : "Roo.Element",
562           "desc" : "The element"
563         }
564       ]
565     },
566     {
567       "name" : "purgeListeners",
568       "desc" : "Removes all listeners for this object",
569       "isStatic" : false,
570       "isConstructor" : false,
571       "isPrivate" : false,
572       "memberOf" : "Roo.util.Observable",
573       "example" : "",
574       "deprecated" : "",
575       "since" : "",
576       "see" : "",
577       "params" : [],
578       "returns" : []
579     },
580     {
581       "name" : "on",
582       "desc" : "Appends an event handler to this element (shorthand for addListener)",
583       "isStatic" : false,
584       "isConstructor" : false,
585       "isPrivate" : false,
586       "memberOf" : "Roo.util.Observable",
587       "example" : "",
588       "deprecated" : "",
589       "since" : "",
590       "see" : "",
591       "params" : [
592         {
593           "name" : "eventName",
594           "type" : "String",
595           "desc" : "The type of event to listen for",
596           "isOptional" : false
597         },
598         {
599           "name" : "handler",
600           "type" : "Function",
601           "desc" : "The method the event invokes",
602           "isOptional" : false
603         },
604         {
605           "name" : "scope",
606           "type" : "Object",
607           "desc" : "(optional) The scope in which to execute the handler\nfunction. The handler function's \"this\" context.",
608           "isOptional" : false
609         },
610         {
611           "name" : "options",
612           "type" : "Object",
613           "desc" : "(optional)",
614           "isOptional" : false
615         }
616       ],
617       "returns" : []
618     },
619     {
620       "name" : "un",
621       "desc" : "Removes a listener (shorthand for removeListener)",
622       "isStatic" : false,
623       "isConstructor" : false,
624       "isPrivate" : false,
625       "memberOf" : "Roo.util.Observable",
626       "example" : "",
627       "deprecated" : "",
628       "since" : "",
629       "see" : "",
630       "params" : [
631         {
632           "name" : "eventName",
633           "type" : "String",
634           "desc" : "The type of event to listen for",
635           "isOptional" : false
636         },
637         {
638           "name" : "handler",
639           "type" : "Function",
640           "desc" : "The handler to remove",
641           "isOptional" : false
642         },
643         {
644           "name" : "scope",
645           "type" : "Object",
646           "desc" : "(optional) The scope (this object) for the handler",
647           "isOptional" : false
648         }
649       ],
650       "returns" : []
651     },
652     {
653       "name" : "addEvents",
654       "desc" : "Used to define events on this Observable",
655       "isStatic" : false,
656       "isConstructor" : false,
657       "isPrivate" : false,
658       "memberOf" : "Roo.util.Observable",
659       "example" : "",
660       "deprecated" : "",
661       "since" : "",
662       "see" : "",
663       "params" : [
664         {
665           "name" : "object",
666           "type" : "Object",
667           "desc" : "The object with the events defined",
668           "isOptional" : false
669         }
670       ],
671       "returns" : []
672     },
673     {
674       "name" : "releaseCapture",
675       "desc" : "Removes <b>all</b> added captures from the Observable.",
676       "isStatic" : true,
677       "isConstructor" : false,
678       "isPrivate" : false,
679       "memberOf" : "Roo.util.Observable",
680       "example" : "",
681       "deprecated" : "",
682       "since" : "",
683       "see" : "",
684       "params" : [
685         {
686           "name" : "o",
687           "type" : "Observable",
688           "desc" : "The Observable to release",
689           "isOptional" : false
690         }
691       ],
692       "returns" : []
693     },
694     {
695       "name" : "removeListener",
696       "desc" : "Removes a listener",
697       "isStatic" : false,
698       "isConstructor" : false,
699       "isPrivate" : false,
700       "memberOf" : "Roo.util.Observable",
701       "example" : "",
702       "deprecated" : "",
703       "since" : "",
704       "see" : "",
705       "params" : [
706         {
707           "name" : "eventName",
708           "type" : "String",
709           "desc" : "The type of event to listen for",
710           "isOptional" : false
711         },
712         {
713           "name" : "handler",
714           "type" : "Function",
715           "desc" : "The handler to remove",
716           "isOptional" : false
717         },
718         {
719           "name" : "scope",
720           "type" : "Object",
721           "desc" : "(optional) The scope (this object) for the handler",
722           "isOptional" : false
723         }
724       ],
725       "returns" : []
726     },
727     {
728       "name" : "fireEvent",
729       "desc" : "Fires the specified event with the passed parameters (minus the event name).",
730       "isStatic" : false,
731       "isConstructor" : false,
732       "isPrivate" : false,
733       "memberOf" : "Roo.util.Observable",
734       "example" : "",
735       "deprecated" : "",
736       "since" : "",
737       "see" : "",
738       "params" : [
739         {
740           "name" : "eventName",
741           "type" : "String",
742           "desc" : "",
743           "isOptional" : false
744         },
745         {
746           "name" : "args",
747           "type" : "Object...",
748           "desc" : "Variable number of parameters are passed to handlers",
749           "isOptional" : false
750         }
751       ],
752       "returns" : [
753         {
754           "name" : "",
755           "type" : "Boolean",
756           "desc" : "returns false if any of the handlers return false otherwise it returns true"
757         }
758       ]
759     },
760     {
761       "name" : "hasListener",
762       "desc" : "Checks to see if this object has any listeners for a specified event",
763       "isStatic" : false,
764       "isConstructor" : false,
765       "isPrivate" : false,
766       "memberOf" : "Roo.util.Observable",
767       "example" : "",
768       "deprecated" : "",
769       "since" : "",
770       "see" : "",
771       "params" : [
772         {
773           "name" : "eventName",
774           "type" : "String",
775           "desc" : "The name of the event to check for",
776           "isOptional" : false
777         }
778       ],
779       "returns" : [
780         {
781           "name" : "",
782           "type" : "Boolean",
783           "desc" : "True if the event is being listened for, else false"
784         }
785       ]
786     },
787     {
788       "name" : "capture",
789       "desc" : "Starts capture on the specified Observable. All events will be passed\nto the supplied function with the event name + standard signature of the event\n<b>before</b> the event is fired. If the supplied function returns false,\nthe event will not fire.",
790       "isStatic" : true,
791       "isConstructor" : false,
792       "isPrivate" : false,
793       "memberOf" : "Roo.util.Observable",
794       "example" : "",
795       "deprecated" : "",
796       "since" : "",
797       "see" : "",
798       "params" : [
799         {
800           "name" : "o",
801           "type" : "Observable",
802           "desc" : "The Observable to capture",
803           "isOptional" : false
804         },
805         {
806           "name" : "fn",
807           "type" : "Function",
808           "desc" : "The function to call",
809           "isOptional" : false
810         },
811         {
812           "name" : "scope",
813           "type" : "Object",
814           "desc" : "(optional) The scope (this object) for the fn",
815           "isOptional" : false
816         }
817       ],
818       "returns" : []
819     },
820     {
821       "name" : "addListener",
822       "desc" : "Appends an event handler to this component",
823       "isStatic" : false,
824       "isConstructor" : false,
825       "isPrivate" : false,
826       "memberOf" : "Roo.util.Observable",
827       "example" : "",
828       "deprecated" : "",
829       "since" : "",
830       "see" : "",
831       "params" : [
832         {
833           "name" : "eventName",
834           "type" : "String",
835           "desc" : "The type of event to listen for",
836           "isOptional" : false
837         },
838         {
839           "name" : "handler",
840           "type" : "Function",
841           "desc" : "The method the event invokes",
842           "isOptional" : false
843         },
844         {
845           "name" : "scope",
846           "type" : "Object",
847           "desc" : "(optional) The scope in which to execute the handler\nfunction. The handler function's \"this\" context.",
848           "isOptional" : false
849         },
850         {
851           "name" : "options",
852           "type" : "Object",
853           "desc" : "(optional) An object containing handler configuration\nproperties. This may contain any of the following properties:<ul>\n<li>scope {Object} The scope in which to execute the handler function. The handler function's \"this\" context.</li>\n<li>delay {Number} The number of milliseconds to delay the invocation of the handler after te event fires.</li>\n<li>single {Boolean} True to add a handler to handle just the next firing of the event, and then remove itself.</li>\n<li>buffer {Number} Causes the handler to be scheduled to run in an {@link Roo.util.DelayedTask} delayed\nby the specified number of milliseconds. If the event fires again within that time, the original\nhandler is <em>not</em> invoked, but the new handler is scheduled in its place.</li>\n</ul><br>\n<p>\n<b>Combining Options</b><br>\nUsing the options argument, it is possible to combine different types of listeners:<br>\n<br>\nA normalized, delayed, one-time listener that auto stops the event and passes a custom argument (forumId)\n\t\t<pre><code>\n\t\tel.on('click', this.onClick, this, {\n \t\t\tsingle: true,\n    \t\tdelay: 100,\n    \t\tforumId: 4\n\t\t});\n\t\t</code></pre>\n<p>\n<b>Attaching multiple handlers in 1 call</b><br>\nThe method also allows for a single argument to be passed which is a config object containing properties\nwhich specify multiple handlers.\n<pre><code>\n\t\tel.on({\n\t\t\t'click': {\n        \t\tfn: this.onClick,\n        \t\tscope: this,\n        \t\tdelay: 100\n    \t\t}, \n    \t\t'mouseover': {\n        \t\tfn: this.onMouseOver,\n        \t\tscope: this\n    \t\t},\n    \t\t'mouseout': {\n        \t\tfn: this.onMouseOut,\n        \t\tscope: this\n    \t\t}\n\t\t});\n\t\t</code></pre>\n<p>\nOr a shorthand syntax which passes the same scope object to all handlers:\n     \t<pre><code>\n\t\tel.on({\n\t\t\t'click': this.onClick,\n    \t\t'mouseover': this.onMouseOver,\n    \t\t'mouseout': this.onMouseOut,\n    \t\tscope: this\n\t\t});\n\t\t</code></pre>",
854           "isOptional" : false
855         }
856       ],
857       "returns" : []
858     }
859   ],
860   "events" : [
861     {
862       "name" : "specialkey",
863       "desc" : "",
864       "memberOf" : "Roo.HtmlEditorCore",
865       "example" : "",
866       "deprecated" : "",
867       "since" : "",
868       "see" : "",
869       "params" : [],
870       "returns" : []
871     },
872     {
873       "name" : "editorevent",
874       "desc" : "Fires when on any editor (mouse up/down cursor movement etc.) - used for toolbar hooks.",
875       "memberOf" : "Roo.HtmlEditorCore",
876       "example" : "",
877       "deprecated" : "",
878       "since" : "",
879       "see" : "",
880       "params" : [
881         {
882           "name" : "this",
883           "type" : "Roo.HtmlEditorCore",
884           "desc" : "",
885           "isOptional" : false
886         }
887       ],
888       "returns" : []
889     },
890     {
891       "name" : "beforepush",
892       "desc" : "Fires before the iframe editor is updated with content from the textarea. Return false\nto cancel the push.",
893       "memberOf" : "Roo.HtmlEditorCore",
894       "example" : "",
895       "deprecated" : "",
896       "since" : "",
897       "see" : "",
898       "params" : [
899         {
900           "name" : "this",
901           "type" : "Roo.HtmlEditorCore",
902           "desc" : "",
903           "isOptional" : false
904         },
905         {
906           "name" : "html",
907           "type" : "String",
908           "desc" : "",
909           "isOptional" : false
910         }
911       ],
912       "returns" : []
913     },
914     {
915       "name" : "activate",
916       "desc" : "Fires when the editor is first receives the focus. Any insertion must wait\nuntil after this event.",
917       "memberOf" : "Roo.HtmlEditorCore",
918       "example" : "",
919       "deprecated" : "",
920       "since" : "",
921       "see" : "",
922       "params" : [
923         {
924           "name" : "this",
925           "type" : "Roo.HtmlEditorCore",
926           "desc" : "",
927           "isOptional" : false
928         }
929       ],
930       "returns" : []
931     },
932     {
933       "name" : "initialize",
934       "desc" : "Fires when the editor is fully initialized (including the iframe)",
935       "memberOf" : "Roo.HtmlEditorCore",
936       "example" : "",
937       "deprecated" : "",
938       "since" : "",
939       "see" : "",
940       "params" : [
941         {
942           "name" : "this",
943           "type" : "Roo.HtmlEditorCore",
944           "desc" : "",
945           "isOptional" : false
946         }
947       ],
948       "returns" : []
949     },
950     {
951       "name" : "beforesync",
952       "desc" : "Fires before the textarea is updated with content from the editor iframe. Return false\nto cancel the sync.",
953       "memberOf" : "Roo.HtmlEditorCore",
954       "example" : "",
955       "deprecated" : "",
956       "since" : "",
957       "see" : "",
958       "params" : [
959         {
960           "name" : "this",
961           "type" : "Roo.HtmlEditorCore",
962           "desc" : "",
963           "isOptional" : false
964         },
965         {
966           "name" : "html",
967           "type" : "String",
968           "desc" : "",
969           "isOptional" : false
970         }
971       ],
972       "returns" : []
973     },
974     {
975       "name" : "push",
976       "desc" : "Fires when the iframe editor is updated with content from the textarea.",
977       "memberOf" : "Roo.HtmlEditorCore",
978       "example" : "",
979       "deprecated" : "",
980       "since" : "",
981       "see" : "",
982       "params" : [
983         {
984           "name" : "this",
985           "type" : "Roo.HtmlEditorCore",
986           "desc" : "",
987           "isOptional" : false
988         },
989         {
990           "name" : "html",
991           "type" : "String",
992           "desc" : "",
993           "isOptional" : false
994         }
995       ],
996       "returns" : []
997     },
998     {
999       "name" : "sync",
1000       "desc" : "Fires when the textarea is updated with content from the editor iframe.",
1001       "memberOf" : "Roo.HtmlEditorCore",
1002       "example" : "",
1003       "deprecated" : "",
1004       "since" : "",
1005       "see" : "",
1006       "params" : [
1007         {
1008           "name" : "this",
1009           "type" : "Roo.HtmlEditorCore",
1010           "desc" : "",
1011           "isOptional" : false
1012         },
1013         {
1014           "name" : "html",
1015           "type" : "String",
1016           "desc" : "",
1017           "isOptional" : false
1018         }
1019       ],
1020       "returns" : []
1021     },
1022     {
1023       "name" : "change",
1024       "desc" : "",
1025       "memberOf" : "Roo.HtmlEditorCore",
1026       "example" : "",
1027       "deprecated" : "",
1028       "since" : "",
1029       "see" : "",
1030       "params" : [],
1031       "returns" : []
1032     },
1033     {
1034       "name" : "blur",
1035       "desc" : "",
1036       "memberOf" : "Roo.HtmlEditorCore",
1037       "example" : "",
1038       "deprecated" : "",
1039       "since" : "",
1040       "see" : "",
1041       "params" : [],
1042       "returns" : []
1043     },
1044     {
1045       "name" : "focus",
1046       "desc" : "",
1047       "memberOf" : "Roo.HtmlEditorCore",
1048       "example" : "",
1049       "deprecated" : "",
1050       "since" : "",
1051       "see" : "",
1052       "params" : [],
1053       "returns" : []
1054     },
1055     {
1056       "name" : "beforerender",
1057       "desc" : "Fires before the component is rendered. Return false to stop the render.",
1058       "memberOf" : "Roo.Component",
1059       "example" : "",
1060       "deprecated" : "",
1061       "since" : "",
1062       "see" : "",
1063       "params" : [
1064         {
1065           "name" : "this",
1066           "type" : "Roo.Component",
1067           "desc" : "",
1068           "isOptional" : false
1069         }
1070       ],
1071       "returns" : []
1072     },
1073     {
1074       "name" : "disable",
1075       "desc" : "Fires after the component is disabled.",
1076       "memberOf" : "Roo.Component",
1077       "example" : "",
1078       "deprecated" : "",
1079       "since" : "",
1080       "see" : "",
1081       "params" : [
1082         {
1083           "name" : "this",
1084           "type" : "Roo.Component",
1085           "desc" : "",
1086           "isOptional" : false
1087         }
1088       ],
1089       "returns" : []
1090     },
1091     {
1092       "name" : "render",
1093       "desc" : "Fires after the component is rendered.",
1094       "memberOf" : "Roo.Component",
1095       "example" : "",
1096       "deprecated" : "",
1097       "since" : "",
1098       "see" : "",
1099       "params" : [
1100         {
1101           "name" : "this",
1102           "type" : "Roo.Component",
1103           "desc" : "",
1104           "isOptional" : false
1105         }
1106       ],
1107       "returns" : []
1108     },
1109     {
1110       "name" : "destroy",
1111       "desc" : "Fires after the component is destroyed.",
1112       "memberOf" : "Roo.Component",
1113       "example" : "",
1114       "deprecated" : "",
1115       "since" : "",
1116       "see" : "",
1117       "params" : [
1118         {
1119           "name" : "this",
1120           "type" : "Roo.Component",
1121           "desc" : "",
1122           "isOptional" : false
1123         }
1124       ],
1125       "returns" : []
1126     },
1127     {
1128       "name" : "hide",
1129       "desc" : "Fires after the component is hidden.",
1130       "memberOf" : "Roo.Component",
1131       "example" : "",
1132       "deprecated" : "",
1133       "since" : "",
1134       "see" : "",
1135       "params" : [
1136         {
1137           "name" : "this",
1138           "type" : "Roo.Component",
1139           "desc" : "",
1140           "isOptional" : false
1141         }
1142       ],
1143       "returns" : []
1144     },
1145     {
1146       "name" : "beforehide",
1147       "desc" : "Fires before the component is hidden. Return false to stop the hide.",
1148       "memberOf" : "Roo.Component",
1149       "example" : "",
1150       "deprecated" : "",
1151       "since" : "",
1152       "see" : "",
1153       "params" : [
1154         {
1155           "name" : "this",
1156           "type" : "Roo.Component",
1157           "desc" : "",
1158           "isOptional" : false
1159         }
1160       ],
1161       "returns" : []
1162     },
1163     {
1164       "name" : "show",
1165       "desc" : "Fires after the component is shown.",
1166       "memberOf" : "Roo.Component",
1167       "example" : "",
1168       "deprecated" : "",
1169       "since" : "",
1170       "see" : "",
1171       "params" : [
1172         {
1173           "name" : "this",
1174           "type" : "Roo.Component",
1175           "desc" : "",
1176           "isOptional" : false
1177         }
1178       ],
1179       "returns" : []
1180     },
1181     {
1182       "name" : "beforeshow",
1183       "desc" : "Fires before the component is shown.  Return false to stop the show.",
1184       "memberOf" : "Roo.Component",
1185       "example" : "",
1186       "deprecated" : "",
1187       "since" : "",
1188       "see" : "",
1189       "params" : [
1190         {
1191           "name" : "this",
1192           "type" : "Roo.Component",
1193           "desc" : "",
1194           "isOptional" : false
1195         }
1196       ],
1197       "returns" : []
1198     },
1199     {
1200       "name" : "enable",
1201       "desc" : "Fires after the component is enabled.",
1202       "memberOf" : "Roo.Component",
1203       "example" : "",
1204       "deprecated" : "",
1205       "since" : "",
1206       "see" : "",
1207       "params" : [
1208         {
1209           "name" : "this",
1210           "type" : "Roo.Component",
1211           "desc" : "",
1212           "isOptional" : false
1213         }
1214       ],
1215       "returns" : []
1216     },
1217     {
1218       "name" : "beforedestroy",
1219       "desc" : "Fires before the component is destroyed. Return false to stop the destroy.",
1220       "memberOf" : "Roo.Component",
1221       "example" : "",
1222       "deprecated" : "",
1223       "since" : "",
1224       "see" : "",
1225       "params" : [
1226         {
1227           "name" : "this",
1228           "type" : "Roo.Component",
1229           "desc" : "",
1230           "isOptional" : false
1231         }
1232       ],
1233       "returns" : []
1234     }
1235   ]
1236 }