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

   1 {
   2   "name" : "Roo.TabPanelItem",
   3   "augments" : [
   4     "Roo.util.Observable"
   5   ],
   6   "desc" : "Represents an individual item (tab plus body) in a TabPanel.",
   7   "isSingleton" : false,
   8   "isStatic" : false,
   9   "isBuiltin" : false,
  10   "memberOf" : "TabPanelItem",
  11   "example" : "",
  12   "deprecated" : "",
  13   "since" : "",
  14   "see" : "",
  15   "params" : [
  16     {
  17       "name" : "tabPanel",
  18       "type" : "Roo.TabPanel",
  19       "desc" : "The {@link Roo.TabPanel} this TabPanelItem belongs to",
  20       "isOptional" : false
  21     },
  22     {
  23       "name" : "id",
  24       "type" : "String",
  25       "desc" : "The id of this TabPanelItem",
  26       "isOptional" : false
  27     },
  28     {
  29       "name" : "text",
  30       "type" : "String",
  31       "desc" : "The text for the tab of this TabPanelItem",
  32       "isOptional" : false
  33     },
  34     {
  35       "name" : "closable",
  36       "type" : "Boolean",
  37       "desc" : "True to allow this TabPanelItem to be closable (defaults to false)",
  38       "isOptional" : false
  39     }
  40   ],
  41   "returns" : [
  42   ],
  43   "config" : [
  44     {
  45       "name" : "listeners",
  46       "type" : "Object",
  47       "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>",
  48       "memberOf" : "Roo.util.Observable",
  49       "values" : [
  50       ]
  51     }
  52   ],
  53   "methods" : [
  54     {
  55       "name" : "setUrl",
  56       "desc" : "Set a URL to be used to load the content for this TabPanelItem.",
  57       "isStatic" : false,
  58       "isConstructor" : false,
  59       "isPrivate" : false,
  60       "memberOf" : "Roo.TabPanelItem",
  61       "example" : "",
  62       "deprecated" : "",
  63       "since" : "",
  64       "see" : "",
  65       "params" : [
  66         {
  67           "name" : "url",
  68           "type" : "String/Function",
  69           "desc" : "The URL to load the content from, or a function to call to get the URL",
  70           "isOptional" : false
  71         },
  72         {
  73           "name" : "params",
  74           "type" : "String/Object",
  75           "desc" : "(optional) The string params for the update call or an object of the params. See {@link Roo.UpdateManager#update} for more details. (Defaults to null)",
  76           "isOptional" : false
  77         },
  78         {
  79           "name" : "loadOnce",
  80           "type" : "Boolean",
  81           "desc" : "(optional) Whether to only load the content once. If this is false it makes the Ajax call every time this TabPanelItem is activated. (Defaults to false)",
  82           "isOptional" : false
  83         }
  84       ],
  85       "returns" : [
  86         {
  87           "name" : "",
  88           "type" : "Roo.UpdateManager",
  89           "desc" : "The UpdateManager"
  90         }
  91       ]
  92     },
  93     {
  94       "name" : "getText",
  95       "desc" : "Returns the text for this tab",
  96       "isStatic" : false,
  97       "isConstructor" : false,
  98       "isPrivate" : false,
  99       "memberOf" : "Roo.TabPanelItem",
 100       "example" : "",
 101       "deprecated" : "",
 102       "since" : "",
 103       "see" : "",
 104       "params" : [
 105       ],
 106       "returns" : [
 107         {
 108           "name" : "",
 109           "type" : "String",
 110           "desc" : ""
 111         }
 112       ]
 113     },
 114     {
 115       "name" : "isHidden",
 116       "desc" : "Returns true if this tab is \"hidden\"",
 117       "isStatic" : false,
 118       "isConstructor" : false,
 119       "isPrivate" : false,
 120       "memberOf" : "Roo.TabPanelItem",
 121       "example" : "",
 122       "deprecated" : "",
 123       "since" : "",
 124       "see" : "",
 125       "params" : [
 126       ],
 127       "returns" : [
 128         {
 129           "name" : "",
 130           "type" : "Boolean",
 131           "desc" : ""
 132         }
 133       ]
 134     },
 135     {
 136       "name" : "setText",
 137       "desc" : "Sets the text for the tab (Note: this also sets the tooltip text)",
 138       "isStatic" : false,
 139       "isConstructor" : false,
 140       "isPrivate" : false,
 141       "memberOf" : "Roo.TabPanelItem",
 142       "example" : "",
 143       "deprecated" : "",
 144       "since" : "",
 145       "see" : "",
 146       "params" : [
 147         {
 148           "name" : "text",
 149           "type" : "String",
 150           "desc" : "The tab's text and tooltip",
 151           "isOptional" : false
 152         }
 153       ],
 154       "returns" : [
 155       ]
 156     },
 157     {
 158       "name" : "activate",
 159       "desc" : "Activates this TabPanelItem -- this <b>does</b> deactivate the currently active TabPanelItem.",
 160       "isStatic" : false,
 161       "isConstructor" : false,
 162       "isPrivate" : false,
 163       "memberOf" : "Roo.TabPanelItem",
 164       "example" : "",
 165       "deprecated" : "",
 166       "since" : "",
 167       "see" : "",
 168       "params" : [
 169       ],
 170       "returns" : [
 171       ]
 172     },
 173     {
 174       "name" : "isActive",
 175       "desc" : "Returns true if this tab is the active tab.",
 176       "isStatic" : false,
 177       "isConstructor" : false,
 178       "isPrivate" : false,
 179       "memberOf" : "Roo.TabPanelItem",
 180       "example" : "",
 181       "deprecated" : "",
 182       "since" : "",
 183       "see" : "",
 184       "params" : [
 185       ],
 186       "returns" : [
 187         {
 188           "name" : "",
 189           "type" : "Boolean",
 190           "desc" : ""
 191         }
 192       ]
 193     },
 194     {
 195       "name" : "setContent",
 196       "desc" : "Sets the content for this TabPanelItem.",
 197       "isStatic" : false,
 198       "isConstructor" : false,
 199       "isPrivate" : false,
 200       "memberOf" : "Roo.TabPanelItem",
 201       "example" : "",
 202       "deprecated" : "",
 203       "since" : "",
 204       "see" : "",
 205       "params" : [
 206         {
 207           "name" : "content",
 208           "type" : "String",
 209           "desc" : "The content",
 210           "isOptional" : false
 211         },
 212         {
 213           "name" : "loadScripts",
 214           "type" : "Boolean",
 215           "desc" : "true to look for and load scripts",
 216           "isOptional" : false
 217         }
 218       ],
 219       "returns" : [
 220       ]
 221     },
 222     {
 223       "name" : "refresh",
 224       "desc" : "Forces a content refresh from the URL specified in the {@link #setUrl} method.\n  Will fail silently if the setUrl method has not been called.\n  This does not activate the panel, just updates its content.",
 225       "isStatic" : false,
 226       "isConstructor" : false,
 227       "isPrivate" : false,
 228       "memberOf" : "Roo.TabPanelItem",
 229       "example" : "",
 230       "deprecated" : "",
 231       "since" : "",
 232       "see" : "",
 233       "params" : [
 234       ],
 235       "returns" : [
 236       ]
 237     },
 238     {
 239       "name" : "setHidden",
 240       "desc" : "Show or hide the tab",
 241       "isStatic" : false,
 242       "isConstructor" : false,
 243       "isPrivate" : false,
 244       "memberOf" : "Roo.TabPanelItem",
 245       "example" : "",
 246       "deprecated" : "",
 247       "since" : "",
 248       "see" : "",
 249       "params" : [
 250         {
 251           "name" : "hidden",
 252           "type" : "Boolean",
 253           "desc" : "True to hide or false to show.",
 254           "isOptional" : false
 255         }
 256       ],
 257       "returns" : [
 258       ]
 259     },
 260     {
 261       "name" : "setTooltip",
 262       "desc" : "Set the tooltip for the tab.",
 263       "isStatic" : false,
 264       "isConstructor" : false,
 265       "isPrivate" : false,
 266       "memberOf" : "Roo.TabPanelItem",
 267       "example" : "",
 268       "deprecated" : "",
 269       "since" : "",
 270       "see" : "",
 271       "params" : [
 272         {
 273           "name" : "tooltip",
 274           "type" : "String",
 275           "desc" : "The tab's tooltip",
 276           "isOptional" : false
 277         }
 278       ],
 279       "returns" : [
 280       ]
 281     },
 282     {
 283       "name" : "enable",
 284       "desc" : "Enables this TabPanelItem if it was previously disabled.",
 285       "isStatic" : false,
 286       "isConstructor" : false,
 287       "isPrivate" : false,
 288       "memberOf" : "Roo.TabPanelItem",
 289       "example" : "",
 290       "deprecated" : "",
 291       "since" : "",
 292       "see" : "",
 293       "params" : [
 294       ],
 295       "returns" : [
 296       ]
 297     },
 298     {
 299       "name" : "getUpdateManager",
 300       "desc" : "Gets the {@link Roo.UpdateManager} for the body of this TabPanelItem. Enables you to perform Ajax updates.",
 301       "isStatic" : false,
 302       "isConstructor" : false,
 303       "isPrivate" : false,
 304       "memberOf" : "Roo.TabPanelItem",
 305       "example" : "",
 306       "deprecated" : "",
 307       "since" : "",
 308       "see" : "",
 309       "params" : [
 310       ],
 311       "returns" : [
 312         {
 313           "name" : "",
 314           "type" : "Roo.UpdateManager",
 315           "desc" : "The UpdateManager"
 316         }
 317       ]
 318     },
 319     {
 320       "name" : "disable",
 321       "desc" : "Disables this TabPanelItem -- this does nothing if this is the active TabPanelItem.",
 322       "isStatic" : false,
 323       "isConstructor" : false,
 324       "isPrivate" : false,
 325       "memberOf" : "Roo.TabPanelItem",
 326       "example" : "",
 327       "deprecated" : "",
 328       "since" : "",
 329       "see" : "",
 330       "params" : [
 331       ],
 332       "returns" : [
 333       ]
 334     },
 335     {
 336       "name" : "hide",
 337       "desc" : "Hides this TabPanelItem -- if you don't activate another TabPanelItem this could look odd.",
 338       "isStatic" : false,
 339       "isConstructor" : false,
 340       "isPrivate" : false,
 341       "memberOf" : "Roo.TabPanelItem",
 342       "example" : "",
 343       "deprecated" : "",
 344       "since" : "",
 345       "see" : "",
 346       "params" : [
 347       ],
 348       "returns" : [
 349       ]
 350     },
 351     {
 352       "name" : "show",
 353       "desc" : "Shows this TabPanelItem -- this <b>does not</b> deactivate the currently active TabPanelItem.",
 354       "isStatic" : false,
 355       "isConstructor" : false,
 356       "isPrivate" : false,
 357       "memberOf" : "Roo.TabPanelItem",
 358       "example" : "",
 359       "deprecated" : "",
 360       "since" : "",
 361       "see" : "",
 362       "params" : [
 363       ],
 364       "returns" : [
 365       ]
 366     },
 367     {
 368       "name" : "purgeListeners",
 369       "desc" : "Removes all listeners for this object",
 370       "isStatic" : false,
 371       "isConstructor" : false,
 372       "isPrivate" : false,
 373       "memberOf" : "Roo.util.Observable",
 374       "example" : "",
 375       "deprecated" : "",
 376       "since" : "",
 377       "see" : "",
 378       "params" : [
 379       ],
 380       "returns" : [
 381       ]
 382     },
 383     {
 384       "name" : "on",
 385       "desc" : "Appends an event handler to this element (shorthand for addListener)",
 386       "isStatic" : false,
 387       "isConstructor" : false,
 388       "isPrivate" : false,
 389       "memberOf" : "Roo.util.Observable",
 390       "example" : "",
 391       "deprecated" : "",
 392       "since" : "",
 393       "see" : "",
 394       "params" : [
 395         {
 396           "name" : "eventName",
 397           "type" : "String",
 398           "desc" : "The type of event to listen for",
 399           "isOptional" : false
 400         },
 401         {
 402           "name" : "handler",
 403           "type" : "Function",
 404           "desc" : "The method the event invokes",
 405           "isOptional" : false
 406         },
 407         {
 408           "name" : "scope",
 409           "type" : "Object",
 410           "desc" : "(optional) The scope in which to execute the handler\nfunction. The handler function's \"this\" context.",
 411           "isOptional" : false
 412         },
 413         {
 414           "name" : "options",
 415           "type" : "Object",
 416           "desc" : "(optional)",
 417           "isOptional" : false
 418         }
 419       ],
 420       "returns" : [
 421       ]
 422     },
 423     {
 424       "name" : "un",
 425       "desc" : "Removes a listener (shorthand for removeListener)",
 426       "isStatic" : false,
 427       "isConstructor" : false,
 428       "isPrivate" : false,
 429       "memberOf" : "Roo.util.Observable",
 430       "example" : "",
 431       "deprecated" : "",
 432       "since" : "",
 433       "see" : "",
 434       "params" : [
 435         {
 436           "name" : "eventName",
 437           "type" : "String",
 438           "desc" : "The type of event to listen for",
 439           "isOptional" : false
 440         },
 441         {
 442           "name" : "handler",
 443           "type" : "Function",
 444           "desc" : "The handler to remove",
 445           "isOptional" : false
 446         },
 447         {
 448           "name" : "scope",
 449           "type" : "Object",
 450           "desc" : "(optional) The scope (this object) for the handler",
 451           "isOptional" : false
 452         }
 453       ],
 454       "returns" : [
 455       ]
 456     },
 457     {
 458       "name" : "addEvents",
 459       "desc" : "Used to define events on this Observable",
 460       "isStatic" : false,
 461       "isConstructor" : false,
 462       "isPrivate" : false,
 463       "memberOf" : "Roo.util.Observable",
 464       "example" : "",
 465       "deprecated" : "",
 466       "since" : "",
 467       "see" : "",
 468       "params" : [
 469         {
 470           "name" : "object",
 471           "type" : "Object",
 472           "desc" : "The object with the events defined",
 473           "isOptional" : false
 474         }
 475       ],
 476       "returns" : [
 477       ]
 478     },
 479     {
 480       "name" : "releaseCapture",
 481       "desc" : "Removes <b>all</b> added captures from the Observable.",
 482       "isStatic" : true,
 483       "isConstructor" : false,
 484       "isPrivate" : false,
 485       "memberOf" : "Roo.util.Observable",
 486       "example" : "",
 487       "deprecated" : "",
 488       "since" : "",
 489       "see" : "",
 490       "params" : [
 491         {
 492           "name" : "o",
 493           "type" : "Observable",
 494           "desc" : "The Observable to release",
 495           "isOptional" : false
 496         }
 497       ],
 498       "returns" : [
 499       ]
 500     },
 501     {
 502       "name" : "removeListener",
 503       "desc" : "Removes a listener",
 504       "isStatic" : false,
 505       "isConstructor" : false,
 506       "isPrivate" : false,
 507       "memberOf" : "Roo.util.Observable",
 508       "example" : "",
 509       "deprecated" : "",
 510       "since" : "",
 511       "see" : "",
 512       "params" : [
 513         {
 514           "name" : "eventName",
 515           "type" : "String",
 516           "desc" : "The type of event to listen for",
 517           "isOptional" : false
 518         },
 519         {
 520           "name" : "handler",
 521           "type" : "Function",
 522           "desc" : "The handler to remove",
 523           "isOptional" : false
 524         },
 525         {
 526           "name" : "scope",
 527           "type" : "Object",
 528           "desc" : "(optional) The scope (this object) for the handler",
 529           "isOptional" : false
 530         }
 531       ],
 532       "returns" : [
 533       ]
 534     },
 535     {
 536       "name" : "fireEvent",
 537       "desc" : "Fires the specified event with the passed parameters (minus the event name).",
 538       "isStatic" : false,
 539       "isConstructor" : false,
 540       "isPrivate" : false,
 541       "memberOf" : "Roo.util.Observable",
 542       "example" : "",
 543       "deprecated" : "",
 544       "since" : "",
 545       "see" : "",
 546       "params" : [
 547         {
 548           "name" : "eventName",
 549           "type" : "String",
 550           "desc" : "",
 551           "isOptional" : false
 552         },
 553         {
 554           "name" : "args",
 555           "type" : "Object...",
 556           "desc" : "Variable number of parameters are passed to handlers",
 557           "isOptional" : false
 558         }
 559       ],
 560       "returns" : [
 561         {
 562           "name" : "",
 563           "type" : "Boolean",
 564           "desc" : "returns false if any of the handlers return false otherwise it returns true"
 565         }
 566       ]
 567     },
 568     {
 569       "name" : "hasListener",
 570       "desc" : "Checks to see if this object has any listeners for a specified event",
 571       "isStatic" : false,
 572       "isConstructor" : false,
 573       "isPrivate" : false,
 574       "memberOf" : "Roo.util.Observable",
 575       "example" : "",
 576       "deprecated" : "",
 577       "since" : "",
 578       "see" : "",
 579       "params" : [
 580         {
 581           "name" : "eventName",
 582           "type" : "String",
 583           "desc" : "The name of the event to check for",
 584           "isOptional" : false
 585         }
 586       ],
 587       "returns" : [
 588         {
 589           "name" : "",
 590           "type" : "Boolean",
 591           "desc" : "True if the event is being listened for, else false"
 592         }
 593       ]
 594     },
 595     {
 596       "name" : "capture",
 597       "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.",
 598       "isStatic" : true,
 599       "isConstructor" : false,
 600       "isPrivate" : false,
 601       "memberOf" : "Roo.util.Observable",
 602       "example" : "",
 603       "deprecated" : "",
 604       "since" : "",
 605       "see" : "",
 606       "params" : [
 607         {
 608           "name" : "o",
 609           "type" : "Observable",
 610           "desc" : "The Observable to capture",
 611           "isOptional" : false
 612         },
 613         {
 614           "name" : "fn",
 615           "type" : "Function",
 616           "desc" : "The function to call",
 617           "isOptional" : false
 618         },
 619         {
 620           "name" : "scope",
 621           "type" : "Object",
 622           "desc" : "(optional) The scope (this object) for the fn",
 623           "isOptional" : false
 624         }
 625       ],
 626       "returns" : [
 627       ]
 628     },
 629     {
 630       "name" : "addListener",
 631       "desc" : "Appends an event handler to this component",
 632       "isStatic" : false,
 633       "isConstructor" : false,
 634       "isPrivate" : false,
 635       "memberOf" : "Roo.util.Observable",
 636       "example" : "",
 637       "deprecated" : "",
 638       "since" : "",
 639       "see" : "",
 640       "params" : [
 641         {
 642           "name" : "eventName",
 643           "type" : "String",
 644           "desc" : "The type of event to listen for",
 645           "isOptional" : false
 646         },
 647         {
 648           "name" : "handler",
 649           "type" : "Function",
 650           "desc" : "The method the event invokes",
 651           "isOptional" : false
 652         },
 653         {
 654           "name" : "scope",
 655           "type" : "Object",
 656           "desc" : "(optional) The scope in which to execute the handler\nfunction. The handler function's \"this\" context.",
 657           "isOptional" : false
 658         },
 659         {
 660           "name" : "options",
 661           "type" : "Object",
 662           "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>",
 663           "isOptional" : false
 664         }
 665       ],
 666       "returns" : [
 667       ]
 668     }
 669   ],
 670   "events" : [
 671     {
 672       "name" : "beforeclose",
 673       "desc" : "Fires before this tab is closed. To cancel the close, set cancel to true on e (e.cancel = true).",
 674       "memberOf" : "Roo.TabPanelItem",
 675       "example" : "",
 676       "deprecated" : "",
 677       "since" : "",
 678       "see" : "",
 679       "params" : [
 680         {
 681           "name" : "this",
 682           "type" : "Roo.TabPanelItem",
 683           "desc" : "",
 684           "isOptional" : false
 685         },
 686         {
 687           "name" : "e",
 688           "type" : "Object",
 689           "desc" : "Set cancel to true on this object to cancel the close.",
 690           "isOptional" : false
 691         }
 692       ],
 693       "returns" : [
 694       ]
 695     },
 696     {
 697       "name" : "close",
 698       "desc" : "Fires when this tab is closed.",
 699       "memberOf" : "Roo.TabPanelItem",
 700       "example" : "",
 701       "deprecated" : "",
 702       "since" : "",
 703       "see" : "",
 704       "params" : [
 705         {
 706           "name" : "this",
 707           "type" : "Roo.TabPanelItem",
 708           "desc" : "",
 709           "isOptional" : false
 710         }
 711       ],
 712       "returns" : [
 713       ]
 714     },
 715     {
 716       "name" : "activate",
 717       "desc" : "Fires when this tab becomes the active tab.",
 718       "memberOf" : "Roo.TabPanelItem",
 719       "example" : "",
 720       "deprecated" : "",
 721       "since" : "",
 722       "see" : "",
 723       "params" : [
 724         {
 725           "name" : "tabPanel",
 726           "type" : "Roo.TabPanel",
 727           "desc" : "The parent TabPanel",
 728           "isOptional" : false
 729         },
 730         {
 731           "name" : "this",
 732           "type" : "Roo.TabPanelItem",
 733           "desc" : "",
 734           "isOptional" : false
 735         }
 736       ],
 737       "returns" : [
 738       ]
 739     },
 740     {
 741       "name" : "deactivate",
 742       "desc" : "Fires when this tab is no longer the active tab.",
 743       "memberOf" : "Roo.TabPanelItem",
 744       "example" : "",
 745       "deprecated" : "",
 746       "since" : "",
 747       "see" : "",
 748       "params" : [
 749         {
 750           "name" : "tabPanel",
 751           "type" : "Roo.TabPanel",
 752           "desc" : "The parent TabPanel",
 753           "isOptional" : false
 754         },
 755         {
 756           "name" : "this",
 757           "type" : "Roo.TabPanelItem",
 758           "desc" : "",
 759           "isOptional" : false
 760         }
 761       ],
 762       "returns" : [
 763       ]
 764     }
 765   ]
 766 }