530 lines
22 KiB
JavaScript
530 lines
22 KiB
JavaScript
/*
|
|
* Tabs 3 - New Wave Tabs
|
|
*
|
|
* Copyright (c) 2007 Klaus Hartl (stilbuero.de)
|
|
* Dual licensed under the MIT (MIT-LICENSE.txt)
|
|
* and GPL (GPL-LICENSE.txt) licenses.
|
|
*/
|
|
|
|
(function($) {
|
|
|
|
// if the UI scope is not availalable, add it
|
|
$.ui = $.ui || {};
|
|
|
|
// tabs initialization
|
|
$.fn.tabs = function(initial, options) {
|
|
if (initial && initial.constructor == Object) { // shift arguments
|
|
options = initial;
|
|
initial = null;
|
|
}
|
|
options = options || {};
|
|
|
|
initial = initial && initial.constructor == Number && --initial || 0;
|
|
|
|
return this.each(function() {
|
|
new $.ui.tabs(this, $.extend(options, { initial: initial }));
|
|
});
|
|
};
|
|
|
|
// other chainable tabs methods
|
|
$.each(['Add', 'Remove', 'Enable', 'Disable', 'Click', 'Load', 'Href'], function(i, method) {
|
|
$.fn['tabs' + method] = function() {
|
|
var args = arguments;
|
|
return this.each(function() {
|
|
var instance = $.ui.tabs.getInstance(this);
|
|
instance[method.toLowerCase()].apply(instance, args);
|
|
});
|
|
};
|
|
});
|
|
$.fn.tabsSelected = function() {
|
|
var selected = -1;
|
|
if (this[0]) {
|
|
var instance = $.ui.tabs.getInstance(this[0]),
|
|
$lis = $('li', this);
|
|
selected = $lis.index( $lis.filter('.' + instance.options.selectedClass)[0] );
|
|
}
|
|
return selected >= 0 ? ++selected : -1;
|
|
};
|
|
|
|
// tabs class
|
|
$.ui.tabs = function(el, options) {
|
|
|
|
this.source = el;
|
|
|
|
this.options = $.extend({
|
|
|
|
// basic setup
|
|
initial: 0,
|
|
event: 'click',
|
|
disabled: [],
|
|
cookie: null, // pass options object as expected by cookie plugin: { expires: 7, path: '/', domain: 'jquery.com', secure: true }
|
|
// TODO bookmarkable: $.ajaxHistory ? true : false,
|
|
unselected: false,
|
|
unselect: options.unselected ? true : false,
|
|
|
|
// Ajax
|
|
spinner: 'Loading…',
|
|
cache: false,
|
|
idPrefix: 'ui-tabs-',
|
|
ajaxOptions: {},
|
|
|
|
// animations
|
|
/*fxFade: null,
|
|
fxSlide: null,
|
|
fxShow: null,
|
|
fxHide: null,*/
|
|
fxSpeed: 'normal',
|
|
/*fxShowSpeed: null,
|
|
fxHideSpeed: null,*/
|
|
|
|
// callbacks
|
|
add: function() {},
|
|
remove: function() {},
|
|
enable: function() {},
|
|
disable: function() {},
|
|
click: function() {},
|
|
hide: function() {},
|
|
show: function() {},
|
|
load: function() {},
|
|
|
|
// templates
|
|
tabTemplate: '<li><a href="#{href}"><span>#{text}</span></a></li>',
|
|
panelTemplate: '<div></div>',
|
|
|
|
// CSS classes
|
|
navClass: 'ui-tabs-nav',
|
|
selectedClass: 'ui-tabs-selected',
|
|
unselectClass: 'ui-tabs-unselect',
|
|
disabledClass: 'ui-tabs-disabled',
|
|
panelClass: 'ui-tabs-panel',
|
|
hideClass: 'ui-tabs-hide',
|
|
loadingClass: 'ui-tabs-loading'
|
|
|
|
}, options);
|
|
|
|
this.options.event += '.ui-tabs'; // namespace event
|
|
this.options.cookie = $.cookie && $.cookie.constructor == Function && this.options.cookie;
|
|
|
|
// save instance for later
|
|
$.data(el, $.ui.tabs.INSTANCE_KEY, this);
|
|
|
|
// create tabs
|
|
this.tabify(true);
|
|
};
|
|
|
|
// static
|
|
$.ui.tabs.INSTANCE_KEY = 'ui_tabs_instance';
|
|
$.ui.tabs.getInstance = function(el) {
|
|
return $.data(el, $.ui.tabs.INSTANCE_KEY);
|
|
};
|
|
|
|
// instance methods
|
|
$.extend($.ui.tabs.prototype, {
|
|
tabId: function(a) {
|
|
return a.title ? a.title.replace(/\s/g, '_')
|
|
: this.options.idPrefix + $.data(a);
|
|
},
|
|
tabify: function(init) {
|
|
|
|
this.$lis = $('li:has(a[href])', this.source);
|
|
this.$tabs = this.$lis.map(function() { return $('a', this)[0] });
|
|
this.$panels = $([]);
|
|
|
|
var self = this, o = this.options;
|
|
|
|
this.$tabs.each(function(i, a) {
|
|
// inline tab
|
|
if (a.hash && a.hash.replace('#', '')) { // Safari 2 reports '#' for an empty hash
|
|
self.$panels = self.$panels.add(a.hash);
|
|
}
|
|
// remote tab
|
|
else if ($(a).attr('href') != '#') { // prevent loading the page itself if href is just "#"
|
|
$.data(a, 'href', a.href);
|
|
var id = self.tabId(a);
|
|
a.href = '#' + id;
|
|
self.$panels = self.$panels.add(
|
|
$('#' + id)[0] || $(o.panelTemplate).attr('id', id).addClass(o.panelClass)
|
|
.insertAfter( self.$panels[i - 1] || self.source )
|
|
);
|
|
}
|
|
// invalid tab href
|
|
else {
|
|
o.disabled.push(i + 1);
|
|
}
|
|
});
|
|
|
|
if (init) {
|
|
|
|
// attach necessary classes for styling if not present
|
|
$(this.source).hasClass(o.navClass) || $(this.source).addClass(o.navClass);
|
|
this.$panels.each(function() {
|
|
var $this = $(this);
|
|
$this.hasClass(o.panelClass) || $this.addClass(o.panelClass);
|
|
});
|
|
|
|
// disabled tabs
|
|
for (var i = 0, position; position = o.disabled[i]; i++) {
|
|
this.disable(position);
|
|
}
|
|
|
|
// Try to retrieve initial tab:
|
|
// 1. from fragment identifier in url if present
|
|
// 2. from cookie
|
|
// 3. from selected class attribute on <li>
|
|
// 4. otherwise use given initial argument
|
|
// 5. check if tab is disabled
|
|
this.$tabs.each(function(i, a) {
|
|
if (location.hash) {
|
|
if (a.hash == location.hash) {
|
|
o.initial = i;
|
|
// prevent page scroll to fragment
|
|
//if (($.browser.msie || $.browser.opera) && !o.remote) {
|
|
if ($.browser.msie || $.browser.opera) {
|
|
var $toShow = $(location.hash), toShowId = $toShow.attr('id');
|
|
$toShow.attr('id', '');
|
|
setTimeout(function() {
|
|
$toShow.attr('id', toShowId); // restore id
|
|
}, 500);
|
|
}
|
|
scrollTo(0, 0);
|
|
return false; // break
|
|
}
|
|
} else if (o.cookie) {
|
|
o.initial = parseInt($.cookie( $.ui.tabs.INSTANCE_KEY + $.data(self.source) )) || 0;
|
|
return false; // break
|
|
} else if ( self.$lis.eq(i).hasClass(o.selectedClass) ) {
|
|
o.initial = i;
|
|
return false; // break
|
|
}
|
|
});
|
|
var n = this.$lis.length;
|
|
while (this.$lis.eq(o.initial).hasClass(o.disabledClass) && n) {
|
|
o.initial = ++o.initial < this.$lis.length ? o.initial : 0;
|
|
n--;
|
|
}
|
|
if (!n) { // all tabs disabled, set option unselected to true
|
|
o.unselected = o.unselect = true;
|
|
}
|
|
|
|
// highlight selected tab
|
|
this.$panels.addClass(o.hideClass);
|
|
this.$lis.removeClass(o.selectedClass);
|
|
if (!o.unselected) {
|
|
this.$panels.eq(o.initial).show().removeClass(o.hideClass); // use show and remove class to show in any case no matter how it has been hidden before
|
|
this.$lis.eq(o.initial).addClass(o.selectedClass);
|
|
}
|
|
|
|
// load if remote tab
|
|
var href = !o.unselected && $.data(this.$tabs[o.initial], 'href');
|
|
if (href) {
|
|
this.load(o.initial + 1, href);
|
|
}
|
|
|
|
// disable click if event is configured to something else
|
|
if (!/^click/.test(o.event)) {
|
|
this.$tabs.bind('click', function(e) { e.preventDefault(); });
|
|
}
|
|
|
|
}
|
|
|
|
// setup animations
|
|
var showAnim = {}, showSpeed = o.fxShowSpeed || o.fxSpeed,
|
|
hideAnim = {}, hideSpeed = o.fxHideSpeed || o.fxSpeed;
|
|
if (o.fxSlide || o.fxFade) {
|
|
if (o.fxSlide) {
|
|
showAnim['height'] = 'show';
|
|
hideAnim['height'] = 'hide';
|
|
}
|
|
if (o.fxFade) {
|
|
showAnim['opacity'] = 'show';
|
|
hideAnim['opacity'] = 'hide';
|
|
}
|
|
} else {
|
|
if (o.fxShow) {
|
|
showAnim = o.fxShow;
|
|
} else { // use some kind of animation to prevent browser scrolling to the tab
|
|
showAnim['min-width'] = 0; // avoid opacity, causes flicker in Firefox
|
|
showSpeed = 1; // as little as 1 is sufficient
|
|
}
|
|
if (o.fxHide) {
|
|
hideAnim = o.fxHide;
|
|
} else { // use some kind of animation to prevent browser scrolling to the tab
|
|
hideAnim['min-width'] = 0; // avoid opacity, causes flicker in Firefox
|
|
hideSpeed = 1; // as little as 1 is sufficient
|
|
}
|
|
}
|
|
|
|
// reset some styles to maintain print style sheets etc.
|
|
var resetCSS = { display: '', overflow: '', height: '' };
|
|
if (!$.browser.msie) { // not in IE to prevent ClearType font issue
|
|
resetCSS['opacity'] = '';
|
|
}
|
|
|
|
// Hide a tab, animation prevents browser scrolling to fragment,
|
|
// $show is optional.
|
|
function hideTab(clicked, $hide, $show) {
|
|
$hide.animate(hideAnim, hideSpeed, function() { //
|
|
$hide.addClass(o.hideClass).css(resetCSS); // maintain flexible height and accessibility in print etc.
|
|
if ($.browser.msie && hideAnim['opacity']) {
|
|
$hide[0].style.filter = '';
|
|
}
|
|
o.hide(clicked, $hide[0], $show && $show[0] || null);
|
|
if ($show) {
|
|
showTab(clicked, $show, $hide);
|
|
}
|
|
});
|
|
}
|
|
|
|
// Show a tab, animation prevents browser scrolling to fragment,
|
|
// $hide is optional
|
|
function showTab(clicked, $show, $hide) {
|
|
if (!(o.fxSlide || o.fxFade || o.fxShow)) {
|
|
$show.css('display', 'block'); // prevent occasionally occuring flicker in Firefox cause by gap between showing and hiding the tab panels
|
|
}
|
|
$show.animate(showAnim, showSpeed, function() {
|
|
$show.removeClass(o.hideClass).css(resetCSS); // maintain flexible height and accessibility in print etc.
|
|
if ($.browser.msie && showAnim['opacity']) {
|
|
$show[0].style.filter = '';
|
|
}
|
|
o.show(clicked, $show[0], $hide && $hide[0] || null);
|
|
});
|
|
}
|
|
|
|
// switch a tab
|
|
function switchTab(clicked, $li, $hide, $show) {
|
|
/*if (o.bookmarkable && trueClick) { // add to history only if true click occured, not a triggered click
|
|
$.ajaxHistory.update(clicked.hash);
|
|
}*/
|
|
$li.addClass(o.selectedClass)
|
|
.siblings().removeClass(o.selectedClass);
|
|
hideTab(clicked, $hide, $show);
|
|
}
|
|
|
|
// attach tab event handler, unbind to avoid duplicates from former tabifying...
|
|
this.$tabs.unbind(o.event).bind(o.event, function() {
|
|
|
|
//var trueClick = e.clientX; // add to history only if true click occured, not a triggered click
|
|
var $li = $(this).parents('li:eq(0)'),
|
|
$hide = self.$panels.filter(':visible'),
|
|
$show = $(this.hash);
|
|
|
|
// If tab is already selected and not unselectable or tab disabled or click callback returns false stop here.
|
|
// Check if click handler returns false last so that it is not executed for a disabled tab!
|
|
if (($li.hasClass(o.selectedClass) && !o.unselect) || $li.hasClass(o.disabledClass)
|
|
|| o.click(this, $show[0], $hide[0]) === false) {
|
|
this.blur();
|
|
return false;
|
|
}
|
|
|
|
if (o.cookie) {
|
|
$.cookie($.ui.tabs.INSTANCE_KEY + $.data(self.source), self.$tabs.index(this), o.cookie);
|
|
}
|
|
|
|
// if tab may be closed
|
|
if (o.unselect) {
|
|
if ($li.hasClass(o.selectedClass)) {
|
|
$li.removeClass(o.selectedClass);
|
|
self.$panels.stop();
|
|
hideTab(this, $hide);
|
|
this.blur();
|
|
return false;
|
|
} else if (!$hide.length) {
|
|
self.$panels.stop();
|
|
if ($.data(this, 'href')) { // remote tab
|
|
var a = this;
|
|
self.load(self.$tabs.index(this) + 1, $.data(this, 'href'), function() {
|
|
$li.addClass(o.selectedClass).addClass(o.unselectClass);
|
|
showTab(a, $show);
|
|
});
|
|
} else {
|
|
$li.addClass(o.selectedClass).addClass(o.unselectClass);
|
|
showTab(this, $show);
|
|
}
|
|
this.blur();
|
|
return false;
|
|
}
|
|
}
|
|
|
|
// stop possibly running animations
|
|
self.$panels.stop();
|
|
|
|
// show new tab
|
|
if ($show.length) {
|
|
|
|
// prevent scrollbar scrolling to 0 and than back in IE7, happens only if bookmarking/history is enabled
|
|
/*if ($.browser.msie && o.bookmarkable) {
|
|
var showId = this.hash.replace('#', '');
|
|
$show.attr('id', '');
|
|
setTimeout(function() {
|
|
$show.attr('id', showId); // restore id
|
|
}, 0);
|
|
}*/
|
|
|
|
if ($.data(this, 'href')) { // remote tab
|
|
var a = this;
|
|
self.load(self.$tabs.index(this) + 1, $.data(this, 'href'), function() {
|
|
switchTab(a, $li, $hide, $show);
|
|
});
|
|
} else {
|
|
switchTab(this, $li, $hide, $show);
|
|
}
|
|
|
|
// Set scrollbar to saved position - need to use timeout with 0 to prevent browser scroll to target of hash
|
|
/*var scrollX = window.pageXOffset || document.documentElement && document.documentElement.scrollLeft || document.body.scrollLeft || 0;
|
|
var scrollY = window.pageYOffset || document.documentElement && document.documentElement.scrollTop || document.body.scrollTop || 0;
|
|
setTimeout(function() {
|
|
scrollTo(scrollX, scrollY);
|
|
}, 0);*/
|
|
|
|
} 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 in modern
|
|
// browsers via CSS, also blur removes focus from address bar in Firefox
|
|
// which can become a usability and annoying problem with tabsRotate.
|
|
if ($.browser.msie) {
|
|
this.blur();
|
|
}
|
|
|
|
//return o.bookmarkable && !!trueClick; // convert trueClick == undefined to Boolean required in IE
|
|
return false;
|
|
|
|
});
|
|
|
|
},
|
|
add: function(url, text, position) {
|
|
if (url && text) {
|
|
position = position || this.$tabs.length; // append by default
|
|
|
|
var o = this.options,
|
|
$li = $(o.tabTemplate.replace(/#\{href\}/, url).replace(/#\{text\}/, text));
|
|
|
|
var id = url.indexOf('#') == 0 ? url.replace('#', '') : this.tabId( $('a:first-child', $li)[0] );
|
|
|
|
// try to find an existing element before creating a new one
|
|
var $panel = $('#' + id);
|
|
$panel = $panel.length && $panel
|
|
|| $(o.panelTemplate).attr('id', id).addClass(o.panelClass).addClass(o.hideClass);
|
|
if (position >= this.$lis.length) {
|
|
$li.appendTo(this.source);
|
|
$panel.appendTo(this.source.parentNode);
|
|
} else {
|
|
$li.insertBefore(this.$lis[position - 1]);
|
|
$panel.insertBefore(this.$panels[position - 1]);
|
|
}
|
|
|
|
this.tabify();
|
|
|
|
if (this.$tabs.length == 1) {
|
|
$li.addClass(o.selectedClass);
|
|
$panel.removeClass(o.hideClass);
|
|
var href = $.data(this.$tabs[0], 'href');
|
|
if (href) {
|
|
this.load(position + 1, href);
|
|
}
|
|
}
|
|
o.add(this.$tabs[position], this.$panels[position]); // callback
|
|
} else {
|
|
throw 'jQuery UI Tabs: Not enough arguments to add tab.';
|
|
}
|
|
},
|
|
remove: function(position) {
|
|
if (position && position.constructor == Number) {
|
|
var o = this.options, $li = this.$lis.eq(position - 1).remove(),
|
|
$panel = this.$panels.eq(position - 1).remove();
|
|
|
|
// If selected tab was removed focus tab to the right or
|
|
// tab to the left if last tab was removed.
|
|
if ($li.hasClass(o.selectedClass) && this.$tabs.length > 1) {
|
|
this.click(position + (position < this.$tabs.length ? 1 : -1));
|
|
}
|
|
this.tabify();
|
|
o.remove($li.end()[0], $panel[0]); // callback
|
|
}
|
|
},
|
|
enable: function(position) {
|
|
var o = this.options, $li = this.$lis.eq(position - 1);
|
|
$li.removeClass(o.disabledClass);
|
|
if ($.browser.safari) { // fix disappearing tab (that used opacity indicating disabling) after enabling in Safari 2...
|
|
$li.css('display', 'inline-block');
|
|
setTimeout(function() {
|
|
$li.css('display', 'block')
|
|
}, 0)
|
|
}
|
|
o.enable(this.$tabs[position - 1], this.$panels[position - 1]); // callback
|
|
},
|
|
disable: function(position) {
|
|
var o = this.options;
|
|
this.$lis.eq(position - 1).addClass(o.disabledClass);
|
|
o.disable(this.$tabs[position - 1], this.$panels[position - 1]); // callback
|
|
},
|
|
click: function(position) {
|
|
this.$tabs.eq(position - 1).trigger(this.options.event);
|
|
},
|
|
load: function(position, url, callback) {
|
|
var self = this, o = this.options,
|
|
$a = this.$tabs.eq(position - 1), a = $a[0], $span = $('span', a);
|
|
|
|
// shift arguments
|
|
if (url && url.constructor == Function) {
|
|
callback = url;
|
|
url = null;
|
|
}
|
|
|
|
// set new URL or get existing
|
|
if (url) {
|
|
$.data(a, 'href', url);
|
|
} else {
|
|
url = $.data(a, 'href');
|
|
}
|
|
|
|
// load
|
|
if (o.spinner) {
|
|
$.data(a, 'title', $span.html());
|
|
$span.html('<em>' + o.spinner + '</em>');
|
|
}
|
|
var finish = function() {
|
|
self.$tabs.filter('.' + o.loadingClass).each(function() {
|
|
$(this).removeClass(o.loadingClass);
|
|
if (o.spinner) {
|
|
$('span', this).html( $.data(this, 'title') );
|
|
}
|
|
});
|
|
self.xhr = null;
|
|
};
|
|
var ajaxOptions = $.extend(o.ajaxOptions, {
|
|
url: url,
|
|
success: function(r) {
|
|
$(a.hash).html(r);
|
|
finish();
|
|
// This callback is required because the switch has to take
|
|
// place after loading has completed.
|
|
if (callback && callback.constructor == Function) {
|
|
callback();
|
|
}
|
|
if (o.cache) {
|
|
$.removeData(a, 'href'); // if loaded once do not load them again
|
|
}
|
|
o.load(self.$tabs[position - 1], self.$panels[position - 1]); // callback
|
|
}
|
|
});
|
|
if (this.xhr) {
|
|
// terminate pending requests from other tabs and restore title
|
|
this.xhr.abort();
|
|
finish();
|
|
}
|
|
$a.addClass(o.loadingClass);
|
|
setTimeout(function() { // timeout is again required in IE, "wait" for id being restored
|
|
self.xhr = $.ajax(ajaxOptions);
|
|
}, 0);
|
|
|
|
},
|
|
href: function(position, href) {
|
|
$.data(this.$tabs.eq(position - 1)[0], 'href', href);
|
|
}
|
|
});
|
|
|
|
})(jQuery);
|