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

650 lines
17 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 ) {
2010-07-22 23:10:14 +00:00
$.widget( "ui.accordion", {
version: "@VERSION",
options: {
active: 0,
animate: {},
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() {
var options = this.options;
2009-01-22 13:10:18 +00:00
this.prevShow = this.prevHide = $();
this.element.addClass( "ui-accordion ui-widget ui-helper-reset" );
2010-07-22 23:10:14 +00:00
this.headers = this.element.find( options.header )
.addClass( "ui-accordion-header ui-helper-reset ui-state-default ui-corner-all" );
this._hoverable( this.headers );
this._focusable( this.headers );
this.headers.find( ":first-child" ).addClass( "ui-accordion-heading" );
2011-02-03 02:33:57 +00:00
this.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;
}
this.active = this._findActive( options.active )
.addClass( "ui-accordion-header-active ui-state-active" )
.toggleClass( "ui-corner-all" )
.toggleClass( "ui-corner-top" );
this.active.next().addClass( "ui-accordion-content-active" );
2009-01-22 13:10:18 +00:00
this._createIcons();
this.originalHeight = this.element[0].style.height;
this.refresh();
2011-02-03 02:33:57 +00:00
2010-07-22 23:10:14 +00:00
// ARIA
this.element.attr( "role", "tablist" );
this.headers
2010-07-22 23:10:14 +00:00
.attr( "role", "tab" )
.bind( "keydown.accordion", $.proxy( this, "_keydown" ) )
.next()
2010-07-22 23:10:14 +00:00
.attr( "role", "tabpanel" );
this.headers
.not( this.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
if ( !this.active.length ) {
this.headers.eq( 0 ).attr( "tabIndex", 0 );
} else {
this.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 ) {
this.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
_getCreateEventData: function() {
return {
header: this.active,
content: !this.active.length ? $() : this.active.next()
};
},
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 );
this.headers.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
.removeClass( "ui-accordion-icons" )
.children( ".ui-accordion-header-icon" )
.remove();
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-header-active ui-accordion-disabled ui-helper-reset ui-state-default ui-corner-all ui-state-active ui-state-disabled ui-corner-top" )
2010-07-22 23:10:14 +00:00
.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" ) {
this.element.css( "height", this.originalHeight );
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( 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() {
var heightStyle = this.options.heightStyle,
parent = this.element.parent(),
maxHeight,
overflow;
if ( 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 ( 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
if ( heightStyle !== "content" ) {
this.element.height( this.element.height() );
}
},
_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
.removeClass( "ui-accordion-header-active ui-state-active ui-corner-top" )
.addClass( "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-corner-all" )
.addClass( "ui-accordion-header-active 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 ) {
var toShow = data.newContent,
toHide = this.prevShow.length ? this.prevShow : data.oldContent;
// handle activating a panel during the animation for another activation
this.prevShow.add( this.prevHide ).stop( true, true );
this.prevShow = toShow;
this.prevHide = toHide;
2009-01-22 13:10:18 +00:00
if ( this.options.animate ) {
this._animate( toShow, toHide, data );
} else {
toHide.hide();
toShow.show();
this._completed( data );
}
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
_animate: function( toShow, toHide, data ) {
var total, easing, duration,
that = this,
down = toShow.length &&
( !toHide.length || ( toShow.index() < toHide.index() ) ),
animate = this.options.animate || {},
options = down && animate.down || animate,
complete = function() {
toShow.removeData( "accordionHeight" );
that._completed( data );
};
if ( typeof options === "number" ) {
duration = options;
}
if ( typeof options === "string" ) {
easing = options;
}
// fall back from options to animation in case of partial down settings
easing = easing || options.easing || animate.easing;
duration = duration || options.duration || animate.duration;
if ( !toHide.size() ) {
return toShow.animate( showProps, duration, easing, complete );
}
if ( !toShow.size() ) {
return toHide.animate( hideProps, duration, easing, complete );
}
total = toShow.show().outerHeight();
toHide.animate( hideProps, duration, easing );
toShow
.hide()
.data( "accordionHeight", {
total: total,
toHide: toHide
})
.animate( this.options.heightStyle === "content" ? showProps : showPropsAdjust,
duration, easing, complete );
},
_completed: function( data ) {
var toShow = data.newContent,
toHide = data.oldContent;
// 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
$.fx.step.accordionHeight = function( fx ) {
var elem = $( fx.elem ),
data = elem.data( "accordionHeight" );
elem.height( data.total - elem.outerHeight() - data.toHide.outerHeight() + elem.height() );
};
var hideProps = {},
showProps = {},
showPropsAdjust = {};
hideProps.height = hideProps.paddingTop = hideProps.paddingBottom =
hideProps.borderTopWidth = hideProps.borderBottomWidth = "hide";
showProps.height = showProps.paddingTop = showProps.paddingBottom =
showProps.borderTopWidth = showProps.borderBottomWidth = "show";
$.extend( showPropsAdjust, showProps, { accordionHeight: "show" } );
2008-06-04 02:34:33 +00:00
// 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 that = 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 ) ) {
that.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 ) );
// animated option
// NOTE: this only provides support for "slide", "bounceslide", and easings
// not the full $.ui.accordion.animations API
(function( $, prototype ) {
$.extend( prototype.options, {
animate: null,
animated: "slide"
});
var _create = prototype._create;
prototype._create = function() {
var options = this.options;
if ( options.animate === null ) {
if ( !options.animated ) {
options.animate = false;
} else if ( options.animated === "slide" ) {
options.animate = 300;
} else if ( options.animated === "bounceslide" ) {
options.animate = {
duration: 200,
down: {
easing: "easeOutBounce",
duration: 1000
}
}
} else {
options.animate = options.animated;
}
}
_create.call( this );
};
}( jQuery, jQuery.ui.accordion.prototype ) );
}
2010-07-22 23:10:14 +00:00
})( jQuery );