/* * jQuery UI Tabs @VERSION * * Copyright 2011, AUTHORS.txt (http://jqueryui.com/about) * Dual licensed under the MIT or GPL Version 2 licenses. * http://jquery.org/license * * http://docs.jquery.com/UI/Tabs * * Depends: * jquery.ui.core.js * jquery.ui.widget.js */ (function( $, undefined ) { var tabId = 0, listId = 0; function getNextTabId() { return ++tabId; } function getNextListId() { return ++listId; } $.widget( "ui.tabs", { options: { active: null, collapsible: false, event: "click", fx: null, // e.g. { height: 'toggle', opacity: 'toggle', duration: 200 } // callbacks activate: null, beforeActivate: null, beforeLoad: null, load: null }, _create: function() { var that = this, options = that.options, active = options.active; that.running = false; that.element.addClass( "ui-tabs ui-widget ui-widget-content ui-corner-all" ); that._processTabs(); if ( active === null ) { // check the fragment identifier in the URL if ( location.hash ) { that.anchors.each(function( i, tab ) { if ( tab.hash === location.hash ) { active = i; return false; } }); } // check for a tab marked active via a class if ( active === null ) { active = that.lis.filter( ".ui-tabs-active" ).index(); } // no active tab, set to false if ( active === null || active === -1 ) { active = that.lis.length ? 0 : false; } } // handle numbers: negative, out of range if ( active !== false ) { active = this.lis.eq( active ).index(); if ( active === -1 ) { active = options.collapsible ? false : 0; } } options.active = active; // don't allow collapsible: false and active: false if ( !options.collapsible && options.active === false ) { options.active = 0; } // Take disabling tabs via class attribute from HTML // into account and update option properly. if ( $.isArray( options.disabled ) ) { options.disabled = $.unique( options.disabled.concat( $.map( this.lis.filter( ".ui-state-disabled" ), function( n, i ) { return that.lis.index( n ); }) ) ).sort(); } this._setupFx( options.fx ); this._refresh(); // highlight selected tab this.panels.hide(); this.lis.removeClass( "ui-tabs-active ui-state-active" ); // check for length avoids error when initializing empty list if ( options.active !== false && this.anchors.length ) { this.active = this._findActive( options.active ); var panel = that._getPanelForTab( this.active ); panel.show(); this.lis.eq( options.active ).addClass( "ui-tabs-active ui-state-active" ); // TODO: we need to remove this or add it to accordion // seems to be expected behavior that the activate callback is fired that.element.queue( "tabs", function() { that._trigger( "activate", null, that._ui( that.active[ 0 ], panel[ 0 ] ) ); }); this.load( options.active ); } else { this.active = $(); } }, _setOption: function( key, value ) { if ( key == "active" ) { // _activate() will handle invalid values and update this.options this._activate( value ); return; } // setting collapsible: false while collapsed; open first panel if ( key === "collapsible" && !value && this.options.active === false ) { this._activate( 0 ); } this.options[ key ] = value; this.refresh(); }, _tabId: function( a ) { return $( a ).attr( "aria-controls" ) || "ui-tabs-" + getNextTabId(); }, _sanitizeSelector: function( hash ) { // we need this because an id may contain a ":" return hash ? hash.replace( /:/g, "\\:" ) : ""; }, _ui: function( tab, panel ) { return { tab: tab, panel: panel, index: this.anchors.index( tab ) }; }, refresh: function() { var self = this; this._processTabs(); this._refresh(); // Remove panels that we created that are missing their tab this.element.find(".ui-tabs-panel:data(destroy.tabs)").each( function( index, panel ) { var anchor = self.anchors.filter( "[aria-controls='" + panel.id + "']"); if ( !anchor.length ) { $( panel ).remove(); } }); }, _refresh: function() { var that = this, options = that.options; this.element.toggleClass( "ui-tabs-collapsible", options.collapsible ); this.list.addClass("ui-tabs-nav ui-helper-reset ui-helper-clearfix ui-widget-header ui-corner-all" ); this.lis.addClass( "ui-state-default ui-corner-top" ); this.panels.addClass( "ui-tabs-panel ui-widget-content ui-corner-bottom" ); if ( !options.disabled.length ) { options.disabled = false; } // disable tabs for ( var i = 0, li; ( li = this.lis[ i ] ); i++ ) { $( li ).toggleClass( "ui-state-disabled", $.inArray( i, options.disabled ) !== -1 ); } this._setupEvents( options.event ); // remove all handlers, may run on existing tabs this.lis.unbind( ".tabs" ); this._focusable( this.lis ); this._hoverable( this.lis ); }, _processTabs: function() { var self = this, fragmentId = /^#.+/; // Safari 2 reports '#' for an empty hash this.list = this.element.find( "ol,ul" ).eq( 0 ); this.lis = $( " > li:has(a[href])", this.list ); this.anchors = this.lis.map(function() { return $( "a", this )[ 0 ]; }); this.panels = $( [] ); this.anchors.each(function( i, a ) { var href = $( a ).attr( "href" ), hrefBase = href.split( "#" )[ 0 ], selector, panel, baseEl; // For dynamically created HTML that contains a hash as href IE < 8 expands // such href to the full page url with hash and then misinterprets tab as ajax. // Same consideration applies for an added tab with a fragment identifier // since a[href=#fragment-identifier] does unexpectedly not match. // Thus normalize href attribute... if ( hrefBase && ( hrefBase === location.toString().split( "#" )[ 0 ] || ( baseEl = $( "base" )[ 0 ]) && hrefBase === baseEl.href ) ) { href = a.hash; a.href = href; } // inline tab if ( fragmentId.test( href ) ) { selector = href; panel = self.element.find( self._sanitizeSelector( selector ) ); // remote tab // prevent loading the page itself if href is just "#" } else if ( href && href !== "#" ) { var id = self._tabId( a ); selector = "#" + id; panel = self.element.find( selector ); if ( !panel.length ) { panel = self._createPanel( id ); panel.insertAfter( self.panels[ i - 1 ] || self.list ); } // invalid tab href } else { self.options.disabled.push( i ); } if ( panel.length) { self.panels = self.panels.add( panel ); } $( a ).attr( "aria-controls", selector.substring( 1 ) ); }); }, _createPanel: function( id ) { return $( "
" ) .attr( "id", id ) .addClass( "ui-tabs-panel ui-widget-content ui-corner-bottom" ) .data( "destroy.tabs", true ); }, _setupFx: function( fx ) { // set up animations if ( fx ) { if ( $.isArray( fx ) ) { this.hideFx = fx[ 0 ]; this.showFx = fx[ 1 ]; } else { this.hideFx = this.showFx = fx; } } }, // Reset certain styles left over from animation // and prevent IE's ClearType bug... _resetStyle: function ( $el, fx ) { $el.css( "display", "" ); if ( !$.support.opacity && fx.opacity ) { $el[ 0 ].style.removeAttribute( "filter" ); } }, _showTab: function( event, eventData ) { var that = this; $( eventData.newTab ).closest( "li" ).addClass( "ui-tabs-active ui-state-active" ); if ( that.showFx ) { that.running = true; eventData.newPanel // TODO: why are we hiding? old code? .hide() .animate( that.showFx, that.showFx.duration || "normal", function() { that._resetStyle( $( this ), that.showFx ); that.running = false; that._trigger( "activate", event, eventData ); }); } else { eventData.newPanel.show(); that._trigger( "activate", event, eventData ); } }, // TODO: combine with _showTab() _hideTab: function( event, eventData ) { var that = this; if ( that.hideFx ) { that.running = true; eventData.oldPanel.animate( that.hideFx, that.hideFx.duration || "normal", function() { that.running = false; eventData.oldTab.closest( "li" ).removeClass( "ui-tabs-active ui-state-active" ); that._resetStyle( $( this ), that.hideFx ); that.element.dequeue( "tabs" ); if ( !eventData.newPanel.length ) { that._trigger( "activate", event, eventData ); } }); } else { eventData.oldTab.closest( "li" ).removeClass( "ui-tabs-active ui-state-active" ); eventData.oldPanel.hide(); that.element.dequeue( "tabs" ); if ( !eventData.newPanel.length ) { that._trigger( "activate", event, eventData ); } } }, _setupEvents: function( event ) { // attach tab event handler, unbind to avoid duplicates from former tabifying... this.anchors.unbind( ".tabs" ); if ( event ) { this.anchors.bind( event.split( " " ).join( ".tabs " ) + ".tabs", $.proxy( this, "_eventHandler" ) ); } // disable click in any case this.anchors.bind( "click.tabs", function( event ){ event.preventDefault(); }); }, _eventHandler: function( event ) { var that = this, options = that.options, active = that.active, clicked = $( event.currentTarget ), clickedIsActive = clicked[ 0 ] === active[ 0 ], collapsing = clickedIsActive && options.collapsible, toShow = collapsing ? $() : that._getPanelForTab( clicked ), toHide = !active.length ? $() : that._getPanelForTab( active ), tab = clicked.closest( "li" ), eventData = { oldTab: active, oldPanel: toHide, newTab: collapsing ? $() : clicked, newPanel: toShow }; event.preventDefault(); if ( tab.hasClass( "ui-state-disabled" ) || // tab is already loading tab.hasClass( "ui-tabs-loading" ) || // can't switch durning an animation that.running || // click on active header, but not collapsible ( clickedIsActive && !options.collapsible ) || // allow canceling activation ( that._trigger( "beforeActivate", event, eventData ) === false ) ) { clicked[ 0 ].blur(); return; } options.active = collapsing ? false : that.anchors.index( clicked ); that.active = clickedIsActive ? $() : clicked; if ( that.xhr ) { that.xhr.abort(); } // if tab may be closed if ( options.collapsible ) { if ( collapsing ) { options.active = false; that.element.queue( "tabs", function() { that._hideTab( event, eventData ); }).dequeue( "tabs" ); clicked[ 0 ].blur(); return; } else if ( !toHide.length ) { that.element.queue( "tabs", function() { that._showTab( event, eventData ); }); // TODO make passing in node possible, see also http://dev.jqueryui.com/ticket/3171 that.load( that.anchors.index( clicked ), event ); clicked[ 0 ].blur(); return; } } // show new tab if ( toShow.length ) { if ( toHide.length ) { that.element.queue( "tabs", function() { that._hideTab( event, eventData ); }); } that.element.queue( "tabs", function() { that._showTab( event, eventData ); }); that.load( that.anchors.index( clicked ), event ); } else { throw "jQuery UI Tabs: Mismatching fragment identifier."; } // Prevent IE from keeping other link focussed when using the back button // and remove dotted border from clicked link. This is controlled via CSS // in modern browsers; blur() removes focus from address bar in Firefox // which can become a usability if ( $.browser.msie ) { clicked[ 0 ].blur(); } }, _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 current active header active = active || this.active[ 0 ]; this._eventHandler({ target: active, currentTarget: active, preventDefault: $.noop }); }, _findActive: function( selector ) { return typeof selector === "number" ? this.anchors.eq( selector ) : typeof selector === "string" ? this.anchors.filter( "[href$='" + selector + "']" ) : $(); }, _getIndex: function( index ) { // meta-function to give users option to provide a href string instead of a numerical index. // also sanitizes numerical indexes to valid values. if ( typeof index == "string" ) { index = this.anchors.index( this.anchors.filter( "[href$=" + index + "]" ) ); } return index; }, _destroy: function() { var o = this.options; if ( this.xhr ) { this.xhr.abort(); } this.element.removeClass( "ui-tabs ui-widget ui-widget-content ui-corner-all ui-tabs-collapsible" ); this.list.removeClass( "ui-tabs-nav ui-helper-reset ui-helper-clearfix ui-widget-header ui-corner-all" ); this.anchors.each(function() { var $this = $( this ).unbind( ".tabs" ); $.each( [ "href", "load" ], function( i, prefix ) { $this.removeData( prefix + ".tabs" ); }); }); this.lis.unbind( ".tabs" ).add( this.panels ).each(function() { if ( $.data( this, "destroy.tabs" ) ) { $( this ).remove(); } else { $( this ).removeClass([ "ui-state-default", "ui-corner-top", "ui-tabs-active", "ui-state-active", "ui-state-disabled", "ui-tabs-panel", "ui-widget-content", "ui-corner-bottom" ].join( " " ) ); } }); return this; }, enable: function( index ) { if ( index === undefined ) { for ( var i = 0, len = this.lis.length; i < len; i++ ) { this.enable( i ); } return this; } index = this._getIndex( index ); var o = this.options; if ( !o.disabled || ($.isArray( o.disabled ) && $.inArray( index, o.disabled ) == -1 ) ) { return; } this.lis.eq( index ).removeClass( "ui-state-disabled" ); o.disabled = this.lis.map( function( i ) { return $(this).is( ".ui-state-disabled" ) ? i : null; }).get(); if ( !o.disabled.length ) { o.disabled = false; } return this; }, disable: function( index ) { if ( index === undefined ) { for ( var i = 0, len = this.lis.length; i < len; i++ ) { this.disable( i ); } return this; } index = this._getIndex( index ); var o = this.options; if ( !o.disabled || ($.isArray( o.disabled ) && $.inArray( index, o.disabled ) == -1 ) ) { this.lis.eq( index ).addClass( "ui-state-disabled" ); o.disabled = this.lis.map( function( i ) { return $(this).is( ".ui-state-disabled" ) ? i : null; }).get(); if ( o.disabled.length === this.anchors.length ) { o.disabled = true; } } return this; }, load: function( index, event ) { index = this._getIndex( index ); var self = this, o = this.options, a = this.anchors.eq( index )[ 0 ], panel = self._getPanelForTab( a ), // TODO until #3808 is fixed strip fragment identifier from url // (IE fails to load from such url) url = $( a ).attr( "href" ).replace( /#.*$/, "" ), eventData = { tab: $( a ), panel: panel }; if ( this.xhr ) { this.xhr.abort(); } // not remote if ( !url ) { this.element.dequeue( "tabs" ); return; } this.xhr = $.ajax({ url: url, beforeSend: function( jqXHR, settings ) { return self._trigger( "beforeLoad", event, $.extend( { jqXHR : jqXHR, ajaxSettings: settings }, eventData ) ); } }); if ( this.xhr ) { // load remote from here on this.lis.eq( index ).addClass( "ui-tabs-loading" ); this.xhr .success(function( response ) { panel.html( response ); }) .complete(function( jqXHR, status ) { if ( status === "abort" ) { // stop possibly running animations self.element.queue( [] ); self.panels.stop( false, true ); // "tabs" queue must not contain more than two elements, // which are the callbacks for the latest clicked tab... self.element.queue( "tabs", self.element.queue( "tabs" ).splice( -2, 2 ) ); delete this.xhr; } self.lis.eq( index ).removeClass( "ui-tabs-loading" ); self._trigger( "load", event, eventData ); }); } // last, so that load event is fired before show... self.element.dequeue( "tabs" ); return this; }, _getPanelForTab: function( tab ) { var id = $( tab ).attr( "aria-controls" ); return this.element.find( this._sanitizeSelector( "#" + id ) ); } }); $.extend( $.ui.tabs, { version: "@VERSION" }); // DEPRECATED if ( $.uiBackCompat !== false ) { // url method (function( $, prototype ) { prototype.url = function( index, url ) { this.anchors.eq( index ).attr( "href", url ); }; }( jQuery, jQuery.ui.tabs.prototype ) ); // ajaxOptions and cache options (function( $, prototype ) { $.extend( prototype.options, { ajaxOptions: null, cache: false }); var _create = prototype._create, _setOption = prototype._setOption, _destroy = prototype._destroy, oldurl = prototype.url || $.noop; $.extend( prototype, { _create: function() { _create.call( this ); var self = this; this.element.bind( "tabsbeforeload", function( event, ui ) { // tab is already cached if ( $.data( ui.tab[ 0 ], "cache.tabs" ) ) { event.preventDefault(); return; } $.extend( ui.ajaxSettings, self.options.ajaxOptions, { error: function( xhr, s, e ) { try { // Passing index avoid a race condition when this method is // called after the user has selected another tab. // Pass the anchor that initiated this request allows // loadError to manipulate the tab content panel via $(a.hash) self.options.ajaxOptions.error( xhr, s, ui.tab.closest( "li" ).index(), ui.tab[ 0 ] ); } catch ( e ) {} } }); ui.jqXHR.success( function() { if ( self.options.cache ) { $.data( ui.tab[ 0 ], "cache.tabs", true ); } }); }); }, _setOption: function( key, value ) { // reset cache if switching from cached to not cached if ( key === "cache" && value === false ) { this.anchors.removeData( "cache.tabs" ); } _setOption.apply( this, arguments ); }, _destroy: function() { this.anchors.removeData( "cache.tabs" ); _destroy.call( this ); }, url: function( index, url ){ this.anchors.eq( index ).removeData( "cache.tabs" ); oldurl.apply( this, arguments ); } }); }( jQuery, jQuery.ui.tabs.prototype ) ); // abort method (function( $, prototype ) { prototype.abort = function() { if ( this.xhr ) { this.xhr.abort(); } }; }( jQuery, jQuery.ui.tabs.prototype ) ); // spinner (function( $, prototype ) { $.extend( prototype.options, { spinner: "Loading…" }); var _create = prototype._create; prototype._create = function() { _create.call( this ); var self = this; this.element.bind( "tabsbeforeload", function( event, ui ) { if ( self.options.spinner ) { var span = $( "span", ui.tab ); if ( span.length ) { span.data( "label.tabs", span.html() ).html( self.options.spinner ); } } ui.jqXHR.complete( function() { if ( self.options.spinner ) { var span = $( "span", ui.tab ); if ( span.length ) { span.html( span.data( "label.tabs" ) ).removeData( "label.tabs" ); } } }); }); }; }( jQuery, jQuery.ui.tabs.prototype ) ); // enable/disable events (function( $, prototype ) { $.extend( prototype.options, { enable: null, disable: null }); var enable = prototype.enable, disable = prototype.disable; prototype.enable = function( index ) { var o = this.options, trigger; if ( index && o.disabled || ($.isArray( o.disabled ) && $.inArray( index, o.disabled ) !== -1 ) ) { trigger = true; } enable.apply( this, arguments ); if ( trigger ) { this._trigger( "enable", null, this._ui( this.anchors[ index ], this.panels[ index ] ) ); } }; prototype.disable = function( index ) { var o = this.options, trigger; if ( index && !o.disabled || ($.isArray( o.disabled ) && $.inArray( index, o.disabled ) == -1 ) ) { trigger = true; } disable.apply( this, arguments ); if ( trigger ) { this._trigger( "disable", null, this._ui( this.anchors[ index ], this.panels[ index ] ) ); } }; }( jQuery, jQuery.ui.tabs.prototype ) ); // add/remove methods and events (function( $, prototype ) { $.extend( prototype.options, { add: null, remove: null, tabTemplate: "