carbon-components
Version:
The Carbon Design System is IBM’s open-source design system for products and experiences.
617 lines (507 loc) • 23.4 kB
JavaScript
function _typeof(obj) {
"@babel/helpers - typeof";
return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (obj) {
return typeof obj;
} : function (obj) {
return obj && "function" == typeof Symbol && obj.constructor === Symbol && obj !== Symbol.prototype ? "symbol" : typeof obj;
}, _typeof(obj);
}
(function (global, factory) {
if (typeof define === "function" && define.amd) {
define(["exports", "../../globals/js/settings", "../../globals/js/misc/event-matches", "../../globals/js/misc/mixin", "../../globals/js/mixins/create-component", "../../globals/js/mixins/init-component-by-search", "../../globals/js/mixins/evented-show-hide-state", "../../globals/js/mixins/handles", "../floating-menu/floating-menu", "../../globals/js/misc/get-launching-details", "../../globals/js/misc/on"], factory);
} else if (typeof exports !== "undefined") {
factory(exports, require("../../globals/js/settings"), require("../../globals/js/misc/event-matches"), require("../../globals/js/misc/mixin"), require("../../globals/js/mixins/create-component"), require("../../globals/js/mixins/init-component-by-search"), require("../../globals/js/mixins/evented-show-hide-state"), require("../../globals/js/mixins/handles"), require("../floating-menu/floating-menu"), require("../../globals/js/misc/get-launching-details"), require("../../globals/js/misc/on"));
} else {
var mod = {
exports: {}
};
factory(mod.exports, global.settings, global.eventMatches, global.mixin, global.createComponent, global.initComponentBySearch, global.eventedShowHideState, global.handles, global.floatingMenu, global.getLaunchingDetails, global.on);
global.overflowMenu = mod.exports;
}
})(typeof globalThis !== "undefined" ? globalThis : typeof self !== "undefined" ? self : this, function (_exports, _settings, _eventMatches, _mixin2, _createComponent, _initComponentBySearch, _eventedShowHideState, _handles, _floatingMenu, _getLaunchingDetails, _on) {
"use strict";
Object.defineProperty(_exports, "__esModule", {
value: true
});
_exports.getMenuOffset = _exports.default = void 0;
_settings = _interopRequireDefault(_settings);
_eventMatches = _interopRequireDefault(_eventMatches);
_mixin2 = _interopRequireDefault(_mixin2);
_createComponent = _interopRequireDefault(_createComponent);
_initComponentBySearch = _interopRequireDefault(_initComponentBySearch);
_eventedShowHideState = _interopRequireDefault(_eventedShowHideState);
_handles = _interopRequireDefault(_handles);
_floatingMenu = _interopRequireWildcard(_floatingMenu);
_getLaunchingDetails = _interopRequireDefault(_getLaunchingDetails);
_on = _interopRequireDefault(_on);
function _getRequireWildcardCache(nodeInterop) {
if (typeof WeakMap !== "function") return null;
var cacheBabelInterop = new WeakMap();
var cacheNodeInterop = new WeakMap();
return (_getRequireWildcardCache = function _getRequireWildcardCache(nodeInterop) {
return nodeInterop ? cacheNodeInterop : cacheBabelInterop;
})(nodeInterop);
}
function _interopRequireWildcard(obj, nodeInterop) {
if (!nodeInterop && obj && obj.__esModule) {
return obj;
}
if (obj === null || _typeof(obj) !== "object" && typeof obj !== "function") {
return {
default: obj
};
}
var cache = _getRequireWildcardCache(nodeInterop);
if (cache && cache.has(obj)) {
return cache.get(obj);
}
var newObj = {};
var hasPropertyDescriptor = Object.defineProperty && Object.getOwnPropertyDescriptor;
for (var key in obj) {
if (key !== "default" && Object.prototype.hasOwnProperty.call(obj, key)) {
var desc = hasPropertyDescriptor ? Object.getOwnPropertyDescriptor(obj, key) : null;
if (desc && (desc.get || desc.set)) {
Object.defineProperty(newObj, key, desc);
} else {
newObj[key] = obj[key];
}
}
}
newObj.default = obj;
if (cache) {
cache.set(obj, newObj);
}
return newObj;
}
function _interopRequireDefault(obj) {
return obj && obj.__esModule ? obj : {
default: obj
};
}
function _toConsumableArray(arr) {
return _arrayWithoutHoles(arr) || _iterableToArray(arr) || _unsupportedIterableToArray(arr) || _nonIterableSpread();
}
function _nonIterableSpread() {
throw new TypeError("Invalid attempt to spread non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.");
}
function _unsupportedIterableToArray(o, minLen) {
if (!o) return;
if (typeof o === "string") return _arrayLikeToArray(o, minLen);
var n = Object.prototype.toString.call(o).slice(8, -1);
if (n === "Object" && o.constructor) n = o.constructor.name;
if (n === "Map" || n === "Set") return Array.from(o);
if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen);
}
function _iterableToArray(iter) {
if (typeof Symbol !== "undefined" && iter[Symbol.iterator] != null || iter["@@iterator"] != null) return Array.from(iter);
}
function _arrayWithoutHoles(arr) {
if (Array.isArray(arr)) return _arrayLikeToArray(arr);
}
function _arrayLikeToArray(arr, len) {
if (len == null || len > arr.length) len = arr.length;
for (var i = 0, arr2 = new Array(len); i < len; i++) {
arr2[i] = arr[i];
}
return arr2;
}
function _classCallCheck(instance, Constructor) {
if (!(instance instanceof Constructor)) {
throw new TypeError("Cannot call a class as a 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);
}
}
function _createClass(Constructor, protoProps, staticProps) {
if (protoProps) _defineProperties(Constructor.prototype, protoProps);
if (staticProps) _defineProperties(Constructor, staticProps);
Object.defineProperty(Constructor, "prototype", {
writable: false
});
return Constructor;
}
function _inherits(subClass, superClass) {
if (typeof superClass !== "function" && superClass !== null) {
throw new TypeError("Super expression must either be null or a function");
}
subClass.prototype = Object.create(superClass && superClass.prototype, {
constructor: {
value: subClass,
writable: true,
configurable: true
}
});
Object.defineProperty(subClass, "prototype", {
writable: false
});
if (superClass) _setPrototypeOf(subClass, superClass);
}
function _setPrototypeOf(o, p) {
_setPrototypeOf = Object.setPrototypeOf || function _setPrototypeOf(o, p) {
o.__proto__ = p;
return o;
};
return _setPrototypeOf(o, p);
}
function _createSuper(Derived) {
var hasNativeReflectConstruct = _isNativeReflectConstruct();
return function _createSuperInternal() {
var Super = _getPrototypeOf(Derived),
result;
if (hasNativeReflectConstruct) {
var NewTarget = _getPrototypeOf(this).constructor;
result = Reflect.construct(Super, arguments, NewTarget);
} else {
result = Super.apply(this, arguments);
}
return _possibleConstructorReturn(this, result);
};
}
function _possibleConstructorReturn(self, call) {
if (call && (_typeof(call) === "object" || typeof call === "function")) {
return call;
} else if (call !== void 0) {
throw new TypeError("Derived constructors may only return object or undefined");
}
return _assertThisInitialized(self);
}
function _assertThisInitialized(self) {
if (self === void 0) {
throw new ReferenceError("this hasn't been initialised - super() hasn't been called");
}
return self;
}
function _isNativeReflectConstruct() {
if (typeof Reflect === "undefined" || !Reflect.construct) return false;
if (Reflect.construct.sham) return false;
if (typeof Proxy === "function") return true;
try {
Boolean.prototype.valueOf.call(Reflect.construct(Boolean, [], function () {}));
return true;
} catch (e) {
return false;
}
}
function _getPrototypeOf(o) {
_getPrototypeOf = Object.setPrototypeOf ? Object.getPrototypeOf : function _getPrototypeOf(o) {
return o.__proto__ || Object.getPrototypeOf(o);
};
return _getPrototypeOf(o);
}
function _defineProperty(obj, key, value) {
if (key in obj) {
Object.defineProperty(obj, key, {
value: value,
enumerable: true,
configurable: true,
writable: true
});
} else {
obj[key] = value;
}
return obj;
}
/**
* The CSS property names of the arrow keyed by the floating menu direction.
* @type {object<string, string>}
*/
var triggerButtonPositionProps = /* #__PURE__ */function () {
var _ref;
return _ref = {}, _defineProperty(_ref, _floatingMenu.DIRECTION_TOP, 'bottom'), _defineProperty(_ref, _floatingMenu.DIRECTION_BOTTOM, 'top'), _defineProperty(_ref, _floatingMenu.DIRECTION_LEFT, 'left'), _defineProperty(_ref, _floatingMenu.DIRECTION_RIGHT, 'right'), _ref;
}();
/**
* Determines how the position of arrow should affect the floating menu position.
* @type {object<string, number>}
*/
var triggerButtonPositionFactors = /* #__PURE__ */function () {
var _ref2;
return _ref2 = {}, _defineProperty(_ref2, _floatingMenu.DIRECTION_TOP, -2), _defineProperty(_ref2, _floatingMenu.DIRECTION_BOTTOM, -1), _defineProperty(_ref2, _floatingMenu.DIRECTION_LEFT, -2), _defineProperty(_ref2, _floatingMenu.DIRECTION_RIGHT, -1), _ref2;
}();
/**
* @param {Element} menuBody The menu body with the menu arrow.
* @param {string} direction The floating menu direction.
* @param {Element} trigger The trigger button.
* @returns {FloatingMenu~offset} The adjustment of the floating menu position, upon the position of the menu arrow.
* @private
*/
var getMenuOffset = function getMenuOffset(menuBody, direction, trigger) {
var triggerButtonPositionProp = triggerButtonPositionProps[direction];
var triggerButtonPositionFactor = triggerButtonPositionFactors[direction];
if (!triggerButtonPositionProp || !triggerButtonPositionFactor) {
console.warn('Wrong floating menu direction:', direction); // eslint-disable-line no-console
}
var menuWidth = menuBody.offsetWidth;
var menuHeight = menuBody.offsetHeight; // eslint-disable-next-line no-use-before-define
var menu = OverflowMenu.components.get(trigger);
if (!menu) {
throw new TypeError('Overflow menu instance cannot be found.');
}
var flip = menuBody.classList.contains(menu.options.classMenuFlip);
if (triggerButtonPositionProp === 'top' || triggerButtonPositionProp === 'bottom') {
var triggerWidth = trigger.offsetWidth;
return {
left: (!flip ? 1 : -1) * (menuWidth / 2 - triggerWidth / 2),
top: 0
};
}
if (triggerButtonPositionProp === 'left' || triggerButtonPositionProp === 'right') {
var triggerHeight = trigger.offsetHeight;
return {
left: 0,
top: (!flip ? 1 : -1) * (menuHeight / 2 - triggerHeight / 2)
};
}
return undefined;
};
_exports.getMenuOffset = getMenuOffset;
var OverflowMenu = /*#__PURE__*/function (_mixin) {
_inherits(OverflowMenu, _mixin);
var _super = _createSuper(OverflowMenu);
/**
* Overflow menu.
* @extends CreateComponent
* @extends InitComponentBySearch
* @extends Handles
* @param {HTMLElement} element The element working as a modal dialog.
* @param {object} [options] The component options.
* @param {string} [options.selectorOptionMenu] The CSS selector to find the menu.
* @param {string} [options.selectorTrigger] The CSS selector to find the trigger button.
* @param {string} [options.classShown] The CSS class for the shown state, for the trigger UI.
* @param {string} [options.classMenuShown] The CSS class for the shown state, for the menu.
* @param {string} [options.classMenuFlip] The CSS class for the flipped state of the menu.
* @param {object} [options.objMenuOffset] The offset locating the menu for the non-flipped state.
* @param {object} [options.objMenuOffsetFlip] The offset locating the menu for the flipped state.
*/
/**
* Overflow menu.
* @extends CreateComponent
* @extends InitComponentBySearch
* @extends Handles
* @param {HTMLElement} element The element working as a modal dialog.
* @param {object} [options] The component options.
* @param {string} [options.selectorOptionMenu] The CSS selector to find the menu.
* @param {string} [options.selectorTrigger] The CSS selector to find the trigger button.
* @param {string} [options.classShown] The CSS class for the shown state, for the trigger UI.
* @param {string} [options.classMenuShown] The CSS class for the shown state, for the menu.
* @param {string} [options.classMenuFlip] The CSS class for the flipped state of the menu.
* @param {object} [options.objMenuOffset] The offset locating the menu for the non-flipped state.
* @param {object} [options.objMenuOffsetFlip] The offset locating the menu for the flipped state.
*/
function OverflowMenu(element, options) {
var _this;
_classCallCheck(this, OverflowMenu);
_this = _super.call(this, element, options);
_this.getCurrentNavigation = function () {
var focused = _this.element.ownerDocument.activeElement;
return focused.nodeType === Node.ELEMENT_NODE && focused.matches(_this.options.selectorItem) ? focused : null;
};
_this.navigate = function (direction) {
var items = _toConsumableArray(_this.element.ownerDocument.querySelectorAll(_this.options.selectorItem));
var start = _this.getCurrentNavigation() || _this.element.querySelector(_this.options.selectorItemSelected);
var getNextItem = function getNextItem(old) {
var handleUnderflow = function handleUnderflow(index, length) {
return index + (index >= 0 ? 0 : length);
};
var handleOverflow = function handleOverflow(index, length) {
return index - (index < length ? 0 : length);
}; // `items.indexOf(old)` may be -1 (Scenario of no previous focus)
// `items.indexOf(old)` may be -1 (Scenario of no previous focus)
var index = Math.max(items.indexOf(old) + direction, -1);
return items[handleUnderflow(handleOverflow(index, items.length), items.length)];
};
for (var current = getNextItem(start); current && current !== start; current = getNextItem(current)) {
if (!current.matches(_this.options.selectorItemHidden) && !current.parentNode.matches(_this.options.selectorItemHidden) && !current.matches(_this.options.selectorItemSelected)) {
current.focus();
break;
}
}
};
if (_this.element.getAttribute('role') !== 'button') {
// Would prefer to use the aria-controls with a specific ID but we
// don't have the menuOptions list at this point to pull the ID from
_this.triggerNode = _this.element.querySelector(_this.options.selectorTrigger);
}
_this.manage((0, _on.default)(_this.element.ownerDocument, 'click', function (event) {
_this._handleDocumentClick(event);
_this.wasOpenBeforeClick = undefined;
}));
_this.manage((0, _on.default)(_this.element.ownerDocument, 'keydown', function (event) {
_this._handleKeyPress(event);
}));
_this.manage((0, _on.default)(_this.element, 'mousedown', function () {
_this.wasOpenBeforeClick = element.classList.contains(_this.options.classShown);
}));
return _this;
}
/**
* Changes the shown/hidden state.
* @param {string} state The new state.
* @param {object} detail The detail of the event trigging this action.
* @param {Function} callback Callback called when change in state completes.
*/
/**
* Changes the shown/hidden state.
* @param {string} state The new state.
* @param {object} detail The detail of the event trigging this action.
* @param {Function} callback Callback called when change in state completes.
*/
_createClass(OverflowMenu, [{
key: "changeState",
value: function changeState(state, detail, callback) {
if (!this.optionMenu) {
var optionMenu = this.element.querySelector(this.options.selectorOptionMenu);
if (!optionMenu) {
throw new Error('Cannot find the target menu.');
} // Lazily create a component instance for menu
// Lazily create a component instance for menu
this.optionMenu = _floatingMenu.default.create(optionMenu, {
refNode: this.element,
classShown: this.options.classMenuShown,
classRefShown: this.options.classShown,
offset: this.options.objMenuOffset,
triggerNode: this.triggerNode,
contentNode: this.element.querySelector(this.options.selectorContent)
});
this.children.push(this.optionMenu);
}
if (this.optionMenu.element.classList.contains(this.options.classMenuFlip)) {
this.optionMenu.options.offset = this.options.objMenuOffsetFlip;
} // Delegates the action of changing state to the menu.
// (And thus the before/after shown/hidden events are fired from the menu)
// Delegates the action of changing state to the menu.
// (And thus the before/after shown/hidden events are fired from the menu)
this.optionMenu.changeState(state, Object.assign(detail, {
delegatorNode: this.element
}), callback);
}
/**
* Handles click on document.
* @param {Event} event The triggering event.
* @private
*/
}, {
key: "_handleDocumentClick",
value: function _handleDocumentClick(event) {
var _this2 = this;
var element = this.element,
optionMenu = this.optionMenu,
wasOpenBeforeClick = this.wasOpenBeforeClick,
triggerNode = this.triggerNode;
var isOfSelf = element.contains(event.target);
var isOfMenu = optionMenu && optionMenu.element.contains(event.target);
var shouldBeOpen = isOfSelf && !wasOpenBeforeClick;
var state = shouldBeOpen ? 'shown' : 'hidden';
if (isOfSelf) {
if (element.tagName === 'A') {
event.preventDefault();
}
event.delegateTarget = element; // eslint-disable-line no-param-reassign
}
if (!isOfMenu || (0, _eventMatches.default)(event, this.options.selectorItem)) {
this.changeState(state, (0, _getLaunchingDetails.default)(event), function () {
if (state === 'hidden' && isOfMenu) {
// @todo Can clean up to use `this.triggerNode` once non-compliant code is deprecated
_this2[triggerNode ? 'triggerNode' : 'element'].focus();
}
});
}
}
/**
* Provides the element to move focus from
* @returns {Element} Currently highlighted element.
*/
}, {
key: "_handleKeyPress",
value:
/**
* Handles key press on document.
* @param {Event} event The triggering event.
* @private
*/
function _handleKeyPress(event) {
var _this3 = this;
var key = event.which;
var element = this.element,
optionMenu = this.optionMenu,
options = this.options,
triggerNode = this.triggerNode;
var isOfMenu = optionMenu && optionMenu.element.contains(event.target);
var isExpanded = this.element.classList.contains(this.options.classShown); // @todo Can clean up to use `this.triggerNode` once non-compliant code is deprecated
// @todo Can clean up to use `this.triggerNode` once non-compliant code is deprecated
var triggerElement = triggerNode ? 'triggerNode' : 'element';
switch (key) {
// Enter || Space bar
case 13:
case 32:
{
if (!isExpanded && this.element.ownerDocument.activeElement !== this.element) {
return;
}
var isOfSelf = element.contains(event.target);
var shouldBeOpen = isOfSelf && !element.classList.contains(options.classShown);
var state = shouldBeOpen ? 'shown' : 'hidden';
if (isOfSelf) {
event.delegateTarget = element; // eslint-disable-line no-param-reassign
// eslint-disable-line no-param-reassign
event.preventDefault(); // prevent scrolling
// prevent scrolling
this.changeState(state, (0, _getLaunchingDetails.default)(event), function () {
if (state === 'hidden' && isOfMenu) {
_this3[triggerElement].focus();
}
});
}
break;
}
case 38: // up arrow
// up arrow
case 40:
// down arrow
{
if (!isExpanded) {
return;
}
event.preventDefault(); // prevent scrolling
// prevent scrolling
var direction = {
38: -1,
40: 1
}[event.which];
this.navigate(direction);
}
break;
default:
break;
}
}
}], [{
key: "options",
get: function get() {
var prefix = _settings.default.prefix;
return {
selectorInit: '[data-overflow-menu]',
selectorOptionMenu: ".".concat(prefix, "--overflow-menu-options"),
selectorTrigger: 'button[aria-haspopup]',
selectorContent: ".".concat(prefix, "--overflow-menu-options__content"),
selectorItem: "\n .".concat(prefix, "--overflow-menu-options--open\n .").concat(prefix, "--overflow-menu-options__option:not(.").concat(prefix, "--overflow-menu-options__option--disabled) >\n .").concat(prefix, "--overflow-menu-options__btn\n "),
classShown: "".concat(prefix, "--overflow-menu--open"),
classMenuShown: "".concat(prefix, "--overflow-menu-options--open"),
classMenuFlip: "".concat(prefix, "--overflow-menu--flip"),
objMenuOffset: getMenuOffset,
objMenuOffsetFlip: getMenuOffset
};
}
}]);
OverflowMenu.components = new WeakMap();
return OverflowMenu;
}((0, _mixin2.default)(_createComponent.default, _initComponentBySearch.default, _eventedShowHideState.default, _handles.default));
var _default = OverflowMenu;
_exports.default = _default;
});