// $Id$
/**
* @file tabs.js
* jQuery UI Tabs (Tabs 3)
*
* This is nothing more than the pure jquery UI tabs implementation.
*/
(function($) {
// if the UI scope is not availalable, add it
$.ui = $.ui || {};
$.fn.tabs = function(initial, options) {
if (initial && initial.constructor == Object) { // shift arguments
options = initial;
initial = null;
}
options = options || {};
// first get initial tab from options
initial = initial && initial.constructor == Number && --initial || 0;
return this.each(function() {
new $.ui.tabs(this, $.extend(options, { initial: initial }));
});
};
// chainable tabs methods
$.each(['add', 'remove', 'enable', 'disable', 'click', 'load'], function(i, method) {
$.fn[method + 'Tab'] = function() {
var args = arguments;
return this.each(function() {
var instance = $.ui.tabs.instances[this.UI_TABS_UUID];
instance[method].apply(instance, args);
});
};
});
$.fn.selectedTab = function(returnElement) {
var selected;
if (returnElement) {
} else {
}
return selected;
};
$.ui.tabs = function(el, options) {
this.source = el;
this.options = $.extend({
// basic setup
initial: 0,
event: 'click',
disabled: [],
// TODO bookmarkable: $.ajaxHistory ? true : false,
unselected: false,
toggle: options.unselected ? true : false,
// Ajax
spinner: 'Loading…',
cache: false,
hashPrefix: 'tab-',
// 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() {},
// CSS classes
navClass: 'ui-tabs-nav',
selectedClass: 'ui-tabs-selected',
disabledClass: 'ui-tabs-disabled',
containerClass: 'ui-tabs-container',
hideClass: 'ui-tabs-hide',
loadingClass: 'ui-tabs-loading'
}, options);
this.tabify(true);
// save instance for later
var uuid = 'instance-' + $.ui.tabs.prototype.count++;
$.ui.tabs.instances[uuid] = this;
this.source['UI_TABS_UUID'] = uuid;
};
// static
$.ui.tabs.instances = {};
$.extend($.ui.tabs.prototype, {
animating: false,
count: 0,
tabify: function(init) {
this.$tabs = $('a:first-child', this.source);
this.$containers = $([]);
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.$containers = self.$containers.add(a.hash);
}
// remote tab
else {
var id = a.title && a.title.replace(/\s/g, '_') || o.hashPrefix + (self.count + 1) + '-' + (i + 1), url = a.href;
a.href = '#' + id;
a.url = url;
self.$containers = self.$containers.add(
$('#' + id)[0] || $('
')
.insertAfter( self.$containers[i - 1] || self.source )
);
}
});
if (init) {
// Try to retrieve initial tab from fragment identifier in url if present,
// otherwise try to find selected class attribute on .
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 ( $(a).parents('li:eq(0)').is('li.' + o.selectedClass) ) {
o.initial = i;
return false; // break
}
});
// attach necessary classes for styling if not present
$(this.source).is('.' + o.navClass) || $(this.source).addClass(o.navClass);
this.$containers.each(function() {
var $this = $(this);
$this.is('.' + o.containerClass) || $this.addClass(o.containerClass);
});
// highlight tab accordingly
var $lis = $('li', this.source);
this.$containers.addClass(o.hideClass);
$lis.removeClass(o.selectedClass);
if (!o.unselected) {
this.$containers.slice(o.initial, o.initial + 1).show();
$lis.slice(o.initial, o.initial + 1).addClass(o.selectedClass);
}
// trigger load of initial tab is remote tab
if (this.$tabs[o.initial].url) {
this.load(o.initial + 1, this.$tabs[o.initial].url);
if (o.cache) {
this.$tabs[o.initial].url = null; // if loaded once do not load them again
}
}
// disabled tabs
for (var i = 0, position; position = o.disabled[i]; i++) {
this.disable(position);
}
}
// setup animations
var showAnim = {}, hideAnim = {}, showSpeed = o.fxShowSpeed || o.fxSpeed,
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
}
}
// callbacks
var click = o.click, hide = o.hide, show = o.show;
// 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
function hideTab(clicked, $hide, $show) {
$hide.animate(hideAnim, hideSpeed, function() { //
$hide.addClass(o.hideClass).css(resetCSS); // maintain flexible height and accessibility in print etc.
hide(clicked, $show, $hide[0]);
if ($show) {
showTab(clicked, $hide, $show);
}
});
}
// show a tab, animation prevents browser scrolling to fragment
function showTab(clicked, $hide, $show) {
// show next tab
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 containers
}
$show.animate(showAnim, showSpeed, function() {
$show.removeClass(o.hideClass).css(resetCSS); // maintain flexible height and accessibility in print etc.
if ($.browser.msie) {
$hide[0].style.filter = '';
$show[0].style.filter = '';
}
show(clicked, $show[0], $hide[0]);
self.animating = false;
});
}
// switch a tab
function switchTab(clicked, $hide, $show) {
/*if (o.bookmarkable && trueClick) { // add to history only if true click occured, not a triggered click
$.ajaxHistory.update(clicked.hash);
}*/
$(clicked).parents('li:eq(0)').addClass(o.selectedClass)
.siblings().removeClass(o.selectedClass);
hideTab(clicked, $hide, $show);
}
// tab click handler
function tabClick(e) {
//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.$containers.filter(':visible'), $show = $(this.hash);
// if tab may be closed
if (o.toggle && !$li.is('.' + o.disabledClass) && !self.animating) {
if ($li.is('.' + o.selectedClass)) {
$li.removeClass(o.selectedClass);
hideTab(this, $hide);
this.blur();
return false;
} else if (!$hide.length) {
$li.addClass(o.selectedClass);
showTab(this, $hide, $show);
this.blur();
return false;
}
}
// If tab is already selected or disabled, animation is still running 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.is('.' + o.selectedClass + ', .' + o.disabledClass)
|| self.animating || click(this, $show[0], $hide[0]) === false) {
this.blur();
return false;
}
self.animating = true;
// 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 (this.url) { // remote tab
var a = this;
self.load(self.$tabs.index(this) + 1, this.url, function() {
switchTab(a, $hide, $show);
});
if (o.cache) {
this.url = null; // if loaded once do not load them again
}
} else {
switchTab(this, $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 Drupal.t('jQuery UI Tabs: Mismatching fragment identifier.');
}
this.blur(); // prevent IE from keeping other link focussed when using the back button
//return o.bookmarkable && !!trueClick; // convert trueClick == undefined to Boolean required in IE
return false;
}
// attach click event, avoid duplicates from former tabifying
this.$tabs.unbind(o.event, tabClick).bind(o.event, tabClick);
},
add: function(url, text, position) {
if (url && text) {
var o = this.options;
position = position || this.$tabs.length; // append by default
if (position >= this.$tabs.length) {
var method = 'insertAfter';
position = this.$tabs.length;
} else {
var method = 'insertBefore';
}
if (url.indexOf('#') == 0) { // ajax container is created by tabify automatically
var $container = $(url);
// try to find an existing element before creating a new one
($container.length && $container || $(''))
[method](this.$containers[position - 1]);
}
$('' + text + '')
[method](this.$tabs.slice(position - 1, position).parents('li:eq(0)'));
this.tabify();
o.add(this.$tabs[position - 1], this.$containers[position - 1]); // callback
} else {
throw Drupal.t('jQuery UI Tabs: Not enough arguments to add tab.');
}
},
remove: function(position) {
if (position && position.constructor == Number) {
this.$tabs.slice(position - 1, position).parents('li:eq(0)').remove();
this.$containers.slice(position - 1, position).remove();
this.tabify();
}
this.options.remove(); // callback
},
enable: function(position) {
var $li = this.$tabs.slice(position - 1, position).parents('li:eq(0)'), o = this.options;
$li.removeClass(o.disabledClass);
if ($.browser.safari) { // fix disappearing tab after enabling in Safari... TODO check Safari 3
$li.animate({ opacity: 1 }, 1, function() {
$li.css({ opacity: '' });
});
}
o.enable(this.$tabs[position - 1], this.$containers[position - 1]); // callback
},
disable: function(position) {
var $li = this.$tabs.slice(position - 1, position).parents('li:eq(0)'), o = this.options;
if ($.browser.safari) { // fix opacity of tab after disabling in Safari... TODO check Safari 3
$li.animate({ opacity: 0 }, 1, function() {
$li.css({ opacity: '' });
});
}
$li.addClass(this.options.disabledClass);
o.disable(this.$tabs[position - 1], this.$containers[position - 1]); // callback
},
click: function(position) {
this.$tabs.slice(position - 1, position).trigger('click');
},
load: function(position, url, callback) {
var self = this,
o = this.options,
$a = this.$tabs.slice(position - 1, position).addClass(o.loadingClass),
$span = $('span', $a),
text = $span.html();
// shift arguments
if (url && url.constructor == Function) {
callback = url;
}
// set new URL
if (url) {
$a[0].url = url;
}
// load
if (o.spinner) {
$span.html('' + o.spinner + '');
}
setTimeout(function() { // timeout is again required in IE, "wait" for id being restored
$($a[0].hash).load(url, function() {
if (o.spinner) {
$span.html(text);
}
$a.removeClass(o.loadingClass);
// This callback is needed because the switch has to take place after loading
// has completed.
if (callback && callback.constructor == Function) {
callback();
}
o.load(self.$tabs[position - 1], self.$containers[position - 1]); // callback
});
}, 0);
}
});
})(jQuery);