334 lines
8.1 KiB
JavaScript
334 lines
8.1 KiB
JavaScript
'use strict';
|
|
|
|
!function($) {
|
|
|
|
/**
|
|
* Tabs module.
|
|
* @module foundation.tabs
|
|
* @requires foundation.util.keyboard
|
|
* @requires foundation.util.timerAndImageLoader if tabs contain images
|
|
*/
|
|
|
|
class Tabs {
|
|
/**
|
|
* Creates a new instance of tabs.
|
|
* @class
|
|
* @fires Tabs#init
|
|
* @param {jQuery} element - jQuery object to make into tabs.
|
|
* @param {Object} options - Overrides to the default plugin settings.
|
|
*/
|
|
constructor(element, options) {
|
|
this.$element = element;
|
|
this.options = $.extend({}, Tabs.defaults, this.$element.data(), options);
|
|
|
|
this._init();
|
|
Foundation.registerPlugin(this, 'Tabs');
|
|
Foundation.Keyboard.register('Tabs', {
|
|
'ENTER': 'open',
|
|
'SPACE': 'open',
|
|
'ARROW_RIGHT': 'next',
|
|
'ARROW_UP': 'previous',
|
|
'ARROW_DOWN': 'next',
|
|
'ARROW_LEFT': 'previous'
|
|
// 'TAB': 'next',
|
|
// 'SHIFT_TAB': 'previous'
|
|
});
|
|
}
|
|
|
|
/**
|
|
* Initializes the tabs by showing and focusing (if autoFocus=true) the preset active tab.
|
|
* @private
|
|
*/
|
|
_init() {
|
|
var _this = this;
|
|
|
|
this.$tabTitles = this.$element.find(`.${this.options.linkClass}`);
|
|
this.$tabContent = $(`[data-tabs-content="${this.$element[0].id}"]`);
|
|
|
|
this.$tabTitles.each(function(){
|
|
var $elem = $(this),
|
|
$link = $elem.find('a'),
|
|
isActive = $elem.hasClass('is-active'),
|
|
hash = $link[0].hash.slice(1),
|
|
linkId = $link[0].id ? $link[0].id : `${hash}-label`,
|
|
$tabContent = $(`#${hash}`);
|
|
|
|
$elem.attr({'role': 'presentation'});
|
|
|
|
$link.attr({
|
|
'role': 'tab',
|
|
'aria-controls': hash,
|
|
'aria-selected': isActive,
|
|
'id': linkId
|
|
});
|
|
|
|
$tabContent.attr({
|
|
'role': 'tabpanel',
|
|
'aria-hidden': !isActive,
|
|
'aria-labelledby': linkId
|
|
});
|
|
|
|
if(isActive && _this.options.autoFocus){
|
|
$link.focus();
|
|
}
|
|
});
|
|
|
|
if(this.options.matchHeight) {
|
|
var $images = this.$tabContent.find('img');
|
|
|
|
if ($images.length) {
|
|
Foundation.onImagesLoaded($images, this._setHeight.bind(this));
|
|
} else {
|
|
this._setHeight();
|
|
}
|
|
}
|
|
|
|
this._events();
|
|
}
|
|
|
|
/**
|
|
* Adds event handlers for items within the tabs.
|
|
* @private
|
|
*/
|
|
_events() {
|
|
this._addKeyHandler();
|
|
this._addClickHandler();
|
|
this._setHeightMqHandler = null;
|
|
|
|
if (this.options.matchHeight) {
|
|
this._setHeightMqHandler = this._setHeight.bind(this);
|
|
|
|
$(window).on('changed.zf.mediaquery', this._setHeightMqHandler);
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Adds click handlers for items within the tabs.
|
|
* @private
|
|
*/
|
|
_addClickHandler() {
|
|
var _this = this;
|
|
|
|
this.$element
|
|
.off('click.zf.tabs')
|
|
.on('click.zf.tabs', `.${this.options.linkClass}`, function(e){
|
|
e.preventDefault();
|
|
e.stopPropagation();
|
|
if ($(this).hasClass('is-active')) {
|
|
return;
|
|
}
|
|
_this._handleTabChange($(this));
|
|
});
|
|
}
|
|
|
|
/**
|
|
* Adds keyboard event handlers for items within the tabs.
|
|
* @private
|
|
*/
|
|
_addKeyHandler() {
|
|
var _this = this;
|
|
var $firstTab = _this.$element.find('li:first-of-type');
|
|
var $lastTab = _this.$element.find('li:last-of-type');
|
|
|
|
this.$tabTitles.off('keydown.zf.tabs').on('keydown.zf.tabs', function(e){
|
|
if (e.which === 9) return;
|
|
|
|
|
|
var $element = $(this),
|
|
$elements = $element.parent('ul').children('li'),
|
|
$prevElement,
|
|
$nextElement;
|
|
|
|
$elements.each(function(i) {
|
|
if ($(this).is($element)) {
|
|
if (_this.options.wrapOnKeys) {
|
|
$prevElement = i === 0 ? $elements.last() : $elements.eq(i-1);
|
|
$nextElement = i === $elements.length -1 ? $elements.first() : $elements.eq(i+1);
|
|
} else {
|
|
$prevElement = $elements.eq(Math.max(0, i-1));
|
|
$nextElement = $elements.eq(Math.min(i+1, $elements.length-1));
|
|
}
|
|
return;
|
|
}
|
|
});
|
|
|
|
// handle keyboard event with keyboard util
|
|
Foundation.Keyboard.handleKey(e, 'Tabs', {
|
|
open: function() {
|
|
$element.find('[role="tab"]').focus();
|
|
_this._handleTabChange($element);
|
|
},
|
|
previous: function() {
|
|
$prevElement.find('[role="tab"]').focus();
|
|
_this._handleTabChange($prevElement);
|
|
},
|
|
next: function() {
|
|
$nextElement.find('[role="tab"]').focus();
|
|
_this._handleTabChange($nextElement);
|
|
},
|
|
handled: function() {
|
|
e.stopPropagation();
|
|
e.preventDefault();
|
|
}
|
|
});
|
|
});
|
|
}
|
|
|
|
/**
|
|
* Opens the tab `$targetContent` defined by `$target`.
|
|
* @param {jQuery} $target - Tab to open.
|
|
* @fires Tabs#change
|
|
* @function
|
|
*/
|
|
_handleTabChange($target) {
|
|
var $tabLink = $target.find('[role="tab"]'),
|
|
hash = $tabLink[0].hash,
|
|
$targetContent = this.$tabContent.find(hash),
|
|
$oldTab = this.$element.
|
|
find(`.${this.options.linkClass}.is-active`)
|
|
.removeClass('is-active')
|
|
.find('[role="tab"]')
|
|
.attr({ 'aria-selected': 'false' });
|
|
|
|
$(`#${$oldTab.attr('aria-controls')}`)
|
|
.removeClass('is-active')
|
|
.attr({ 'aria-hidden': 'true' });
|
|
|
|
$target.addClass('is-active');
|
|
|
|
$tabLink.attr({'aria-selected': 'true'});
|
|
|
|
$targetContent
|
|
.addClass('is-active')
|
|
.attr({'aria-hidden': 'false'});
|
|
|
|
/**
|
|
* Fires when the plugin has successfully changed tabs.
|
|
* @event Tabs#change
|
|
*/
|
|
this.$element.trigger('change.zf.tabs', [$target]);
|
|
}
|
|
|
|
/**
|
|
* Public method for selecting a content pane to display.
|
|
* @param {jQuery | String} elem - jQuery object or string of the id of the pane to display.
|
|
* @function
|
|
*/
|
|
selectTab(elem) {
|
|
var idStr;
|
|
|
|
if (typeof elem === 'object') {
|
|
idStr = elem[0].id;
|
|
} else {
|
|
idStr = elem;
|
|
}
|
|
|
|
if (idStr.indexOf('#') < 0) {
|
|
idStr = `#${idStr}`;
|
|
}
|
|
|
|
var $target = this.$tabTitles.find(`[href="${idStr}"]`).parent(`.${this.options.linkClass}`);
|
|
|
|
this._handleTabChange($target);
|
|
};
|
|
/**
|
|
* Sets the height of each panel to the height of the tallest panel.
|
|
* If enabled in options, gets called on media query change.
|
|
* If loading content via external source, can be called directly or with _reflow.
|
|
* @function
|
|
* @private
|
|
*/
|
|
_setHeight() {
|
|
var max = 0;
|
|
this.$tabContent
|
|
.find(`.${this.options.panelClass}`)
|
|
.css('height', '')
|
|
.each(function() {
|
|
var panel = $(this),
|
|
isActive = panel.hasClass('is-active');
|
|
|
|
if (!isActive) {
|
|
panel.css({'visibility': 'hidden', 'display': 'block'});
|
|
}
|
|
|
|
var temp = this.getBoundingClientRect().height;
|
|
|
|
if (!isActive) {
|
|
panel.css({
|
|
'visibility': '',
|
|
'display': ''
|
|
});
|
|
}
|
|
|
|
max = temp > max ? temp : max;
|
|
})
|
|
.css('height', `${max}px`);
|
|
}
|
|
|
|
/**
|
|
* Destroys an instance of an tabs.
|
|
* @fires Tabs#destroyed
|
|
*/
|
|
destroy() {
|
|
this.$element
|
|
.find(`.${this.options.linkClass}`)
|
|
.off('.zf.tabs').hide().end()
|
|
.find(`.${this.options.panelClass}`)
|
|
.hide();
|
|
|
|
if (this.options.matchHeight) {
|
|
if (this._setHeightMqHandler != null) {
|
|
$(window).off('changed.zf.mediaquery', this._setHeightMqHandler);
|
|
}
|
|
}
|
|
|
|
Foundation.unregisterPlugin(this);
|
|
}
|
|
}
|
|
|
|
Tabs.defaults = {
|
|
/**
|
|
* Allows the window to scroll to content of active pane on load if set to true.
|
|
* @option
|
|
* @example false
|
|
*/
|
|
autoFocus: false,
|
|
|
|
/**
|
|
* Allows keyboard input to 'wrap' around the tab links.
|
|
* @option
|
|
* @example true
|
|
*/
|
|
wrapOnKeys: true,
|
|
|
|
/**
|
|
* Allows the tab content panes to match heights if set to true.
|
|
* @option
|
|
* @example false
|
|
*/
|
|
matchHeight: false,
|
|
|
|
/**
|
|
* Class applied to `li`'s in tab link list.
|
|
* @option
|
|
* @example 'tabs-title'
|
|
*/
|
|
linkClass: 'tabs-title',
|
|
|
|
/**
|
|
* Class applied to the content containers.
|
|
* @option
|
|
* @example 'tabs-panel'
|
|
*/
|
|
panelClass: 'tabs-panel'
|
|
};
|
|
|
|
function checkClass($elem){
|
|
return $elem.hasClass('is-active');
|
|
}
|
|
|
|
// Window exports
|
|
Foundation.plugin(Tabs, 'Tabs');
|
|
|
|
}(jQuery);
|