'use strict';
var _createClass = function () { function defineProperties(target, props) { for (var i = 0; i < props.length; i++) { var descriptor = props[i]; descriptor.enumerable = descriptor.enumerable || false; descriptor.configurable = true; if ("value" in descriptor) descriptor.writable = true; Object.defineProperty(target, descriptor.key, descriptor); } } return function (Constructor, protoProps, staticProps) { if (protoProps) defineProperties(Constructor.prototype, protoProps); if (staticProps) defineProperties(Constructor, staticProps); return Constructor; }; }();
function _classCallCheck(instance, Constructor) { if (!(instance instanceof Constructor)) { throw new TypeError("Cannot call a class as a function"); } }
!function ($) {
/**
* Drilldown module.
* @module foundation.drilldown
* @requires foundation.util.keyboard
* @requires foundation.util.motion
* @requires foundation.util.nest
*/
var Drilldown = function () {
/**
* Creates a new instance of a drilldown menu.
* @class
* @param {jQuery} element - jQuery object to make into an accordion menu.
* @param {Object} options - Overrides to the default plugin settings.
*/
function Drilldown(element, options) {
_classCallCheck(this, Drilldown);
this.$element = element;
this.options = $.extend({}, Drilldown.defaults, this.$element.data(), options);
Foundation.Nest.Feather(this.$element, 'drilldown');
this._init();
Foundation.registerPlugin(this, 'Drilldown');
Foundation.Keyboard.register('Drilldown', {
'ENTER': 'open',
'SPACE': 'open',
'ARROW_RIGHT': 'next',
'ARROW_UP': 'up',
'ARROW_DOWN': 'down',
'ARROW_LEFT': 'previous',
'ESCAPE': 'close',
'TAB': 'down',
'SHIFT_TAB': 'up'
});
}
/**
* Initializes the drilldown by creating jQuery collections of elements
* @private
*/
_createClass(Drilldown, [{
key: '_init',
value: function _init() {
this.$submenuAnchors = this.$element.find('li.is-drilldown-submenu-parent').children('a');
this.$submenus = this.$submenuAnchors.parent('li').children('[data-submenu]');
this.$menuItems = this.$element.find('li').not('.js-drilldown-back').attr('role', 'menuitem').find('a');
this.$element.attr('data-mutate', this.$element.attr('data-drilldown') || Foundation.GetYoDigits(6, 'drilldown'));
this._prepareMenu();
this._registerEvents();
this._keyboardEvents();
}
/**
* prepares drilldown menu by setting attributes to links and elements
* sets a min height to prevent content jumping
* wraps the element if not already wrapped
* @private
* @function
*/
}, {
key: '_prepareMenu',
value: function _prepareMenu() {
var _this = this;
// if(!this.options.holdOpen){
// this._menuLinkEvents();
// }
this.$submenuAnchors.each(function () {
var $link = $(this);
var $sub = $link.parent();
if (_this.options.parentLink) {
$link.clone().prependTo($sub.children('[data-submenu]')).wrap('<li class="is-submenu-parent-item is-submenu-item is-drilldown-submenu-item" role="menu-item"></li>');
}
$link.data('savedHref', $link.attr('href')).removeAttr('href').attr('tabindex', 0);
$link.children('[data-submenu]').attr({
'aria-hidden': true,
'tabindex': 0,
'role': 'menu'
});
_this._events($link);
});
this.$submenus.each(function () {
var $menu = $(this),
$back = $menu.find('.js-drilldown-back');
if (!$back.length) {
switch (_this.options.backButtonPosition) {
case "bottom":
$menu.append(_this.options.backButton);
break;
case "top":
$menu.prepend(_this.options.backButton);
break;
default:
console.error("Unsupported backButtonPosition value '" + _this.options.backButtonPosition + "'");
}
}
_this._back($menu);
});
if (!this.options.autoHeight) {
this.$submenus.addClass('drilldown-submenu-cover-previous');
}
if (!this.$element.parent().hasClass('is-drilldown')) {
this.$wrapper = $(this.options.wrapper).addClass('is-drilldown');
if (this.options.animateHeight) this.$wrapper.addClass('animate-height');
this.$wrapper = this.$element.wrap(this.$wrapper).parent().css(this._getMaxDims());
}
}
}, {
key: '_resize',
value: function _resize() {
this.$wrapper.css({ 'max-width': 'none', 'min-height': 'none' });
// _getMaxDims has side effects (boo) but calling it should update all other necessary heights & widths
this.$wrapper.css(this._getMaxDims());
}
/**
* Adds event handlers to elements in the menu.
* @function
* @private
* @param {jQuery} $elem - the current menu item to add handlers to.
*/
}, {
key: '_events',
value: function _events($elem) {
var _this = this;
$elem.off('click.zf.drilldown').on('click.zf.drilldown', function (e) {
if ($(e.target).parentsUntil('ul', 'li').hasClass('is-drilldown-submenu-parent')) {
e.stopImmediatePropagation();
e.preventDefault();
}
// if(e.target !== e.currentTarget.firstElementChild){
// return false;
// }
_this._show($elem.parent('li'));
if (_this.options.closeOnClick) {
var $body = $('body');
$body.off('.zf.drilldown').on('click.zf.drilldown', function (e) {
if (e.target === _this.$element[0] || $.contains(_this.$element[0], e.target)) {
return;
}
e.preventDefault();
_this._hideAll();
$body.off('.zf.drilldown');
});
}
});
this.$element.on('mutateme.zf.trigger', this._resize.bind(this));
}
/**
* Adds event handlers to the menu element.
* @function
* @private
*/
}, {
key: '_registerEvents',
value: function _registerEvents() {
if (this.options.scrollTop) {
this._bindHandler = this._scrollTop.bind(this);
this.$element.on('open.zf.drilldown hide.zf.drilldown closed.zf.drilldown', this._bindHandler);
}
}
/**
* Scroll to Top of Element or data-scroll-top-element
* @function
* @fires Drilldown#scrollme
*/
}, {
key: '_scrollTop',
value: function _scrollTop() {
var _this = this;
var $scrollTopElement = _this.options.scrollTopElement != '' ? $(_this.options.scrollTopElement) : _this.$element,
scrollPos = parseInt($scrollTopElement.offset().top + _this.options.scrollTopOffset);
$('html, body').stop(true).animate({ scrollTop: scrollPos }, _this.options.animationDuration, _this.options.animationEasing, function () {
/**
* Fires after the menu has scrolled
* @event Drilldown#scrollme
*/
if (this === $('html')[0]) _this.$element.trigger('scrollme.zf.drilldown');
});
}
/**
* Adds keydown event listener to `li`'s in the menu.
* @private
*/
}, {
key: '_keyboardEvents',
value: function _keyboardEvents() {
var _this = this;
this.$menuItems.add(this.$element.find('.js-drilldown-back > a, .is-submenu-parent-item > a')).on('keydown.zf.drilldown', function (e) {
var $element = $(this),
$elements = $element.parent('li').parent('ul').children('li').children('a'),
$prevElement,
$nextElement;
$elements.each(function (i) {
if ($(this).is($element)) {
$prevElement = $elements.eq(Math.max(0, i - 1));
$nextElement = $elements.eq(Math.min(i + 1, $elements.length - 1));
return;
}
});
Foundation.Keyboard.handleKey(e, 'Drilldown', {
next: function () {
if ($element.is(_this.$submenuAnchors)) {
_this._show($element.parent('li'));
$element.parent('li').one(Foundation.transitionend($element), function () {
$element.parent('li').find('ul li a').filter(_this.$menuItems).first().focus();
});
return true;
}
},
previous: function () {
_this._hide($element.parent('li').parent('ul'));
$element.parent('li').parent('ul').one(Foundation.transitionend($element), function () {
setTimeout(function () {
$element.parent('li').parent('ul').parent('li').children('a').first().focus();
}, 1);
});
return true;
},
up: function () {
$prevElement.focus();
return true;
},
down: function () {
$nextElement.focus();
return true;
},
close: function () {
_this._back();
//_this.$menuItems.first().focus(); // focus to first element
},
open: function () {
if (!$element.is(_this.$menuItems)) {
// not menu item means back button
_this._hide($element.parent('li').parent('ul'));
$element.parent('li').parent('ul').one(Foundation.transitionend($element), function () {
setTimeout(function () {
$element.parent('li').parent('ul').parent('li').children('a').first().focus();
}, 1);
});
return true;
} else if ($element.is(_this.$submenuAnchors)) {
_this._show($element.parent('li'));
$element.parent('li').one(Foundation.transitionend($element), function () {
$element.parent('li').find('ul li a').filter(_this.$menuItems).first().focus();
});
return true;
}
},
handled: function (preventDefault) {
if (preventDefault) {
e.preventDefault();
}
e.stopImmediatePropagation();
}
});
}); // end keyboardAccess
}
/**
* Closes all open elements, and returns to root menu.
* @function
* @fires Drilldown#closed
*/
}, {
key: '_hideAll',
value: function _hideAll() {
var $elem = this.$element.find('.is-drilldown-submenu.is-active').addClass('is-closing');
if (this.options.autoHeight) this.$wrapper.css({ height: $elem.parent().closest('ul').data('calcHeight') });
$elem.one(Foundation.transitionend($elem), function (e) {
$elem.removeClass('is-active is-closing');
});
/**
* Fires when the menu is fully closed.
* @event Drilldown#closed
*/
this.$element.trigger('closed.zf.drilldown');
}
/**
* Adds event listener for each `back` button, and closes open menus.
* @function
* @fires Drilldown#back
* @param {jQuery} $elem - the current sub-menu to add `back` event.
*/
}, {
key: '_back',
value: function _back($elem) {
var _this = this;
$elem.off('click.zf.drilldown');
$elem.children('.js-drilldown-back').on('click.zf.drilldown', function (e) {
e.stopImmediatePropagation();
// console.log('mouseup on back');
_this._hide($elem);
// If there is a parent submenu, call show
var parentSubMenu = $elem.parent('li').parent('ul').parent('li');
if (parentSubMenu.length) {
_this._show(parentSubMenu);
}
});
}
/**
* Adds event listener to menu items w/o submenus to close open menus on click.
* @function
* @private
*/
}, {
key: '_menuLinkEvents',
value: function _menuLinkEvents() {
var _this = this;
this.$menuItems.not('.is-drilldown-submenu-parent').off('click.zf.drilldown').on('click.zf.drilldown', function (e) {
// e.stopImmediatePropagation();
setTimeout(function () {
_this._hideAll();
}, 0);
});
}
/**
* Opens a submenu.
* @function
* @fires Drilldown#open
* @param {jQuery} $elem - the current element with a submenu to open, i.e. the `li` tag.
*/
}, {
key: '_show',
value: function _show($elem) {
if (this.options.autoHeight) this.$wrapper.css({ height: $elem.children('[data-submenu]').data('calcHeight') });
$elem.attr('aria-expanded', true);
$elem.children('[data-submenu]').addClass('is-active').attr('aria-hidden', false);
/**
* Fires when the submenu has opened.
* @event Drilldown#open
*/
this.$element.trigger('open.zf.drilldown', [$elem]);
}
}, {
key: '_hide',
/**
* Hides a submenu
* @function
* @fires Drilldown#hide
* @param {jQuery} $elem - the current sub-menu to hide, i.e. the `ul` tag.
*/
value: function _hide($elem) {
if (this.options.autoHeight) this.$wrapper.css({ height: $elem.parent().closest('ul').data('calcHeight') });
var _this = this;
$elem.parent('li').attr('aria-expanded', false);
$elem.attr('aria-hidden', true).addClass('is-closing');
$elem.addClass('is-closing').one(Foundation.transitionend($elem), function () {
$elem.removeClass('is-active is-closing');
$elem.blur();
});
/**
* Fires when the submenu has closed.
* @event Drilldown#hide
*/
$elem.trigger('hide.zf.drilldown', [$elem]);
}
/**
* Iterates through the nested menus to calculate the min-height, and max-width for the menu.
* Prevents content jumping.
* @function
* @private
*/
}, {
key: '_getMaxDims',
value: function _getMaxDims() {
var maxHeight = 0,
result = {},
_this = this;
this.$submenus.add(this.$element).each(function () {
var numOfElems = $(this).children('li').length;
var height = Foundation.Box.GetDimensions(this).height;
maxHeight = height > maxHeight ? height : maxHeight;
if (_this.options.autoHeight) {
$(this).data('calcHeight', height);
if (!$(this).hasClass('is-drilldown-submenu')) result['height'] = height;
}
});
if (!this.options.autoHeight) result['min-height'] = maxHeight + 'px';
result['max-width'] = this.$element[0].getBoundingClientRect().width + 'px';
return result;
}
/**
* Destroys the Drilldown Menu
* @function
*/
}, {
key: 'destroy',
value: function destroy() {
if (this.options.scrollTop) this.$element.off('.zf.drilldown', this._bindHandler);
this._hideAll();
this.$element.off('mutateme.zf.trigger');
Foundation.Nest.Burn(this.$element, 'drilldown');
this.$element.unwrap().find('.js-drilldown-back, .is-submenu-parent-item').remove().end().find('.is-active, .is-closing, .is-drilldown-submenu').removeClass('is-active is-closing is-drilldown-submenu').end().find('[data-submenu]').removeAttr('aria-hidden tabindex role');
this.$submenuAnchors.each(function () {
$(this).off('.zf.drilldown');
});
this.$submenus.removeClass('drilldown-submenu-cover-previous');
this.$element.find('a').each(function () {
var $link = $(this);
$link.removeAttr('tabindex');
if ($link.data('savedHref')) {
$link.attr('href', $link.data('savedHref')).removeData('savedHref');
} else {
return;
}
});
Foundation.unregisterPlugin(this);
}
}]);
return Drilldown;
}();
Drilldown.defaults = {
/**
* Markup used for JS generated back button. Prepended or appended (see backButtonPosition) to submenu lists and deleted on `destroy` method, 'js-drilldown-back' class required. Remove the backslash (`\`) if copy and pasting.
* @option
* @example '<\li><\a>Back<\/a><\/li>'
*/
backButton: '<li class="js-drilldown-back"><a tabindex="0">Back</a></li>',
/**
* Position the back button either at the top or bottom of drilldown submenus.
* @option
* @example bottom
*/
backButtonPosition: 'top',
/**
* Markup used to wrap drilldown menu. Use a class name for independent styling; the JS applied class: `is-drilldown` is required. Remove the backslash (`\`) if copy and pasting.
* @option
* @example '<\div class="is-drilldown"><\/div>'
*/
wrapper: '<div></div>',
/**
* Adds the parent link to the submenu.
* @option
* @example false
*/
parentLink: false,
/**
* Allow the menu to return to root list on body click.
* @option
* @example false
*/
closeOnClick: false,
/**
* Allow the menu to auto adjust height.
* @option
* @example false
*/
autoHeight: false,
/**
* Animate the auto adjust height.
* @option
* @example false
*/
animateHeight: false,
/**
* Scroll to the top of the menu after opening a submenu or navigating back using the menu back button
* @option
* @example false
*/
scrollTop: false,
/**
* String jquery selector (for example 'body') of element to take offset().top from, if empty string the drilldown menu offset().top is taken
* @option
* @example ''
*/
scrollTopElement: '',
/**
* ScrollTop offset
* @option
* @example 100
*/
scrollTopOffset: 0,
/**
* Scroll animation duration
* @option
* @example 500
*/
animationDuration: 500,
/**
* Scroll animation easing
* @option
* @example 'swing'
*/
animationEasing: 'swing'
// holdOpen: false
};
// Window exports
Foundation.plugin(Drilldown, 'Drilldown');
}(jQuery);
|
Download
