jquery-ui/ui/jquery.ui.accordion.js

686 lines
18 KiB
JavaScript
Raw Normal View History

2008-06-04 02:34:33 +00:00
/*
* jQuery UI Accordion @VERSION
*
2011-01-17 14:13:18 +00:00
* Copyright 2011, AUTHORS.txt (http://jqueryui.com/about)
* Dual licensed under the MIT or GPL Version 2 licenses.
* http://jquery.org/license
2008-06-04 02:34:33 +00:00
*
* http://docs.jquery.com/UI/Accordion
*
* Depends:
* jquery.ui.core.js
* jquery.ui.widget.js
2008-06-04 02:34:33 +00:00
*/
(function( $, undefined ) {
// TODO: use ui-accordion-header-active class and fix styling
2010-07-22 23:10:14 +00:00
$.widget( "ui.accordion", {
version: "@VERSION",
options: {
active: 0,
2010-07-22 23:10:14 +00:00
animated: "slide",
collapsible: false,
event: "click",
header: "> li > :first-child,> :not(li):even",
heightStyle: "auto",
icons: {
2011-01-24 20:45:29 +00:00
activeHeader: "ui-icon-triangle-1-s",
header: "ui-icon-triangle-1-e"
},
// callbacks
activate: null,
beforeActivate: null
},
2010-07-22 23:10:14 +00:00
_create: function() {
2010-07-27 21:23:00 +00:00
var self = this,
options = self.options;
2009-01-22 13:10:18 +00:00
2011-09-30 21:06:06 +00:00
self.lastToggle = {};
self.element.addClass( "ui-accordion ui-widget ui-helper-reset" );
2010-07-22 23:10:14 +00:00
2010-07-27 21:23:00 +00:00
self.headers = self.element.find( options.header )
.addClass( "ui-accordion-header ui-helper-reset ui-state-default ui-corner-all" );
self._hoverable( self.headers );
self._focusable( self.headers );
2011-02-03 02:33:57 +00:00
self.headers.find( ":first-child" ).addClass( "ui-accordion-heading" );
2010-07-27 21:23:00 +00:00
self.headers.next()
2010-07-22 23:10:14 +00:00
.addClass( "ui-accordion-content ui-helper-reset ui-widget-content ui-corner-bottom" );
// don't allow collapsible: false and active: false
if ( !options.collapsible && options.active === false ) {
options.active = 0;
}
// handle negative values
if ( options.active < 0 ) {
options.active += this.headers.length;
}
self.active = self._findActive( options.active )
2010-07-22 23:10:14 +00:00
.addClass( "ui-state-default ui-state-active" )
.toggleClass( "ui-corner-all" )
.toggleClass( "ui-corner-top" );
2010-07-27 21:23:00 +00:00
self.active.next().addClass( "ui-accordion-content-active" );
2009-01-22 13:10:18 +00:00
2010-07-27 21:23:00 +00:00
self._createIcons();
self.refresh();
2011-02-03 02:33:57 +00:00
2010-07-22 23:10:14 +00:00
// ARIA
2010-07-27 21:23:00 +00:00
self.element.attr( "role", "tablist" );
2010-07-27 21:23:00 +00:00
self.headers
2010-07-22 23:10:14 +00:00
.attr( "role", "tab" )
.bind( "keydown.accordion", $.proxy( self, "_keydown" ) )
.next()
2010-07-22 23:10:14 +00:00
.attr( "role", "tabpanel" );
2010-07-27 21:23:00 +00:00
self.headers
2011-02-03 02:33:57 +00:00
.not( self.active )
.attr({
"aria-expanded": "false",
"aria-selected": "false",
tabIndex: -1
2010-07-22 23:10:14 +00:00
})
2008-06-04 02:34:33 +00:00
.next()
2010-07-22 23:10:14 +00:00
.hide();
// make sure at least one header is in the tab order
2010-07-27 21:23:00 +00:00
if ( !self.active.length ) {
self.headers.eq( 0 ).attr( "tabIndex", 0 );
} else {
self.active.attr({
"aria-expanded": "true",
"aria-selected": "true",
tabIndex: 0
});
}
2010-07-22 23:10:14 +00:00
// only need links in tab order for Safari
if ( !$.browser.safari ) {
2010-07-27 21:23:00 +00:00
self.headers.find( "a" ).attr( "tabIndex", -1 );
2010-07-22 23:10:14 +00:00
}
this._setupEvents( options.event );
2008-06-04 02:34:33 +00:00
},
2010-07-22 23:10:14 +00:00
2009-05-11 11:43:48 +00:00
_createIcons: function() {
2011-01-14 00:23:55 +00:00
var icons = this.options.icons;
if ( icons ) {
$( "<span>" )
.addClass( "ui-accordion-header-icon ui-icon " + icons.header )
2010-07-22 23:10:14 +00:00
.prependTo( this.headers );
this.active.children( ".ui-accordion-header-icon" )
2011-01-14 00:23:55 +00:00
.removeClass( icons.header )
.addClass( icons.activeHeader );
2010-07-22 23:10:14 +00:00
this.element.addClass( "ui-accordion-icons" );
2009-05-11 11:43:48 +00:00
}
},
2010-07-22 23:10:14 +00:00
2009-05-11 11:43:48 +00:00
_destroyIcons: function() {
this.headers.children( ".ui-accordion-header-icon" ).remove();
2010-07-22 23:10:14 +00:00
this.element.removeClass( "ui-accordion-icons" );
2009-05-11 11:43:48 +00:00
},
_destroy: function() {
// clean up main element
this.element
2010-07-22 23:10:14 +00:00
.removeClass( "ui-accordion ui-widget ui-helper-reset" )
.removeAttr( "role" );
// clean up headers
this.headers
2010-07-22 23:10:14 +00:00
.unbind( ".accordion" )
.removeClass( "ui-accordion-header ui-accordion-disabled ui-helper-reset ui-state-default ui-corner-all ui-state-active ui-state-disabled ui-corner-top" )
.removeAttr( "role" )
.removeAttr( "aria-expanded" )
.removeAttr( "aria-selected" )
2011-02-03 02:33:57 +00:00
.removeAttr( "tabIndex" )
.find( "a" )
.removeAttr( "tabIndex" )
.end()
.find( ".ui-accordion-heading" )
.removeClass( "ui-accordion-heading" );
2009-05-11 11:43:48 +00:00
this._destroyIcons();
2011-02-03 02:33:57 +00:00
// clean up content panels
2010-07-22 23:10:14 +00:00
var contents = this.headers.next()
.css( "display", "" )
.removeAttr( "role" )
.removeClass( "ui-helper-reset ui-widget-content ui-corner-bottom ui-accordion-content ui-accordion-content-active ui-accordion-disabled ui-state-disabled" );
if ( this.options.heightStyle !== "content" ) {
2010-07-22 23:10:14 +00:00
contents.css( "height", "" );
}
},
2010-07-22 23:10:14 +00:00
_setOption: function( key, value ) {
2011-02-03 02:33:57 +00:00
if ( key === "active" ) {
// _activate() will handle invalid values and update this.options
this._activate( value );
return;
}
2011-02-03 02:33:57 +00:00
2011-07-13 00:50:24 +00:00
if ( key === "event" ) {
if ( this.options.event ) {
this.headers.unbind( this.options.event + ".accordion", this._eventHandler );
}
this._setupEvents( value );
}
this._super( "_setOption", key, value );
2011-02-03 02:33:57 +00:00
// setting collapsible: false while collapsed; open first panel
if ( key === "collapsible" && !value && this.options.active === false ) {
this._activate( 0 );
}
2011-02-03 02:33:57 +00:00
if ( key === "icons" ) {
2009-05-11 11:43:48 +00:00
this._destroyIcons();
2010-07-22 23:10:14 +00:00
if ( value ) {
2009-05-11 11:43:48 +00:00
this._createIcons();
}
}
// #5332 - opacity doesn't cascade to positioned elements in IE
// so we need to add the disabled class to the headers and panels
2011-02-03 02:33:57 +00:00
if ( key === "disabled" ) {
this.headers.add(this.headers.next())
.toggleClass( "ui-accordion-disabled ui-state-disabled", !!value );
}
},
2010-07-22 23:10:14 +00:00
_keydown: function( event ) {
2010-07-27 21:23:00 +00:00
if ( this.options.disabled || event.altKey || event.ctrlKey ) {
return;
2010-07-22 23:10:14 +00:00
}
2010-07-27 21:23:00 +00:00
var keyCode = $.ui.keyCode,
length = this.headers.length,
currentIndex = this.headers.index( event.target ),
2010-07-22 23:10:14 +00:00
toFocus = false;
2010-07-22 23:10:14 +00:00
switch ( event.keyCode ) {
case keyCode.RIGHT:
case keyCode.DOWN:
2010-07-22 23:10:14 +00:00
toFocus = this.headers[ ( currentIndex + 1 ) % length ];
break;
case keyCode.LEFT:
case keyCode.UP:
2010-07-22 23:10:14 +00:00
toFocus = this.headers[ ( currentIndex - 1 + length ) % length ];
break;
case keyCode.SPACE:
case keyCode.ENTER:
this._eventHandler( event );
}
2010-07-22 23:10:14 +00:00
if ( toFocus ) {
$( event.target ).attr( "tabIndex", -1 );
$( toFocus ).attr( "tabIndex", 0 );
toFocus.focus();
event.preventDefault();
}
},
2008-12-31 08:22:11 +00:00
refresh: function() {
2010-07-27 21:23:00 +00:00
var options = this.options,
parent = this.element.parent(),
maxHeight,
overflow;
if ( options.heightStyle === "fill" ) {
// IE 6 treats height like minHeight, so we need to turn off overflow
// in order to get a reliable height
// we use the minHeight support test because we assume that only
// browsers that don't support minHeight will treat height as minHeight
if ( !$.support.minHeight ) {
overflow = parent.css( "overflow" );
parent.css( "overflow", "hidden");
2010-07-22 23:10:14 +00:00
}
maxHeight = parent.height();
this.element.siblings( ":visible" ).each(function() {
var elem = $( this ),
position = elem.css( "position" );
if ( position === "absolute" || position === "fixed" ) {
return;
}
maxHeight -= elem.outerHeight( true );
});
if ( overflow ) {
parent.css( "overflow", overflow );
2010-07-22 23:10:14 +00:00
}
this.headers.each(function() {
2010-07-22 23:10:14 +00:00
maxHeight -= $( this ).outerHeight( true );
});
2009-01-22 13:10:18 +00:00
2010-07-22 23:10:14 +00:00
this.headers.next()
.each(function() {
$( this ).height( Math.max( 0, maxHeight -
$( this ).innerHeight() + $( this ).height() ) );
})
.css( "overflow", "auto" );
} else if ( options.heightStyle === "auto" ) {
maxHeight = 0;
2010-07-22 23:10:14 +00:00
this.headers.next()
.each(function() {
maxHeight = Math.max( maxHeight, $( this ).height( "" ).height() );
})
.height( maxHeight );
}
2009-01-22 13:10:18 +00:00
return this;
},
_activate: function( index ) {
var active = this._findActive( index )[ 0 ];
// trying to activate the already active panel
if ( active === this.active[ 0 ] ) {
return;
}
// trying to collapse, simulate a click on the currently active header
active = active || this.active[ 0 ];
this._eventHandler({
target: active,
currentTarget: active,
preventDefault: $.noop
});
},
2009-01-22 13:10:18 +00:00
2010-07-27 21:23:00 +00:00
_findActive: function( selector ) {
return typeof selector === "number" ? this.headers.eq( selector ) : $();
},
2009-01-22 13:10:18 +00:00
_setupEvents: function( event ) {
if ( event ) {
this.headers.bind( event.split( " " ).join( ".accordion " ) + ".accordion",
$.proxy( this, "_eventHandler" ) );
}
},
_eventHandler: function( event ) {
var options = this.options,
active = this.active,
clicked = $( event.currentTarget ),
clickedIsActive = clicked[ 0 ] === active[ 0 ],
collapsing = clickedIsActive && options.collapsible,
toShow = collapsing ? $() : clicked.next(),
toHide = active.next(),
eventData = {
oldHeader: active,
oldContent: toHide,
newHeader: collapsing ? $() : clicked,
newContent: toShow
};
event.preventDefault();
if ( options.disabled ||
// click on active header, but not collapsible
( clickedIsActive && !options.collapsible ) ||
// allow canceling activation
( this._trigger( "beforeActivate", event, eventData ) === false ) ) {
return;
}
options.active = collapsing ? false : this.headers.index( clicked );
2009-01-22 13:10:18 +00:00
// when the call to ._toggle() comes after the class changes
// it causes a very odd bug in IE 8 (see #6720)
this.active = clickedIsActive ? $() : clicked;
this._toggle( eventData );
// switch classes
active
2010-07-22 23:10:14 +00:00
.removeClass( "ui-state-active ui-corner-top" )
.addClass( "ui-state-default ui-corner-all" )
.children( ".ui-accordion-header-icon" )
.removeClass( options.icons.activeHeader )
2010-07-27 21:23:00 +00:00
.addClass( options.icons.header );
2010-07-22 23:10:14 +00:00
if ( !clickedIsActive ) {
clicked
.removeClass( "ui-state-default ui-corner-all" )
.addClass( "ui-state-active ui-corner-top" )
.children( ".ui-accordion-header-icon" )
2010-07-27 21:23:00 +00:00
.removeClass( options.icons.header )
.addClass( options.icons.activeHeader );
2010-07-22 23:10:14 +00:00
clicked
.next()
.addClass( "ui-accordion-content-active" );
2008-06-04 02:34:33 +00:00
}
},
2009-01-22 13:10:18 +00:00
_toggle: function( data ) {
2010-07-27 21:23:00 +00:00
var self = this,
options = self.options,
toShow = data.newContent,
toHide = data.oldContent;
2009-01-22 13:10:18 +00:00
function complete() {
self._completed( data );
}
2010-07-27 21:23:00 +00:00
if ( options.animated ) {
var animations = $.ui.accordion.animations,
animation = options.animated,
additional;
2009-01-22 13:10:18 +00:00
if ( !animations[ animation ] ) {
additional = {
easing: $.easing[ animation ] ? animation : "slide",
duration: 700
};
animation = "slide";
}
2009-01-22 13:10:18 +00:00
animations[ animation ]({
2011-09-30 21:06:06 +00:00
widget: self,
toShow: toShow,
toHide: toHide,
2011-09-30 21:06:06 +00:00
prevShow: self.lastToggle.toShow,
prevHide: self.lastToggle.toHide,
complete: complete,
down: toShow.length && ( !toHide.length || ( toShow.index() < toHide.index() ) )
}, additional );
} else {
toHide.hide();
toShow.show();
complete();
}
2009-01-22 13:10:18 +00:00
// TODO assert that the blur and focus triggers are really necessary, remove otherwise
2010-07-22 23:10:14 +00:00
toHide.prev()
.attr({
"aria-expanded": "false",
"aria-selected": "false",
tabIndex: -1
2010-07-22 23:10:14 +00:00
})
.blur();
toShow.prev()
.attr({
"aria-expanded": "true",
"aria-selected": "true",
tabIndex: 0
2010-07-22 23:10:14 +00:00
})
.focus();
},
2009-01-22 13:10:18 +00:00
_completed: function( data ) {
var toShow = data.newContent,
toHide = data.oldContent;
if ( this.options.heightStyle === "content" ) {
toShow.add( toHide ).css({
height: "",
overflow: ""
});
}
2010-07-22 23:10:14 +00:00
// other classes are removed before the animation; this one needs to stay until completed
toHide.removeClass( "ui-accordion-content-active" );
// Work around for rendering bug in IE (#5421)
if ( toHide.length ) {
toHide.parent()[0].className = toHide.parent()[0].className;
}
2009-01-22 13:10:18 +00:00
this._trigger( "activate", null, data );
2008-06-04 02:34:33 +00:00
}
});
2008-06-04 02:34:33 +00:00
2010-07-22 23:10:14 +00:00
$.extend( $.ui.accordion, {
2008-06-04 02:34:33 +00:00
animations: {
2010-07-22 23:10:14 +00:00
slide: function( options, additions ) {
if ( options.prevShow || options.prevHide ) {
options.prevHide.stop( true, true );
options.toHide = options.prevShow;
}
var showOverflow = options.toShow.css( "overflow" ),
hideOverflow = options.toHide.css( "overflow" ),
percentDone = 0,
showProps = {},
hideProps = {},
fxAttrs = [ "height", "paddingTop", "paddingBottom" ],
originalWidth;
2008-06-04 02:34:33 +00:00
options = $.extend({
easing: "swing",
duration: 300
2010-07-22 23:10:14 +00:00
}, options, additions );
2011-09-30 21:06:06 +00:00
options.widget.lastToggle = options;
2008-06-04 02:34:33 +00:00
if ( !options.toHide.size() ) {
originalWidth = options.toShow[0].style.width;
options.toShow
.show()
.width( options.toShow.width() )
.hide()
.animate({
height: "show",
paddingTop: "show",
paddingBottom: "show"
}, {
duration: options.duration,
easing: options.easing,
complete: function() {
options.toShow.width( originalWidth );
options.complete();
}
});
2008-06-04 02:34:33 +00:00
return;
}
if ( !options.toShow.size() ) {
2010-07-22 23:10:14 +00:00
options.toHide.animate({
height: "hide",
paddingTop: "hide",
paddingBottom: "hide"
}, options );
return;
}
// fix width before calculating height of hidden element
var s = options.toShow;
originalWidth = s[0].style.width;
s.width( s.parent().width()
- parseFloat( s.css( "paddingLeft" ) )
- parseFloat( s.css( "paddingRight" ) )
- ( parseFloat( s.css( "borderLeftWidth" ) ) || 0 )
- ( parseFloat( s.css( "borderRightWidth" ) ) || 0 ) );
2010-07-22 23:10:14 +00:00
$.each( fxAttrs, function( i, prop ) {
hideProps[ prop ] = "hide";
var parts = ( "" + $.css( options.toShow[0], prop ) ).match( /^([\d+-.]+)(.*)$/ ),
// work around bug when a panel has no height - #7335
propVal = prop === "height" && parts[ 1 ] === "0" ? 1 : parts[ 1 ];
2010-07-22 23:10:14 +00:00
showProps[ prop ] = {
value: propVal,
2010-07-22 23:10:14 +00:00
unit: parts[ 2 ] || "px"
};
});
2010-07-22 23:10:14 +00:00
options.toShow.css({ height: 0, overflow: "hidden" }).show();
options.toHide
.filter( ":hidden" )
.each( options.complete )
.end()
.filter( ":visible" )
.animate( hideProps, {
step: function( now, settings ) {
if ( settings.prop == "height" || settings.prop == "paddingTop" || settings.prop == "paddingBottom" ) {
percentDone = ( settings.end - settings.start === 0 ) ? 0 :
2010-07-22 23:10:14 +00:00
( settings.now - settings.start ) / ( settings.end - settings.start );
2008-06-04 02:34:33 +00:00
}
2010-07-22 23:10:14 +00:00
options.toShow[ 0 ].style[ settings.prop ] =
( percentDone * showProps[ settings.prop ].value )
+ showProps[ settings.prop ].unit;
2008-06-04 02:34:33 +00:00
},
duration: options.duration,
easing: options.easing,
complete: function() {
2010-07-22 23:10:14 +00:00
options.toShow.css({
width: originalWidth,
overflow: showOverflow
2010-07-22 23:10:14 +00:00
});
options.toHide.css( "overflow", hideOverflow );
2008-06-04 02:34:33 +00:00
options.complete();
}
});
},
2010-07-22 23:10:14 +00:00
bounceslide: function( options ) {
this.slide( options, {
easing: options.down ? "easeOutBounce" : "swing",
2008-06-04 02:34:33 +00:00
duration: options.down ? 1000 : 200
});
}
}
});
// DEPRECATED
if ( $.uiBackCompat !== false ) {
// navigation options
(function( $, prototype ) {
$.extend( prototype.options, {
navigation: false,
navigationFilter: function() {
return this.href.toLowerCase() === location.href.toLowerCase();
}
});
var _create = prototype._create;
prototype._create = function() {
if ( this.options.navigation ) {
var self = this,
headers = this.element.find( this.options.header ),
content = headers.next(),
current = headers.add( content )
.find( "a" )
.filter( this.options.navigationFilter )
[ 0 ];
if ( current ) {
headers.add( content ).each( function( index ) {
if ( $.contains( this, current ) ) {
self.options.active = Math.floor( index / 2 );
return false;
}
});
}
}
_create.call( this );
};
}( jQuery, jQuery.ui.accordion.prototype ) );
// height options
(function( $, prototype ) {
$.extend( prototype.options, {
heightStyle: null, // remove default so we fall back to old values
autoHeight: true, // use heightStyle: "auto"
clearStyle: false, // use heightStyle: "content"
fillSpace: false // use heightStyle: "fill"
});
var _create = prototype._create,
_setOption = prototype._setOption;
$.extend( prototype, {
_create: function() {
this.options.heightStyle = this.options.heightStyle ||
this._mergeHeightStyle();
_create.call( this );
},
_setOption: function( key, value ) {
if ( key === "autoHeight" || key === "clearStyle" || key === "fillSpace" ) {
this.options.heightStyle = this._mergeHeightStyle();
}
_setOption.apply( this, arguments );
},
_mergeHeightStyle: function() {
var options = this.options;
if ( options.fillSpace ) {
return "fill";
}
if ( options.clearStyle ) {
return "content";
}
if ( options.autoHeight ) {
return "auto";
}
}
});
}( jQuery, jQuery.ui.accordion.prototype ) );
// icon options
(function( $, prototype ) {
$.extend( prototype.options.icons, {
activeHeader: null, // remove default so we fall back to old values
headerSelected: "ui-icon-triangle-1-s"
});
var _createIcons = prototype._createIcons;
prototype._createIcons = function() {
if ( this.options.icons ) {
this.options.icons.activeHeader = this.options.icons.activeHeader ||
this.options.icons.headerSelected;
}
_createIcons.call( this );
};
}( jQuery, jQuery.ui.accordion.prototype ) );
// expanded active option, activate method
(function( $, prototype ) {
prototype.activate = prototype._activate;
var _findActive = prototype._findActive;
prototype._findActive = function( index ) {
if ( index === -1 ) {
index = false;
}
if ( index && typeof index !== "number" ) {
index = this.headers.index( this.headers.filter( index ) );
if ( index === -1 ) {
index = false;
}
}
return _findActive.call( this, index );
};
}( jQuery, jQuery.ui.accordion.prototype ) );
// resize method
jQuery.ui.accordion.prototype.resize = jQuery.ui.accordion.prototype.refresh;
2011-01-31 13:58:01 +00:00
// change events
(function( $, prototype ) {
$.extend( prototype.options, {
change: null,
changestart: null
});
var _trigger = prototype._trigger;
prototype._trigger = function( type, event, data ) {
var ret = _trigger.apply( this, arguments );
if ( !ret ) {
return false;
}
if ( type === "beforeActivate" ) {
ret = _trigger.call( this, "changestart", event, data );
} else if ( type === "activate" ) {
ret = _trigger.call( this, "change", event, data );
}
return ret;
2011-03-23 12:57:41 +00:00
};
}( jQuery, jQuery.ui.accordion.prototype ) );
}
2010-07-22 23:10:14 +00:00
})( jQuery );