jQuery UI Accordion

+ +

Make the selected elements Accordion widgets. Semantic requirements:

The markup of your accordion container needs pairs of headers and content panels:

<div id="accordion">
+    <h3><a href="#">First header</a></h3>
+    <div>First content</div>
+    <h3><a href="#">Second header</a></h3>
+    <div>Second content</div>
+</div>

If you use a different element for the header, specify the header-option with an appropriate selector, eg. header: 'a.header'. The content element must be always next to its header.

If you have links inside the accordion content and use a-elements as headers, add a class to them and use that as the header, eg. header: 'a.header'.

Use activate(Number) to change the active content programmatically.

[edit]

NOTE: If you want multiple sections open at once, don't use an accordion

An accordion doesn't allow more than one content panel to be open at the same time, and it takes a lot of effort to do that. If you are looking for a widget that allows more than one content panel to be open, don't use this. Usually it can be written with a few lines of jQuery instead, something like this:

jQuery(document).ready(function(){
+	$('.accordion .head').click(function() {
+		$(this).next().toggle();
+		return false;
+	}).next().hide();
+});

Or animated:

jQuery(document).ready(function(){
+	$('.accordion .head').click(function() {
+		$(this).next().toggle('slow');
+		return false;
+	}).next().hide();
+});

Dependencies

UI Core
UI Effects Core (Optional - only for non-default animations)

+A simple jQuery UI Accordion.
+

$("#accordion").accordion();
+

<!DOCTYPE html>
+<html>
+<head>
+  <link href="http://ajax.googleapis.com/ajax/libs/jqueryui/1.8/themes/base/jquery-ui.css" rel="stylesheet" type="text/css"/>
+  <script src="http://ajax.googleapis.com/ajax/libs/jquery/1.4/jquery.min.js"></script>
+  <script src="http://ajax.googleapis.com/ajax/libs/jqueryui/1.8/jquery-ui.min.js"></script>
+  
+  <script>
+  $(document).ready(function() {
+    $("#accordion").accordion();
+  });
+  </script>
+</head>
+<body style="font-size:62.5%;">
+  
+<div id="accordion">
+	<h3><a href="#">Section 1</a></h3>
+	<div>
+		<p>
+		Mauris mauris ante, blandit et, ultrices a, suscipit eget, quam. Integer
+		ut neque. Vivamus nisi metus, molestie vel, gravida in, condimentum sit
+		amet, nunc. Nam a nibh. Donec suscipit eros. Nam mi. Proin viverra leo ut
+		odio. Curabitur malesuada. Vestibulum a velit eu ante scelerisque vulputate.
+		</p>
+	</div>
+	<h3><a href="#">Section 2</a></h3>
+	<div>
+		<p>
+		Sed non urna. Donec et ante. Phasellus eu ligula. Vestibulum sit amet
+		purus. Vivamus hendrerit, dolor at aliquet laoreet, mauris turpis porttitor
+		velit, faucibus interdum tellus libero ac justo. Vivamus non quam. In
+		suscipit faucibus urna.
+		</p>
+	</div>
+	<h3><a href="#">Section 3</a></h3>
+	<div>
+		<p>
+		Nam enim risus, molestie et, porta ac, aliquam ac, risus. Quisque lobortis.
+		Phasellus pellentesque purus in massa. Aenean in pede. Phasellus ac libero
+		ac tellus pellentesque semper. Sed ac felis. Sed commodo, magna quis
+		lacinia ornare, quam ante aliquam nisi, eu iaculis leo purus venenatis dui.
+		</p>
+		<ul>
+			<li>List item one</li>
+			<li>List item two</li>
+			<li>List item three</li>
+		</ul>
+	</div>
+	<h3><a href="#">Section 4</a></h3>
+	<div>
+		<p>
+		Cras dictum. Pellentesque habitant morbi tristique senectus et netus
+		et malesuada fames ac turpis egestas. Vestibulum ante ipsum primis in
+		faucibus orci luctus et ultrices posuere cubilia Curae; Aenean lacinia
+		mauris vel est.
+		</p>
+		<p>
+		Suspendisse eu nisl. Nullam ut libero. Integer dignissim consequat lectus.
+		Class aptent taciti sociosqu ad litora torquent per conubia nostra, per
+		inceptos himenaeos.
+		</p>
+	</div>
+</div>
+
+</body>
+</html>
+

+ +

+
+
disabled
+
+
Type:
+
Boolean
+ +
Default:
+
false
+ +
+
+
+
Disables (true) or enables (false) the accordion. Can be set when initialising (first creating) the accordion.
+
+
+
Code examples
+
+ +
+ Initialize a accordion with the disabled option specified. +
+
+
```
$( ".selector" ).accordion({ disabled: true });
```
+
+ + +
+ Get or set the disabled option, after init. +
+
+
```
//getter
+var disabled = $( ".selector" ).accordion( "option", "disabled" );
+//setter
+$( ".selector" ).accordion( "option", "disabled", true );
```
+
+ +
+
+
+
+
active
+
+
Type:
+
Selector, Element, jQuery, Boolean, Number
+ +
Default:
+
first child
+ +
+
+
+
Selector for the active element. Set to false to display none at start. Needs collapsible: true.
+
+
+
Code examples
+
+ +
+ Initialize a accordion with the active option specified. +
+
+
```
$( ".selector" ).accordion({ active: 2 });
```
+
+ + +
+ Get or set the active option, after init. +
+
+
```
//getter
+var active = $( ".selector" ).accordion( "option", "active" );
+//setter
+$( ".selector" ).accordion( "option", "active", 2 );
```
+
+ +
+
+
+
+
animated
+
+
Type:
+
Boolean, String
+ +
Default:
+
'slide'
+ +
+
+
+
Choose your favorite animation, or disable them (set to false). In addition to the default, 'bounceslide' and all defined easing methods are supported ('bounceslide' requires UI Effects Core).
+
+
+
Code examples
+
+ +
+ Initialize a accordion with the animated option specified. +
+
+
```
$( ".selector" ).accordion({ animated: 'bounceslide' });
```
+
+ + +
+ Get or set the animated option, after init. +
+
+
```
//getter
+var animated = $( ".selector" ).accordion( "option", "animated" );
+//setter
+$( ".selector" ).accordion( "option", "animated", 'bounceslide' );
```
+
+ +
+
+
+
+
autoHeight
+
+
Type:
+
Boolean
+ +
Default:
+
true
+ +
+
+
+
If set, the highest content part is used as height reference for all other parts. Provides more consistent animations.
+
+
+
Code examples
+
+ +
+ Initialize a accordion with the autoHeight option specified. +
+
+
```
$( ".selector" ).accordion({ autoHeight: false });
```
+
+ + +
+ Get or set the autoHeight option, after init. +
+
+
```
//getter
+var autoHeight = $( ".selector" ).accordion( "option", "autoHeight" );
+//setter
+$( ".selector" ).accordion( "option", "autoHeight", false );
```
+
+ +
+
+
+
+
clearStyle
+
+
Type:
+
Boolean
+ +
Default:
+
false
+ +
+
+
+
If set, clears height and overflow styles after finishing animations. This enables accordions to work with dynamic content. Won't work together with autoHeight.
+
+
+
Code examples
+
+ +
+ Initialize a accordion with the clearStyle option specified. +
+
+
```
$( ".selector" ).accordion({ clearStyle: true });
```
+
+ + +
+ Get or set the clearStyle option, after init. +
+
+
```
//getter
+var clearStyle = $( ".selector" ).accordion( "option", "clearStyle" );
+//setter
+$( ".selector" ).accordion( "option", "clearStyle", true );
```
+
+ +
+
+
+
+
collapsible
+
+
Type:
+
Boolean
+ +
Default:
+
false
+ +
+
+
+
Whether all the sections can be closed at once. Allows collapsing the active section by the triggering event (click is the default).
+
+
+
Code examples
+
+ +
+ Initialize a accordion with the collapsible option specified. +
+
+
```
$( ".selector" ).accordion({ collapsible: true });
```
+
+ + +
+ Get or set the collapsible option, after init. +
+
+
```
//getter
+var collapsible = $( ".selector" ).accordion( "option", "collapsible" );
+//setter
+$( ".selector" ).accordion( "option", "collapsible", true );
```
+
+ +
+
+
+
+
event
+
+
Type:
+
String
+ +
Default:
+
'click'
+ +
+
+
+
The event on which to trigger the accordion.
+
+
+
Code examples
+
+ +
+ Initialize a accordion with the event option specified. +
+
+
```
$( ".selector" ).accordion({ event: 'mouseover' });
```
+
+ + +
+ Get or set the event option, after init. +
+
+
```
//getter
+var event = $( ".selector" ).accordion( "option", "event" );
+//setter
+$( ".selector" ).accordion( "option", "event", 'mouseover' );
```
+
+ +
+
+
+
+
fillSpace
+
+
Type:
+
Boolean
+ +
Default:
+
false
+ +
+
+
+
If set, the accordion completely fills the height of the parent element. Overrides autoheight.
+
+
+
Code examples
+
+ +
+ Initialize a accordion with the fillSpace option specified. +
+
+
```
$( ".selector" ).accordion({ fillSpace: true });
```
+
+ + +
+ Get or set the fillSpace option, after init. +
+
+
```
//getter
+var fillSpace = $( ".selector" ).accordion( "option", "fillSpace" );
+//setter
+$( ".selector" ).accordion( "option", "fillSpace", true );
```
+
+ +
+
+
+
+
header
+
+
Type:
+
Selector, jQuery
+ +
Default:
+
'> li > :first-child,> :not(li):even'
+ +
+
+
+
Selector for the header element.
+
+
+
Code examples
+
+ +
+ Initialize a accordion with the header option specified. +
+
+
```
$( ".selector" ).accordion({ header: 'h3' });
```
+
+ + +
+ Get or set the header option, after init. +
+
+
```
//getter
+var header = $( ".selector" ).accordion( "option", "header" );
+//setter
+$( ".selector" ).accordion( "option", "header", 'h3' );
```
+
+ +
+
+
+
+
icons
+
+
Type:
+
Object
+ +
Default:
+
{ 'header': 'ui-icon-triangle-1-e', 'headerSelected': 'ui-icon-triangle-1-s' }
+ +
+
+
+
Icons to use for headers. Icons may be specified for 'header' and 'headerSelected', and we recommend using the icons native to the jQuery UI CSS Framework manipulated by jQuery UI ThemeRoller
+
+
+
Code examples
+
+ +
+ Initialize a accordion with the icons option specified. +
+
+
```
$( ".selector" ).accordion({ icons: { 'header': 'ui-icon-plus', 'headerSelected': 'ui-icon-minus' } });
```
+
+ + +
+ Get or set the icons option, after init. +
+
+
```
//getter
+var icons = $( ".selector" ).accordion( "option", "icons" );
+//setter
+$( ".selector" ).accordion( "option", "icons", { 'header': 'ui-icon-plus', 'headerSelected': 'ui-icon-minus' } );
```
+
+ +
+
+
+
+
navigation
+
+
Type:
+
Boolean
+ +
Default:
+
false
+ +
+
+
+
If set, looks for the anchor that matches location.href and activates it. Great for href-based state-saving. Use navigationFilter to implement your own matcher.
+
+
+
Code examples
+
+ +
+ Initialize a accordion with the navigation option specified. +
+
+
```
$( ".selector" ).accordion({ navigation: true });
```
+
+ + +
+ Get or set the navigation option, after init. +
+
+
```
//getter
+var navigation = $( ".selector" ).accordion( "option", "navigation" );
+//setter
+$( ".selector" ).accordion( "option", "navigation", true );
```
+
+ +
+
+
+
+
navigationFilter
+
+
Type:
+
Function
+ +
Default:
+

+ +
+
+
+
Overwrite the default location.href-matching with your own matcher.
+
+
+
Code examples
+
+ +
+ Initialize a accordion with the navigationFilter option specified. +
+
+
```
$( ".selector" ).accordion({ navigationFilter: function(){ ... } });
```
+
+ + +
+ Get or set the navigationFilter option, after init. +
+
+
```
//getter
+var navigationFilter = $( ".selector" ).accordion( "option", "navigationFilter" );
+//setter
+$( ".selector" ).accordion( "option", "navigationFilter", function(){ ... } );
```
+
+ +
+
+

+ +

change

Type:: accordionchange

This event is triggered every time the accordion changes. If the accordion is animated, the event will be triggered upon completion of the animation; otherwise, it is triggered immediately. +

$('.ui-accordion').bind('accordionchange', function(event, ui) {
+  ui.newHeader // jQuery object, activated header
+  ui.oldHeader // jQuery object, previous header
+  ui.newContent // jQuery object, activated content
+  ui.oldContent // jQuery object, previous content
+});

Code examples

+ Supply a callback function to handle the change event as an init option. +

$( ".selector" ).accordion({
+   change: function(event, ui) { ... }
+});

+ Bind to the change event by type: accordionchange. +

$( ".selector" ).bind( "accordionchange", function(event, ui) {
+  ...
+});

changestart

Type:: accordionchangestart

This event is triggered every time the accordion starts to change. +

$('.ui-accordion').bind('accordionchangestart', function(event, ui) {
+  ui.newHeader // jQuery object, activated header
+  ui.oldHeader // jQuery object, previous header
+  ui.newContent // jQuery object, activated content
+  ui.oldContent // jQuery object, previous content
+});

Code examples

+ Supply a callback function to handle the changestart event as an init option. +

$( ".selector" ).accordion({
+   changestart: function(event, ui) { ... }
+});

+ Bind to the changestart event by type: accordionchangestart. +

$( ".selector" ).bind( "accordionchangestart", function(event, ui) {
+  ...
+});

+ +

+
+
destroy
+
+
Signature:
+
.accordion( "destroy" + + + + + + + +)
+
+
+
+
Remove the accordion functionality completely. This will return the element back to its pre-init state.
+
+

+
+
disable
+
+
Signature:
+
.accordion( "disable" + + + + + + + +)
+
+
+
+
Disable the accordion.
+
+
+
+
enable
+
+
Signature:
+
.accordion( "enable" + + + + + + + +)
+
+
+
+
Enable the accordion.
+
+
+
+
option
+
+
Signature:
+
.accordion( "option" + +, optionName + +, [value] + + + +)
+
+
+
+
Get or set any accordion option. If no value is specified, will act as a getter.
+
+
+
+
option
+
+
Signature:
+
.accordion( "option" + +, options + + + + + +)
+
+
+
+
Set multiple accordion options at once by providing an options object.
+
+
+
+
widget
+
+
Signature:
+
.accordion( "widget" + + + + + + + +)
+
+
+
+
Returns the .ui-accordion element.
+
+
+
+
activate
+
+
Signature:
+
.accordion( "activate" + +, index + + + + + +)
+
+
+
+
Activate a content part of the Accordion programmatically. The index can be a zero-indexed number to match the position of the header to close or a Selector matching an element. Pass false to close all (only possible with collapsible:true).
+
+
+
+
resize
+
+
Signature:
+
.accordion( "resize" + + + + + + + +)
+
+
+
+
Recompute heights of the accordion contents when using the fillSpace option and the container height changed. For example, when the container is a resizable, this method should be called by its resize-event.
+
+

+ +

The jQuery UI Accordion 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. +

If a deeper level of customization is needed, there are widget-specific classes referenced within the jquery.ui.accordion.css stylesheet that can be modified. These classes are highlighed in bold below. +

+ +

Sample markup with jQuery UI CSS Framework classes

+ <div class="ui-accordion ui-widget ui-helper-reset">
+  <h3 class="ui-accordion-header ui-helper-reset ui-state-active ui-corner-top">
+    <span class="ui-icon ui-icon-triangle-1-s"/>
+    <a href="#">Section 1</a>
+  </h3>
+  <div class="ui-accordion-content ui-helper-reset ui-widget-content ui-corner-bottom ui-accordion-content-active">
+    Section 1 content
+  </div>
+  <h3 class="ui-accordion-header ui-helper-reset ui-state-default ui-corner-all">
+    <span class="ui-icon ui-icon-triangle-1-e"/>
+    <a href="#">Section 2</a>
+  </h3>
+  <div class="ui-accordion-content ui-helper-reset ui-widget-content ui-corner-bottom">
+    Section 2 content
+  </div>
+  <h3 class="ui-accordion-header ui-helper-reset ui-state-default ui-corner-all">
+    <span class="ui-icon ui-icon-triangle-1-e"/>
+    <a href="#">Section 3</a>
+  </h3>
+  <div class="ui-accordion-content ui-helper-reset ui-widget-content ui-corner-bottom">
+    Section 3 content
+  </div>
+</div>
+

+ + Note: This is a sample of markup generated by the accordion plugin, not markup you should use to create a accordion. The only markup needed for that is
<div>
+   <h3><a href="#">Section 1</a></h3>
+   <div>
+      Section 1 content
+   </div>
+   <h3><a href="#">Section 2</a></h3>
+   <div>
+      Section 2 content
+   </div>
+   <h3><a href="#">Section 3</a></h3>
+   <div>
+      Section 3 content
+   </div>
+</div>. + +

+ +

jQuery UI Accordion

Overview

NOTE: If you want multiple sections open at once, don't use an accordion

Dependencies

Example

Options

Code examples

Code examples

Code examples

Code examples

Code examples

Code examples

Code examples

Code examples

Code examples

Code examples

Code examples

Code examples

Events

Code examples

Code examples

Methods

Theming

Sample markup with jQuery UI CSS Framework classes