git.roojs.org Git - roojs1/blob - docs2/symbols/Roo.bootstrap.panel.TabItem.json

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