git.roojs.org Git - roojs1/blob - docs/symbols/Roo.UpdateManager.json

   1 {
   2   "name" : "Roo.UpdateManager",
   3   "augments" : [
   4     "Roo.util.Observable"
   5   ],
   6   "childClasses" : {  },
   7   "tree_children" : [],
   8   "tree_parent" : [],
   9   "desc" : "Provides AJAX-style update for Element object.<br><br>\nUsage:<br>\n<pre><code>\n// Get it from a Roo.Element object\nvar el = Roo.get(\"foo\");\nvar mgr = el.getUpdateManager();\nmgr.update(\"http://myserver.com/index.php\", \"param1=1&amp;param2=2\");\n...\nmgr.formUpdate(\"myFormId\", \"http://myserver.com/index.php\");\n<br>\n// or directly (returns the same UpdateManager instance)\nvar mgr = new Roo.UpdateManager(\"myElementId\");\nmgr.startAutoRefresh(60, \"http://myserver.com/index.php\");\nmgr.on(\"update\", myFcnNeedsToKnow);\n<br>\n   // short handed call directly from the element object\n   Roo.get(\"foo\").load({\n        url: \"bar.php\",\n        scripts:true,\n        params: \"for=bar\",\n        text: \"Loading Foo...\"\n   });\n</code></pre>",
  10   "isSingleton" : false,
  11   "isStatic" : false,
  12   "isBuiltin" : false,
  13   "isAbstract" : false,
  14   "isBuilderTop" : false,
  15   "memberOf" : "UpdateManager",
  16   "example" : "",
  17   "deprecated" : "",
  18   "since" : "",
  19   "see" : "",
  20   "params" : [
  21     {
  22       "name" : "el",
  23       "type" : "String/HTMLElement/Roo.Element",
  24       "desc" : "The element to update",
  25       "isOptional" : false
  26     },
  27     {
  28       "name" : "forceNew",
  29       "type" : "Boolean",
  30       "desc" : "(optional) By default the constructor checks to see if the passed element already has an UpdateManager and if it does it returns the same instance. This will skip that check (useful for extending this class).",
  31       "isOptional" : false
  32     }
  33   ],
  34   "returns" : [],
  35   "throws" : "",
  36   "requires" : "",
  37   "config" : [
  38     {
  39       "name" : "listeners",
  40       "type" : "Object",
  41       "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>",
  42       "memberOf" : "Roo.util.Observable",
  43       "isOptional" : false,
  44       "optvalues" : []
  45     }
  46   ],
  47   "methods" : [
  48     {
  49       "name" : "update",
  50       "type" : "function",
  51       "desc" : "Performs an async request, updating this element with the response. If params are specified it uses POST, otherwise it uses GET.",
  52       "sig" : "(url, params, callback, discardUrl)",
  53       "static" : false,
  54       "memberOf" : "",
  55       "isStatic" : false,
  56       "isConstructor" : false,
  57       "isPrivate" : false,
  58       "example" : "",
  59       "deprecated" : "",
  60       "since" : "",
  61       "see" : "",
  62       "exceptions" : "",
  63       "requires" : "",
  64       "params" : [
  65         {
  66           "name" : "url",
  67           "type" : "Object/String/Function",
  68           "desc" : "The url for this request or a function to call to get the url or a config object containing any of the following options:\n<pre><code>\num.update({<br/>\n    url: \"your-url.php\",<br/>\n    params: {param1: \"foo\", param2: \"bar\"}, // or a URL encoded string<br/>\n    callback: yourFunction,<br/>\n    scope: yourObject, //(optional scope)  <br/>\n    discardUrl: false, <br/>\n    nocache: false,<br/>\n    text: \"Loading...\",<br/>\n    timeout: 30,<br/>\n    scripts: false<br/>\n});\n</code></pre>\nThe only required property is url. The optional properties nocache, text and scripts\nare shorthand for disableCaching, indicatorText and loadScripts and are used to set their associated property on this UpdateManager instance.",
  69           "isOptional" : false
  70         },
  71         {
  72           "name" : "params",
  73           "type" : "String/Object",
  74           "desc" : "(optional) The parameters to pass as either a url encoded string \"param1=1&amp;param2=2\" or an object {param1: 1, param2: 2}",
  75           "isOptional" : false
  76         },
  77         {
  78           "name" : "callback",
  79           "type" : "Function",
  80           "desc" : "(optional) Callback when transaction is complete - called with signature (oElement, bSuccess, oResponse)",
  81           "isOptional" : false
  82         },
  83         {
  84           "name" : "discardUrl",
  85           "type" : "Boolean",
  86           "desc" : "(optional) By default when you execute an update the defaultUrl is changed to the last used url. If true, it will not store the url.",
  87           "isOptional" : false
  88         }
  89       ],
  90       "returns" : []
  91     },
  92     {
  93       "name" : "showLoading",
  94       "type" : "function",
  95       "desc" : "Called to update the element to \"Loading\" state. Override to perform custom action.",
  96       "sig" : "()\n{\n\n}",
  97       "static" : false,
  98       "memberOf" : "",
  99       "isStatic" : false,
 100       "isConstructor" : false,
 101       "isPrivate" : false,
 102       "example" : "",
 103       "deprecated" : "",
 104       "since" : "",
 105       "see" : "",
 106       "exceptions" : "",
 107       "requires" : "",
 108       "params" : [],
 109       "returns" : []
 110     },
 111     {
 112       "name" : "setDefaultUrl",
 113       "type" : "function",
 114       "desc" : "Set the defaultUrl used for updates",
 115       "sig" : "(defaultUrl)",
 116       "static" : false,
 117       "memberOf" : "",
 118       "isStatic" : false,
 119       "isConstructor" : false,
 120       "isPrivate" : false,
 121       "example" : "",
 122       "deprecated" : "",
 123       "since" : "",
 124       "see" : "",
 125       "exceptions" : "",
 126       "requires" : "",
 127       "params" : [
 128         {
 129           "name" : "defaultUrl",
 130           "type" : "String/Function",
 131           "desc" : "The url or a function to call to get the url",
 132           "isOptional" : false
 133         }
 134       ],
 135       "returns" : []
 136     },
 137     {
 138       "name" : "updateElement",
 139       "type" : "function",
 140       "desc" : "Static convenience method. This method is deprecated in favor of el.load({url:'foo.php', ...}).\nUsage:\n<pre><code>Roo.UpdateManager.updateElement(\"my-div\", \"stuff.php\");</code></pre>",
 141       "sig" : "(el, url, params, options)",
 142       "static" : true,
 143       "memberOf" : "",
 144       "isStatic" : true,
 145       "isConstructor" : false,
 146       "isPrivate" : false,
 147       "example" : "",
 148       "deprecated" : "This has been deprecated: ",
 149       "since" : "",
 150       "see" : "",
 151       "exceptions" : "",
 152       "requires" : "",
 153       "params" : [
 154         {
 155           "name" : "el",
 156           "type" : "String/HTMLElement/Roo.Element",
 157           "desc" : "The element to update",
 158           "isOptional" : false
 159         },
 160         {
 161           "name" : "url",
 162           "type" : "String",
 163           "desc" : "The url",
 164           "isOptional" : false
 165         },
 166         {
 167           "name" : "params",
 168           "type" : "String/Object",
 169           "desc" : "(optional) Url encoded param string or an object of name/value pairs",
 170           "isOptional" : false
 171         },
 172         {
 173           "name" : "options",
 174           "type" : "Object",
 175           "desc" : "(optional) A config object with any of the UpdateManager properties you want to set - for example: {disableCaching:true, indicatorText: \"Loading data...\"}",
 176           "isOptional" : false
 177         }
 178       ],
 179       "returns" : []
 180     },
 181     {
 182       "name" : "refresh",
 183       "type" : "function",
 184       "desc" : "Refresh the element with the last used url or defaultUrl. If there is no url, it returns immediately",
 185       "sig" : "(callback)",
 186       "static" : false,
 187       "memberOf" : "",
 188       "isStatic" : false,
 189       "isConstructor" : false,
 190       "isPrivate" : false,
 191       "example" : "",
 192       "deprecated" : "",
 193       "since" : "",
 194       "see" : "",
 195       "exceptions" : "",
 196       "requires" : "",
 197       "params" : [
 198         {
 199           "name" : "callback",
 200           "type" : "Function",
 201           "desc" : "(optional) Callback when transaction is complete - called with signature (oElement, bSuccess)",
 202           "isOptional" : false
 203         }
 204       ],
 205       "returns" : []
 206     },
 207     {
 208       "name" : "getEl",
 209       "type" : "function",
 210       "desc" : "Get the Element this UpdateManager is bound to",
 211       "sig" : "()\n{\n\n}",
 212       "static" : false,
 213       "memberOf" : "",
 214       "isStatic" : false,
 215       "isConstructor" : false,
 216       "isPrivate" : false,
 217       "example" : "",
 218       "deprecated" : "",
 219       "since" : "",
 220       "see" : "",
 221       "exceptions" : "",
 222       "requires" : "",
 223       "params" : [],
 224       "returns" : [
 225         {
 226           "name" : "",
 227           "type" : "Roo.Element",
 228           "desc" : "The element"
 229         }
 230       ]
 231     },
 232     {
 233       "name" : "isUpdating",
 234       "type" : "function",
 235       "desc" : "Returns true if an update is in progress",
 236       "sig" : "()\n{\n\n}",
 237       "static" : false,
 238       "memberOf" : "",
 239       "isStatic" : false,
 240       "isConstructor" : false,
 241       "isPrivate" : false,
 242       "example" : "",
 243       "deprecated" : "",
 244       "since" : "",
 245       "see" : "",
 246       "exceptions" : "",
 247       "requires" : "",
 248       "params" : [],
 249       "returns" : [
 250         {
 251           "name" : "",
 252           "type" : "Boolean",
 253           "desc" : ""
 254         }
 255       ]
 256     },
 257     {
 258       "name" : "stopAutoRefresh",
 259       "type" : "function",
 260       "desc" : "Stop auto refresh on this element.",
 261       "sig" : "()\n{\n\n}",
 262       "static" : false,
 263       "memberOf" : "",
 264       "isStatic" : false,
 265       "isConstructor" : false,
 266       "isPrivate" : false,
 267       "example" : "",
 268       "deprecated" : "",
 269       "since" : "",
 270       "see" : "",
 271       "exceptions" : "",
 272       "requires" : "",
 273       "params" : [],
 274       "returns" : []
 275     },
 276     {
 277       "name" : "startAutoRefresh",
 278       "type" : "function",
 279       "desc" : "Set this element to auto refresh.",
 280       "sig" : "(interval, url, params, callback, refreshNow)",
 281       "static" : false,
 282       "memberOf" : "",
 283       "isStatic" : false,
 284       "isConstructor" : false,
 285       "isPrivate" : false,
 286       "example" : "",
 287       "deprecated" : "",
 288       "since" : "",
 289       "see" : "",
 290       "exceptions" : "",
 291       "requires" : "",
 292       "params" : [
 293         {
 294           "name" : "interval",
 295           "type" : "Number",
 296           "desc" : "How often to update (in seconds).",
 297           "isOptional" : false
 298         },
 299         {
 300           "name" : "url",
 301           "type" : "String/Function",
 302           "desc" : "(optional) The url for this request or a function to call to get the url (Defaults to the last used url)",
 303           "isOptional" : false
 304         },
 305         {
 306           "name" : "params",
 307           "type" : "String/Object",
 308           "desc" : "(optional) The parameters to pass as either a url encoded string \"&param1=1&param2=2\" or as an object {param1: 1, param2: 2}",
 309           "isOptional" : false
 310         },
 311         {
 312           "name" : "callback",
 313           "type" : "Function",
 314           "desc" : "(optional) Callback when transaction is complete - called with signature (oElement, bSuccess)",
 315           "isOptional" : false
 316         },
 317         {
 318           "name" : "refreshNow",
 319           "type" : "Boolean",
 320           "desc" : "(optional) Whether to execute the refresh now, or wait the interval",
 321           "isOptional" : false
 322         }
 323       ],
 324       "returns" : []
 325     },
 326     {
 327       "name" : "abort",
 328       "type" : "function",
 329       "desc" : "Aborts the executing transaction",
 330       "sig" : "()\n{\n\n}",
 331       "static" : false,
 332       "memberOf" : "",
 333       "isStatic" : false,
 334       "isConstructor" : false,
 335       "isPrivate" : false,
 336       "example" : "",
 337       "deprecated" : "",
 338       "since" : "",
 339       "see" : "",
 340       "exceptions" : "",
 341       "requires" : "",
 342       "params" : [],
 343       "returns" : []
 344     },
 345     {
 346       "name" : "setRenderer",
 347       "type" : "function",
 348       "desc" : "Set the content renderer for this UpdateManager. See {@link Roo.UpdateManager.BasicRenderer#render} for more details.",
 349       "sig" : "(renderer)",
 350       "static" : false,
 351       "memberOf" : "",
 352       "isStatic" : false,
 353       "isConstructor" : false,
 354       "isPrivate" : false,
 355       "example" : "",
 356       "deprecated" : "",
 357       "since" : "",
 358       "see" : "",
 359       "exceptions" : "",
 360       "requires" : "",
 361       "params" : [
 362         {
 363           "name" : "renderer",
 364           "type" : "Object",
 365           "desc" : "The object implementing the render() method",
 366           "isOptional" : false
 367         }
 368       ],
 369       "returns" : []
 370     },
 371     {
 372       "name" : "formUpdate",
 373       "type" : "function",
 374       "desc" : "Performs an async form post, updating this element with the response. If the form has the attribute enctype=\"multipart/form-data\", it assumes it's a file upload.\nUses this.sslBlankUrl for SSL file uploads to prevent IE security warning.",
 375       "sig" : "(form, url, reset, callback)",
 376       "static" : false,
 377       "memberOf" : "",
 378       "isStatic" : false,
 379       "isConstructor" : false,
 380       "isPrivate" : false,
 381       "example" : "",
 382       "deprecated" : "",
 383       "since" : "",
 384       "see" : "",
 385       "exceptions" : "",
 386       "requires" : "",
 387       "params" : [
 388         {
 389           "name" : "form",
 390           "type" : "String/HTMLElement",
 391           "desc" : "The form Id or form element",
 392           "isOptional" : false
 393         },
 394         {
 395           "name" : "url",
 396           "type" : "String",
 397           "desc" : "(optional) The url to pass the form to. If omitted the action attribute on the form will be used.",
 398           "isOptional" : false
 399         },
 400         {
 401           "name" : "reset",
 402           "type" : "Boolean",
 403           "desc" : "(optional) Whether to try to reset the form after the update",
 404           "isOptional" : false
 405         },
 406         {
 407           "name" : "callback",
 408           "type" : "Function",
 409           "desc" : "(optional) Callback when transaction is complete - called with signature (oElement, bSuccess, oResponse)",
 410           "isOptional" : false
 411         }
 412       ],
 413       "returns" : []
 414     },
 415     {
 416       "name" : "purgeListeners",
 417       "type" : "function",
 418       "desc" : "Removes all listeners for this object",
 419       "sig" : "()\n{\n\n}",
 420       "static" : false,
 421       "memberOf" : "Roo.util.Observable",
 422       "isStatic" : false,
 423       "isConstructor" : false,
 424       "isPrivate" : false,
 425       "example" : "",
 426       "deprecated" : "",
 427       "since" : "",
 428       "see" : "",
 429       "exceptions" : "",
 430       "requires" : "",
 431       "params" : [],
 432       "returns" : []
 433     },
 434     {
 435       "name" : "on",
 436       "type" : "function",
 437       "desc" : "Appends an event handler to this element (shorthand for addListener)",
 438       "sig" : "(eventName, handler, scope, options)",
 439       "static" : false,
 440       "memberOf" : "Roo.util.Observable",
 441       "isStatic" : false,
 442       "isConstructor" : false,
 443       "isPrivate" : false,
 444       "example" : "",
 445       "deprecated" : "",
 446       "since" : "",
 447       "see" : "",
 448       "exceptions" : "",
 449       "requires" : "",
 450       "params" : [
 451         {
 452           "name" : "eventName",
 453           "type" : "String",
 454           "desc" : "The type of event to listen for",
 455           "isOptional" : false
 456         },
 457         {
 458           "name" : "handler",
 459           "type" : "Function",
 460           "desc" : "The method the event invokes",
 461           "isOptional" : false
 462         },
 463         {
 464           "name" : "scope",
 465           "type" : "Object",
 466           "desc" : "(optional) The scope in which to execute the handler\nfunction. The handler function's \"this\" context.",
 467           "isOptional" : false
 468         },
 469         {
 470           "name" : "options",
 471           "type" : "Object",
 472           "desc" : "(optional)",
 473           "isOptional" : false
 474         }
 475       ],
 476       "returns" : []
 477     },
 478     {
 479       "name" : "un",
 480       "type" : "function",
 481       "desc" : "Removes a listener (shorthand for removeListener)",
 482       "sig" : "(eventName, handler, scope)",
 483       "static" : false,
 484       "memberOf" : "Roo.util.Observable",
 485       "isStatic" : false,
 486       "isConstructor" : false,
 487       "isPrivate" : false,
 488       "example" : "",
 489       "deprecated" : "",
 490       "since" : "",
 491       "see" : "",
 492       "exceptions" : "",
 493       "requires" : "",
 494       "params" : [
 495         {
 496           "name" : "eventName",
 497           "type" : "String",
 498           "desc" : "The type of event to listen for",
 499           "isOptional" : false
 500         },
 501         {
 502           "name" : "handler",
 503           "type" : "Function",
 504           "desc" : "The handler to remove",
 505           "isOptional" : false
 506         },
 507         {
 508           "name" : "scope",
 509           "type" : "Object",
 510           "desc" : "(optional) The scope (this object) for the handler",
 511           "isOptional" : false
 512         }
 513       ],
 514       "returns" : []
 515     },
 516     {
 517       "name" : "addEvents",
 518       "type" : "function",
 519       "desc" : "Used to define events on this Observable",
 520       "sig" : "(object)",
 521       "static" : false,
 522       "memberOf" : "Roo.util.Observable",
 523       "isStatic" : false,
 524       "isConstructor" : false,
 525       "isPrivate" : false,
 526       "example" : "",
 527       "deprecated" : "",
 528       "since" : "",
 529       "see" : "",
 530       "exceptions" : "",
 531       "requires" : "",
 532       "params" : [
 533         {
 534           "name" : "object",
 535           "type" : "Object",
 536           "desc" : "The object with the events defined",
 537           "isOptional" : false
 538         }
 539       ],
 540       "returns" : []
 541     },
 542     {
 543       "name" : "releaseCapture",
 544       "type" : "function",
 545       "desc" : "Removes <b>all</b> added captures from the Observable.",
 546       "sig" : "(o)",
 547       "static" : true,
 548       "memberOf" : "Roo.util.Observable",
 549       "isStatic" : true,
 550       "isConstructor" : false,
 551       "isPrivate" : false,
 552       "example" : "",
 553       "deprecated" : "",
 554       "since" : "",
 555       "see" : "",
 556       "exceptions" : "",
 557       "requires" : "",
 558       "params" : [
 559         {
 560           "name" : "o",
 561           "type" : "Observable",
 562           "desc" : "The Observable to release",
 563           "isOptional" : false
 564         }
 565       ],
 566       "returns" : []
 567     },
 568     {
 569       "name" : "removeListener",
 570       "type" : "function",
 571       "desc" : "Removes a listener",
 572       "sig" : "(eventName, handler, scope)",
 573       "static" : false,
 574       "memberOf" : "Roo.util.Observable",
 575       "isStatic" : false,
 576       "isConstructor" : false,
 577       "isPrivate" : false,
 578       "example" : "",
 579       "deprecated" : "",
 580       "since" : "",
 581       "see" : "",
 582       "exceptions" : "",
 583       "requires" : "",
 584       "params" : [
 585         {
 586           "name" : "eventName",
 587           "type" : "String",
 588           "desc" : "The type of event to listen for",
 589           "isOptional" : false
 590         },
 591         {
 592           "name" : "handler",
 593           "type" : "Function",
 594           "desc" : "The handler to remove",
 595           "isOptional" : false
 596         },
 597         {
 598           "name" : "scope",
 599           "type" : "Object",
 600           "desc" : "(optional) The scope (this object) for the handler",
 601           "isOptional" : false
 602         }
 603       ],
 604       "returns" : []
 605     },
 606     {
 607       "name" : "fireEvent",
 608       "type" : "function",
 609       "desc" : "Fires the specified event with the passed parameters (minus the event name).",
 610       "sig" : "(eventName, args)",
 611       "static" : false,
 612       "memberOf" : "Roo.util.Observable",
 613       "isStatic" : false,
 614       "isConstructor" : false,
 615       "isPrivate" : false,
 616       "example" : "",
 617       "deprecated" : "",
 618       "since" : "",
 619       "see" : "",
 620       "exceptions" : "",
 621       "requires" : "",
 622       "params" : [
 623         {
 624           "name" : "eventName",
 625           "type" : "String",
 626           "desc" : "",
 627           "isOptional" : false
 628         },
 629         {
 630           "name" : "args",
 631           "type" : "Object...",
 632           "desc" : "Variable number of parameters are passed to handlers",
 633           "isOptional" : false
 634         }
 635       ],
 636       "returns" : [
 637         {
 638           "name" : "",
 639           "type" : "Boolean",
 640           "desc" : "returns false if any of the handlers return false otherwise it returns true"
 641         }
 642       ]
 643     },
 644     {
 645       "name" : "hasListener",
 646       "type" : "function",
 647       "desc" : "Checks to see if this object has any listeners for a specified event",
 648       "sig" : "(eventName)",
 649       "static" : false,
 650       "memberOf" : "Roo.util.Observable",
 651       "isStatic" : false,
 652       "isConstructor" : false,
 653       "isPrivate" : false,
 654       "example" : "",
 655       "deprecated" : "",
 656       "since" : "",
 657       "see" : "",
 658       "exceptions" : "",
 659       "requires" : "",
 660       "params" : [
 661         {
 662           "name" : "eventName",
 663           "type" : "String",
 664           "desc" : "The name of the event to check for",
 665           "isOptional" : false
 666         }
 667       ],
 668       "returns" : [
 669         {
 670           "name" : "",
 671           "type" : "Boolean",
 672           "desc" : "True if the event is being listened for, else false"
 673         }
 674       ]
 675     },
 676     {
 677       "name" : "capture",
 678       "type" : "function",
 679       "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.",
 680       "sig" : "(o, fn, scope)",
 681       "static" : true,
 682       "memberOf" : "Roo.util.Observable",
 683       "isStatic" : true,
 684       "isConstructor" : false,
 685       "isPrivate" : false,
 686       "example" : "",
 687       "deprecated" : "",
 688       "since" : "",
 689       "see" : "",
 690       "exceptions" : "",
 691       "requires" : "",
 692       "params" : [
 693         {
 694           "name" : "o",
 695           "type" : "Observable",
 696           "desc" : "The Observable to capture",
 697           "isOptional" : false
 698         },
 699         {
 700           "name" : "fn",
 701           "type" : "Function",
 702           "desc" : "The function to call",
 703           "isOptional" : false
 704         },
 705         {
 706           "name" : "scope",
 707           "type" : "Object",
 708           "desc" : "(optional) The scope (this object) for the fn",
 709           "isOptional" : false
 710         }
 711       ],
 712       "returns" : []
 713     },
 714     {
 715       "name" : "addListener",
 716       "type" : "function",
 717       "desc" : "Appends an event handler to this component",
 718       "sig" : "(eventName, handler, scope, options)",
 719       "static" : false,
 720       "memberOf" : "Roo.util.Observable",
 721       "isStatic" : false,
 722       "isConstructor" : false,
 723       "isPrivate" : false,
 724       "example" : "",
 725       "deprecated" : "",
 726       "since" : "",
 727       "see" : "",
 728       "exceptions" : "",
 729       "requires" : "",
 730       "params" : [
 731         {
 732           "name" : "eventName",
 733           "type" : "String",
 734           "desc" : "The type of event to listen for",
 735           "isOptional" : false
 736         },
 737         {
 738           "name" : "handler",
 739           "type" : "Function",
 740           "desc" : "The method the event invokes",
 741           "isOptional" : false
 742         },
 743         {
 744           "name" : "scope",
 745           "type" : "Object",
 746           "desc" : "(optional) The scope in which to execute the handler\nfunction. The handler function's \"this\" context.",
 747           "isOptional" : false
 748         },
 749         {
 750           "name" : "options",
 751           "type" : "Object",
 752           "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>",
 753           "isOptional" : false
 754         }
 755       ],
 756       "returns" : []
 757     }
 758   ],
 759   "events" : [
 760     {
 761       "name" : "update",
 762       "type" : "function",
 763       "desc" : "Fired after successful update is made.",
 764       "sig" : "function (el, oResponseObject)\n{\n\n}",
 765       "memberOf" : "",
 766       "example" : "",
 767       "deprecated" : "",
 768       "since" : "",
 769       "see" : "",
 770       "params" : [
 771         {
 772           "name" : "el",
 773           "type" : "Roo.Element",
 774           "desc" : "",
 775           "isOptional" : false
 776         },
 777         {
 778           "name" : "oResponseObject",
 779           "type" : "Object",
 780           "desc" : "The response Object",
 781           "isOptional" : false
 782         }
 783       ],
 784       "returns" : []
 785     },
 786     {
 787       "name" : "beforeupdate",
 788       "type" : "function",
 789       "desc" : "Fired before an update is made, return false from your handler and the update is cancelled.",
 790       "sig" : "function (el, url, params)\n{\n\n}",
 791       "memberOf" : "",
 792       "example" : "",
 793       "deprecated" : "",
 794       "since" : "",
 795       "see" : "",
 796       "params" : [
 797         {
 798           "name" : "el",
 799           "type" : "Roo.Element",
 800           "desc" : "",
 801           "isOptional" : false
 802         },
 803         {
 804           "name" : "url",
 805           "type" : "String/Object/Function",
 806           "desc" : "",
 807           "isOptional" : false
 808         },
 809         {
 810           "name" : "params",
 811           "type" : "String/Object",
 812           "desc" : "",
 813           "isOptional" : false
 814         }
 815       ],
 816       "returns" : []
 817     },
 818     {
 819       "name" : "failure",
 820       "type" : "function",
 821       "desc" : "Fired on update failure.",
 822       "sig" : "function (el, oResponseObject)\n{\n\n}",
 823       "memberOf" : "",
 824       "example" : "",
 825       "deprecated" : "",
 826       "since" : "",
 827       "see" : "",
 828       "params" : [
 829         {
 830           "name" : "el",
 831           "type" : "Roo.Element",
 832           "desc" : "",
 833           "isOptional" : false
 834         },
 835         {
 836           "name" : "oResponseObject",
 837           "type" : "Object",
 838           "desc" : "The response Object",
 839           "isOptional" : false
 840         }
 841       ],
 842       "returns" : []
 843     }
 844   ]
 845 }