You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
315 lines
8.3 KiB
315 lines
8.3 KiB
'use strict'; |
|
|
|
!function($) { |
|
|
|
/** |
|
* Accordion module. |
|
* @module foundation.accordion |
|
* @requires foundation.util.keyboard |
|
* @requires foundation.util.motion |
|
*/ |
|
|
|
class Accordion { |
|
/** |
|
* Creates a new instance of an accordion. |
|
* @class |
|
* @fires Accordion#init |
|
* @param {jQuery} element - jQuery object to make into an accordion. |
|
* @param {Object} options - a plain object with settings to override the default options. |
|
*/ |
|
constructor(element, options) { |
|
this.$element = element; |
|
this.options = $.extend({}, Accordion.defaults, this.$element.data(), options); |
|
|
|
this._init(); |
|
|
|
Foundation.registerPlugin(this, 'Accordion'); |
|
Foundation.Keyboard.register('Accordion', { |
|
'ENTER': 'toggle', |
|
'SPACE': 'toggle', |
|
'ARROW_DOWN': 'next', |
|
'ARROW_UP': 'previous' |
|
}); |
|
} |
|
|
|
/** |
|
* Initializes the accordion by animating the preset active pane(s). |
|
* @private |
|
*/ |
|
_init() { |
|
this.$element.attr('role', 'tablist'); |
|
this.$tabs = this.$element.children('[data-accordion-item]'); |
|
|
|
this.$tabs.each(function(idx, el) { |
|
var $el = $(el), |
|
$content = $el.children('[data-tab-content]'), |
|
id = $content[0].id || Foundation.GetYoDigits(6, 'accordion'), |
|
linkId = el.id || `${id}-label`; |
|
|
|
$el.find('a:first').attr({ |
|
'aria-controls': id, |
|
'role': 'tab', |
|
'id': linkId, |
|
'aria-expanded': false, |
|
'aria-selected': false |
|
}); |
|
|
|
$content.attr({'role': 'tabpanel', 'aria-labelledby': linkId, 'aria-hidden': true, 'id': id}); |
|
}); |
|
var $initActive = this.$element.find('.is-active').children('[data-tab-content]'); |
|
this.firstTimeInit = true; |
|
if($initActive.length){ |
|
this.down($initActive, this.firstTimeInit); |
|
this.firstTimeInit = false; |
|
} |
|
|
|
this._checkDeepLink = () => { |
|
var anchor = window.location.hash; |
|
//need a hash and a relevant anchor in this tabset |
|
if(anchor.length) { |
|
var $link = this.$element.find('[href$="'+anchor+'"]'), |
|
$anchor = $(anchor); |
|
|
|
if ($link.length && $anchor) { |
|
if (!$link.parent('[data-accordion-item]').hasClass('is-active')) { |
|
this.down($anchor, this.firstTimeInit); |
|
this.firstTimeInit = false; |
|
}; |
|
|
|
//roll up a little to show the titles |
|
if (this.options.deepLinkSmudge) { |
|
var _this = this; |
|
$(window).load(function() { |
|
var offset = _this.$element.offset(); |
|
$('html, body').animate({ scrollTop: offset.top }, _this.options.deepLinkSmudgeDelay); |
|
}); |
|
} |
|
|
|
/** |
|
* Fires when the zplugin has deeplinked at pageload |
|
* @event Accordion#deeplink |
|
*/ |
|
this.$element.trigger('deeplink.zf.accordion', [$link, $anchor]); |
|
} |
|
} |
|
} |
|
|
|
//use browser to open a tab, if it exists in this tabset |
|
if (this.options.deepLink) { |
|
this._checkDeepLink(); |
|
} |
|
|
|
this._events(); |
|
} |
|
|
|
/** |
|
* Adds event handlers for items within the accordion. |
|
* @private |
|
*/ |
|
_events() { |
|
var _this = this; |
|
|
|
this.$tabs.each(function() { |
|
var $elem = $(this); |
|
var $tabContent = $elem.children('[data-tab-content]'); |
|
if ($tabContent.length) { |
|
$elem.children('a').off('click.zf.accordion keydown.zf.accordion') |
|
.on('click.zf.accordion', function(e) { |
|
e.preventDefault(); |
|
_this.toggle($tabContent); |
|
}).on('keydown.zf.accordion', function(e){ |
|
Foundation.Keyboard.handleKey(e, 'Accordion', { |
|
toggle: function() { |
|
_this.toggle($tabContent); |
|
}, |
|
next: function() { |
|
var $a = $elem.next().find('a').focus(); |
|
if (!_this.options.multiExpand) { |
|
$a.trigger('click.zf.accordion') |
|
} |
|
}, |
|
previous: function() { |
|
var $a = $elem.prev().find('a').focus(); |
|
if (!_this.options.multiExpand) { |
|
$a.trigger('click.zf.accordion') |
|
} |
|
}, |
|
handled: function() { |
|
e.preventDefault(); |
|
e.stopPropagation(); |
|
} |
|
}); |
|
}); |
|
} |
|
}); |
|
if(this.options.deepLink) { |
|
$(window).on('popstate', this._checkDeepLink); |
|
} |
|
} |
|
|
|
/** |
|
* Toggles the selected content pane's open/close state. |
|
* @param {jQuery} $target - jQuery object of the pane to toggle (`.accordion-content`). |
|
* @function |
|
*/ |
|
toggle($target) { |
|
if($target.parent().hasClass('is-active')) { |
|
this.up($target); |
|
} else { |
|
this.down($target); |
|
} |
|
//either replace or update browser history |
|
if (this.options.deepLink) { |
|
var anchor = $target.prev('a').attr('href'); |
|
|
|
if (this.options.updateHistory) { |
|
history.pushState({}, '', anchor); |
|
} else { |
|
history.replaceState({}, '', anchor); |
|
} |
|
} |
|
} |
|
|
|
/** |
|
* Opens the accordion tab defined by `$target`. |
|
* @param {jQuery} $target - Accordion pane to open (`.accordion-content`). |
|
* @param {Boolean} firstTime - flag to determine if reflow should happen. |
|
* @fires Accordion#down |
|
* @function |
|
*/ |
|
down($target, firstTime) { |
|
$target |
|
.attr('aria-hidden', false) |
|
.parent('[data-tab-content]') |
|
.addBack() |
|
.parent().addClass('is-active'); |
|
|
|
if (!this.options.multiExpand && !firstTime) { |
|
var $currentActive = this.$element.children('.is-active').children('[data-tab-content]'); |
|
if ($currentActive.length) { |
|
this.up($currentActive.not($target)); |
|
} |
|
} |
|
|
|
$target.slideDown(this.options.slideSpeed, () => { |
|
/** |
|
* Fires when the tab is done opening. |
|
* @event Accordion#down |
|
*/ |
|
this.$element.trigger('down.zf.accordion', [$target]); |
|
}); |
|
|
|
$(`#${$target.attr('aria-labelledby')}`).attr({ |
|
'aria-expanded': true, |
|
'aria-selected': true |
|
}); |
|
} |
|
|
|
/** |
|
* Closes the tab defined by `$target`. |
|
* @param {jQuery} $target - Accordion tab to close (`.accordion-content`). |
|
* @fires Accordion#up |
|
* @function |
|
*/ |
|
up($target) { |
|
var $aunts = $target.parent().siblings(), |
|
_this = this; |
|
|
|
if((!this.options.allowAllClosed && !$aunts.hasClass('is-active')) || !$target.parent().hasClass('is-active')) { |
|
return; |
|
} |
|
|
|
// Foundation.Move(this.options.slideSpeed, $target, function(){ |
|
$target.slideUp(_this.options.slideSpeed, function () { |
|
/** |
|
* Fires when the tab is done collapsing up. |
|
* @event Accordion#up |
|
*/ |
|
_this.$element.trigger('up.zf.accordion', [$target]); |
|
}); |
|
// }); |
|
|
|
$target.attr('aria-hidden', true) |
|
.parent().removeClass('is-active'); |
|
|
|
$(`#${$target.attr('aria-labelledby')}`).attr({ |
|
'aria-expanded': false, |
|
'aria-selected': false |
|
}); |
|
} |
|
|
|
/** |
|
* Destroys an instance of an accordion. |
|
* @fires Accordion#destroyed |
|
* @function |
|
*/ |
|
destroy() { |
|
this.$element.find('[data-tab-content]').stop(true).slideUp(0).css('display', ''); |
|
this.$element.find('a').off('.zf.accordion'); |
|
if(this.options.deepLink) { |
|
$(window).off('popstate', this._checkDeepLink); |
|
} |
|
|
|
Foundation.unregisterPlugin(this); |
|
} |
|
} |
|
|
|
Accordion.defaults = { |
|
/** |
|
* Amount of time to animate the opening of an accordion pane. |
|
* @option |
|
* @type {number} |
|
* @default 250 |
|
*/ |
|
slideSpeed: 250, |
|
/** |
|
* Allow the accordion to have multiple open panes. |
|
* @option |
|
* @type {boolean} |
|
* @default false |
|
*/ |
|
multiExpand: false, |
|
/** |
|
* Allow the accordion to close all panes. |
|
* @option |
|
* @type {boolean} |
|
* @default false |
|
*/ |
|
allowAllClosed: false, |
|
/** |
|
* Allows the window to scroll to content of pane specified by hash anchor |
|
* @option |
|
* @type {boolean} |
|
* @default false |
|
*/ |
|
deepLink: false, |
|
|
|
/** |
|
* Adjust the deep link scroll to make sure the top of the accordion panel is visible |
|
* @option |
|
* @type {boolean} |
|
* @default false |
|
*/ |
|
deepLinkSmudge: false, |
|
|
|
/** |
|
* Animation time (ms) for the deep link adjustment |
|
* @option |
|
* @type {number} |
|
* @default 300 |
|
*/ |
|
deepLinkSmudgeDelay: 300, |
|
|
|
/** |
|
* Update the browser history with the open accordion |
|
* @option |
|
* @type {boolean} |
|
* @default false |
|
*/ |
|
updateHistory: false |
|
}; |
|
|
|
// Window exports |
|
Foundation.plugin(Accordion, 'Accordion'); |
|
|
|
}(jQuery);
|
|
|