2
<ul class="UIAPIPlugin-toc">
3
<li><a href="#overview">Overview</a></li>
4
<li><a href="#options">Options</a></li>
5
<li><a href="#events">Events</a></li>
6
<li><a href="#methods">Methods</a></li>
7
<li><a href="#theming">Theming</a></li>
9
<div class="UIAPIPlugin">
10
<h1>jQuery UI Tabs</h1>
12
<h2 class="top-header">Overview</h2>
13
<div id="overview-main">
14
<p>Tabs are generally used to break content into multiple sections that can be swapped to save space, much like an accordion.</p>
15
<p>By default a tab widget will swap between tabbed sections onClick, but the events can be changed to onHover through an option. Tab content can be loaded via Ajax by setting an href on a tab.</p>
16
<table id="toc" class="toc" summary="Contents"><tr><td><div id="toctitle"><h2>Contents</h2></div>
18
<li class="toclevel-1"><a href="#Events"><span class="tocnumber">1</span> <span class="toctext">Events</span></a></li>
19
<li class="toclevel-1"><a href="#Ajax_mode"><span class="tocnumber">2</span> <span class="toctext">Ajax mode</span></a>
21
<li class="toclevel-2"><a href="#Back_button_and_bookmarking"><span class="tocnumber">2.1</span> <span class="toctext">Back button and bookmarking</span></a></li>
24
<li class="toclevel-1"><a href="#How_to..."><span class="tocnumber">3</span> <span class="toctext">How to...</span></a>
26
<li class="toclevel-2"><a href="#...retrieve_the_index_of_the_currently_selected_tab"><span class="tocnumber">3.1</span> <span class="toctext">...retrieve the index of the currently selected tab</span></a></li>
27
<li class="toclevel-2"><a href="#...open_links_in_the_current_tab_instead_of_leaving_the_page"><span class="tocnumber">3.2</span> <span class="toctext">...open links in the current tab instead of leaving the page</span></a></li>
28
<li class="toclevel-2"><a href="#...select_a_tab_from_a_text_link_instead_of_clicking_a_tab_itself"><span class="tocnumber">3.3</span> <span class="toctext">...select a tab from a text link instead of clicking a tab itself</span></a></li>
29
<li class="toclevel-2"><a href="#...prevent_switching_to_the_tab_on_click_depending_on_form_validation"><span class="tocnumber">3.4</span> <span class="toctext">...prevent switching to the tab on click depending on form validation</span></a></li>
30
<li class="toclevel-2"><a href="#...immediately_select_a_just_added_tab"><span class="tocnumber">3.5</span> <span class="toctext">...immediately select a just added tab</span></a></li>
31
<li class="toclevel-2"><a href="#...open_a_tab_in_a_new_window_instead"><span class="tocnumber">3.6</span> <span class="toctext">...open a tab in a new window instead</span></a></li>
32
<li class="toclevel-2"><a href="#...prevent_a_FOUC_.28Flash_of_Unstyled_Content.29_before_tabs_are_initialized"><span class="tocnumber">3.7</span> <span class="toctext">...prevent a FOUC (Flash of Unstyled Content) before tabs are initialized</span></a></li>
35
<li class="toclevel-1"><a href="#Why_does..."><span class="tocnumber">4</span> <span class="toctext">Why does...</span></a>
37
<li class="toclevel-2"><a href="#...my_slider.2C_Google_Map.2C_sIFR_etc._not_work_when_placed_in_a_hidden_.28inactive.29_tab.3F"><span class="tocnumber">4.1</span> <span class="toctext">...my slider, Google Map, sIFR etc. not work when placed in a hidden (inactive) tab?</span></a></li>
41
</td></tr></table><script type="text/javascript"> if (window.showTocToggle) { var tocShowText = "show"; var tocHideText = "hide"; showTocToggle(); } </script>
42
<div class="editsection" style="float:right;margin-left:5px;">[<a href="http://docs.jquery.com/action/edit/Template:UIAPIPlugin?section=1" title="Template:UIAPIPlugin">edit</a>]</div><a name="Events"></a><h2>Events</h2>
43
<p>A series of events fire when interacting with a tabs interface:
45
<ul><li> tabsselect, tabsload, tabsshow (in that order)
46
</li><li> tabsadd, tabsremove
47
</li><li> tabsenable, tabsdisable
49
<p>Event binding example:
51
<pre>$('#example').bind('tabsselect', function(event, ui) {
53
// Objects available in the function context:
54
ui.tab // anchor element of the selected (clicked) tab
55
ui.panel // element, that contains the selected/clicked tab contents
56
ui.index // zero-based index of the selected (clicked) tab
59
<p>Note that if a handler for the tabsselect event returns false, the clicked tab will not become selected (useful for example if switching to the next tab requires a form validation).
61
<div class="editsection" style="float:right;margin-left:5px;">[<a href="http://docs.jquery.com/action/edit/Template:UIAPIPlugin?section=2" title="Template:UIAPIPlugin">edit</a>]</div><a name="Ajax_mode"></a><h2> Ajax mode </h2>
62
<p>Tabs supports loading tab content via Ajax in an unobtrusive manner.
63
</p><p>The HTML you need is slightly different from the one that is used for static tabs: A list of links pointing to existing resources (from where the content gets loaded) and no additional containers at all (unobtrusive!). The containers' markup is going to be created on the fly:
66
<div id="example">
68
<li><a href="ahah_1.html"><span>Content 1</span></a></li>
69
<li><a href="ahah_2.html"><span>Content 2</span></a></li>
70
<li><a href="ahah_3.html"><span>Content 3</span></a></li>
74
<p>Obviously this degrades gracefully - the links, e.g. the content, will still be accessible with JavaScript disabled.
75
</p><p>Note that if you wish to reuse an existing container, you
76
could do so by matching a title attribute and the container's id:
79
<li><a href="hello/world.html" title="Todo Overview"> ... </a></li>
81
<p>and a container like:
84
<div id="Todo_Overview"> ... </div>
86
<p>(Note how white space is replaced with an underscore)
87
</p><p>This is useful if you want a human readable hash in the URL instead of
88
a cryptic generated one.
90
<div class="editsection" style="float:right;margin-left:5px;">[<a href="http://docs.jquery.com/action/edit/Template:UIAPIPlugin?section=3" title="Template:UIAPIPlugin">edit</a>]</div><a name="Back_button_and_bookmarking"></a><h3>Back button and bookmarking</h3>
91
<p>Tabs 2 already supported this functionality, although the history plugin needs a rewrite first (it doesn't support Safari 3 and is in general a little inflexible) before it can be build back into the tabs. It is planned and Klaus is working on it whenever he finds the time. Actual bugs in the UI Tabs plugin itself always have higher priority though.
93
<div class="editsection" style="float:right;margin-left:5px;">[<a href="http://docs.jquery.com/action/edit/Template:UIAPIPlugin?section=4" title="Template:UIAPIPlugin">edit</a>]</div><a name="How_to..."></a><h2>How to...</h2>
94
<div class="editsection" style="float:right;margin-left:5px;">[<a href="http://docs.jquery.com/action/edit/Template:UIAPIPlugin?section=5" title="Template:UIAPIPlugin">edit</a>]</div><a name="...retrieve_the_index_of_the_currently_selected_tab"></a><h3>...retrieve the index of the currently selected tab</h3>
95
<pre>var $tabs = $('#example').tabs();
96
var selected = $tabs.tabs('option', 'selected'); // => 0</pre>
97
<div class="editsection" style="float:right;margin-left:5px;">[<a href="http://docs.jquery.com/action/edit/Template:UIAPIPlugin?section=6" title="Template:UIAPIPlugin">edit</a>]</div><a name="...open_links_in_the_current_tab_instead_of_leaving_the_page"></a><h3>...open links in the current tab instead of leaving the page</h3>
98
<p>"Hijax" links after tab content has been loaded:
100
<pre>$('#example').tabs({
101
load: function(event, ui) {
102
$('a', ui.panel).click(function() {
103
$(ui.panel).load(this.href);
108
<div class="editsection" style="float:right;margin-left:5px;">[<a href="http://docs.jquery.com/action/edit/Template:UIAPIPlugin?section=7" title="Template:UIAPIPlugin">edit</a>]</div><a name="...select_a_tab_from_a_text_link_instead_of_clicking_a_tab_itself"></a><h3>...select a tab from a text link instead of clicking a tab itself</h3>
109
<pre>var $tabs = $('#example').tabs(); // first tab selected
111
$('#my-text-link').click(function() { // bind click event to link
112
$tabs.tabs('select', 2); // switch to third tab
115
<div class="editsection" style="float:right;margin-left:5px;">[<a href="http://docs.jquery.com/action/edit/Template:UIAPIPlugin?section=8" title="Template:UIAPIPlugin">edit</a>]</div><a name="...prevent_switching_to_the_tab_on_click_depending_on_form_validation"></a><h3>...prevent switching to the tab on click depending on form validation</h3>
116
<p>Returning false in the tabs select handler prevents the clicked tab from becoming selected.
118
<pre>$('#example').tabs({
119
select: function(event, ui) {
120
var isValid = ... // form validation returning true or false
124
<div class="editsection" style="float:right;margin-left:5px;">[<a href="http://docs.jquery.com/action/edit/Template:UIAPIPlugin?section=9" title="Template:UIAPIPlugin">edit</a>]</div><a name="...immediately_select_a_just_added_tab"></a><h3>...immediately select a just added tab</h3>
125
<pre>var $tabs = $('#example').tabs({
126
add: function(event, ui) {
127
$tabs.tabs('select', '#' + ui.panel.id);
130
<div class="editsection" style="float:right;margin-left:5px;">[<a href="http://docs.jquery.com/action/edit/Template:UIAPIPlugin?section=10" title="Template:UIAPIPlugin">edit</a>]</div><a name="...open_a_tab_in_a_new_window_instead"></a><h3>...open a tab in a new window instead</h3>
131
<p>Note that opening a tab in a new window is unexpected, e.g.
132
inconsistent behaviour exposing a usablity problem (<a href="http://www.useit.com/alertbox/tabs.html" class="external free" title="http://www.useit.com/alertbox/tabs.html">http://www.useit.com/alertbox/tabs.html</a>).
134
<pre>$('#example').tabs({
135
select: function(event, ui) {
136
location.href = $.data(ui.tab, 'load.tabs');
140
<div class="editsection" style="float:right;margin-left:5px;">[<a href="http://docs.jquery.com/action/edit/Template:UIAPIPlugin?section=11" title="Template:UIAPIPlugin">edit</a>]</div><a name="...prevent_a_FOUC_.28Flash_of_Unstyled_Content.29_before_tabs_are_initialized"></a><h3>...prevent a FOUC (Flash of Unstyled Content) before tabs are initialized</h3>
141
<p>Add the necessary classes to hide an inactive tab panel to the HTML right away - note that this will <b>not</b> degrade gracefully with JavaScript being disabled:
143
<pre><div id="example" class="ui-tabs">
145
<div id="a-tab-panel" class="ui-tabs-hide"> </div>
148
<div class="editsection" style="float:right;margin-left:5px;">[<a href="http://docs.jquery.com/action/edit/Template:UIAPIPlugin?section=12" title="Template:UIAPIPlugin">edit</a>]</div><a name="Why_does..."></a><h2>Why does...</h2>
149
<div class="editsection" style="float:right;margin-left:5px;">[<a href="http://docs.jquery.com/action/edit/Template:UIAPIPlugin?section=13" title="Template:UIAPIPlugin">edit</a>]</div><a name="...my_slider.2C_Google_Map.2C_sIFR_etc._not_work_when_placed_in_a_hidden_.28inactive.29_tab.3F"></a><h3>...my slider, Google Map, sIFR etc. not work when placed in a hidden (inactive) tab?</h3>
150
<p>Any component that requires some dimensional computation for its initialization won't work in a hidden tab, because the tab panel itself is hidden via <code>display: none</code> so that any elements inside won't report their actual width and height (0 in most browsers).
151
</p><p>There's an easy workaround. Use the <em>off-left technique</em> for hiding inactive tab panels. E.g. in your style sheet replace the rule for the class selector ".ui-tabs .ui-tabs-hide" with
153
<pre>.ui-tabs .ui-tabs-hide {
157
<p>For Google maps you can also resize the map once the tab is displayed like this:
159
<pre>$('#example').bind('tabsshow', function(event, ui) {
160
if (ui.panel.id == "map-tab") {
164
resizeMap() will call Google Maps' checkResize() on the particular map.
166
<div id="overview-dependencies">
167
<h3>Dependencies</h3>
170
<li>To use the cookie option: <a href="http://plugins.jquery.com/project/cookie" class="external text" title="http://plugins.jquery.com/project/cookie">jquery.cookie.js</a></li>
172
<pre>.ui-tabs .ui-tabs-hide {
177
<div id="overview-example">
179
<div id="overview-example" class="example">
180
<ul><li><a href="#demo"><span>Demo</span></a></li><li><a href="#source"><span>View Source</span></a></li></ul>
181
<p><div id="demo" class="tabs-container" rel="295">
182
A simple jQuery UI Tabs.<br />
184
<pre>$("#tabs").tabs();
186
<p></div><div id="source" class="tabs-container">
188
<pre><!DOCTYPE html>
191
<link type="text/css" href="http://jqueryui.com/latest/themes/base/ui.all.css" rel="stylesheet" />
192
<script type="text/javascript" src="http://jqueryui.com/latest/jquery-1.3.2.js"></script>
193
<script type="text/javascript" src="http://jqueryui.com/latest/ui/ui.core.js"></script>
194
<script type="text/javascript" src="http://jqueryui.com/latest/ui/ui.tabs.js"></script>
195
<script type="text/javascript">
196
$(document).ready(function(){
197
$("#tabs").tabs();
201
<body style="font-size:62.5%;">
203
<div id="tabs">
205
<li><a href="#fragment-1"><span>One</span></a></li>
206
<li><a href="#fragment-2"><span>Two</span></a></li>
207
<li><a href="#fragment-3"><span>Three</span></a></li>
209
<div id="fragment-1">
210
<p>First tab is active by default:</p>
211
<pre><code>$('#example').tabs();</code></pre>
213
<div id="fragment-2">
214
Lorem ipsum dolor sit amet, consectetuer adipiscing elit, sed diam nonummy nibh euismod tincidunt ut laoreet dolore magna aliquam erat volutpat.
215
Lorem ipsum dolor sit amet, consectetuer adipiscing elit, sed diam nonummy nibh euismod tincidunt ut laoreet dolore magna aliquam erat volutpat.
217
<div id="fragment-3">
218
Lorem ipsum dolor sit amet, consectetuer adipiscing elit, sed diam nonummy nibh euismod tincidunt ut laoreet dolore magna aliquam erat volutpat.
219
Lorem ipsum dolor sit amet, consectetuer adipiscing elit, sed diam nonummy nibh euismod tincidunt ut laoreet dolore magna aliquam erat volutpat.
220
Lorem ipsum dolor sit amet, consectetuer adipiscing elit, sed diam nonummy nibh euismod tincidunt ut laoreet dolore magna aliquam erat volutpat.
231
<h2 class="top-header">Options</h2>
232
<ul class="options-list">
234
<li class="option" id="option-ajaxOptions">
235
<div class="option-header">
236
<h3 class="option-name"><a href="#option-ajaxOptions">ajaxOptions</a></h3>
238
<dt class="option-type-label">Type:</dt>
239
<dd class="option-type">Options</dd>
241
<dt class="option-default-label">Default:</dt>
242
<dd class="option-default">null</dd>
246
<div class="option-description">
247
<p>Additional Ajax options to consider when loading tab content (see $.ajax).</p>
249
<div class="option-examples">
250
<h4>Code examples</h4>
251
<dl class="option-examples-list">
254
Initialize a tabs with the <code>ajaxOptions</code> option specified.
257
<pre><code>$('.selector').tabs({ ajaxOptions: { async: false } });</code></pre>
262
Get or set the <code>ajaxOptions</code> option, after init.
266
var ajaxOptions = $('.selector').tabs('option', 'ajaxOptions');
268
$('.selector').tabs('option', 'ajaxOptions', { async: false });</code></pre>
276
<li class="option" id="option-cache">
277
<div class="option-header">
278
<h3 class="option-name"><a href="#option-cache">cache</a></h3>
280
<dt class="option-type-label">Type:</dt>
281
<dd class="option-type">Boolean</dd>
283
<dt class="option-default-label">Default:</dt>
284
<dd class="option-default">false</dd>
288
<div class="option-description">
289
<p>Whether or not to cache remote tabs content, e.g. load only once or with every click. Cached content is being lazy loaded, e.g once and only once for the first click. Note that to prevent the actual Ajax requests from being cached by the browser you need to provide an extra cache: false flag to ajaxOptions.</p>
291
<div class="option-examples">
292
<h4>Code examples</h4>
293
<dl class="option-examples-list">
296
Initialize a tabs with the <code>cache</code> option specified.
299
<pre><code>$('.selector').tabs({ cache: true });</code></pre>
304
Get or set the <code>cache</code> option, after init.
308
var cache = $('.selector').tabs('option', 'cache');
310
$('.selector').tabs('option', 'cache', true);</code></pre>
318
<li class="option" id="option-collapsible">
319
<div class="option-header">
320
<h3 class="option-name"><a href="#option-collapsible">collapsible</a></h3>
322
<dt class="option-type-label">Type:</dt>
323
<dd class="option-type">Boolean</dd>
325
<dt class="option-default-label">Default:</dt>
326
<dd class="option-default">false</dd>
330
<div class="option-description">
331
<p>Set to true to allow an already selected tab to become unselected again upon reselection.</p>
333
<div class="option-examples">
334
<h4>Code examples</h4>
335
<dl class="option-examples-list">
338
Initialize a tabs with the <code>collapsible</code> option specified.
341
<pre><code>$('.selector').tabs({ collapsible: true });</code></pre>
346
Get or set the <code>collapsible</code> option, after init.
350
var collapsible = $('.selector').tabs('option', 'collapsible');
352
$('.selector').tabs('option', 'collapsible', true);</code></pre>
360
<li class="option" id="option-cookie">
361
<div class="option-header">
362
<h3 class="option-name"><a href="#option-cookie">cookie</a></h3>
364
<dt class="option-type-label">Type:</dt>
365
<dd class="option-type">Object</dd>
367
<dt class="option-default-label">Default:</dt>
368
<dd class="option-default">null</dd>
372
<div class="option-description">
373
<p>Store the latest selected tab in a cookie. The cookie is then used to determine the initially selected tab if the <i>selected</i> option is not defined. Requires cookie plugin. The object needs to have key/value pairs of the form the cookie plugin expects as options. Available options (example): { expires: 7, path: '/', domain: 'jquery.com', secure: true }. Since jQuery UI 1.7 it is also possible to define the cookie name being used via <i>name</i> property.</p>
375
<div class="option-examples">
376
<h4>Code examples</h4>
377
<dl class="option-examples-list">
380
Initialize a tabs with the <code>cookie</code> option specified.
383
<pre><code>$('.selector').tabs({ cookie: { expires: 30 } });</code></pre>
388
Get or set the <code>cookie</code> option, after init.
392
var cookie = $('.selector').tabs('option', 'cookie');
394
$('.selector').tabs('option', 'cookie', { expires: 30 });</code></pre>
402
<li class="option" id="option-deselectable">
403
<div class="option-header">
404
<h3 class="option-name"><a href="#option-deselectable">deselectable</a></h3>
406
<dt class="option-type-label">Type:</dt>
407
<dd class="option-type">Boolean</dd>
409
<dt class="option-default-label">Default:</dt>
410
<dd class="option-default">false</dd>
414
<div class="option-description">
415
<p>deprecated in jQuery UI 1.7, use collapsible.</p>
417
<div class="option-examples">
418
<h4>Code examples</h4>
419
<dl class="option-examples-list">
422
Initialize a tabs with the <code>deselectable</code> option specified.
425
<pre><code>$('.selector').tabs({ deselectable: true });</code></pre>
430
Get or set the <code>deselectable</code> option, after init.
434
var deselectable = $('.selector').tabs('option', 'deselectable');
436
$('.selector').tabs('option', 'deselectable', true);</code></pre>
444
<li class="option" id="option-disabled">
445
<div class="option-header">
446
<h3 class="option-name"><a href="#option-disabled">disabled</a></h3>
448
<dt class="option-type-label">Type:</dt>
449
<dd class="option-type">Array<Number></dd>
451
<dt class="option-default-label">Default:</dt>
452
<dd class="option-default">[]</dd>
456
<div class="option-description">
457
<p>An array containing the position of the tabs (zero-based index) that should be disabled on initialization.</p>
459
<div class="option-examples">
460
<h4>Code examples</h4>
461
<dl class="option-examples-list">
464
Initialize a tabs with the <code>disabled</code> option specified.
467
<pre><code>$('.selector').tabs({ disabled: [1, 2] });</code></pre>
472
Get or set the <code>disabled</code> option, after init.
476
var disabled = $('.selector').tabs('option', 'disabled');
478
$('.selector').tabs('option', 'disabled', [1, 2]);</code></pre>
486
<li class="option" id="option-event">
487
<div class="option-header">
488
<h3 class="option-name"><a href="#option-event">event</a></h3>
490
<dt class="option-type-label">Type:</dt>
491
<dd class="option-type">String</dd>
493
<dt class="option-default-label">Default:</dt>
494
<dd class="option-default">'click'</dd>
498
<div class="option-description">
499
<p>The type of event to be used for selecting a tab.</p>
501
<div class="option-examples">
502
<h4>Code examples</h4>
503
<dl class="option-examples-list">
506
Initialize a tabs with the <code>event</code> option specified.
509
<pre><code>$('.selector').tabs({ event: 'mouseover' });</code></pre>
514
Get or set the <code>event</code> option, after init.
518
var event = $('.selector').tabs('option', 'event');
520
$('.selector').tabs('option', 'event', 'mouseover');</code></pre>
528
<li class="option" id="option-fx">
529
<div class="option-header">
530
<h3 class="option-name"><a href="#option-fx">fx</a></h3>
532
<dt class="option-type-label">Type:</dt>
533
<dd class="option-type">Options, Array<Options></dd>
535
<dt class="option-default-label">Default:</dt>
536
<dd class="option-default">null</dd>
540
<div class="option-description">
541
<p>Enable animations for hiding and showing tab panels. The duration option can be a string representing one of the three predefined speeds ("slow", "normal", "fast") or the duration in milliseconds to run an animation (default is "normal").</p>
543
<div class="option-examples">
544
<h4>Code examples</h4>
545
<dl class="option-examples-list">
548
Initialize a tabs with the <code>fx</code> option specified.
551
<pre><code>$('.selector').tabs({ fx: { opacity: 'toggle' } });</code></pre>
556
Get or set the <code>fx</code> option, after init.
560
var fx = $('.selector').tabs('option', 'fx');
562
$('.selector').tabs('option', 'fx', { opacity: 'toggle' });</code></pre>
570
<li class="option" id="option-idPrefix">
571
<div class="option-header">
572
<h3 class="option-name"><a href="#option-idPrefix">idPrefix</a></h3>
574
<dt class="option-type-label">Type:</dt>
575
<dd class="option-type">String</dd>
577
<dt class="option-default-label">Default:</dt>
578
<dd class="option-default">'ui-tabs-'</dd>
582
<div class="option-description">
583
<p>If the remote tab, its anchor element that is, has no title attribute to generate an id from, an id/fragment identifier is created from this prefix and a unique id returned by $.data(el), for example "ui-tabs-54".</p>
585
<div class="option-examples">
586
<h4>Code examples</h4>
587
<dl class="option-examples-list">
590
Initialize a tabs with the <code>idPrefix</code> option specified.
593
<pre><code>$('.selector').tabs({ idPrefix: 'ui-tabs-primary' });</code></pre>
598
Get or set the <code>idPrefix</code> option, after init.
602
var idPrefix = $('.selector').tabs('option', 'idPrefix');
604
$('.selector').tabs('option', 'idPrefix', 'ui-tabs-primary');</code></pre>
612
<li class="option" id="option-panelTemplate">
613
<div class="option-header">
614
<h3 class="option-name"><a href="#option-panelTemplate">panelTemplate</a></h3>
616
<dt class="option-type-label">Type:</dt>
617
<dd class="option-type">String</dd>
619
<dt class="option-default-label">Default:</dt>
620
<dd class="option-default">'<div></div>'</dd>
624
<div class="option-description">
625
<p>HTML template from which a new tab panel is created in case of adding a tab with the add method or when creating a panel for a remote tab on the fly.</p>
627
<div class="option-examples">
628
<h4>Code examples</h4>
629
<dl class="option-examples-list">
632
Initialize a tabs with the <code>panelTemplate</code> option specified.
635
<pre><code>$('.selector').tabs({ panelTemplate: '<li></li>' });</code></pre>
640
Get or set the <code>panelTemplate</code> option, after init.
644
var panelTemplate = $('.selector').tabs('option', 'panelTemplate');
646
$('.selector').tabs('option', 'panelTemplate', '<li></li>');</code></pre>
654
<li class="option" id="option-selected">
655
<div class="option-header">
656
<h3 class="option-name"><a href="#option-selected">selected</a></h3>
658
<dt class="option-type-label">Type:</dt>
659
<dd class="option-type">Number</dd>
661
<dt class="option-default-label">Default:</dt>
662
<dd class="option-default">0</dd>
666
<div class="option-description">
667
<p>Zero-based index of the tab to be selected on initialization. To set all tabs to nselected pass -1 as value.</p>
669
<div class="option-examples">
670
<h4>Code examples</h4>
671
<dl class="option-examples-list">
674
Initialize a tabs with the <code>selected</code> option specified.
677
<pre><code>$('.selector').tabs({ selected: 3 });</code></pre>
682
Get or set the <code>selected</code> option, after init.
686
var selected = $('.selector').tabs('option', 'selected');
688
$('.selector').tabs('option', 'selected', 3);</code></pre>
696
<li class="option" id="option-spinner">
697
<div class="option-header">
698
<h3 class="option-name"><a href="#option-spinner">spinner</a></h3>
700
<dt class="option-type-label">Type:</dt>
701
<dd class="option-type">String</dd>
703
<dt class="option-default-label">Default:</dt>
704
<dd class="option-default">'<em>Loading&#8230;</em>'</dd>
708
<div class="option-description">
709
<p>The HTML content of this string is shown in a tab title while remote content is loading. Pass in empty string to deactivate that behavior.</p>
711
<div class="option-examples">
712
<h4>Code examples</h4>
713
<dl class="option-examples-list">
716
Initialize a tabs with the <code>spinner</code> option specified.
719
<pre><code>$('.selector').tabs({ spinner: 'Retrieving data...' });</code></pre>
724
Get or set the <code>spinner</code> option, after init.
728
var spinner = $('.selector').tabs('option', 'spinner');
730
$('.selector').tabs('option', 'spinner', 'Retrieving data...');</code></pre>
738
<li class="option" id="option-tabTemplate">
739
<div class="option-header">
740
<h3 class="option-name"><a href="#option-tabTemplate">tabTemplate</a></h3>
742
<dt class="option-type-label">Type:</dt>
743
<dd class="option-type">String</dd>
745
<dt class="option-default-label">Default:</dt>
746
<dd class="option-default">'<li><a href="#{href}"><span>#{label}</span></a></li>'</dd>
750
<div class="option-description">
751
<p>HTML template from which a new tab is created and added. The placeholders #{href} and #{label} are replaced with the url and tab label that are passed as arguments to the add method.</p>
753
<div class="option-examples">
754
<h4>Code examples</h4>
755
<dl class="option-examples-list">
758
Initialize a tabs with the <code>tabTemplate</code> option specified.
761
<pre><code>$('.selector').tabs({ tabTemplate: '<div><a href="#{href}"><span>#{label}</span></a></div>' });</code></pre>
766
Get or set the <code>tabTemplate</code> option, after init.
770
var tabTemplate = $('.selector').tabs('option', 'tabTemplate');
772
$('.selector').tabs('option', 'tabTemplate', '<div><a href="#{href}"><span>#{label}</span></a></div>');</code></pre>
782
<h2 class="top-header">Events</h2>
783
<ul class="events-list">
785
<li class="event" id="event-select">
786
<div class="event-header">
787
<h3 class="event-name"><a href="#event-select">select</a></h3>
789
<dt class="event-type-label">Type:</dt>
790
<dd class="event-type">tabsselect</dd>
793
<div class="event-description">
794
<p>This event is triggered when clicking a tab.</p>
796
<div class="event-examples">
797
<h4>Code examples</h4>
798
<dl class="event-examples-list">
801
Supply a callback function to handle the <code>select</code> event as an init option.
804
<pre><code>$('.selector').tabs({
805
select: function(event, ui) { ... }
811
Bind to the <code>select</code> event by type: <code>tabsselect</code>.
814
<pre><code>$('.selector').bind('tabsselect', function(event, ui) {
824
<li class="event" id="event-load">
825
<div class="event-header">
826
<h3 class="event-name"><a href="#event-load">load</a></h3>
828
<dt class="event-type-label">Type:</dt>
829
<dd class="event-type">tabsload</dd>
832
<div class="event-description">
833
<p>This event is triggered after the content of a remote tab has been loaded.</p>
835
<div class="event-examples">
836
<h4>Code examples</h4>
837
<dl class="event-examples-list">
840
Supply a callback function to handle the <code>load</code> event as an init option.
843
<pre><code>$('.selector').tabs({
844
load: function(event, ui) { ... }
850
Bind to the <code>load</code> event by type: <code>tabsload</code>.
853
<pre><code>$('.selector').bind('tabsload', function(event, ui) {
863
<li class="event" id="event-show">
864
<div class="event-header">
865
<h3 class="event-name"><a href="#event-show">show</a></h3>
867
<dt class="event-type-label">Type:</dt>
868
<dd class="event-type">tabsshow</dd>
871
<div class="event-description">
872
<p>This event is triggered when a tab is shown.</p>
874
<div class="event-examples">
875
<h4>Code examples</h4>
876
<dl class="event-examples-list">
879
Supply a callback function to handle the <code>show</code> event as an init option.
882
<pre><code>$('.selector').tabs({
883
show: function(event, ui) { ... }
889
Bind to the <code>show</code> event by type: <code>tabsshow</code>.
892
<pre><code>$('.selector').bind('tabsshow', function(event, ui) {
902
<li class="event" id="event-add">
903
<div class="event-header">
904
<h3 class="event-name"><a href="#event-add">add</a></h3>
906
<dt class="event-type-label">Type:</dt>
907
<dd class="event-type">tabsadd</dd>
910
<div class="event-description">
911
<p>This event is triggered when a tab is added.</p>
913
<div class="event-examples">
914
<h4>Code examples</h4>
915
<dl class="event-examples-list">
918
Supply a callback function to handle the <code>add</code> event as an init option.
921
<pre><code>$('.selector').tabs({
922
add: function(event, ui) { ... }
928
Bind to the <code>add</code> event by type: <code>tabsadd</code>.
931
<pre><code>$('.selector').bind('tabsadd', function(event, ui) {
941
<li class="event" id="event-remove">
942
<div class="event-header">
943
<h3 class="event-name"><a href="#event-remove">remove</a></h3>
945
<dt class="event-type-label">Type:</dt>
946
<dd class="event-type">tabsremove</dd>
949
<div class="event-description">
950
<p>This event is triggered when a tab is removed.</p>
952
<div class="event-examples">
953
<h4>Code examples</h4>
954
<dl class="event-examples-list">
957
Supply a callback function to handle the <code>remove</code> event as an init option.
960
<pre><code>$('.selector').tabs({
961
remove: function(event, ui) { ... }
967
Bind to the <code>remove</code> event by type: <code>tabsremove</code>.
970
<pre><code>$('.selector').bind('tabsremove', function(event, ui) {
980
<li class="event" id="event-enable">
981
<div class="event-header">
982
<h3 class="event-name"><a href="#event-enable">enable</a></h3>
984
<dt class="event-type-label">Type:</dt>
985
<dd class="event-type">tabsenable</dd>
988
<div class="event-description">
989
<p>This event is triggered when a tab is enabled.</p>
991
<div class="event-examples">
992
<h4>Code examples</h4>
993
<dl class="event-examples-list">
996
Supply a callback function to handle the <code>enable</code> event as an init option.
999
<pre><code>$('.selector').tabs({
1000
enable: function(event, ui) { ... }
1006
Bind to the <code>enable</code> event by type: <code>tabsenable</code>.
1009
<pre><code>$('.selector').bind('tabsenable', function(event, ui) {
1019
<li class="event" id="event-disable">
1020
<div class="event-header">
1021
<h3 class="event-name"><a href="#event-disable">disable</a></h3>
1023
<dt class="event-type-label">Type:</dt>
1024
<dd class="event-type">tabsdisable</dd>
1027
<div class="event-description">
1028
<p>This event is triggered when a tab is disabled.</p>
1030
<div class="event-examples">
1031
<h4>Code examples</h4>
1032
<dl class="event-examples-list">
1035
Supply a callback function to handle the <code>disable</code> event as an init option.
1038
<pre><code>$('.selector').tabs({
1039
disable: function(event, ui) { ... }
1045
Bind to the <code>disable</code> event by type: <code>tabsdisable</code>.
1048
<pre><code>$('.selector').bind('tabsdisable', function(event, ui) {
1060
<h2 class="top-header">Methods</h2>
1061
<ul class="methods-list">
1063
<li class="method" id="method-destroy">
1064
<div class="method-header">
1065
<h3 class="method-name"><a href="#method-destroy">destroy</a></h3>
1067
<dt class="method-signature-label">Signature:</dt>
1068
<dd class="method-signature">.tabs( 'destroy'
1079
<div class="method-description">
1080
<p>Remove the tabs functionality completely. This will return the element back to its pre-init state.</p>
1085
<li class="method" id="method-disable">
1086
<div class="method-header">
1087
<h3 class="method-name"><a href="#method-disable">disable</a></h3>
1089
<dt class="method-signature-label">Signature:</dt>
1090
<dd class="method-signature">.tabs( 'disable'
1101
<div class="method-description">
1102
<p>Disable the tabs.</p>
1107
<li class="method" id="method-enable">
1108
<div class="method-header">
1109
<h3 class="method-name"><a href="#method-enable">enable</a></h3>
1111
<dt class="method-signature-label">Signature:</dt>
1112
<dd class="method-signature">.tabs( 'enable'
1123
<div class="method-description">
1124
<p>Enable the tabs.</p>
1129
<li class="method" id="method-option">
1130
<div class="method-header">
1131
<h3 class="method-name"><a href="#method-option">option</a></h3>
1133
<dt class="method-signature-label">Signature:</dt>
1134
<dd class="method-signature">.tabs( 'option'
1138
, <span class="optional">[</span>value<span class="optional">] </span>
1145
<div class="method-description">
1146
<p>Get or set any tabs option. If no value is specified, will act as a getter.</p>
1151
<li class="method" id="method-add">
1152
<div class="method-header">
1153
<h3 class="method-name"><a href="#method-add">add</a></h3>
1155
<dt class="method-signature-label">Signature:</dt>
1156
<dd class="method-signature">.tabs( 'add'
1162
, <span class="optional">[</span>index<span class="optional">] </span>
1167
<div class="method-description">
1168
<p>Add a new tab. The second argument is either a URL consisting of a fragment identifier only to create an in-page tab or a full url (relative or absolute, no cross-domain support) to turn the new tab into an Ajax (remote) tab. The third is the zero-based position where to insert the new tab. Optional, by default a new tab is appended at the end.</p>
1173
<li class="method" id="method-remove">
1174
<div class="method-header">
1175
<h3 class="method-name"><a href="#method-remove">remove</a></h3>
1177
<dt class="method-signature-label">Signature:</dt>
1178
<dd class="method-signature">.tabs( 'remove'
1189
<div class="method-description">
1190
<p>Remove a tab. The second argument is the zero-based index of the tab to be removed.</p>
1195
<li class="method" id="method-enable">
1196
<div class="method-header">
1197
<h3 class="method-name"><a href="#method-enable">enable</a></h3>
1199
<dt class="method-signature-label">Signature:</dt>
1200
<dd class="method-signature">.tabs( 'enable'
1211
<div class="method-description">
1212
<p>Enable a disabled tab. To enable more than one tab at once reset the disabled property like: <code>$('#example').data('disabled.tabs', []);</code>. The second argument is the zero-based index of the tab to be enabled.</p>
1217
<li class="method" id="method-disable">
1218
<div class="method-header">
1219
<h3 class="method-name"><a href="#method-disable">disable</a></h3>
1221
<dt class="method-signature-label">Signature:</dt>
1222
<dd class="method-signature">.tabs( 'disable'
1233
<div class="method-description">
1234
<p>Disable a tab. The selected tab cannot be disabled. To disable more than one tab at once use: <code>$('#example').data('disabled.tabs', [1, 2, 3]);</code> The second argument is the zero-based index of the tab to be disabled.</p>
1239
<li class="method" id="method-select">
1240
<div class="method-header">
1241
<h3 class="method-name"><a href="#method-select">select</a></h3>
1243
<dt class="method-signature-label">Signature:</dt>
1244
<dd class="method-signature">.tabs( 'select'
1255
<div class="method-description">
1256
<p>Select a tab, as if it were clicked. The second argument is the zero-based index of the tab to be selected or the id selector of the panel the tab is associated with (the tab's href fragment identifier, e.g. hash, points to the panel's id).</p>
1261
<li class="method" id="method-load">
1262
<div class="method-header">
1263
<h3 class="method-name"><a href="#method-load">load</a></h3>
1265
<dt class="method-signature-label">Signature:</dt>
1266
<dd class="method-signature">.tabs( 'load'
1277
<div class="method-description">
1278
<p>Reload the content of an Ajax tab programmatically. This method always loads the tab content from the remote location, even if cache is set to true. The second argument is the zero-based index of the tab to be reloaded.</p>
1283
<li class="method" id="method-url">
1284
<div class="method-header">
1285
<h3 class="method-name"><a href="#method-url">url</a></h3>
1287
<dt class="method-signature-label">Signature:</dt>
1288
<dd class="method-signature">.tabs( 'url'
1299
<div class="method-description">
1300
<p>Change the url from which an Ajax (remote) tab will be loaded. The specified URL will be used for subsequent loads. Note that you can not only change the URL for an existing remote tab with this method, but also turn an in-page tab into a remote tab. The second argument is the zero-based index of the tab of which its URL is to be updated. The third is a URL the content of the tab is loaded from.</p>
1305
<li class="method" id="method-length">
1306
<div class="method-header">
1307
<h3 class="method-name"><a href="#method-length">length</a></h3>
1309
<dt class="method-signature-label">Signature:</dt>
1310
<dd class="method-signature">.tabs( 'length'
1321
<div class="method-description">
1322
<p>Retrieve the number of tabs of the first matched tab pane.</p>
1327
<li class="method" id="method-abort">
1328
<div class="method-header">
1329
<h3 class="method-name"><a href="#method-abort">abort</a></h3>
1331
<dt class="method-signature-label">Signature:</dt>
1332
<dd class="method-signature">.tabs( 'abort'
1343
<div class="method-description">
1344
<p>Terminate all running tab ajax requests and animations.</p>
1349
<li class="method" id="method-rotate">
1350
<div class="method-header">
1351
<h3 class="method-name"><a href="#method-rotate">rotate</a></h3>
1353
<dt class="method-signature-label">Signature:</dt>
1354
<dd class="method-signature">.tabs( 'rotate'
1358
, <span class="optional">[</span>continuing<span class="optional">] </span>
1365
<div class="method-description">
1366
<p>Set up an automatic rotation through tabs of a tab pane. The second argument is an amount of time in milliseconds until the next tab in the cycle gets activated. Use 0 or null to stop the rotation. The third controls whether or not to continue the rotation after a tab has been selected by a user. Default: false.</p>
1373
<h2 class="top-header">Theming</h2>
1374
<p>The jQuery UI Tabs plugin uses the jQuery UI CSS Framework to style its look and feel, including colors and background textures. We recommend using the ThemeRoller tool to create and download custom themes that are easy to build and maintain.
1376
<p>If a deeper level of customization is needed, there are widget-specific classes referenced within the ui.tabs.css stylesheet that can be modified. These classes are highlighed in bold below.
1379
<h3>Sample markup with jQuery UI CSS Framework classes</h3>
1380
<div class="<strong>ui-tabs</strong> ui-widget ui-widget-content ui-corner-all" id="tabs"><br />
1381
<ul class="<strong>ui-tabs-nav</strong> ui-helper-reset ui-helper-clearfix ui-widget-header ui-corner-all"><br />
1382
<li class="ui-state-default ui-corner-top ui-tabs-selected ui-state-active"><a href="#tabs-1">Nunc tincidunt</a></li><br />
1383
<li class="ui-state-default ui-corner-top"><a href="#tabs-2">Proin dolor</a></li><br />
1384
<div class="<strong>ui-tabs-panel</strong> ui-widget-content ui-corner-bottom" id="tabs-1"><br />
1385
<p>Tab one content goes here.</p><br />
1386
</div><br />
1387
...<br />
1389
<p class="theme-note">
1391
Note: This is a sample of markup generated by the tabs plugin, not markup you should use to create a tabs. The only markup needed for that is <br /><div id="tabs"><br />
1392
   <ul><br />
1393
      <li><a href="#tabs-1">Nunc tincidunt</a></li><br />
1394
      <li><a href="#tabs-2">Proin dolor</a></li><br />
1395
      <li><a href="#tabs-3">Aenean lacinia</a></li><br />
1396
   </ul><br />
1397
   <div id="tabs-1"><br />
1398
      <p>Tab 1 content</p><br />
1399
   </div><br />
1400
   <div id="tabs-2"><br />
1401
      <p>Tab 2 content</p><br />
1402
   </div><br />
1403
   <div id="tabs-3"><br />
1404
      <p>Tab 3 content</p><br />
1405
   </div><br />
1414
Pre-expand include size: 51589 bytes
1415
Post-expand include size: 90199 bytes
1416
Template argument size: 55853 bytes
1417
Maximum: 2097152 bytes
1420
<!-- Saved in parser cache with key jqdocs_docs:pcache:idhash:3184-1!1!0!!en!2 and timestamp 20090319021844 -->
added
removed
lib/jquery/jquery.ui-1.7.1/development-bundle/docs/tabs.html
