Fix #5665 - pre-commit hooks for roojs
[roojs1] / docs / symbols / Roo.Resizable.json
1 {
2   "name" : "Roo.Resizable",
3   "augments" : [
4     "Roo.util.Observable"
5   ],
6   "desc" : "<p>Applies drag handles to an element to make it resizable. The drag handles are inserted into the element\nand positioned absolute. Some elements, such as a textarea or image, don't support this. To overcome that, you can wrap\nthe textarea in a div and set \"resizeChild\" to true (or to the id of the element), <b>or</b> set wrap:true in your config and\nthe element will be wrapped for you automatically.</p>\n<p>Here is the list of valid resize handles:</p>\n<pre>\nValue   Description\n------  -------------------\n 'n'     north\n 's'     south\n 'e'     east\n 'w'     west\n 'nw'    northwest\n 'sw'    southwest\n 'se'    southeast\n 'ne'    northeast\n 'hd'    horizontal drag\n 'all'   all\n</pre>\n<p>Here's an example showing the creation of a typical Resizable:</p>\n<pre><code>\nvar resizer = new Roo.Resizable(\"element-id\", {\n    handles: 'all',\n    minWidth: 200,\n    minHeight: 100,\n    maxWidth: 500,\n    maxHeight: 400,\n    pinned: true\n});\nresizer.on(\"resize\", myHandler);\n</code></pre>\n<p>To hide a particular handle, set its display to none in CSS, or through script:<br>\nresizer.east.setDisplayed(false);</p>",
7   "isSingleton" : false,
8   "isStatic" : false,
9   "isBuiltin" : false,
10   "memberOf" : "Resizable",
11   "example" : "",
12   "deprecated" : "",
13   "since" : "",
14   "see" : "",
15   "params" : [
16     {
17       "name" : "el",
18       "type" : "String/HTMLElement/Roo.Element",
19       "desc" : "The id or element to resize",
20       "isOptional" : false
21     },
22     {
23       "name" : "config",
24       "type" : "Object",
25       "desc" : "configuration options",
26       "isOptional" : false
27     }
28   ],
29   "returns" : [
30   ],
31   "config" : [
32     {
33       "name" : "easing",
34       "type" : "String",
35       "desc" : "Animation easing if animate = true (defaults to 'easingOutStrong')",
36       "memberOf" : "Roo.Resizable",
37       "values" : [
38       ]
39     },
40     {
41       "name" : "listeners",
42       "type" : "Object",
43       "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>",
44       "memberOf" : "Roo.util.Observable",
45       "values" : [
46       ]
47     },
48     {
49       "name" : "maxWidth",
50       "type" : "Number",
51       "desc" : "The maximum width for the element (defaults to 10000)",
52       "memberOf" : "Roo.Resizable",
53       "values" : [
54       ]
55     },
56     {
57       "name" : "minWidth",
58       "type" : "Number",
59       "desc" : "The minimum width for the element (defaults to 5)",
60       "memberOf" : "Roo.Resizable",
61       "values" : [
62       ]
63     },
64     {
65       "name" : "dynamic",
66       "type" : "Boolean",
67       "desc" : "True to resize the element while dragging instead of using a proxy (defaults to false)",
68       "memberOf" : "Roo.Resizable",
69       "values" : [
70       ]
71     },
72     {
73       "name" : "pinned",
74       "type" : "Boolean",
75       "desc" : "True to ensure that the resize handles are always visible, false to display them only when the\nuser mouses over the resizable borders. This is only applied at config time. (defaults to false)",
76       "memberOf" : "Roo.Resizable",
77       "values" : [
78       ]
79     },
80     {
81       "name" : "enabled",
82       "type" : "Boolean",
83       "desc" : "False to disable resizing (defaults to true)",
84       "memberOf" : "Roo.Resizable",
85       "values" : [
86       ]
87     },
88     {
89       "name" : "handles",
90       "type" : "String",
91       "desc" : "String consisting of the resize handles to display (defaults to undefined)",
92       "memberOf" : "Roo.Resizable",
93       "values" : [
94       ]
95     },
96     {
97       "name" : "preserveRatio",
98       "type" : "Boolean",
99       "desc" : "True to preserve the original ratio between height and width during resize (defaults to false)",
100       "memberOf" : "Roo.Resizable",
101       "values" : [
102       ]
103     },
104     {
105       "name" : "minHeight",
106       "type" : "Number",
107       "desc" : "The minimum height for the element (defaults to 5)",
108       "memberOf" : "Roo.Resizable",
109       "values" : [
110       ]
111     },
112     {
113       "name" : "maxHeight",
114       "type" : "Number",
115       "desc" : "The maximum height for the element (defaults to 10000)",
116       "memberOf" : "Roo.Resizable",
117       "values" : [
118       ]
119     },
120     {
121       "name" : "widthIncrement",
122       "type" : "Number",
123       "desc" : "The increment to snap the width resize in pixels (dynamic must be true, defaults to 0)",
124       "memberOf" : "Roo.Resizable",
125       "values" : [
126       ]
127     },
128     {
129       "name" : "resizeChild",
130       "type" : "Boolean/String/Element",
131       "desc" : "True to resize the first child, or id/element to resize (defaults to false)",
132       "memberOf" : "Roo.Resizable",
133       "values" : [
134       ]
135     },
136     {
137       "name" : "width",
138       "type" : "Number",
139       "desc" : "The width of the element in pixels (defaults to null)",
140       "memberOf" : "Roo.Resizable",
141       "values" : [
142       ]
143     },
144     {
145       "name" : "transparent",
146       "type" : "Boolean",
147       "desc" : "True for transparent handles. This is only applied at config time. (defaults to false)",
148       "memberOf" : "Roo.Resizable",
149       "values" : [
150       ]
151     },
152     {
153       "name" : "minX",
154       "type" : "Number",
155       "desc" : "The minimum allowed page X for the element (only used for west resizing, defaults to 0)",
156       "memberOf" : "Roo.Resizable",
157       "values" : [
158       ]
159     },
160     {
161       "name" : "constrainTo",
162       "type" : "String/HTMLElement/Element",
163       "desc" : "Constrain the resize to a particular element",
164       "memberOf" : "Roo.Resizable",
165       "values" : [
166       ]
167     },
168     {
169       "name" : "disableTrackOver",
170       "type" : "Boolean",
171       "desc" : "True to disable mouse tracking. This is only applied at config time. (defaults to false)",
172       "memberOf" : "Roo.Resizable",
173       "values" : [
174       ]
175     },
176     {
177       "name" : "minY",
178       "type" : "Number",
179       "desc" : "The minimum allowed page Y for the element (only used for north resizing, defaults to 0)",
180       "memberOf" : "Roo.Resizable",
181       "values" : [
182       ]
183     },
184     {
185       "name" : "adjustments",
186       "type" : "Array/String",
187       "desc" : "String \"auto\" or an array [width, height] with values to be <b>added</b> to the\nresize operation's new size (defaults to [0, 0])",
188       "memberOf" : "Roo.Resizable",
189       "values" : [
190       ]
191     },
192     {
193       "name" : "wrap",
194       "type" : "Boolean",
195       "desc" : "True to wrap an element with a div if needed (required for textareas and images, defaults to false)",
196       "memberOf" : "Roo.Resizable",
197       "values" : [
198       ]
199     },
200     {
201       "name" : "height",
202       "type" : "Number",
203       "desc" : "The height of the element in pixels (defaults to null)",
204       "memberOf" : "Roo.Resizable",
205       "values" : [
206       ]
207     },
208     {
209       "name" : "duration",
210       "type" : "Number",
211       "desc" : "Animation duration if animate = true (defaults to .35)",
212       "memberOf" : "Roo.Resizable",
213       "values" : [
214       ]
215     },
216     {
217       "name" : "animate",
218       "type" : "Boolean",
219       "desc" : "True to animate the resize (not compatible with dynamic sizing, defaults to false)",
220       "memberOf" : "Roo.Resizable",
221       "values" : [
222       ]
223     },
224     {
225       "name" : "multiDirectional",
226       "type" : "Boolean",
227       "desc" : "<b>Deprecated</b>.  The old style of adding multi-direction resize handles, deprecated\nin favor of the handles config option (defaults to false)",
228       "memberOf" : "Roo.Resizable",
229       "values" : [
230       ]
231     },
232     {
233       "name" : "heightIncrement",
234       "type" : "Number",
235       "desc" : "The increment to snap the height resize in pixels (dynamic must be true, defaults to 0)",
236       "memberOf" : "Roo.Resizable",
237       "values" : [
238       ]
239     },
240     {
241       "name" : "draggable",
242       "type" : "Boolean",
243       "desc" : "Convenience to initialize drag drop (defaults to false)",
244       "memberOf" : "Roo.Resizable",
245       "values" : [
246       ]
247     },
248     {
249       "name" : "resizeRegion",
250       "type" : "Roo.lib.Region",
251       "desc" : "Constrain the resize to a particular region",
252       "memberOf" : "Roo.Resizable",
253       "values" : [
254       ]
255     }
256   ],
257   "methods" : [
258     {
259       "name" : "getEl",
260       "desc" : "Returns the element this component is bound to.",
261       "isStatic" : false,
262       "isConstructor" : false,
263       "isPrivate" : false,
264       "memberOf" : "Roo.Resizable",
265       "example" : "",
266       "deprecated" : "",
267       "since" : "",
268       "see" : "",
269       "params" : [
270       ],
271       "returns" : [
272         {
273           "name" : "",
274           "type" : "Roo.Element",
275           "desc" : ""
276         }
277       ]
278     },
279     {
280       "name" : "getResizeChild",
281       "desc" : "Returns the resizeChild element (or null).",
282       "isStatic" : false,
283       "isConstructor" : false,
284       "isPrivate" : false,
285       "memberOf" : "Roo.Resizable",
286       "example" : "",
287       "deprecated" : "",
288       "since" : "",
289       "see" : "",
290       "params" : [
291       ],
292       "returns" : [
293         {
294           "name" : "",
295           "type" : "Roo.Element",
296           "desc" : ""
297         }
298       ]
299     },
300     {
301       "name" : "destroy",
302       "desc" : "Destroys this resizable. If the element was wrapped and\nremoveEl is not true then the element remains.",
303       "isStatic" : false,
304       "isConstructor" : false,
305       "isPrivate" : false,
306       "memberOf" : "Roo.Resizable",
307       "example" : "",
308       "deprecated" : "",
309       "since" : "",
310       "see" : "",
311       "params" : [
312         {
313           "name" : "removeEl",
314           "type" : "Boolean",
315           "desc" : "(optional) true to remove the element from the DOM",
316           "isOptional" : false
317         }
318       ],
319       "returns" : [
320       ]
321     },
322     {
323       "name" : "resizeTo",
324       "desc" : "Perform a manual resize",
325       "isStatic" : false,
326       "isConstructor" : false,
327       "isPrivate" : false,
328       "memberOf" : "Roo.Resizable",
329       "example" : "",
330       "deprecated" : "",
331       "since" : "",
332       "see" : "",
333       "params" : [
334         {
335           "name" : "width",
336           "type" : "Number",
337           "desc" : "",
338           "isOptional" : false
339         },
340         {
341           "name" : "height",
342           "type" : "Number",
343           "desc" : "",
344           "isOptional" : false
345         }
346       ],
347       "returns" : [
348       ]
349     },
350     {
351       "name" : "purgeListeners",
352       "desc" : "Removes all listeners for this object",
353       "isStatic" : false,
354       "isConstructor" : false,
355       "isPrivate" : false,
356       "memberOf" : "Roo.util.Observable",
357       "example" : "",
358       "deprecated" : "",
359       "since" : "",
360       "see" : "",
361       "params" : [
362       ],
363       "returns" : [
364       ]
365     },
366     {
367       "name" : "on",
368       "desc" : "Appends an event handler to this element (shorthand for addListener)",
369       "isStatic" : false,
370       "isConstructor" : false,
371       "isPrivate" : false,
372       "memberOf" : "Roo.util.Observable",
373       "example" : "",
374       "deprecated" : "",
375       "since" : "",
376       "see" : "",
377       "params" : [
378         {
379           "name" : "eventName",
380           "type" : "String",
381           "desc" : "The type of event to listen for",
382           "isOptional" : false
383         },
384         {
385           "name" : "handler",
386           "type" : "Function",
387           "desc" : "The method the event invokes",
388           "isOptional" : false
389         },
390         {
391           "name" : "scope",
392           "type" : "Object",
393           "desc" : "(optional) The scope in which to execute the handler\nfunction. The handler function's \"this\" context.",
394           "isOptional" : false
395         },
396         {
397           "name" : "options",
398           "type" : "Object",
399           "desc" : "(optional)",
400           "isOptional" : false
401         }
402       ],
403       "returns" : [
404       ]
405     },
406     {
407       "name" : "un",
408       "desc" : "Removes a listener (shorthand for removeListener)",
409       "isStatic" : false,
410       "isConstructor" : false,
411       "isPrivate" : false,
412       "memberOf" : "Roo.util.Observable",
413       "example" : "",
414       "deprecated" : "",
415       "since" : "",
416       "see" : "",
417       "params" : [
418         {
419           "name" : "eventName",
420           "type" : "String",
421           "desc" : "The type of event to listen for",
422           "isOptional" : false
423         },
424         {
425           "name" : "handler",
426           "type" : "Function",
427           "desc" : "The handler to remove",
428           "isOptional" : false
429         },
430         {
431           "name" : "scope",
432           "type" : "Object",
433           "desc" : "(optional) The scope (this object) for the handler",
434           "isOptional" : false
435         }
436       ],
437       "returns" : [
438       ]
439     },
440     {
441       "name" : "addEvents",
442       "desc" : "Used to define events on this Observable",
443       "isStatic" : false,
444       "isConstructor" : false,
445       "isPrivate" : false,
446       "memberOf" : "Roo.util.Observable",
447       "example" : "",
448       "deprecated" : "",
449       "since" : "",
450       "see" : "",
451       "params" : [
452         {
453           "name" : "object",
454           "type" : "Object",
455           "desc" : "The object with the events defined",
456           "isOptional" : false
457         }
458       ],
459       "returns" : [
460       ]
461     },
462     {
463       "name" : "releaseCapture",
464       "desc" : "Removes <b>all</b> added captures from the Observable.",
465       "isStatic" : true,
466       "isConstructor" : false,
467       "isPrivate" : false,
468       "memberOf" : "Roo.util.Observable",
469       "example" : "",
470       "deprecated" : "",
471       "since" : "",
472       "see" : "",
473       "params" : [
474         {
475           "name" : "o",
476           "type" : "Observable",
477           "desc" : "The Observable to release",
478           "isOptional" : false
479         }
480       ],
481       "returns" : [
482       ]
483     },
484     {
485       "name" : "removeListener",
486       "desc" : "Removes a listener",
487       "isStatic" : false,
488       "isConstructor" : false,
489       "isPrivate" : false,
490       "memberOf" : "Roo.util.Observable",
491       "example" : "",
492       "deprecated" : "",
493       "since" : "",
494       "see" : "",
495       "params" : [
496         {
497           "name" : "eventName",
498           "type" : "String",
499           "desc" : "The type of event to listen for",
500           "isOptional" : false
501         },
502         {
503           "name" : "handler",
504           "type" : "Function",
505           "desc" : "The handler to remove",
506           "isOptional" : false
507         },
508         {
509           "name" : "scope",
510           "type" : "Object",
511           "desc" : "(optional) The scope (this object) for the handler",
512           "isOptional" : false
513         }
514       ],
515       "returns" : [
516       ]
517     },
518     {
519       "name" : "fireEvent",
520       "desc" : "Fires the specified event with the passed parameters (minus the event name).",
521       "isStatic" : false,
522       "isConstructor" : false,
523       "isPrivate" : false,
524       "memberOf" : "Roo.util.Observable",
525       "example" : "",
526       "deprecated" : "",
527       "since" : "",
528       "see" : "",
529       "params" : [
530         {
531           "name" : "eventName",
532           "type" : "String",
533           "desc" : "",
534           "isOptional" : false
535         },
536         {
537           "name" : "args",
538           "type" : "Object...",
539           "desc" : "Variable number of parameters are passed to handlers",
540           "isOptional" : false
541         }
542       ],
543       "returns" : [
544         {
545           "name" : "",
546           "type" : "Boolean",
547           "desc" : "returns false if any of the handlers return false otherwise it returns true"
548         }
549       ]
550     },
551     {
552       "name" : "hasListener",
553       "desc" : "Checks to see if this object has any listeners for a specified event",
554       "isStatic" : false,
555       "isConstructor" : false,
556       "isPrivate" : false,
557       "memberOf" : "Roo.util.Observable",
558       "example" : "",
559       "deprecated" : "",
560       "since" : "",
561       "see" : "",
562       "params" : [
563         {
564           "name" : "eventName",
565           "type" : "String",
566           "desc" : "The name of the event to check for",
567           "isOptional" : false
568         }
569       ],
570       "returns" : [
571         {
572           "name" : "",
573           "type" : "Boolean",
574           "desc" : "True if the event is being listened for, else false"
575         }
576       ]
577     },
578     {
579       "name" : "capture",
580       "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.",
581       "isStatic" : true,
582       "isConstructor" : false,
583       "isPrivate" : false,
584       "memberOf" : "Roo.util.Observable",
585       "example" : "",
586       "deprecated" : "",
587       "since" : "",
588       "see" : "",
589       "params" : [
590         {
591           "name" : "o",
592           "type" : "Observable",
593           "desc" : "The Observable to capture",
594           "isOptional" : false
595         },
596         {
597           "name" : "fn",
598           "type" : "Function",
599           "desc" : "The function to call",
600           "isOptional" : false
601         },
602         {
603           "name" : "scope",
604           "type" : "Object",
605           "desc" : "(optional) The scope (this object) for the fn",
606           "isOptional" : false
607         }
608       ],
609       "returns" : [
610       ]
611     },
612     {
613       "name" : "addListener",
614       "desc" : "Appends an event handler to this component",
615       "isStatic" : false,
616       "isConstructor" : false,
617       "isPrivate" : false,
618       "memberOf" : "Roo.util.Observable",
619       "example" : "",
620       "deprecated" : "",
621       "since" : "",
622       "see" : "",
623       "params" : [
624         {
625           "name" : "eventName",
626           "type" : "String",
627           "desc" : "The type of event to listen for",
628           "isOptional" : false
629         },
630         {
631           "name" : "handler",
632           "type" : "Function",
633           "desc" : "The method the event invokes",
634           "isOptional" : false
635         },
636         {
637           "name" : "scope",
638           "type" : "Object",
639           "desc" : "(optional) The scope in which to execute the handler\nfunction. The handler function's \"this\" context.",
640           "isOptional" : false
641         },
642         {
643           "name" : "options",
644           "type" : "Object",
645           "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>",
646           "isOptional" : false
647         }
648       ],
649       "returns" : [
650       ]
651     }
652   ],
653   "events" : [
654     {
655       "name" : "resize",
656       "desc" : "Fired after a resize.",
657       "memberOf" : "Roo.Resizable",
658       "example" : "",
659       "deprecated" : "",
660       "since" : "",
661       "see" : "",
662       "params" : [
663         {
664           "name" : "this",
665           "type" : "Roo.Resizable",
666           "desc" : "",
667           "isOptional" : false
668         },
669         {
670           "name" : "width",
671           "type" : "Number",
672           "desc" : "The new width",
673           "isOptional" : false
674         },
675         {
676           "name" : "height",
677           "type" : "Number",
678           "desc" : "The new height",
679           "isOptional" : false
680         },
681         {
682           "name" : "e",
683           "type" : "Roo.EventObject",
684           "desc" : "The mouseup event",
685           "isOptional" : false
686         }
687       ],
688       "returns" : [
689       ]
690     },
691     {
692       "name" : "resizing",
693       "desc" : "Fired a resizing.",
694       "memberOf" : "Roo.Resizable",
695       "example" : "",
696       "deprecated" : "",
697       "since" : "",
698       "see" : "",
699       "params" : [
700         {
701           "name" : "this",
702           "type" : "Roo.Resizable",
703           "desc" : "",
704           "isOptional" : false
705         },
706         {
707           "name" : "x",
708           "type" : "Number",
709           "desc" : "The new x position",
710           "isOptional" : false
711         },
712         {
713           "name" : "y",
714           "type" : "Number",
715           "desc" : "The new y position",
716           "isOptional" : false
717         },
718         {
719           "name" : "w",
720           "type" : "Number",
721           "desc" : "The new w width",
722           "isOptional" : false
723         },
724         {
725           "name" : "h",
726           "type" : "Number",
727           "desc" : "The new h hight",
728           "isOptional" : false
729         },
730         {
731           "name" : "e",
732           "type" : "Roo.EventObject",
733           "desc" : "The mouseup event",
734           "isOptional" : false
735         }
736       ],
737       "returns" : [
738       ]
739     },
740     {
741       "name" : "beforeresize",
742       "desc" : "Fired before resize is allowed. Set enabled to false to cancel resize.",
743       "memberOf" : "Roo.Resizable",
744       "example" : "",
745       "deprecated" : "",
746       "since" : "",
747       "see" : "",
748       "params" : [
749         {
750           "name" : "this",
751           "type" : "Roo.Resizable",
752           "desc" : "",
753           "isOptional" : false
754         },
755         {
756           "name" : "e",
757           "type" : "Roo.EventObject",
758           "desc" : "The mousedown event",
759           "isOptional" : false
760         }
761       ],
762       "returns" : [
763       ]
764     }
765   ]
766 }